Mac Developer Library Developer


This manual page is for Mac OS X version 10.9

If you are running a different version of Mac OS X, view the documentation locally:

  • In Terminal, using the man(1) command

Reading manual pages

Manual pages are intended as a quick reference for people who already understand a technology.

  • To learn how the manual is organized or to learn about command syntax, read the manual page for manpages(5).

  • For more information about this technology, look for other documentation in the Apple Developer Library.

  • For general information about writing shell scripts, read Shell Scripting Primer.

PERL(1)                   BSD General Commands Manual                  PERL(1)

     perl, a2p -- Practical Extraction and Report Language

     perl ...
     a2p ...

     To support multiple versions, the program named perl now just selects the real version of Perl to run,
     and the program named a2p now just selects the real version of the awk-to-perl translator to run,
     depending on various settings.  The current supported versions are and , with the default being (older
     alternate versions are provided for backward-compatibility, while newer alternate versions are provided
     before we are ready to make it the default).  Use

           % man perl
           % man perl
           % man a2p
           % man a2p

     to see the man page for a specific version.  When the version is unspecified, as in:

           % man perldoc

     the man page for the (unmodified) default version of Perl () will be shown.


           % defaults write Version

     will make version the user default when running the both the perl and a2p commands (versioner is the
     internal name of the version-selection software used).

     To set a system-wide default, replace `' with
     `/Library/Preferences/' (admin privileges will be required).

     The environment variable VERSIONER_PERL_VERSION can also be used to set the perl and a2p version:

           % export VERSIONER_PERL_VERSION= # Bourne-like shells
           % setenv VERSIONER_PERL_VERSION # C-like shells
           % perl ...

     This environment variable takes precedence over the setting in any preference file.

     Both versions of perl support 64-bit execution (which is the default).  Like the setting the version of
     Perl, the perl command can select between 32 and 64-bit execution.  Use:

           % defaults write Prefer-32-Bit -bool yes

     to make 32-bit execution the user default (using `/Library/Preferences/' will
     set the system-wide default).  The environment variable VERSIONER_PERL_PREFER_32_BIT can also be used
     (has precedence over the preference file):

           % export VERSIONER_PERL_PREFER_32_BIT=yes # Bourne-like shells
           % setenv VERSIONER_PERL_PREFER_32_BIT yes # C-like shells

     Again, the preference setting and environmental variable applies to both perl and a2p.

     Rather than using the perl command, one can use a specific version directly.  For example, running perl
     from the command line will run the version of Perl, independent of what the default version of Perl is.

     One can use a specific version of Perl on the #! line of a script, but that may have portability and
     future compatibility issues.

     Note that the preference files and environment variable that apply to the perl command, do not apply
     when running a specific version of Perl.  In particular, running perl will always default to 64-bit
     execution (unless one uses the arch(1) command to specifically select a 32-bit architecture).

     perl(1), perl(1), a2p(1), a2p(1), arch(1)

BSD                              Apr 17, 2010                              BSD

Reporting Problems

The way to report a problem with this manual page depends on the type of problem:

Content errors
Report errors in the content of this documentation to the Perl project. (See perlbug(1) for submission instructions.)
Bug reports
Report bugs in the functionality of the described tool or API to Apple through Bug Reporter and to the Perl project using perlbug(1).
Formatting problems
Report formatting mistakes in the online version of these pages with the feedback links below.