NAME ^ - Parrot's Configuration Script


    % perl [options]


This is Parrot's configuration script. It should be run to create the necessary system-specific files before building Parrot.

Command-line Options ^

General Options


Prints out a description of the options and exits.


Prints out the version number of and exits.


Tells to output extra information about the configuration data it is setting.


Tells to output information about i<every> setting added or changed.


Run --verbose=2 for step number N or matching description.


Tells not to run the MANIFEST check.


Sets the location where parrot will be installed.


This turns on the user prompts.

Compile Options

You can add and remove option values with :rem{<opt>} and :add{<opt>}. For example:

    perl --ccflags=":rem{-g} :add{-O2}"

Debugging is turned on by default. Use this to disable it.


Turn on profiled compile (gcc only for now)


Tell the compiler to do an optimization phase.


Tell Configure that the compiler supports inline.


Specify which compiler to use.


Use the given compiler flags.


Use the given compiler warning flags.


Specify which C++ compiler to use (for ICU).


Use the given libraries.


Specify which linker to use.


Use the given linker flags


Specify which loader to use for shared libraries.


Use the given loader flags for shared libraries


Specify which lexer to use.


Specify which parser to use.


Generate "#define PARROT_DEF_VAL1 1" ... entries in has_header.h. Currently needed to use inet_aton for systems that lack inet_pton:


Parrot Options


Use the given type for INTVAL.


Use the given type for FLOATVAL.


Use the given type for opcodes.


Use the given ops files.


Use the given PMC files.


Don't build cgoto core. This is recommended when you are short of memory.


Use JIT system.


Use JIT to emit a native executable.


Determine the type of garbage collection. The value for type should be one of: gc, libc, malloc or malloc-trace. The default is gc.

ICU Options


Use the specified icu-config script to determine the neccessary ICU options.

Use --icu-config=none to disable the autodetect feature. Parrot will then be build with its own ICU.

Note: If you specifiy another ICU option than --icu-config, the autodetection functionality will be disabled.


Use the given platform name to pass to ICU's runConfigureICU. (See icu/source/runConfigureICU for the list of available "platform" names, which specify both operating system and compiler.)


Pass the given arguments to ICU's configuration script, instead of the default.


Use the given directory to locate ICU's data file(s) at runtime

If you have an installed unicode package, you can use these two options instead:


Linker command to link against ICU library version 2.6.


   --icushared='-L /opt/openoffice/program -licudata -licuuc'
(The libs in openoffice are actually version 2.2 and do not work)


Location of ICU header files without the /unicode suffix. The header files must match your platform, especially platform.h must be present.



You might also need '--nomanicheck'.

Other Options


Use this option if you want imcc's parser and lexer files to be generated. Needs a working parser and lexer.


Build parrot assuming only pure ANSI C is available.


Enable experimental networking. This is an unused option and should probably be removed.


config/init/, lib/Parrot/Configure/, lib/Parrot/Configure/, docs/configuration.pod