cpanm man page on Pidora

Man page or keyword search:  
man Server   31170 pages
apropos Keyword Search (all sections)
Output format
Pidora logo
[printable version]

CPANM(1)	      User Contributed Perl Documentation	      CPANM(1)

NAME
       cpanm - get, unpack build and install modules from CPAN

SYNOPSIS
	 cpanm Test::More					   # install Test::More
	 cpanm MIYAGAWA/Plack-0.99_05.tar.gz			   # full distribution path
	 cpanm http://example.org/LDS/CGI.pm-3.20.tar.gz	   # install from URL
	 cpanm ~/dists/MyCompany-Enterprise-1.00.tar.gz		   # install from a local file
	 cpanm --interactive Task::Kensho			   # Configure interactively
	 cpanm .						   # install from local directory
	 cpanm --installdeps .					   # install all the deps for the current directory
	 cpanm -L extlib Plack					   # install Plack and all non-core deps into extlib
	 cpanm --mirror http://cpan.cpantesters.org/ DBI	   # use the fast-syncing mirror
	 cpanm --scandeps Moose					   # See what modules will be installed for Moose

COMMANDS
       -i, --install
	   Installs the modules. This is a default behavior and this is just a
	   compatibility option to make it work like cpan or cpanp.

       --self-upgrade
	   Upgrades itself. It's just an alias for:

	     cpanm App::cpanminus

       --info
	   Displays the distribution information in
	   "AUTHOR/Dist-Name-ver.tar.gz" format in the standard out.

       --installdeps
	   Installs the dependencies of the target distribution but won't
	   build itself. Handy if you want to try the application from a
	   version controlled repository such as git.

	     cpanm --installdeps .

       --look
	   Download and unpack the distribution and then open the directory
	   with your shell. Handy to poke around the source code or do manual
	   testing.

       -h, --help
	   Displays the help message.

       -V, --version
	   Displays the version number.

