perlbrew - Perl Environment manager.
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
Run this once to setup the perlbrew directory ready for installing perls into. Run it again if you decide to change PERLBREW_ROOT.
perlbrew
PERLBREW_ROOT
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.
Build and install the given version of perl.
Build and install from the given git checkout dir.
List the installed versions of perl.
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 keyword system to stop using any perlbrew-based perl.
perl-version
system
Without a parameter, shows the version of perl currently in use.
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.
Disable perlbrew. Use switch command to re-enable it.
switch
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 the cpanm standalone executable in $PERLBREW_ROOT/bin.
cpanm
$PERLBREW_ROOT/bin
Show the version of perbrew.
prints this help.
Force installation of a perl.
Skip the test suite
Log output to a log file rather than STDOUT. This is the default. The log file is saved in $ROOT/build.log
Log output to STDOUT rather than a logfile.
Install a given perl under an alias.
perlbrew install perl-5.6.2 --as legacy-perl
pass through switches to the perl Configure script.
perlbrew install perl-5.10.1 -D usemymalloc -U uselargefiles
By default, perlbrew builds and installs perls into $ENV{HOME}/perl5/perlbrew directory. To use a different directory, set this environment variable in your bashrc to the directory before running perlbrew.
$ENV{HOME}/perl5/perlbrew
bashrc
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.
use
Note the version of perl currently selected with perlbrew switch. Then turn perlbrew off, and switched back again with perlbrew switch previous-perl-version.
perlbrew switch
perlbrew off
perlbrew switch previous-perl-version
App::perlbrew, App::cpanminus
To install App::perlbrew, copy and paste the appropriate command in to your terminal.
cpanm App::perlbrew
CPAN shell
perl -MCPAN -e shell install App::perlbrew
For more information on module installation, please visit the detailed CPAN module installation guide.