1PERLBREW(1) User Contributed Perl Documentation PERLBREW(1)
2
6 perlbrew - Perl Environment manager.
7
9 perlbrew <command> [options] [arguments]
10 Commonly used commands:
12 init Initialize perlbrew environment.
13 install Install perl
14 uninstall Uninstall the given installation
15 list List installed perls
16 use Use the specified perl in current shell
17 available List perls available to install
18 switch Permanently use the specified perl as default
19 mirror Pick a preferred mirror site
20 off Permanently turn off perlbrew, go back to system Perl
21 version Display version
22 help Read more detailed instructions
23 Examples:
25 perlbrew install perl-5.14.0
26 perlbrew install 5.12.3
27 perlbrew list
29 perlbrew use perl-5.12.3
31 perlbrew switch perl-5.14.0
32 perlbrew switch /path/to/special/perl
34 perlbrew switch /path/to/special/perl special-perl
35 # later
37 perlbrew switch special-perl
38
40 init
41 Run this once to setup the "perlbrew" directory ready for
42 installing perls into. Run it again if you decide to change
43 "PERLBREW_ROOT".
44 install perl-<version-number>
46 install <version-number>
47 Build and install the given version of perl.
48 Version numbers usually look like "5.x.xx", or "perl-5.xx.x-RCx"
50 for release candidates.
51 The specified perl is downloaded from the CPAN website, unless
53 mirror setting are present.
54 install perl-blead
56 install blead
57 A special way to install the blead version of perl.
58 The blead version is downloaded from:
60 http://perl5.git.perl.org/perl.git/snapshot/blead.tar.gz
62 This command does not consult mirror settings.
64 install /path/to/perl/git/checkout/dir
66 Build and install from the given git checkout dir.
67 install /path/to/perl-5.14.0.tar.gz
69 Build and install from the given archive file.
70 install http://example.com/mirror/perl-5.12.3.tar.gz
72 Build and install from the given URL. Supported URL schemes are
73 "http://", "https://", "ftp://" and "file://".
74 uninstall <target>
76 Uninstalls the given version.
77 mirror
79 Run this if you want to choose a specific CPAN mirror to install
80 the perls from. It will display a list of mirrors for you to pick
81 from. Hit 'q' to cancel the selection.
82 list
84 List the installed versions of perl.
85 use [perl-<version>]
87 use [<version>]
88 Switch to the given version of perl only in the current shell. This
89 will not effect newly opened shells.
90 You can use as "perl-version" the special keyword "system" to stop
92 using any perlbrew-based perl.
93 Without a parameter, shows the version of perl currently in use.
95 available
97 Displays the available versions of perl on CPAN.
98 switch [perl-<version>]
100 switch [<version>]
101 Switch to the given version, and makes it the default for this and
102 all future terminal sessions.
103 Without a parameter, shows the version of perl currently selected.
105 alias [-f] create <name> <alias>
107 Create an alias for the installation named <name>.
108 alias [-f] rename <old_alias> <new_alias>
110 Rename the alias to a new name.
111 alias delete <alias>
113 Delete the given alias.
114 off Disable perlbrew. Use "switch" command to re-enable it.
116 Re-enables the default system Perl, whatever that is.
118 exec command
120 Execute command for all perls.
121 For example, run a Hello program:
123 perlbrew exec perl -e 'print "Hello from $]\n"'
125 Depending on your actual installations, the output might look like
127 this:
128 perl-5.12.2
130 ==========
131 Hello word from perl-5.012002
132 perl-5.12.3
134 ==========
135 Hello word from perl-5.012003
136 perl-5.13.10
138 ==========
139 Hello word from perl-5.013010
140 perl-5.14.0
142 ==========
143 Hello word from perl-5.014000
144 env [perl-version]
146 Low-level command. Use this command to see the list of environment
147 variables that are set by "perlbrew" itself for shell integration.
148 The output is something similar to this (if your shell is bash):
150 export PERLBREW_ROOT=/Users/gugod/perl5/perlbrew
152 export PERLBREW_VERSION=0.13
153 export PERLBREW_PATH=/Users/gugod/perl5/perlbrew/bin:/Users/gugod/perl5/perlbrew/perls/current/bin
154 export PERLBREW_PERL=perl-5.12.3
155 You can also ask for the proper variables for a specific perl
157 version.
158 symlink_executables <perl-version>
160 Low-level command. Use this command to create the "perl" executable
161 symbolic link to , say, "perl5.13.6". This is only useful for
162 development version of perls.
163 You don't need to do this unless you have been using old perlbrew
165 to install perls. The installation layout is changed since version
166 0.11.
167 If you just upgraded perlbrew and found "perlbrew switch" failed to
169 work after you switch to a development release of perl, say,
170 perl-5.13.6, run this command:
171 perlbrew symlink_executables perl-5.13.6
173 This essentially creates this symlink:
175 ${PERLBREW_ROOT}/perls/perl-5.13.6/bin/perl
177 -> ${PERLBREW_ROOT}/perls/perl-5.13.6/bin/perl5.13.6
178 install-cpanm
180 Install the "cpanm" standalone executable in "$PERLBREW_ROOT/bin".
181 self-upgrade
183 This command upgrades Perlbrew to its latest version.
184 version
186 Show the version of perlbrew.
187
189 -h| --help
190 prints this help.
191 -f| --force
193 Force installation of a perl.
194 -j Enable parallel make and test (if supported by the target perl)
196 perlbrew install -j 5 perl-5.12.3
198 -n| --notest
200 Skip the test suite
201 -q| --quiet
203 Log output to a log file rather than STDOUT. This is the default.
204 The log file is saved in $ROOT/build.log
205 -v| --verbose
207 Log output to STDOUT rather than a log file.
208 --as
210 Install a given perl under an alias.
211 perlbrew install perl-5.6.2 --as legacy-perl
213 -D, -U, -A
215 pass through switches to the perl Configure script.
216 perlbrew install perl-5.10.1 -D usemymalloc -U uselargefiles
218
220 PERLBREW_ROOT
221 By default, perlbrew builds and installs perls into
222 "$ENV{HOME}/perl5/perlbrew" directory. To use a different
223 directory, set this environment variable in your "bashrc" to the
224 directory before running perlbrew.
225
227 If you upgraded "perlbrew" from version 0.16 or older, you should do
228 this cleanup your setup. Failure to do so might make the "use" command
229 to fail.
230 Note the version of perl currently selected with "perlbrew switch".
232 Then turn "perlbrew off", and switched back again with "perlbrew switch
233 previous-perl-version".
234
236 App::perlbrew, App::cpanminus
237perl v5.12.3 2011-08-08 PERLBREW(1)