OPTIONS
       You can specify the default options in "PERL_CPANM_OPT" environment
       variable.

       -f, --force
	   Force install modules even when testing failed.

       -n, --notest
	   Skip the testing of modules. Use this only when you just want to
	   save time for installing hundreds of distributions to the same perl
	   and architecture you've already tested to make sure it builds fine.

	   Defaults to false, and you can say "--no-notest" to override when
	   it is set in the default options in "PERL_CPANM_OPT".

       -S, --sudo
	   Switch to the root user with "sudo" when installing modules. Use
	   this if you want to install modules to the system perl include
	   path.

	   Defaults to false, and you can say "--no-sudo" to override when it
	   is set in the default options in "PERL_CPANM_OPT".

       -v, --verbose
	   Makes the output verbose. It also enables the interactive
	   configuration. (See --interactive)

       -q, --quiet
	   Makes the output even more quiet than the default. It doesn't print
	   anything to the STDERR.

       -l, --local-lib
	   Sets the local::lib compatible path to install modules to. You
	   don't need to set this if you already configure the shell
	   environment variables using local::lib, but this can be used to
	   override that as well.

       -L, --local-lib-contained
	   Same with "--local-lib" but when examining the dependencies, it
	   assumes no non-core modules are installed on the system. It's handy
	   if you want to bundle application dependencies in one directory so
	   you can distribute to other machines.

	   For instance,

	     cpanm -L extlib Plack

	   would install Plack and all of its non-core dependencies into the
	   directory "extlib", which can be loaded from your application with:

	     use local::lib '/path/to/extlib';

       --mirror
	   Specifies the base URL for the CPAN mirror to use, such as
	   "http://cpan.cpantesters.org/" (you can omit the trailing slash).
	   You can specify multiple mirror URLs by repeating the command line
	   option.

	   Defaults to "http://search.cpan.org/CPAN" which is a geo location
	   aware redirector.

       --mirror-only
	   Download the mirror's 02packages.details.txt.gz index file instead
	   of querying the CPAN Meta DB.

	   Select this option if you are using a local mirror of CPAN, such as
	   minicpan when you're offline, or your own CPAN index (a.k.a
	   darkpan).

	   Tip: It might be useful if you name these mirror options with your
	   shell aliases, like:

	     alias minicpanm='cpanm --mirror ~/minicpan --mirror-only'
	     alias darkpan='cpanm --mirror http://mycompany.example.com/DPAN --mirror-only'

       --prompt
	   Prompts when a test fails so that you can skip, force install,
	   retry or look in the shell to see what's going wrong. It also
	   prompts when one of the dependency failed if you want to proceed
	   the installation.

	   Defaults to false, and you can say "--no-prompt" to override if
	   it's set in the default options in "PERL_CPANM_OPT".

       --reinstall
	   cpanm, when given a module name in the command line (i.e. "cpanm
	   Plack"), checks the locally installed version first and skips if it
	   is already installed. This option makes it skip the check, so:

	     cpanm --reinstall Plack

	   would reinstall Plack even if your locally installed version is
	   latest, or even newer (which would happen if you install a
	   developer release from version control repositories).

	   Defaults to false.

       --interactive
	   Makes the configuration (such as "Makefile.PL" and "Build.PL")
	   interactive, so you can answer questions in the distribution that
	   requires custom configuration or Task:: distributions.

	   Defaults to false, and you can say "--no-interactive" to override
	   when it's set in the default options in "PERL_CPANM_OPT".

       --scandeps
	   Scans the depencencies of given modules and output the tree in a
	   text format. (See "--format" below for more options)

	   Because this command doesn't actually install any distributions, it
	   will be useful that by typing:

	     cpanm --scandeps Catalyst::Runtime

	   you can make sure what modules will be installed.

	   This command takes into account which modules you already have
	   installed in your system. If you want to see what modules will be
	   installed against a vanilla perl installation, you might want to
	   combine it with "-L" option.

       --format
	   Determines what format to display the scanned dependency tree.
	   Available options are "tree", "json", "yaml" and "dists".

	   tree	   Displays the tree in a plain text format. This is the
		   default value.

	   json, yaml
		   Outputs the tree in a JSON or YAML format. JSON and YAML
		   modules need to be installed respectively. The output tree
		   is represented as a recursive tuple of:

		     [ distribution, dependencies ]

		   and the container is an array containing the root elements.
		   Note that there may be multiple root nodes, since you can
		   give multiple modules to the "--scandeps" command.

	   dists   "dists" is a special output format, where it prints the
		   distribution filename in the depth first order after the
		   dependency resolution, like:

		     GAAS/MIME-Base64-3.13.tar.gz
		     GAAS/URI-1.58.tar.gz
		     PETDANCE/HTML-Tagset-3.20.tar.gz
		     GAAS/HTML-Parser-3.68.tar.gz
		     GAAS/libwww-perl-5.837.tar.gz

		   which means you can install these distributions in this
		   order without extra dependencies. When combined with "-L"
		   option, it will be useful to replay installations on other
		   machines.

       --save-dists
	   Specifies the optional directory path to copy downloaded tarballs
	   in the CPAN mirror compatible directory structure i.e.
	   authors/id/A/AU/AUTHORS/Foo-Bar-version.tar.gz

       --uninst-shadows
	   Uninstalls the shadow files of the distribution that you're
	   installing. This eliminates the confusion if you're trying to
	   install core (dual-life) modules from CPAN against perl 5.10 or
	   older, or modules that used to be XS-based but switched to pure
	   perl at some version.

	   If you run cpanm as root and use "INSTALL_BASE" or equivalent to
	   specify custom installation path, you SHOULD disable this option so
	   you won't accidentally uninstall dual-life modules from the core
	   include path.

	   Defaults to true if your perl version is smaller than 5.12, and you
	   can disable that with "--no-uninst-shadows".

	   NOTE: Since version 1.3000 this flag is turned off by default for
	   perl newer than 5.12, since with 5.12 @INC contains site_perl
	   directory before the perl core library path, and uninstalling
	   shadows is not necessary anymore and does more harm by deleting
	   files from the core library path.

       --auto-cleanup
	   Specifies the number of days in whcih cpanm's work directories
	   expire. Defaults to 7, which means old work directories will be
	   cleaned up in one week.

	   You can set the value to 0 to make cpan never cleanup those
	   directories.

       --man-pages
	   Generates man pages for executables (man1) and libraries (man3).

	   Defaults to false (no man pages generated) if
	   "-L|--local-lib-contained" option is supplied. Otherwise, defaults
	   to true, and you can disable it with "--no-man-pages".

       --lwp
	   Uses LWP module to download stuff over HTTP. Defaults to true, and
	   you can say "--no-lwp" to disable using LWP, when you want to
	   upgrade LWP from CPAN on some broken perl systems.

       --wget
	   Uses GNU Wget (if available) to download stuff. Defaults to true,
	   and you can say "--no-wget" to disable using Wget (versions of Wget
	   older than 1.9 don't support the "--retry-connrefused" option used
	   by cpanm).

       --curl
	   Uses cURL (if available) to download stuff. Defaults to true, and
	   you can say "--no-curl" to disable using cURL.

	   Normally with "--lwp", "--wget" and "--curl" options set to true
	   (which is the default) cpanm tries LWP, Wget, cURL and HTTP::Tiny
	   (in that order) and uses the first one available.

SEE ALSO
       App::cpanminus

COPYRIGHT
       Copyright 2010 Tatsuhiko Miyagawa.

AUTHOR
       Tatsuhiko Miyagawa

perl v5.14.1			  2011-06-16			      CPANM(1)
[top]

List of man pages available for Pidora

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net