NAME
perlbrew - Perl Environment manager.
SYNOPSIS
perlbrew <command> [options] [arguments]
Commonly used commands:
init Initialize perlbrew environment.
install Install perl
list List installed perls
use Use the specified perl in current shell
switch Permanently use the specified perl as default
mirror Pick a preferred mirror site
off Permanently turn off perlbrew
version Display version
help Read more detailed instructions
Examples:
perlbrew install perl-5.12.3
perlbrew install perl-5.13.6
perlbrew list
perlbrew use perl-5.13.6
perlbrew switch perl-5.12.3
perlbrew switch /path/to/special/perl
perlbrew switch /path/to/special/perl special-perl
# later
perlbrew switch special-perl
COMMANDS
- init
-
Run this once to setup the
perlbrew
directory ready for installing perls into. Run it again if you decide to changePERLBREW_ROOT
. - mirror
-
Run this if you want to choose a specific CPAN mirror to install the perls from. It will display a list of mirrors for you to pick from. Hit 'q' to cancel the selection.
- install perl-<version>
-
Build and install the given version of perl.
- install /path/to/perl/git/checkout/dir
-
Build and install from the given git checkout dir.
- list
-
List the installed versions of perl.
- use [perl-<version>]
-
Notice: this only works in bash and zsh.
Switch to the given version of perl only in the current shell. This will not effect newly opened shells.
You can use as
perl-version
the special keywordsystem
to stop using any perlbrew-based perl.Without a parameter, shows the version of perl currently in use.
- switch [perl-<version>]
-
Switch to the given version, and makes it the default for this and all future terminal sessions.
Without a parameter, shows the version of perl currently selected.
- off
-
Disable perlbrew. Use
switch
command to re-enable it. - env [perl-version]
-
Low-level command. Use this command to see the list of environment variables that are set by
perlbrew
itself for shell integration.The output is something similar to this (if your shell is bash):
export PERLBREW_ROOT=/Users/gugod/perl5/perlbrew export PERLBREW_VERSION=0.13 export PERLBREW_PATH=/Users/gugod/perl5/perlbrew/bin:/Users/gugod/perl5/perlbrew/perls/current/bin export PERLBREW_PERL=perl-5.12.3
You can also ask for the proper variables for a specific perl version.
- install-cpanm
-
Install the
cpanm
standalone executable in$PERLBREW_ROOT/bin
. - version
-
Show the version of perbrew.
OPTIONS
- -h| --help
-
prints this help.
- -f| --force
-
Force installation of a perl.
- -j
-
Enable parallel make and test (if supported by the target perl)
perlbrew install -j 5 perl-5.12.3
- -n| --notest
-
Skip the test suite
- -q| --quiet
-
Log output to a log file rather than STDOUT. This is the default. The log file is saved in $ROOT/build.log
- -v| --verbose
-
Log output to STDOUT rather than a logfile.
- --as
-
Install a given perl under an alias.
perlbrew install perl-5.6.2 --as legacy-perl
- -D, -U, -A
-
pass through switches to the perl Configure script.
perlbrew install perl-5.10.1 -D usemymalloc -U uselargefiles
CONFIGURATION
- PERLBREW_ROOT
-
By default, perlbrew builds and installs perls into
$ENV{HOME}/perl5/perlbrew
directory. To use a different directory, set this environment variable in yourbashrc
to the directory before running perlbrew.
UPGRADE NOTES
If you upgraded perlbrew
from version 0.16 or older, you should do this cleanup your setup. Failure to do so might make the use
command to fail.
Note the version of perl currently selected with perlbrew switch
. Then turn perlbrew off
, and switched back again with perlbrew switch previous-perl-version
.