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 change PERLBREW_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 keyword system 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 your bashrc 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.

SEE ALSO

App::perlbrew, App::cpanminus