mirror of
https://github.com/Zeckmathederg/glfs.git
synced 2025-01-24 23:32:12 +08:00
4392a40e94
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@20713 af4574ff-66df-0310-9fd7-8a98e5e911e0
87 lines
3.4 KiB
XML
87 lines
3.4 KiB
XML
<?xml version="1.0" encoding="ISO-8859-1"?>
|
|
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
|
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
|
|
<!ENTITY % general-entities SYSTEM "../../general.ent">
|
|
%general-entities;
|
|
|
|
<!-- it seems at least one entity is needed -->
|
|
<!ENTITY perl-alternatives-dummy "42">
|
|
]>
|
|
<!-- Begin perl alternatives -->
|
|
<sect2 id="perl-alternatives" xreflabel="CPAN automated install of perl modules">
|
|
|
|
<title>CPAN automated install of perl modules</title>
|
|
|
|
<indexterm zone="perl-alternatives">
|
|
<primary sortas="a-cpan-install-of-perl-modules">CPAN automated install of perl modules</primary>
|
|
</indexterm>
|
|
|
|
<sect3 role="installation" id="perl-auto-install"
|
|
xreflabel="automatic installation of perl modules">
|
|
<title> Automatic Installation of Perl Modules.</title>
|
|
|
|
<para>
|
|
There is an alternate way of installing the modules using the
|
|
<command>cpan</command> shell <command>install</command> command. The
|
|
command automatically downloads the latest source from the CPAN archive
|
|
for the module and any missing prerequisite modules listed by upstream.
|
|
Then for each module it extracts it, runs the compilation, the tests and
|
|
installs it.
|
|
</para>
|
|
|
|
<para>
|
|
You still need to install any non-perl dependencies before running
|
|
the automated installation method. You may wish to clean out the
|
|
<filename class="directory">build/</filename> directory after
|
|
installing, to free up the space. If any post-install actions such
|
|
as creating a symlink are mentioned, you should also do those.
|
|
</para>
|
|
|
|
<para>
|
|
The first time you run <command>cpan</command>, you'll be prompted
|
|
to enter some information regarding download locations and methods. This
|
|
information is retained in files located in
|
|
<filename class='directory'>~/.cpan</filename>.
|
|
</para>
|
|
|
|
<para>
|
|
In particular, you may wish to configure it so that <xref linkend="sudo"/>
|
|
is used for the installs, allowing you to build and test as a regular user.
|
|
The following examples have not used that approach.
|
|
</para>
|
|
|
|
<para>
|
|
Start the
|
|
<command>cpan</command> shell by issuing '<command>cpan</command>' as the
|
|
<systemitem class="username">root</systemitem> user. Any module may now be
|
|
installed from the
|
|
<emphasis role='underlined'><prompt>cpan> </prompt></emphasis>
|
|
prompt with the command:
|
|
</para>
|
|
|
|
<screen role="root"><userinput>install <replaceable><Module::Name></replaceable></userinput></screen>
|
|
|
|
<para>
|
|
For additional commands and help, issue '<command>help</command>'
|
|
from the
|
|
<emphasis role='underlined'><prompt>cpan> </prompt></emphasis>
|
|
prompt.
|
|
</para>
|
|
|
|
<para>
|
|
Alternatively, for scripted or non-interactive installations, use the
|
|
following syntax as the <systemitem class="username">root</systemitem>
|
|
user to install one or more modules:
|
|
</para>
|
|
|
|
<screen role="root"><userinput>cpan -i <replaceable><Module1::Name> <Module2::Name></replaceable></userinput></screen>
|
|
|
|
<para>
|
|
Review the <filename>cpan.1</filename> man page for additional
|
|
parameters you can pass to <command>cpan</command> on the command line.
|
|
</para>
|
|
|
|
</sect3>
|
|
|
|
</sect2>
|