generates pod documentation for Config.pm from this file--please try to keep
the formatting regular.]
-Mcc (Loc.U):
- This variable is used internally by Configure to determine the
- full pathname (if any) of the Mcc program. After Configure runs,
- the value is reset to a plain "Mcc" and is not useful.
-
-PERL_REVISION (Oldsyms.U):
- In a Perl version number such as 5.6.2, this is the 5.
- This value is manually set in patchlevel.h
-
-PERL_SUBVERSION (Oldsyms.U):
- In a Perl version number such as 5.6.2, this is the 2.
- Values greater than 50 represent potentially unstable
- development subversions.
- This value is manually set in patchlevel.h
-
-PERL_VERSION (Oldsyms.U):
- In a Perl version number such as 5.6.2, this is the 6.
- This value is manually set in patchlevel.h
-
_a (Unix.U):
This variable defines the extension used for ordinary library files.
For unix, it is '.a'. The '.' is included. Other possible
the value is reset to a plain "cpp" and is not useful.
cpp_stuff (cpp_stuff.U):
- This variable contains an identification of the catenation mechanism
+ This variable contains an identification of the concatenation mechanism
used by the C preprocessor.
cppccsymbols (Cppsym.U):
REENTRANT_PROTO_T_ABC macros of reentr.h if d_ctime_r
is defined.
-d_Gconvert (d_gconvert.U):
- This variable holds what Gconvert is defined as to convert
- floating point numbers into strings. By default, Configure
- sets this macro to use the first of gconvert, gcvt, or sprintf
- that pass sprintf-%g-like behaviour tests. If perl is using
- long doubles, the macro uses the first of the following
- functions that pass Configure's tests: qgcvt, sprintf (if
- Configure knows how to make sprintf format long doubles--see
- sPRIgldbl), gconvert, gcvt, and sprintf (casting to double).
- The gconvert_preference and gconvert_ld_preference variables
- can be used to alter Configure's preferences, for doubles and
- long doubles, respectively. If present, they contain a
- space-separated list of one or more of the above function
- names in the order they should be tried.
-
- d_Gconvert may be set to override Configure with a platform-
- specific function. If this function expects a double, a
- different value may need to be set by the uselongdouble.cbu
- call-back unit so that long doubles can be formatted without
- loss of precision.
-
-d_PRIEUldbl (longdblfio.U):
- This variable conditionally defines the PERL_PRIfldbl symbol, which
- indiciates that stdio has a symbol to print long doubles.
- The 'U' in the name is to separate this from d_PRIeldbl so that even
- case-blind systems can see the difference.
-
-d_PRIFUldbl (longdblfio.U):
- This variable conditionally defines the PERL_PRIfldbl symbol, which
- indiciates that stdio has a symbol to print long doubles.
- The 'U' in the name is to separate this from d_PRIfldbl so that even
- case-blind systems can see the difference.
-
-d_PRIGUldbl (longdblfio.U):
- This variable conditionally defines the PERL_PRIfldbl symbol, which
- indiciates that stdio has a symbol to print long doubles.
- The 'U' in the name is to separate this from d_PRIgldbl so that even
- case-blind systems can see the difference.
-
-d_PRIXU64 (quadfio.U):
- This variable conditionally defines the PERL_PRIXU64 symbol, which
- indiciates that stdio has a symbol to print 64-bit hExADECimAl numbers.
- The 'U' in the name is to separate this from d_PRIx64 so that even
- case-blind systems can see the difference.
-
-d_PRId64 (quadfio.U):
- This variable conditionally defines the PERL_PRId64 symbol, which
- indiciates that stdio has a symbol to print 64-bit decimal numbers.
-
-d_PRIeldbl (longdblfio.U):
- This variable conditionally defines the PERL_PRIfldbl symbol, which
- indiciates that stdio has a symbol to print long doubles.
-
-d_PRIfldbl (longdblfio.U):
- This variable conditionally defines the PERL_PRIfldbl symbol, which
- indiciates that stdio has a symbol to print long doubles.
-
-d_PRIgldbl (longdblfio.U):
- This variable conditionally defines the PERL_PRIfldbl symbol, which
- indiciates that stdio has a symbol to print long doubles.
-
-d_PRIi64 (quadfio.U):
- This variable conditionally defines the PERL_PRIi64 symbol, which
- indiciates that stdio has a symbol to print 64-bit decimal numbers.
-
-d_PRIo64 (quadfio.U):
- This variable conditionally defines the PERL_PRIo64 symbol, which
- indiciates that stdio has a symbol to print 64-bit octal numbers.
-
-d_PRIu64 (quadfio.U):
- This variable conditionally defines the PERL_PRIu64 symbol, which
- indiciates that stdio has a symbol to print 64-bit unsigned decimal
- numbers.
-
-d_PRIx64 (quadfio.U):
- This variable conditionally defines the PERL_PRIx64 symbol, which
- indiciates that stdio has a symbol to print 64-bit hexadecimal numbers.
-
-d_SCNfldbl (longdblfio.U):
- This variable conditionally defines the PERL_PRIfldbl symbol, which
- indiciates that stdio has a symbol to scan long doubles.
-
d__fwalk (d__fwalk.U):
This variable conditionally defines HAS__FWALK if _fwalk() is
available to apply a function to all the file handles.
This variable conditionally defines the HAS_ACCESSX symbol, which
indicates to the C program that the accessx() routine is available.
+d_aintl (d_aintl.U):
+ This variable conditionally defines the HAS_AINTL symbol, which
+ indicates to the C program that the aintl() routine is available.
+ If copysignl is also present we can emulate modfl.
+
d_alarm (d_alarm.U):
This variable conditionally defines the HAS_ALARM symbol, which
indicates to the C program that the alarm() routine is available.
This variable conditionally defines the HAS_ATOLL symbol, which
indicates to the C program that the atoll() routine is available.
-d_attribut (d_attribut.U):
- This variable conditionally defines HASATTRIBUTE, which
- indicates the C compiler can check for function attributes,
- such as printf formats.
+d_attribute_format (d_attribut_format.U):
+ This variable conditionally defines HASATTRIBUTE_FORMAT, which
+ indicates the C compiler can check for printf-like formats.
+
+d_attribute_malloc (d_attribute_malloc.U):
+ This variable conditionally defines HASATTRIBUTE_MALLOC, which
+ indicates the C compiler can understand functions as having
+ malloc-like semantics.
+
+d_attribute_nonnull (d_attribute_nonnull.U):
+ This variable conditionally defines HASATTRIBUTE_NONNULL, which
+ indicates that the C compiler can know that certain arguments
+ must not be NULL, and will check accordingly at compile time.
+
+d_attribute_noreturn (d_attribute_noreturn.U):
+ This variable conditionally defines HASATTRIBUTE_NORETURN, which
+ indicates that the C compiler can know that certain functions
+ are guaranteed never to return.
+
+d_attribute_pure (d_attribute_pure.U):
+ This variable conditionally defines HASATTRIBUTE_PURE, which
+ indicates that the C compiler can know that certain functions
+ are "pure" functions, meaning that they have no side effects, and
+ only rely on function input and/or global data for their results.
+
+d_attribute_unused (d_attribute_unused.U):
+ This variable conditionally defines HASATTRIBUTE_UNUSED, which
+ indicates that the C compiler can know that certain variables
+ and arguments may not always be used, and to not throw warnings
+ if they don't get used.
+
+d_attribute_warn_unused_result (d_attribute_warn_unused_result.U):
+ This variable conditionally defines
+ HASATTRIBUTE_WARN_UNUSED_RESULT, which indicates that the C
+ compiler can know that certain functions have a return values
+ that must not be ignored, such as malloc() or open().
d_bcmp (d_bcmp.U):
This variable conditionally defines the HAS_BCMP symbol if
This variable conditionally defines the HAS_CLASS symbol, which
indicates to the C program that the class() routine is available.
+d_clearenv (d_clearenv.U):
+ This variable conditionally defines the HAS_CLEARENV symbol, which
+ indicates to the C program that the clearenv () routine is available.
+
d_closedir (d_closedir.U):
This variable conditionally defines HAS_CLOSEDIR if closedir() is
available.
indicates to the C program that this C compiler knows about the
const type.
+d_copysignl (d_copysignl.U):
+ This variable conditionally defines the HAS_COPYSIGNL symbol, which
+ indicates to the C program that the copysignl() routine is available.
+ If aintl is also present we can emulate modfl.
+
d_crypt (d_crypt.U):
This variable conditionally defines the CRYPT symbol, which
indicates to the C program that the crypt() routine is available
This variable conditionally defines the symbols EUNICE and VAX, which
alerts the C program that it must deal with ideosyncracies of VMS.
+d_faststdio (d_faststdio.U):
+ This variable conditionally defines the HAS_FAST_STDIO symbol,
+ which indicates to the C program that the "fast stdio" is available
+ to manipulate the stdio buffers directly.
+
d_fchdir (d_fchdir.U):
This variable conditionally defines the HAS_FCHDIR symbol, which
indicates to the C program that the fchdir() routine is available.
that the ftime() routine exists. The ftime() routine is basically
a sub-second accuracy clock.
+d_futimes (f_futimes.U):
+ This variable conditionally defines the HAS_FUTIMES symbol, which
+ indicates to the C program that the futimes() routine is available.
+
+d_Gconvert (d_gconvert.U):
+ This variable holds what Gconvert is defined as to convert
+ floating point numbers into strings. By default, Configure
+ sets this macro to use the first of gconvert, gcvt, or sprintf
+ that pass sprintf-%g-like behaviour tests. If perl is using
+ long doubles, the macro uses the first of the following
+ functions that pass Configure's tests: qgcvt, sprintf (if
+ Configure knows how to make sprintf format long doubles--see
+ sPRIgldbl), gconvert, gcvt, and sprintf (casting to double).
+ The gconvert_preference and gconvert_ld_preference variables
+ can be used to alter Configure's preferences, for doubles and
+ long doubles, respectively. If present, they contain a
+ space-separated list of one or more of the above function
+ names in the order they should be tried.
+
+ d_Gconvert may be set to override Configure with a platform-
+ specific function. If this function expects a double, a
+ different value may need to be set by the uselongdouble.cbu
+ call-back unit so that long doubles can be formatted without
+ loss of precision.
+
d_getcwd (d_getcwd.U):
This variable conditionally defines the HAS_GETCWD symbol, which
indicates to the C program that the getcwd() routine is available
This variable conditionally defines HAS_HTONL if htonl() and its
friends are available to do network order byte swapping.
+d_ilogbl (d_ilogbl.U):
+ This variable conditionally defines the HAS_ILOGBL symbol, which
+ indicates to the C program that the ilogbl() routine is available.
+ If scalbnl is also present we can emulate frexpl.
+
d_index (d_strchr.U):
This variable conditionally defines HAS_INDEX if index() and
rindex() are available for string searching.
This variable conditionally defines HAS_MADVISE if madvise() is
available to map a file into memory.
+d_malloc_size (d_malloc_size.U):
+ This symbol, if defined, indicates that the malloc_size
+ routine is available for use.
+
+d_malloc_good_size (d_malloc_good_size.U):
+ This symbol, if defined, indicates that the malloc_good_size
+ routine is available for use.
+
d_mblen (d_mblen.U):
This variable conditionally defines the HAS_MBLEN symbol, which
indicates to the C program that the mblen() routine is available
This variable indicates whether a variable of type nvtype
can preserve all the bits a variable of type uvtype.
+d_nv_zero_is_allbits_zero (perlxv.U):
+ This variable indicates whether a variable of type nvtype
+ stores 0.0 in memory as all bits zero.
+
d_off64_t (d_off64_t.U):
This symbol will be defined if the C compiler supports off64_t.
indicates to the C program that it should not assume that it is
running on the machine it was compiled on.
+d_PRId64 (quadfio.U):
+ This variable conditionally defines the PERL_PRId64 symbol, which
+ indiciates that stdio has a symbol to print 64-bit decimal numbers.
+
+d_PRIeldbl (longdblfio.U):
+ This variable conditionally defines the PERL_PRIfldbl symbol, which
+ indiciates that stdio has a symbol to print long doubles.
+
+d_PRIEUldbl (longdblfio.U):
+ This variable conditionally defines the PERL_PRIfldbl symbol, which
+ indiciates that stdio has a symbol to print long doubles.
+ The 'U' in the name is to separate this from d_PRIeldbl so that even
+ case-blind systems can see the difference.
+
+d_PRIfldbl (longdblfio.U):
+ This variable conditionally defines the PERL_PRIfldbl symbol, which
+ indiciates that stdio has a symbol to print long doubles.
+
+d_PRIFUldbl (longdblfio.U):
+ This variable conditionally defines the PERL_PRIfldbl symbol, which
+ indiciates that stdio has a symbol to print long doubles.
+ The 'U' in the name is to separate this from d_PRIfldbl so that even
+ case-blind systems can see the difference.
+
+d_PRIgldbl (longdblfio.U):
+ This variable conditionally defines the PERL_PRIfldbl symbol, which
+ indiciates that stdio has a symbol to print long doubles.
+
+d_PRIGUldbl (longdblfio.U):
+ This variable conditionally defines the PERL_PRIfldbl symbol, which
+ indiciates that stdio has a symbol to print long doubles.
+ The 'U' in the name is to separate this from d_PRIgldbl so that even
+ case-blind systems can see the difference.
+
+d_PRIi64 (quadfio.U):
+ This variable conditionally defines the PERL_PRIi64 symbol, which
+ indiciates that stdio has a symbol to print 64-bit decimal numbers.
+
+d_PRIo64 (quadfio.U):
+ This variable conditionally defines the PERL_PRIo64 symbol, which
+ indiciates that stdio has a symbol to print 64-bit octal numbers.
+
+d_PRIu64 (quadfio.U):
+ This variable conditionally defines the PERL_PRIu64 symbol, which
+ indiciates that stdio has a symbol to print 64-bit unsigned decimal
+ numbers.
+
+d_PRIx64 (quadfio.U):
+ This variable conditionally defines the PERL_PRIx64 symbol, which
+ indiciates that stdio has a symbol to print 64-bit hexadecimal numbers.
+
+d_PRIXU64 (quadfio.U):
+ This variable conditionally defines the PERL_PRIXU64 symbol, which
+ indiciates that stdio has a symbol to print 64-bit hExADECimAl numbers.
+ The 'U' in the name is to separate this from d_PRIx64 so that even
+ case-blind systems can see the difference.
+
d_procselfexe (d_procselfexe.U):
Defined if $procselfexe is symlink to the absolute
pathname of the executing program.
which indicates to the C program that the pthread_atfork()
routine is available.
+d_pthread_attr_setscope (d_pthread_attr_ss.U):
+ This variable conditionally defines HAS_PTHREAD_ATTR_SETSCOPE if
+ pthread_attr_setscope() is available to set the contention scope
+ attribute of a thread attribute object.
+
d_pthread_yield (d_pthread_y.U):
This variable conditionally defines the HAS_PTHREAD_YIELD
symbol if the pthread_yield routine is available to yield
a prototype for the sbrk() function. Otherwise, it is
up to the program to supply one.
+d_scalbnl (d_scalbnl.U):
+ This variable conditionally defines the HAS_SCALBNL symbol, which
+ indicates to the C program that the scalbnl() routine is available.
+ If ilogbl is also present we can emulate frexpl.
+
d_sched_yield (d_pthread_y.U):
This variable conditionally defines the HAS_SCHED_YIELD
symbol if the sched_yield routine is available to yield
which indicates that the SCM_RIGHTS is available. #ifdef is
not enough because it may be an enum, glibc has been known to do this.
+d_SCNfldbl (longdblfio.U):
+ This variable conditionally defines the PERL_PRIfldbl symbol, which
+ indiciates that stdio has a symbol to scan long doubles.
+
d_seekdir (d_readdir.U):
This variable conditionally defines HAS_SEEKDIR if seekdir() is
available.
This variable conditionally defines the HAS_SOCKS5_INIT symbol, which
indicates to the C program that the socks5_init() routine is available.
+d_sprintf_returns_strlen (d_sprintf_returns_strlen.U):
+ This variable defines whether sprintf returns the length of the string
+ (as per the ANSI spec). Some C libraries retain compatibility with
+ pre-ANSI C and return a pointer to the passed in buffer; for these
+ this variable will be undef.
+
d_sqrtl (d_sqrtl.U):
This variable conditionally defines the HAS_SQRTL symbol, which
indicates to the C program that the sqrtl() routine is available.
This variable conditionally defines the HAS_STRFTIME symbol, which
indicates to the C program that the strftime() routine is available.
+d_strlcat (d_strlcat.U):
+ This variable conditionally defines the HAS_STRLCAT symbol, which
+ indicates to the C program that the strlcat () routine is available.
+
+d_strlcpy (d_strlcpy.U):
+ This variable conditionally defines the HAS_STRLCPY symbol, which
+ indicates to the C program that the strlcpy () routine is available.
+
d_strtod (d_strtod.U):
This variable conditionally defines the HAS_STRTOD symbol, which
indicates to the C program that the strtod() routine is available
This variable conditionally defines the HAS_UNORDERED symbol, which
indicates to the C program that the unordered() routine is available.
+d_unsetenv (d_unsetenv.U):
+ This variable conditionally defines the HAS_UNSETENV symbol, which
+ indicates to the C program that the unsetenv () routine is available.
+
d_usleep (d_usleep.U):
This variable conditionally defines HAS_USLEEP if usleep() is
available to do high granularity sleeps.
d_vendorlib (vendorlib.U):
This variable conditionally defines PERL_VENDORLIB.
+d_vendorscript (vendorscript.U):
+ This variable conditionally defines PERL_VENDORSCRIPT.
+
d_vfork (d_vfork.U):
This variable conditionally defines the HAS_VFORK symbol, which
indicates the vfork() routine is available.
extras (Extras.U):
This variable holds a list of extra modules to install.
-fflushNULL (fflushall.U):
- This symbol, if defined, tells that fflush(NULL) does flush
- all pending stdio output.
-
fflushall (fflushall.U):
This symbol, if defined, tells that to flush
all pending stdio output one must loop through all
Note that if fflushNULL is defined, fflushall will not
even be probed for and will be left undefined.
+fflushNULL (fflushall.U):
+ This symbol, if defined, tells that fflush(NULL) does flush
+ all pending stdio output.
+
find (Loc.U):
This variable is defined but not used by Configure.
The value is a plain '' and is not useful.
can share this executable will have the same full pathname to
'sed.'
+gccansipedantic (gccvers.U):
+ If GNU cc (gcc) is used, this variable will enable (if set) the
+ -ansi and -pedantic ccflags for building core files (through
+ cflags script). (See Porting/pumpkin.pod for full description).
+
gccosandvers (gccvers.U):
- If GNU cc (gcc) is used, this variable the operating system and
- version used to compile the gcc. It is set to '' if not gcc,
+ If GNU cc (gcc) is used, this variable holds the operating system
+ and version used to compile gcc. It is set to '' if not gcc,
or if nothing useful can be parsed as the os version.
gccversion (gccvers.U):
- If GNU cc (gcc) is used, this variable holds '1' or '2' to
+ If GNU cc (gcc) is used, this variable holds '1' or '2' to
indicate whether the compiler is version 1 or 2. This is used in
setting some of the default cflags. It is set to '' if not gcc.
On some systems, such as os390, there may be no equivalent
command, in which case this variable is unset.
+html1dir (html1dir.U):
+ This variable contains the name of the directory in which html
+ source pages are to be put. This directory is for pages
+ that describe whole programs, not libraries or modules. It
+ is intended to correspond roughly to section 1 of the Unix
+ manuals.
+
+html1direxp (html1dir.U):
+ This variable is the same as the html1dir variable, but is filename
+ expanded at configuration time, for convenient use in makefiles.
+
+html3dir (html3dir.U):
+ This variable contains the name of the directory in which html
+ source pages are to be put. This directory is for pages
+ that describe libraries or modules. It is intended to
+ correspond roughly to section 3 of the Unix manuals.
+
+html3direxp (html3dir.U):
+ This variable is the same as the html3dir variable, but is filename
+ expanded at configuration time, for convenient use in makefiles.
+
i16size (perlxv.U):
This variable is the size of an I16 in bytes.
the user is explicitely prompted for it. This variable should always
be used in your makefiles for maximum portability.
+installhtml1dir (html1dir.U):
+ This variable is really the same as html1direxp, unless you are
+ using a different installprefix. For extra portability, you
+ should only use this variable within your makefiles.
+
+installhtml3dir (html3dir.U):
+ This variable is really the same as html3direxp, unless you are
+ using a different installprefix. For extra portability, you
+ should only use this variable within your makefiles.
+
installman1dir (man1dir.U):
This variable is really the same as man1direxp, unless you are using
AFS in which case it points to the read/write location whereas
a system running AFS, in which case they may differ slightly. You
should always use this variable within your makefiles for portability.
+installsitehtml1dir (sitehtml1dir.U):
+ This variable is really the same as sitehtml1direxp, unless you are using
+ AFS in which case it points to the read/write location whereas
+ html1direxp only points to the read-only access location. For extra
+ portability, you should only use this variable within your makefiles.
+
+installsitehtml3dir (sitehtml3dir.U):
+ This variable is really the same as sitehtml3direxp, unless you are using
+ AFS in which case it points to the read/write location whereas
+ html3direxp only points to the read-only access location. For extra
+ portability, you should only use this variable within your makefiles.
+
installsitelib (sitelib.U):
This variable is really the same as sitelibexp but may differ on
those systems using AFS. For extra portability, only this variable
should be used in makefiles.
+installsiteman1dir (siteman1dir.U):
+ This variable is really the same as siteman1direxp, unless you are using
+ AFS in which case it points to the read/write location whereas
+ man1direxp only points to the read-only access location. For extra
+ portability, you should only use this variable within your makefiles.
+
+installsiteman3dir (siteman3dir.U):
+ This variable is really the same as siteman3direxp, unless you are using
+ AFS in which case it points to the read/write location whereas
+ man3direxp only points to the read-only access location. For extra
+ portability, you should only use this variable within your makefiles.
+
+installsitescript (sitescript.U):
+ This variable is usually the same as sitescriptexp, unless you are on
+ a system running AFS, in which case they may differ slightly. You
+ should always use this variable within your makefiles for portability.
+
installstyle (installstyle.U):
This variable describes the "style" of the perl installation.
This is intended to be useful for tools that need to
is useful if $prefix is shared by many packages, e.g. if
$prefix=/usr/local.
+ Unfortunately, while this "style" variable is used to set
+ defaults for all three directory hierarchies (core, vendor, and
+ site), there is no guarantee that the same style is actually
+ appropriate for all those directories. For example, $prefix
+ might be /opt/perl, but $siteprefix might be /usr/local.
+ (Perhaps, in retrospect, the "lib" style should never have been
+ supported, but it did seem like a nice idea at the time.)
+
+ The situation is even less clear for tools such as MakeMaker
+ that can be used to install additional modules into
+ non-standard places. For example, if a user intends to install
+ a module into a private directory (perhaps by setting PREFIX on
+ the Makefile.PL command line), then there is no reason to
+ assume that the Configure-time $installstyle setting will be
+ relevant for that PREFIX.
+
This may later be extended to include other information, so
be careful with pattern-matching on the results.
those systems using AFS. For extra portability, only this variable
should be used in makefiles.
+installvendorhtml1dir (vendorhtml1dir.U):
+ This variable is really the same as vendorhtml1direxp but may differ on
+ those systems using AFS. For extra portability, only this variable
+ should be used in makefiles.
+
+installvendorhtml3dir (vendorhtml3dir.U):
+ This variable is really the same as vendorhtml3direxp but may differ on
+ those systems using AFS. For extra portability, only this variable
+ should be used in makefiles.
+
installvendorlib (vendorlib.U):
This variable is really the same as vendorlibexp but may differ on
those systems using AFS. For extra portability, only this variable
should be used in makefiles.
+installvendorman1dir (vendorman1dir.U):
+ This variable is really the same as vendorman1direxp but may differ on
+ those systems using AFS. For extra portability, only this variable
+ should be used in makefiles.
+
+installvendorman3dir (vendorman3dir.U):
+ This variable is really the same as vendorman3direxp but may differ on
+ those systems using AFS. For extra portability, only this variable
+ should be used in makefiles.
+
+installvendorscript (vendorscript.U):
+ This variable is really the same as vendorscriptexp but may differ on
+ those systems using AFS. For extra portability, only this variable
+ should be used in makefiles.
+
intsize (intsize.U):
This variable contains the value of the INTSIZE symbol, which
indicates to the C program how many bytes there are in an int.
have: one of 'n', 'l', or '3'. The Makefile must supply the '.'.
See man3dir.
+Mcc (Loc.U):
+ This variable is used internally by Configure to determine the
+ full pathname (if any) of the Mcc program. After Configure runs,
+ the value is reset to a plain "Mcc" and is not useful.
+
mips_type (usrinc.U):
This variable holds the environment type for the mips system.
Possible values are "BSD 4.3" and "System V".
+mistrustnm (Csym.U):
+ This variable can be used to establish a fallthrough for the cases
+ where nm fails to find a symbol. If usenm is false or usenm is true
+ and mistrustnm is false, this variable has no effect. If usenm is true
+ and mistrustnm is "compile", a test program will be compiled to try to
+ find any symbol that can't be located via nm lookup. If mistrustnm is
+ "run", the test program will be run as well as being compiled.
+
mkdir (Loc.U):
This variable is used internally by Configure to determine the
full pathname (if any) of the mkdir program. After Configure runs,
full pathname (if any) of the nroff program. After Configure runs,
the value is reset to a plain "nroff" and is not useful.
-nvEUformat (perlxvf.U):
- This variable contains the format string used for printing
- a Perl NV using %E-ish floating point format.
-
-nvFUformat (perlxvf.U):
- This variable confains the format string used for printing
- a Perl NV using %F-ish floating point format.
-
-nvGUformat (perlxvf.U):
- This variable contains the format string used for printing
- a Perl NV using %G-ish floating point format.
-
nv_preserves_uv_bits (perlxv.U):
This variable indicates how many of bits type uvtype
a variable nvtype can preserve.
This variable contains the format string used for printing
a Perl NV using %e-ish floating point format.
+nvEUformat (perlxvf.U):
+ This variable contains the format string used for printing
+ a Perl NV using %E-ish floating point format.
+
nvfformat (perlxvf.U):
This variable confains the format string used for printing
a Perl NV using %f-ish floating point format.
+nvFUformat (perlxvf.U):
+ This variable confains the format string used for printing
+ a Perl NV using %F-ish floating point format.
+
nvgformat (perlxvf.U):
This variable contains the format string used for printing
a Perl NV using %g-ish floating point format.
+nvGUformat (perlxvf.U):
+ This variable contains the format string used for printing
+ a Perl NV using %G-ish floating point format.
+
nvsize (perlxv.U):
This variable is the size of an NV in bytes.
the maintenance versus development dichotomy except
by also being increasing.
+PERL_REVISION (Oldsyms.U):
+ In a Perl version number such as 5.6.2, this is the 5.
+ This value is manually set in patchlevel.h
+
+PERL_SUBVERSION (Oldsyms.U):
+ In a Perl version number such as 5.6.2, this is the 2.
+ Values greater than 50 represent potentially unstable
+ development subversions.
+ This value is manually set in patchlevel.h
+
+PERL_VERSION (Oldsyms.U):
+ In a Perl version number such as 5.6.2, this is the 6.
+ This value is manually set in patchlevel.h
+
perladmin (perladmin.U):
Electronic mail address of the perl5 administrator.
Its value is prepend to libpth. This variable takes care of special
machines, like the mips. Usually, it should be empty.
-pm_apiversion (xs_apiversion.U):
- This variable contains the version of the oldest perl
- compatible with the present perl. (That is, pure perl modules
- written for $pm_apiversion will still work for the current
- version). perl.c:incpush() and lib/lib.pm will automatically
- search in $sitelib for older directories across major versions
- back to pm_apiversion. This is only useful if you have a perl
- library directory tree structured like the default one. The
- versioned site_perl library was introduced in 5.005, so that's
- the default setting for this variable. It's hard to imagine
- it changing before Perl6. It is included here for symmetry
- with xs_apiveprsion -- the searching algorithms will
- (presumably) be similar.
- See the INSTALL file for how this works.
-
pmake (Loc.U):
This variable is defined but not used by Configure.
The value is a plain '' and is not useful.
nm extraction should be performed or not, according to the value
of usenm and the flags on the Configure command line.
-sPRIEUldbl (longdblfio.U):
- This variable, if defined, contains the string used by stdio to
- format long doubles (format 'E') for output.
- The 'U' in the name is to separate this from sPRIeldbl so that even
- case-blind systems can see the difference.
-
-sPRIFUldbl (longdblfio.U):
- This variable, if defined, contains the string used by stdio to
- format long doubles (format 'F') for output.
- The 'U' in the name is to separate this from sPRIfldbl so that even
- case-blind systems can see the difference.
-
-sPRIGUldbl (longdblfio.U):
- This variable, if defined, contains the string used by stdio to
- format long doubles (format 'G') for output.
- The 'U' in the name is to separate this from sPRIgldbl so that even
- case-blind systems can see the difference.
-
-sPRIXU64 (quadfio.U):
- This variable, if defined, contains the string used by stdio to
- format 64-bit hExADECimAl numbers (format 'X') for output.
- The 'U' in the name is to separate this from sPRIx64 so that even
- case-blind systems can see the difference.
-
-sPRId64 (quadfio.U):
- This variable, if defined, contains the string used by stdio to
- format 64-bit decimal numbers (format 'd') for output.
-
-sPRIeldbl (longdblfio.U):
- This variable, if defined, contains the string used by stdio to
- format long doubles (format 'e') for output.
-
-sPRIfldbl (longdblfio.U):
- This variable, if defined, contains the string used by stdio to
- format long doubles (format 'f') for output.
-
-sPRIgldbl (longdblfio.U):
- This variable, if defined, contains the string used by stdio to
- format long doubles (format 'g') for output.
-
-sPRIi64 (quadfio.U):
- This variable, if defined, contains the string used by stdio to
- format 64-bit decimal numbers (format 'i') for output.
-
-sPRIo64 (quadfio.U):
- This variable, if defined, contains the string used by stdio to
- format 64-bit octal numbers (format 'o') for output.
-
-sPRIu64 (quadfio.U):
- This variable, if defined, contains the string used by stdio to
- format 64-bit unsigned decimal numbers (format 'u') for output.
-
-sPRIx64 (quadfio.U):
- This variable, if defined, contains the string used by stdio to
- format 64-bit hexadecimal numbers (format 'x') for output.
-
-sSCNfldbl (longdblfio.U):
- This variable, if defined, contains the string used by stdio to
- format long doubles (format 'f') for input.
-
sched_yield (d_pthread_y.U):
This variable defines the way to yield the execution
of the current thread.
sig_name (sig_name.U):
This variable holds the signal names, space separated. The leading
- SIG in signal name is removed. A ZERO is prepended to the
- list. This is currently not used.
+ SIG in signal name is removed. A ZERO is prepended to the list.
+ This is currently not used, sig_name_init is used instead.
sig_name_init (sig_name.U):
This variable holds the signal names, enclosed in double quotes and
sig_num (sig_name.U):
This variable holds the signal numbers, space separated. A ZERO is
- prepended to the list (corresponding to the fake SIGZERO), and
- the list is terminated with a 0. Those numbers correspond to
- the value of the signal listed in the same place within the
- sig_name list.
+ prepended to the list (corresponding to the fake SIGZERO).
+ Those numbers correspond to the value of the signal listed
+ in the same place within the sig_name list.
+ This is currently not used, sig_num_init is used instead.
sig_num_init (sig_name.U):
This variable holds the signal numbers, enclosed in double quotes and
sig_size (sig_name.U):
This variable contains the number of elements of the sig_name
- and sig_num arrays, excluding the final NULL entry.
+ and sig_num arrays.
signal_t (d_voidsig.U):
This variable holds the type of the signal handler (void or int).
This is the same as the sitebin variable, but is filename expanded at
configuration time, for use in your makefiles.
+sitehtml1dir (sitehtml1dir.U):
+ This variable contains the name of the directory in which site-specific
+ html source pages are to be put. It is the responsibility of the
+ Makefile.SH to get the value of this into the proper command.
+ You must be prepared to do the ~name expansion yourself.
+ The standard distribution will put nothing in this directory.
+ After perl has been installed, users may install their own local
+ html pages in this directory with
+ MakeMaker Makefile.PL
+ or equivalent. See INSTALL for details.
+
+sitehtml1direxp (sitehtml1dir.U):
+ This variable is the same as the sitehtml1dir variable, but is filename
+ expanded at configuration time, for convenient use in makefiles.
+
+sitehtml3dir (sitehtml3dir.U):
+ This variable contains the name of the directory in which site-specific
+ library html source pages are to be put. It is the responsibility of the
+ Makefile.SH to get the value of this into the proper command.
+ You must be prepared to do the ~name expansion yourself.
+ The standard distribution will put nothing in this directory.
+ After perl has been installed, users may install their own local
+ library html pages in this directory with
+ MakeMaker Makefile.PL
+ or equivalent. See INSTALL for details.
+
+sitehtml3direxp (sitehtml3dir.U):
+ This variable is the same as the sitehtml3dir variable, but is filename
+ expanded at configuration time, for convenient use in makefiles.
+
sitelib (sitelib.U):
This variable contains the eventual value of the SITELIB symbol,
which is the name of the private library for this package. It may
This variable is the ~name expanded version of sitelib, so that you
may use it directly in Makefiles or shell scripts.
+siteman1dir (siteman1dir.U):
+ This variable contains the name of the directory in which site-specific
+ manual source pages are to be put. It is the responsibility of the
+ Makefile.SH to get the value of this into the proper command.
+ You must be prepared to do the ~name expansion yourself.
+ The standard distribution will put nothing in this directory.
+ After perl has been installed, users may install their own local
+ man1 pages in this directory with
+ MakeMaker Makefile.PL
+ or equivalent. See INSTALL for details.
+
+siteman1direxp (siteman1dir.U):
+ This variable is the same as the siteman1dir variable, but is filename
+ expanded at configuration time, for convenient use in makefiles.
+
+siteman3dir (siteman3dir.U):
+ This variable contains the name of the directory in which site-specific
+ library man source pages are to be put. It is the responsibility of the
+ Makefile.SH to get the value of this into the proper command.
+ You must be prepared to do the ~name expansion yourself.
+ The standard distribution will put nothing in this directory.
+ After perl has been installed, users may install their own local
+ man3 pages in this directory with
+ MakeMaker Makefile.PL
+ or equivalent. See INSTALL for details.
+
+siteman3direxp (siteman3dir.U):
+ This variable is the same as the siteman3dir variable, but is filename
+ expanded at configuration time, for convenient use in makefiles.
+
siteprefix (siteprefix.U):
This variable holds the full absolute path of the directory below
which the user will install add-on packages.
This variable holds the full absolute path of the directory below
which the user will install add-on packages. Derived from siteprefix.
+sitescript (sitescript.U):
+ This variable holds the name of the directory in which the user wants
+ to put add-on publicly executable files for the package in question. It
+ is most often a local directory such as /usr/local/bin. Programs using
+ this variable must be prepared to deal with ~name substitution.
+ The standard distribution will put nothing in this directory.
+ After perl has been installed, users may install their own local
+ scripts in this directory with
+ MakeMaker Makefile.PL
+ or equivalent. See INSTALL for details.
+
+sitescriptexp (sitescript.U):
+ This is the same as the sitescript variable, but is filename expanded at
+ configuration time, for use in your makefiles.
+
sizesize (sizesize.U):
This variable contains the size of a sizetype in bytes.
This variable contains the command necessary to spit out a runnable
shell on this system. It is either cat or a grep '-v' for # comments.
+sPRId64 (quadfio.U):
+ This variable, if defined, contains the string used by stdio to
+ format 64-bit decimal numbers (format 'd') for output.
+
+sPRIeldbl (longdblfio.U):
+ This variable, if defined, contains the string used by stdio to
+ format long doubles (format 'e') for output.
+
+sPRIEUldbl (longdblfio.U):
+ This variable, if defined, contains the string used by stdio to
+ format long doubles (format 'E') for output.
+ The 'U' in the name is to separate this from sPRIeldbl so that even
+ case-blind systems can see the difference.
+
+sPRIfldbl (longdblfio.U):
+ This variable, if defined, contains the string used by stdio to
+ format long doubles (format 'f') for output.
+
+sPRIFUldbl (longdblfio.U):
+ This variable, if defined, contains the string used by stdio to
+ format long doubles (format 'F') for output.
+ The 'U' in the name is to separate this from sPRIfldbl so that even
+ case-blind systems can see the difference.
+
+sPRIgldbl (longdblfio.U):
+ This variable, if defined, contains the string used by stdio to
+ format long doubles (format 'g') for output.
+
+sPRIGUldbl (longdblfio.U):
+ This variable, if defined, contains the string used by stdio to
+ format long doubles (format 'G') for output.
+ The 'U' in the name is to separate this from sPRIgldbl so that even
+ case-blind systems can see the difference.
+
+sPRIi64 (quadfio.U):
+ This variable, if defined, contains the string used by stdio to
+ format 64-bit decimal numbers (format 'i') for output.
+
+sPRIo64 (quadfio.U):
+ This variable, if defined, contains the string used by stdio to
+ format 64-bit octal numbers (format 'o') for output.
+
+sPRIu64 (quadfio.U):
+ This variable, if defined, contains the string used by stdio to
+ format 64-bit unsigned decimal numbers (format 'u') for output.
+
+sPRIx64 (quadfio.U):
+ This variable, if defined, contains the string used by stdio to
+ format 64-bit hexadecimal numbers (format 'x') for output.
+
+sPRIXU64 (quadfio.U):
+ This variable, if defined, contains the string used by stdio to
+ format 64-bit hExADECimAl numbers (format 'X') for output.
+ The 'U' in the name is to separate this from sPRIx64 so that even
+ case-blind systems can see the difference.
+
srand48_r_proto (d_srand48_r.U):
This variable encodes the prototype of srand48_r.
It is zero if d_srand48_r is undef, and one of the
the Makefile to use this variable and set VPATH accordingly to
find the sources remotely.
+sSCNfldbl (longdblfio.U):
+ This variable, if defined, contains the string used by stdio to
+ format long doubles (format 'f') for input.
+
ssizetype (ssizetype.U):
This variable defines ssizetype to be something like ssize_t,
long or int. It is used by functions that return a count
This variable indicates if the system supports dynamic
loading of some sort. See also dlsrc and dlobj.
+usefaststdio (usefaststdio.U):
+ This variable conditionally defines the USE_FAST_STDIO symbol,
+ and indicates that Perl should be built to use 'fast stdio'.
+ Defaults to define in Perls 5.8 and earlier, to undef later.
+
useithreads (usethreads.U):
This variable conditionally defines the USE_ITHREADS symbol,
and indicates that Perl should be built to use the interpreter-based
This variable conditionally defines the USE_LONG_DOUBLE symbol,
and indicates that long doubles should be used when available.
+usemallocwrap (mallocsrc.U):
+ This variable contains y if we are wrapping malloc to prevent
+ integer overflow during size calculations.
+
usemorebits (usemorebits.U):
This variable conditionally defines the USE_MORE_BITS symbol,
and indicates that explicit 64-bit interfaces and long doubles
meaningful if usethreads is set and is very experimental, it is
not even prompted for.
+userelocatableinc (XXX.U):
+ This variable is set to true to indicate that perl should relocate
+ @INC entries at runtime based on the path to the perl binary.
+ Any @INC paths starting ".../" are relocated relative to the directory
+ containing the perl binary, and a logical cleanup of the path is then
+ made around the join point (removing "dir/../" pairs)
+
usesfio (d_sfio.U):
This variable is set to true when the user agrees to use sfio.
It is set to false when sfio is not available or when the user
This variable is defined but not used by Configure.
The value is a plain '' and is not useful.
-uvXUformat (perlxvf.U):
- This variable contains the format string used for printing
- a Perl UV as an unsigned hexadecimal integer in uppercase ABCDEF.
-
uvoformat (perlxvf.U):
This variable contains the format string used for printing
a Perl UV as an unsigned octal integer.
This variable contains the format string used for printing
a Perl UV as an unsigned hexadecimal integer in lowercase abcdef.
+uvXUformat (perlxvf.U):
+ This variable contains the format string used for printing
+ a Perl UV as an unsigned hexadecimal integer in uppercase ABCDEF.
+
vendorarch (vendorarch.U):
This variable contains the value of the PERL_VENDORARCH symbol.
It may have a ~ on the front.
This variable is the ~name expanded version of vendorbin, so that you
may use it directly in Makefiles or shell scripts.
+vendorhtml1dir (vendorhtml1dir.U):
+ This variable contains the name of the directory for html
+ pages. It may have a ~ on the front.
+ The standard distribution will put nothing in this directory.
+ Vendors who distribute perl may wish to place their own
+ html pages in this directory with
+ MakeMaker Makefile.PL INSTALLDIRS=vendor
+ or equivalent. See INSTALL for details.
+
+vendorhtml1direxp (vendorhtml1dir.U):
+ This variable is the ~name expanded version of vendorhtml1dir, so that you
+ may use it directly in Makefiles or shell scripts.
+
+vendorhtml3dir (vendorhtml3dir.U):
+ This variable contains the name of the directory for html
+ library pages. It may have a ~ on the front.
+ The standard distribution will put nothing in this directory.
+ Vendors who distribute perl may wish to place their own
+ html pages for modules and extensions in this directory with
+ MakeMaker Makefile.PL INSTALLDIRS=vendor
+ or equivalent. See INSTALL for details.
+
+vendorhtml3direxp (vendorhtml3dir.U):
+ This variable is the ~name expanded version of vendorhtml3dir, so that you
+ may use it directly in Makefiles or shell scripts.
+
vendorlib (vendorlib.U):
This variable contains the eventual value of the VENDORLIB symbol,
which is the name of the private library for this package.
This variable is the ~name expanded version of vendorlib, so that you
may use it directly in Makefiles or shell scripts.
+vendorman1dir (vendorman1dir.U):
+ This variable contains the name of the directory for man1
+ pages. It may have a ~ on the front.
+ The standard distribution will put nothing in this directory.
+ Vendors who distribute perl may wish to place their own
+ man1 pages in this directory with
+ MakeMaker Makefile.PL INSTALLDIRS=vendor
+ or equivalent. See INSTALL for details.
+
+vendorman1direxp (vendorman1dir.U):
+ This variable is the ~name expanded version of vendorman1dir, so that you
+ may use it directly in Makefiles or shell scripts.
+
+vendorman3dir (vendorman3dir.U):
+ This variable contains the name of the directory for man3
+ pages. It may have a ~ on the front.
+ The standard distribution will put nothing in this directory.
+ Vendors who distribute perl may wish to place their own
+ man3 pages in this directory with
+ MakeMaker Makefile.PL INSTALLDIRS=vendor
+ or equivalent. See INSTALL for details.
+
+vendorman3direxp (vendorman3dir.U):
+ This variable is the ~name expanded version of vendorman3dir, so that you
+ may use it directly in Makefiles or shell scripts.
+
vendorprefix (vendorprefix.U):
This variable holds the full absolute path of the directory below
which the vendor will install add-on packages.
This variable holds the full absolute path of the directory below
which the vendor will install add-on packages. Derived from vendorprefix.
+vendorscript (vendorscript.U):
+ This variable contains the eventual value of the VENDORSCRIPT symbol.
+ It may have a ~ on the front.
+ The standard distribution will put nothing in this directory.
+ Vendors who distribute perl may wish to place additional
+ executable scripts in this directory with
+ MakeMaker Makefile.PL INSTALLDIRS=vendor
+ or equivalent. See INSTALL for details.
+
+vendorscriptexp (vendorscript.U):
+ This variable is the ~name expanded version of vendorscript, so that you
+ may use it directly in Makefiles or shell scripts.
+
version (patchlevel.U):
The full version number of this package, such as 5.6.1 (or 5_6_1).
This combines revision, patchlevel, and subversion to get the
libraries on this platform, for example CPU-specific libraries
(on multi-CPU platforms) may be listed here.
-xs_apiversion (xs_apiversion.U):
- This variable contains the version of the oldest perl binary
- compatible with the present perl. perl.c:incpush() and
- lib/lib.pm will automatically search in $sitearch for older
- directories across major versions back to xs_apiversion.
- This is only useful if you have a perl library directory tree
- structured like the default one.
- See INSTALL for how this works.
- The versioned site_perl directory was introduced in 5.005,
- so that is the lowest possible value.
- Since this can depend on compile time options
- it is set by Configure. Other non-default sources
- of potential incompatibility, such as multiplicity, threads,
- debugging, 64bits, sfio, etc., are not checked for currently,
- though in principle we could go snooping around in old
- Config.pm files.
-
yacc (yacc.U):
This variable holds the name of the compiler compiler we
want to use in the Makefile. It can be yacc, byacc, or bison -y.