X-Git-Url: https://perl5.git.perl.org/perl5.git/blobdiff_plain/9334179235ad5f0daf753c23b9b00df2933b98e9..ff935051c0581ebaf8a1cbeb640d7c48ba85cbbc:/Porting/Glossary diff --git a/Porting/Glossary b/Porting/Glossary index f681679..080a4d8 100644 --- a/Porting/Glossary +++ b/Porting/Glossary @@ -4,11 +4,6 @@ programs (e.g. I_UNISTD) are already described in config_h.SH. [`configpm' generates pod documentation for Config.pm from this file--please try to keep the formatting regular.] -Mcc (Loc.U): - This variable is be 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. - _a (Unix.U): This variable defines the extension used for ordinary libraries. For unix, it is '.a'. The '.' is included. Other possible @@ -38,21 +33,56 @@ ansi2knr (ansi2knr.U): Currently, this is not supported, so we just abort. aphostname (d_gethname.U): - Thie variable contains the command which can be used to compute the + This variable contains the command which can be used to compute the host name. The command is fully qualified by its absolute path, to make it safe when used by a process with super-user privileges. -apiversion (patchlevel.U): - This is a number which identifies the lowest version of perl - to have an API (for XS extensions) compatible with the present - version. For example, for 5.005_01, the apiversion should be - 5.005, since 5.005_01 should be binary compatible with 5.005. - This should probably be incremented manually somehow, perhaps - from patchlevel.h. For now, we'll guess maintenance subversions - will retain binary compatibility. +api_revision (patchlevel.U): + The three variables, api_revision, api_version, and + api_subversion, specify the version of the oldest perl binary + compatible with the present perl. In a full version string + such as '5.6.1', api_revision is the '5'. + Prior to 5.5.640, the format was a floating point number, + like 5.00563. + perl.c:incpush() and lib/lib.pm will automatically search in + $sitelib/.. for older directories back to the limit specified + by these api_ variables. 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. The version list appropriate for the current + system is determined in inc_version_list.U. + XXX To do: Since compatibility can depend on compile time + options (such as bincompat, longlong, etc.) it should + (perhaps) be set by Configure, but currently it isn't. + Currently, we read a hard-wired value from patchlevel.h. + Perhaps what we ought to do is take the hard-wired value from + patchlevel.h but then modify it if the current Configure + options warrant. patchlevel.h then would use an #ifdef guard. + +api_subversion (patchlevel.U): + The three variables, api_revision, api_version, and + api_subversion, specify the version of the oldest perl binary + compatible with the present perl. In a full version string + such as '5.6.1', api_subversion is the '1'. See api_revision for + full details. + +api_version (patchlevel.U): + The three variables, api_revision, api_version, and + api_subversion, specify the version of the oldest perl binary + compatible with the present perl. In a full version string + such as '5.6.1', api_version is the '6'. See api_revision for + full details. As a special case, 5.5.0 is rendered in the + old-style as 5.005. (In the 5.005_0x maintenance series, + this was the only versioned directory in $sitelib.) + +api_versionstring (patchlevel.U): + This variable combines api_revision, api_version, and + api_subversion in a format such as 5.6.1 (or 5_6_1) suitable + for use as a directory name. This is filesystem dependent. ar (Loc.U): - This variable is be used internally by Configure to determine the + This variable is used internally by Configure to determine the full pathname (if any) of the ar program. After Configure runs, the value is reset to a plain "ar" and is not useful. @@ -67,6 +97,9 @@ archlibexp (archlib.U): This variable is the same as the archlib variable, but is filename expanded at configuration time, for convenient use. +archname64 (use64bits.U): + This variable is used for the 64-bitness part of $archname. + archname (archname.U): This variable is a short name to characterize the current architecture. It is used mainly to construct the default archlib. @@ -79,7 +112,7 @@ archobjs (Unix.U): include os2/os2.obj. awk (Loc.U): - This variable is be used internally by Configure to determine the + This variable is used internally by Configure to determine the full pathname (if any) of the awk program. After Configure runs, the value is reset to a plain "awk" and is not useful. @@ -96,6 +129,10 @@ bin (bin.U): is most often a local directory such as /usr/local/bin. Programs using this variable must be prepared to deal with ~name substitution. +bincompat5005 (bincompat5005.U): + This variable contains y if Perl 5.006 should be binary-compatible + with Perl 5.005. + binexp (bin.U): This is the same as the bin variable, but is filename expanded at configuration time, for use in your makefiles. @@ -105,7 +142,7 @@ bison (Loc.U): The value is a plain '' and is not useful. byacc (Loc.U): - This variable is be used internally by Configure to determine the + This variable is used internally by Configure to determine the full pathname (if any) of the byacc program. After Configure runs, the value is reset to a plain "byacc" and is not useful. @@ -118,18 +155,18 @@ byteorder (byteorder.U): c (n.U): This variable contains the \c string if that is what causes the echo command to suppress newline. Otherwise it is null. Correct usage is - $echo $n "prompt for a question: $c". + $echo $n "prompt for a question: $c". castflags (d_castneg.U): This variable contains a flag that precise difficulties the compiler has casting odd floating values to unsigned long: - 0 = ok - 1 = couldn't cast < 0 - 2 = couldn't cast >= 0x80000000 - 4 = couldn't cast in argument expression list + 0 = ok + 1 = couldn't cast < 0 + 2 = couldn't cast >= 0x80000000 + 4 = couldn't cast in argument expression list cat (Loc.U): - This variable is be used internally by Configure to determine the + This variable is used internally by Configure to determine the full pathname (if any) of the cat program. After Configure runs, the value is reset to a plain "cat" and is not useful. @@ -154,6 +191,12 @@ ccflags (ccflags.U): This variable contains any additional C compiler flags desired by the user. It is up to the Makefile to use this. +ccsymbols (Cppsym.U): + The variable contains the symbols defined by the C compiler alone. + The symbols defined by cpp or by cc when it calls cpp are not in + this list, see cppsymbols and cppccsymbols. + The list is a space-separated list of symbol=value tokens. + cf_by (cf_who.U): Login name of the person who ran the Configure script and answered the questions. This is used to tag both config.sh and config_h.SH. @@ -166,6 +209,10 @@ cf_time (cf_who.U): Holds the output of the "date" command when the configuration file was produced. This is used to tag both config.sh and config_h.SH. +charsize (charsize.U): + This variable contains the value of the CHARSIZE symbol, which + indicates to the C program how many bytes there are in a character. + chgrp (Loc.U): This variable is defined but not used by Configure. The value is a plain '' and is not useful. @@ -184,7 +231,7 @@ clocktype (d_times.U): included). comm (Loc.U): - This variable is be used internally by Configure to determine the + This variable is used internally by Configure to determine the full pathname (if any) of the comm program. After Configure runs, the value is reset to a plain "comm" and is not useful. @@ -192,6 +239,10 @@ compress (Loc.U): This variable is defined but not used by Configure. The value is a plain '' and is not useful. +CONFIGDOTSH (Oldsyms.U): + This is set to 'true' in config.sh so that a shell script + sourcing config.sh can tell if it has been sourced already. + contains (contains.U): This variable holds the command to do a grep with a proper return status. On most sane systems it is simply "grep". On insane systems @@ -199,7 +250,7 @@ contains (contains.U): is primarily for the use of other Configure units. cp (Loc.U): - This variable is be used internally by Configure to determine the + This variable is used internally by Configure to determine the full pathname (if any) of the cp program. After Configure runs, the value is reset to a plain "cp" and is not useful. @@ -208,7 +259,7 @@ cpio (Loc.U): The value is a plain '' and is not useful. cpp (Loc.U): - This variable is be used internally by Configure to determine the + This variable is used internally by Configure to determine the full pathname (if any) of the cpp program. After Configure runs, the value is reset to a plain "cpp" and is not useful. @@ -216,19 +267,25 @@ cpp_stuff (cpp_stuff.U): This variable contains an identification of the catenation mechanism used by the C preprocessor. +cppccsymbols (Cppsym.U): + The variable contains the symbols defined by the C compiler + when it calls cpp. The symbols defined by the cc alone or cpp + alone are not in this list, see ccsymbols and cppsymbols. + The list is a space-separated list of symbol=value tokens. + cppflags (ccflags.U): This variable holds the flags that will be passed to the C pre- processor. It is up to the Makefile to use it. cpplast (cppstdin.U): - This variable has the same functionality as cppminus, only it applies to - cpprun and not cppstdin. + This variable has the same functionality as cppminus, only it applies + to cpprun and not cppstdin. cppminus (cppstdin.U): This variable contains the second part of the string which will invoke the C preprocessor on the standard input and produce to standard - output. This variable will have the value "-" if cppstdin needs a minus - to specify standard input, otherwise the value is "". + output. This variable will have the value "-" if cppstdin needs + a minus to specify standard input, otherwise the value is "". cpprun (cppstdin.U): This variable contains the command which will invoke a C preprocessor @@ -244,25 +301,35 @@ cppstdin (cppstdin.U): It is primarily used by other Configure units that ask about preprocessor symbols. +cppsymbols (Cppsym.U): + The variable contains the symbols defined by the C preprocessor + alone. The symbols defined by cc or by cc when it calls cpp are + not in this list, see ccsymbols and cppccsymbols. + The list is a space-separated list of symbol=value tokens. + +crosscompile (crosscompile.U): + This variable conditionally defines the CROSSCOMPILE symbol + which signifies that the build process is be a cross-compilation. + This is normally set by hints files or from Configure command line. + cryptlib (d_crypt.U): This variable holds -lcrypt or the path to a libcrypt.a archive if the crypt() function is not defined in the standard C library. It is up to the Makefile to use this. csh (Loc.U): - This variable is be used internally by Configure to determine the + This variable is used internally by Configure to determine the full pathname (if any) of the csh program. After Configure runs, the value is reset to a plain "csh" and is not useful. -d_Gconvert (d_gconvert.U): - This variable holds what Gconvert is defined as to convert - floating point numbers into strings. It could be 'gconvert' - or a more complex macro emulating gconvert with gcvt() or sprintf. - d_access (d_access.U): This variable conditionally defines HAS_ACCESS if the access() system call is available to check for access permissions using real IDs. +d_accessx (d_accessx.U): + This variable conditionally defines the HAS_ACCESSX symbol, which + indicates to the C program that the accessx() routine is available. + 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. @@ -272,6 +339,14 @@ d_archlib (archlib.U): of architecture-dependent library files for $package. If $archlib is the same as $privlib, then this is set to undef. +d_atolf (atolf.U): + This variable conditionally defines the HAS_ATOLF symbol, which + indicates to the C program that the atolf() routine is available. + +d_atoll (atoll.U): + 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, @@ -285,6 +360,12 @@ d_bcopy (d_bcopy.U): This variable conditionally defines the HAS_BCOPY symbol if the bcopy() routine is available to copy strings. +d_bincompat5005 (bincompat5005.U): + This variable conditionally defines BINCOMPAT5005 so that embed.h + can take special action if Perl 5.006 should be binary-compatible + with Perl 5.005. This is impossible for builds that use features + like threads and multiplicity it is always $undef for those versions. + d_bsd (Guess.U): This symbol conditionally defines the symbol BSD when running on a BSD system. @@ -383,10 +464,20 @@ d_dosuid (d_dosuid.U): tells the C program that it should insert setuid emulation code on hosts which have setuid #! scripts disabled. +d_drand48proto (d_drand48proto.U): + This variable conditionally defines the HAS_DRAND48_PROTO symbol, + which indicates to the C program that the system provides + a prototype for the drand48() function. Otherwise, it is + up to the program to supply one. + d_dup2 (d_dup2.U): This variable conditionally defines HAS_DUP2 if dup2() is available to duplicate file descriptors. +d_eaccess (d_eaccess.U): + This variable conditionally defines the HAS_EACCESS symbol, which + indicates to the C program that the eaccess() routine is available. + d_endgrent (d_endgrent.U): This variable conditionally defines the HAS_ENDGRENT symbol, which indicates to the C program that the endgrent() routine is available @@ -413,6 +504,10 @@ d_endsent (d_endsent.U): This variable conditionally defines HAS_ENDSERVENT if endservent() is available to close whatever was being used for service queries. +d_endspent (d_endspent.U): + This variable conditionally defines HAS_ENDSPENT if endspent() is + available to finalize the scan of SysV shadow password entries. + d_eofnblk (nblock_io.U): This variable conditionally defines EOF_NONBLOCK if EOF can be seen when reading from a non-blocking I/O source. @@ -473,15 +568,47 @@ d_fpathconf (d_pathconf.U): to determine file-system related limits and options associated with a given open file descriptor. +d_fpos64_t (io64.U): + This symbol will be defined if the C compiler supports fpos64_t. + +d_fs_data_s (d_fs_data_s.U): + This variable conditionally defines the HAS_STRUCT_FS_DATA symbol, + which indicates that the struct fs_data is supported. + +d_fseeko (d_fseeko.U): + This variable conditionally defines the HAS_FSEEKO symbol, which + indicates to the C program that the fseeko() routine is available. + d_fsetpos (d_fsetpos.U): This variable conditionally defines HAS_FSETPOS if fsetpos() is available to set the file position indicator. +d_fstatfs (d_fstatfs.U): + This variable conditionally defines the HAS_FSTATFS symbol, which + indicates to the C program that the fstatfs() routine is available. + +d_fstatvfs (d_statvfs.U): + This variable conditionally defines the HAS_FSTATVFS symbol, which + indicates to the C program that the fstatvfs() routine is available. + +d_ftello (d_ftello.U): + This variable conditionally defines the HAS_FTELLO symbol, which + indicates to the C program that the ftello() routine is available. + d_ftime (d_ftime.U): This variable conditionally defines the HAS_FTIME symbol, which indicates that the ftime() routine exists. The ftime() routine is basically a sub-second accuracy clock. +d_Gconvert (d_gconvert.U): + This variable holds what Gconvert is defined as to convert + floating point numbers into strings. It could be 'gconvert' + or a more complex macro emulating gconvert with gcvt() or sprintf. + Possible values are: + d_Gconvert='gconvert((x),(n),(t),(b))' + d_Gconvert='gcvt((x),(n),(b))' + d_Gconvert='sprintf((b),"%.*g",(n),(x))' + d_getgrent (d_getgrent.U): This variable conditionally defines the HAS_GETGRENT symbol, which indicates to the C program that the getgrent() routine is available @@ -522,6 +649,16 @@ d_getlogin (d_getlogin.U): indicates to the C program that the getlogin() routine is available to get the login name. +d_getmnt (d_getmnt.U): + This variable conditionally defines the HAS_GETMNT symbol, which + indicates to the C program that the getmnt() routine is available + to retrieve one or more mount info blocks by filename. + +d_getmntent (d_getmntent.U): + This variable conditionally defines the HAS_GETMNTENT symbol, which + indicates to the C program that the getmntent() routine is available + to iterate through mounted files to get their mount info. + d_getnbyaddr (d_getnbyad.U): This variable conditionally defines the HAS_GETNETBYADDR symbol, which indicates to the C program that the getnetbyaddr() routine is available @@ -614,6 +751,14 @@ d_getservprotos (d_getservprotos.U): prototypes for the various getserv*() functions. See also netdbtype.U for probing for various netdb types. +d_getspent (d_getspent.U): + This variable conditionally defines HAS_GETSPENT if getspent() is + available to retrieve SysV shadow password entries sequentially. + +d_getspnam (d_getspnam.U): + This variable conditionally defines HAS_GETSPNAM if getspnam() is + available to retrieve SysV shadow password entries by name. + d_gettimeod (d_ftime.U): This variable conditionally defines the HAS_GETTIMEOFDAY symbol, which indicates that the gettimeofday() system call exists (to obtain a @@ -626,6 +771,11 @@ d_grpasswd (i_grp.U): This variable conditionally defines GRPASSWD, which indicates that struct group in contains gr_passwd. +d_hasmntopt (d_hasmntopt.U): + This variable conditionally defines the HAS_HASMNTOPT symbol, which + indicates to the C program that the hasmntopt() routine is available + to query the mount options of file systems. + d_htonl (d_htonl.U): This variable conditionally defines HAS_HTONL if htonl() and its friends are available to do network order byte swapping. @@ -639,6 +789,9 @@ d_inetaton (d_inetaton.U): indicates to the C program that the inet_aton() function is available to parse IP address "dotted-quad" strings. +d_int64t (d_int64t.U): + This symbol will be defined if the C compiler supports int64_t. + d_isascii (d_isascii.U): This variable conditionally defines the HAS_ISASCII constant, which indicates to the C program that isascii() is available. @@ -653,6 +806,11 @@ d_lchown (d_lchown.U): indicates to the C program that the lchown() routine is available to operate on a symbolic link (instead of following the link). +d_ldbl_dig (d_ldbl_dig.U): + This variable conditionally defines d_ldbl_dig if this system's + header files provide LDBL_DIG, which is the number of significant + digits in a long double precision number. + d_link (d_link.U): This variable conditionally defines HAS_LINK if link() is available to create hard links. @@ -692,6 +850,11 @@ d_mbtowc (d_mbtowc.U): indicates to the C program that the mbtowc() routine is available to convert multibyte to a wide character. +d_memchr (d_memchr.U): + This variable conditionally defines the HAS_MEMCHR symbol, which + indicates to the C program that the memchr() routine is available + to locate characters within a C string. + d_memcmp (d_memcmp.U): This variable conditionally defines the HAS_MEMCMP symbol, which indicates to the C program that the memcmp() routine is available @@ -729,6 +892,31 @@ d_msg (d_msg.U): This variable conditionally defines the HAS_MSG symbol, which indicates that the entire msg*(2) library is present. +d_msg_ctrunc (d_socket.U): + This variable conditionally defines the HAS_MSG_CTRUNC symbol, + which indicates that the MSG_CTRUNC is available. #ifdef is + not enough because it may be an enum, glibc has been known to do this. + +d_msg_dontroute (d_socket.U): + This variable conditionally defines the HAS_MSG_DONTROUTE symbol, + which indicates that the MSG_DONTROUTE is available. #ifdef is + not enough because it may be an enum, glibc has been known to do this. + +d_msg_oob (d_socket.U): + This variable conditionally defines the HAS_MSG_OOB symbol, + which indicates that the MSG_OOB is available. #ifdef is + not enough because it may be an enum, glibc has been known to do this. + +d_msg_peek (d_socket.U): + This variable conditionally defines the HAS_MSG_PEEK symbol, + which indicates that the MSG_PEEK is available. #ifdef is + not enough because it may be an enum, glibc has been known to do this. + +d_msg_proxy (d_socket.U): + This variable conditionally defines the HAS_MSG_PROXY symbol, + which indicates that the MSG_PROXY is available. #ifdef is + not enough because it may be an enum, glibc has been known to do this. + d_msgctl (d_msgctl.U): This variable conditionally defines the HAS_MSGCTL symbol, which indicates to the C program that the msgctl() routine is available. @@ -754,10 +942,17 @@ d_nice (d_nice.U): This variable conditionally defines the HAS_NICE symbol, which indicates to the C program that the nice() routine is available. +d_off64_t (io64.U): + This symbol will be defined if the C compiler supports off64_t. + +d_old_pthread_create_joinable (d_pthrattrj.U): + This variable conditionally defines pthread_create_joinable. + undef if pthread.h defines PTHREAD_CREATE_JOINABLE. + d_oldpthreads (usethreads.U): This variable conditionally defines the OLD_PTHREADS_API symbol, and indicates that Perl should be built to use the old - draft POSIX threads API. This is only potneially meaningful if + draft POSIX threads API. This is only potentially meaningful if usethreads is set. d_oldsock (d_socket.U): @@ -781,7 +976,7 @@ d_pause (d_pause.U): to suspend a process until a signal is received. d_phostname (d_gethname.U): - This variable conditionally defines the PHOSTNAME symbol, which + This variable conditionally defines the HAS_PHOSTNAME symbol, which contains the shell command which, when fed to popen(), may be used to derive the host name. @@ -800,16 +995,60 @@ d_portable (d_portable.U): 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_PRIfldlbl symbol, which + indiciates that stdio has a symbol to print long doubles. + +d_PRIEldbl (longdblfio.U): + This variable conditionally defines the PERL_PRIfldlbl symbol, which + indiciates that stdio has a symbol to print long doubles. + +d_PRIfldbl (longdblfio.U): + This variable conditionally defines the PERL_PRIfldlbl symbol, which + indiciates that stdio has a symbol to print long doubles. + +d_PRIFldbl (longdblfio.U): + This variable conditionally defines the PERL_PRIfldlbl symbol, which + indiciates that stdio has a symbol to print long doubles. + +d_PRIgldbl (longdblfio.U): + This variable conditionally defines the PERL_PRIfldlbl symbol, which + indiciates that stdio has a symbol to print long doubles. + +d_PRIGldbl (longdblfio.U): + This variable conditionally defines the PERL_PRIfldlbl 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_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_pthread_yield (d_pthread_y.U): This variable conditionally defines the HAS_PTHREAD_YIELD symbol if the pthread_yield routine is available to yield the execution of the current thread. -d_pthreads_created_joinable (d_pthreadj.U): - This variable conditionally defines the PTHREADS_CREATED_JOINABLE - symbol if pthreads are created in the joinable (aka undetached) - state. - d_pwage (i_pwd.U): This variable conditionally defines PWAGE, which indicates that struct passwd contains pw_age. @@ -842,6 +1081,14 @@ d_pwquota (i_pwd.U): This variable conditionally defines PWQUOTA, which indicates that struct passwd contains pw_quota. +d_qgcvt (d_qgcvt.U): + This variable conditionally defines the HAS_QGCVT symbol, which + indicates to the C program that the qgcvt() routine is available. + +d_quad (quadtype.U): + This variable, if defined, tells that there's a 64-bit integer type, + quadtype. + d_readdir (d_readdir.U): This variable conditionally defines HAS_READDIR if readdir() is available to read directory entries. @@ -882,6 +1129,11 @@ d_sched_yield (d_pthread_y.U): symbol if the sched_yield routine is available to yield the execution of the current thread. +d_scm_rights (d_socket.U): + This variable conditionally defines the HAS_SCM_RIGHTS symbol, + 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_seekdir (d_readdir.U): This variable conditionally defines HAS_SEEKDIR if seekdir() is available. @@ -899,11 +1151,11 @@ d_semctl (d_semctl.U): This variable conditionally defines the HAS_SEMCTL symbol, which indicates to the C program that the semctl() routine is available. -d_semctl_semid_ds (d_union_senum.U): +d_semctl_semid_ds (d_union_semun.U): This variable conditionally defines USE_SEMCTL_SEMID_DS, which indicates that struct semid_ds * is to be used for semctl IPC_STAT. -d_semctl_semun (d_union_senum.U): +d_semctl_semun (d_union_semun.U): This variable conditionally defines USE_SEMCTL_SEMUN, which indicates that union semun is to be used for semctl IPC_STAT. @@ -1017,6 +1269,10 @@ d_setsid (d_setsid.U): This variable conditionally defines HAS_SETSID if setsid() is available to set the process group ID. +d_setspent (d_setspent.U): + This variable conditionally defines HAS_SETSPENT if setspent() is + available to initialize the scan of SysV shadow password entries. + d_setvbuf (d_setvbuf.U): This variable conditionally defines the HAS_SETVBUF symbol, which indicates to the C program that the setvbuf() routine is available @@ -1068,9 +1324,28 @@ d_sockpair (d_socket.U): This variable conditionally defines the HAS_SOCKETPAIR symbol, which indicates that the BSD socketpair() is supported. +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. + d_statblks (d_statblks.U): - This variable conditionally defines USE_STAT_BLOCKS if this system - has a stat structure declaring st_blksize and st_blocks. + This variable conditionally defines USE_STAT_BLOCKS + if this system has a stat structure declaring + st_blksize and st_blocks. + +d_statfs_f_flags (d_statfs_f_flags.U): + This variable conditionally defines the HAS_STRUCT_STATFS_F_FLAGS + symbol, which indicates to struct statfs from has f_flags member. + This kind of struct statfs is coming from sys/mount.h (BSD), + not from sys/statfs.h (SYSV). + +d_statfs_s (d_statfs_s.U): + This variable conditionally defines the HAS_STRUCT_STATFS symbol, + which indicates that the struct statfs is supported. + +d_statvfs (d_statvfs.U): + This variable conditionally defines the HAS_STATVFS symbol, which + indicates to the C program that the statvfs() routine is available. d_stdio_cnt_lval (d_stdstdio.U): This variable conditionally defines STDIO_CNT_LVALUE if the @@ -1080,6 +1355,10 @@ d_stdio_ptr_lval (d_stdstdio.U): This variable conditionally defines STDIO_PTR_LVALUE if the FILE_ptr macro can be used as an lvalue. +d_stdio_stream_array (stdio_streams.U): + This variable tells whether there is an array holding + the stdio streams. + d_stdiobase (d_stdstdio.U): This variable conditionally defines USE_STDIO_BASE if this system has a FILE structure declaring a usable _base field (or equivalent) @@ -1123,11 +1402,23 @@ d_strtol (d_strtol.U): indicates to the C program that the strtol() routine is available to provide better numeric string conversion than atoi() and friends. +d_strtold (d_strtold.U): + This variable conditionally defines the HAS_STRTOLD symbol, which + indicates to the C program that the strtold() routine is available. + d_strtoul (d_strtoul.U): This variable conditionally defines the HAS_STRTOUL symbol, which indicates to the C program that the strtoul() routine is available to provide conversion of strings to unsigned long. +d_strtoull (d_strtoull.U): + This variable conditionally defines the HAS_STRTOULL symbol, which + indicates to the C program that the strtoull() routine is available. + +d_strtouq (d_strtouq.U): + This variable conditionally defines the HAS_STRTOUQ symbol, which + indicates to the C program that the strtouq() routine is available. + d_strxfrm (d_strxfrm.U): This variable conditionally defines HAS_STRXFRM if strxfrm() is available to transform strings. @@ -1176,6 +1467,12 @@ d_telldir (d_readdir.U): This variable conditionally defines HAS_TELLDIR if telldir() is available. +d_telldirproto (d_telldirproto.U): + This variable conditionally defines the HAS_TELLDIR_PROTO symbol, + which indicates to the C program that the system provides + a prototype for the telldir() function. Otherwise, it is + up to the program to supply one. + d_time (d_time.U): This variable conditionally defines the HAS_TIME symbol, which indicates that the time() routine exists. The time() routine is normaly @@ -1204,10 +1501,20 @@ d_uname (d_gethname.U): indicates to the C program that the uname() routine may be used to derive the host name. -d_union_semun (d_union_senum.U): +d_union_semun (d_union_semun.U): This variable conditionally defines HAS_UNION_SEMUN if the union semun is defined by including . +d_ustat (d_ustat.U): + This variable conditionally defines HAS_USTAT if ustat() is + available to query file system statistics by dev_t. + +d_vendorbin (vendorbin.U): + This variable conditionally defines PERL_VENDORBIN. + +d_vendorlib (vendorlib.U): + This variable conditionally defines PERL_VENDORLIB. + d_vfork (d_vfork.U): This variable conditionally defines the HAS_VFORK symbol, which indicates the vfork() routine is available. @@ -1260,7 +1567,7 @@ d_xenix (Guess.U): the C program that it runs under Xenix. date (Loc.U): - This variable is be used internally by Configure to determine the + This variable is used internally by Configure to determine the full pathname (if any) of the date program. After Configure runs, the value is reset to a plain "date" and is not useful. @@ -1274,6 +1581,9 @@ db_prefixtype (i_db.U): in the header file. In older versions of DB, it was int, while in newer ones it is size_t. +defvoidused (voidflags.U): + This variable contains the default value of the VOIDUSED symbol (15). + direntrytype (i_dirent.U): This symbol is set to 'struct direct' or 'struct dirent' depending on whether dirent is available or not. You should use this pseudo type to @@ -1291,6 +1601,13 @@ doublesize (doublesize.U): This variable contains the value of the DOUBLESIZE symbol, which indicates to the C program how many bytes there are in a double. +drand01 (randfunc.U): + Indicates the macro to be used to generate normalized + random numbers. Uses randfunc, often divided by + (double) (((unsigned long) 1 << randbits)) in order to + normalize the result. + In C programs, the macro 'Drand01' is mapped to drand01. + dynamic_ext (Extensions.U): This variable holds a list of XS extension files we want to link dynamically into the package. It is used by Makefile. @@ -1307,12 +1624,12 @@ ebcdic (ebcdic.U): See trnl.U echo (Loc.U): - This variable is be used internally by Configure to determine the + This variable is used internally by Configure to determine the full pathname (if any) of the echo program. After Configure runs, the value is reset to a plain "echo" and is not useful. egrep (Loc.U): - This variable is be used internally by Configure to determine the + This variable is used internally by Configure to determine the full pathname (if any) of the egrep program. After Configure runs, the value is reset to a plain "egrep" and is not useful. @@ -1329,7 +1646,7 @@ exe_ext (Unix.U): This is an old synonym for _exe. expr (Loc.U): - This variable is be used internally by Configure to determine the + This variable is used internally by Configure to determine the full pathname (if any) of the expr program. After Configure runs, the value is reset to a plain "expr" and is not useful. @@ -1339,10 +1656,20 @@ extensions (Extensions.U): and is typically used to test whether a particular extesion is available. +fflushall (fflushall.U): + This symbol, if defined, tells that to flush + all pending stdio output one must loop through all + the stdio file handles stored in an array and fflush them. + 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 be used internally by Configure to determine the - full pathname (if any) of the find program. After Configure runs, - the value is reset to a plain "find" and is not useful. + This variable is defined but not used by Configure. + The value is a plain '' and is not useful. firstmakefile (Unix.U): This variable defines the first file searched by make. On unix, @@ -1354,14 +1681,22 @@ flex (Loc.U): This variable is defined but not used by Configure. The value is a plain '' and is not useful. +fpossize (fpossize.U): + This variable contains the size of a fpostype in bytes. + fpostype (fpostype.U): - This variable defines Fpos_t to be something like fpost_t, long, + This variable defines Fpos_t to be something like fpos_t, long, uint, or whatever type is used to declare file positions in libc. freetype (mallocsrc.U): This variable contains the return type of free(). It is usually void, but occasionally int. +full_ar (Loc_ar.U): + This variable contains the full pathname to 'ar', whether or + not the user has specified 'portability'. This is only used + in the Makefile.SH. + full_csh (d_csh.U): This variable contains the full pathname to 'csh', whether or not the user has specified 'portability'. This is only used @@ -1381,13 +1716,28 @@ gccversion (cc.U): 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. +gidformat (gidf.U): + This variable contains the format string used for printing a Gid_t. + +gidsign (gidsign.U): + This variable contains the signedness of a gidtype. + 1 for unsigned, -1 for signed. + +gidsize (gidsize.U): + This variable contains the size of a gidtype in bytes. + gidtype (gidtype.U): This variable defines Gid_t to be something like gid_t, int, ushort, or whatever type is used to declare the return type of getgid(). Typically, it is the type of group ids in the kernel. +glibpth (libpth.U): + This variable holds the general path (space-separated) used to + find libraries. It may contain directories that do not exist on + this platform, libpth is the cleaned-up version. + grep (Loc.U): - This variable is be used internally by Configure to determine the + This variable is used internally by Configure to determine the full pathname (if any) of the grep program. After Configure runs, the value is reset to a plain "grep" and is not useful. @@ -1395,6 +1745,8 @@ groupcat (nis.U): This variable contains a command that produces the text of the /etc/group file. This is normally "cat /etc/group", but can be "ypcat group" when NIS is used. + On some systems, such as os390, there may be no equivalent + command, in which case this variable is unset. groupstype (groupstype.U): This variable defines Groups_t to be something like gid_t, int, @@ -1403,7 +1755,7 @@ groupstype (groupstype.U): gidtype (gid_t), but sometimes it isn't. gzip (Loc.U): - This variable is be used internally by Configure to determine the + This variable is used internally by Configure to determine the full pathname (if any) of the gzip program. After Configure runs, the value is reset to a plain "gzip" and is not useful. @@ -1423,6 +1775,8 @@ hostcat (nis.U): This variable contains a command that produces the text of the /etc/hosts file. This is normally "cat /etc/hosts", but can be "ypcat hosts" when NIS is used. + On some systems, such as os390, there may be no equivalent + command, in which case this variable is unset. huge (models.U): This variable contains a flag which will tell the C compiler and loader @@ -1430,6 +1784,30 @@ huge (models.U): huge model is not supported, contains the flag to produce large model programs. It is up to the Makefile to use this. +i16size (perlxv.U): + This variable is the size of an I16 in bytes. + +i16type (perlxv.U): + This variable contains the C type used for Perl's I16. + +i32size (perlxv.U): + This variable is the size of an I32 in bytes. + +i32type (perlxv.U): + This variable contains the C type used for Perl's I32. + +i64size (perlxv.U): + This variable is the size of an I64 in bytes. + +i64type (perlxv.U): + This variable contains the C type used for Perl's I64. + +i8size (perlxv.U): + This variable is the size of an I8 in bytes. + +i8type (perlxv.U): + This variable contains the C type used for Perl's I8. + i_arpainet (i_arpainet.U): This variable conditionally defines the I_ARPA_INET symbol, and indicates whether a C program should include . @@ -1480,6 +1858,10 @@ i_grp (i_grp.U): This variable conditionally defines the I_GRP symbol, and indicates whether a C program should include . +i_inttypes (i_inttypes.U): + This variable conditionally defines the I_INTTYPES symbol, + and indicates whether a C program should include . + i_limits (i_limits.U): This variable conditionally defines the I_LIMITS symbol, and indicates whether a C program may include to get symbols like WORD_BIT @@ -1489,6 +1871,10 @@ i_locale (i_locale.U): This variable conditionally defines the I_LOCALE symbol, and indicates whether a C program should include . +i_machcthr (i_machcthr.U): + This variable conditionally defines the I_MACH_CTHREADS symbol, + and indicates whether a C program should include . + i_malloc (i_malloc.U): This variable conditionally defines the I_MALLOC symbol, and indicates whether a C program should include . @@ -1501,6 +1887,10 @@ i_memory (i_memory.U): This variable conditionally defines the I_MEMORY symbol, and indicates whether a C program should include . +i_mntent (i_mntent.U): + This variable conditionally defines the I_MNTENT symbol, and indicates + whether a C program should include . + i_ndbm (i_ndbm.U): This variable conditionally defines the I_NDBM symbol, which indicates to the C program that exists and should @@ -1515,11 +1905,23 @@ i_neterrno (i_neterrno.U): indicates to the C program that exists and should be included. +i_netinettcp (i_netinettcp.U): + This variable conditionally defines the I_NETINET_TCP symbol, + and indicates whether a C program should include . + i_niin (i_niin.U): This variable conditionally defines I_NETINET_IN, which indicates to the C program that it should include . Otherwise, you may try . +i_poll (i_poll.U): + This variable conditionally defines the I_POLL symbol, and indicates + whether a C program should include . + +i_pthread (i_pthread.U): + This variable conditionally defines the I_PTHREAD symbol, + and indicates whether a C program should include . + i_pwd (i_pwd.U): This variable conditionally defines I_PWD, which indicates to the C program that it should include . @@ -1538,6 +1940,14 @@ i_sgtty (i_termio.U): indicates to the C program that it should include rather than . +i_shadow (i_shadow.U): + This variable conditionally defines the I_SHADOW symbol, and indicates + whether a C program should include . + +i_socks (i_socks.U): + This variable conditionally defines the I_SOCKS symbol, and indicates + whether a C program should include . + i_stdarg (i_varhdr.U): This variable conditionally defines the I_STDARG symbol, which indicates to the C program that exists and should @@ -1557,6 +1967,10 @@ i_string (i_string.U): This variable conditionally defines the I_STRING symbol, which indicates that should be included rather than . +i_sysaccess (i_sysaccess.U): + This variable conditionally defines the I_SYS_ACCESS symbol, + and indicates whether a C program should include . + i_sysdir (i_sysdir.U): This variable conditionally defines the I_SYS_DIR symbol, and indicates whether a C program should include . @@ -1580,6 +1994,10 @@ i_sysioctl (i_sysioctl.U): indicates to the C program that exists and should be included. +i_sysmount (i_sysmount.U): + This variable conditionally defines the I_SYSMOUNT symbol, + and indicates whether a C program should include . + i_sysndir (i_sysndir.U): This variable conditionally defines the I_SYS_NDIR symbol, and indicates whether a C program should include . @@ -1592,6 +2010,10 @@ i_sysresrc (i_sysresrc.U): This variable conditionally defines the I_SYS_RESOURCE symbol, and indicates whether a C program should include . +i_syssecrt (i_syssecrt.U): + This variable conditionally defines the I_SYS_SECURITY symbol, + and indicates whether a C program should include . + i_sysselct (i_sysselct.U): This variable conditionally defines I_SYS_SELECT, which indicates to the C program that it should include in order to @@ -1606,6 +2028,14 @@ i_sysstat (i_sysstat.U): This variable conditionally defines the I_SYS_STAT symbol, and indicates whether a C program should include . +i_sysstatfs (i_sysstatfs.U): + This variable conditionally defines the I_SYSSTATFS symbol, + and indicates whether a C program should include . + +i_sysstatvfs (i_sysstatvfs.U): + This variable conditionally defines the I_SYSSTATVFS symbol, + and indicates whether a C program should include . + i_systime (i_time.U): This variable conditionally defines I_SYS_TIME, which indicates to the C program that it should include . @@ -1623,11 +2053,19 @@ i_systypes (i_systypes.U): This variable conditionally defines the I_SYS_TYPES symbol, and indicates whether a C program should include . +i_sysuio (i_sysuio.U): + This variable conditionally defines the I_SYSUIO symbol, and indicates + whether a C program should include . + i_sysun (i_sysun.U): This variable conditionally defines I_SYS_UN, which indicates to the C program that it should include to get UNIX domain socket definitions. +i_sysvfs (i_sysvfs.U): + This variable conditionally defines the I_SYSVFS symbol, + and indicates whether a C program should include . + i_syswait (i_syswait.U): This variable conditionally defines I_SYS_WAIT, which indicates to the C program that it should include . @@ -1650,6 +2088,10 @@ i_unistd (i_unistd.U): This variable conditionally defines the I_UNISTD symbol, and indicates whether a C program should include . +i_ustat (i_ustat.U): + This variable conditionally defines the I_USTAT symbol, and indicates + whether a C program should include . + i_utime (i_utime.U): This variable conditionally defines the I_UTIME symbol, and indicates whether a C program should include . @@ -1671,6 +2113,20 @@ i_vfork (i_vfork.U): This variable conditionally defines the I_VFORK symbol, and indicates whether a C program should include vfork.h. +ignore_versioned_solibs (libs.U): + This variable should be non-empty if non-versioned shared + libraries (libfoo.so.x.y) are to be ignored (because they + cannot be linked against). + +inc_version_list (inc_version_list.U): + This variable specifies the list of subdirectories in over + which perl.c:incpush() and lib/lib.pm will automatically + search when adding directories to @INC. 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. + incpath (usrinc.U): This variable must preceed the normal include path to get hte right one, as in "$incpath/usr/include" or "$incpath/usr/lib". @@ -1702,6 +2158,18 @@ installman3dir (man3dir.U): man3direxp only points to the read-only access location. For extra portability, you should only use this variable within your makefiles. +installprefix (installprefix.U): + This variable holds the name of the directory below which + "make install" will install the package. For most users, this + is the same as prefix. However, it is useful for + installing the software into a different (usually temporary) + location after which it can be bundled up and moved somehow + to the final location specified by prefix. + +installprefixexp (installprefix.U): + This variable holds the full absolute path of installprefix + with all ~-expansion done. + installprivlib (privlib.U): This variable is really the same as privlibexp but may differ on those systems using AFS. For extra portability, only this variable @@ -1717,15 +2185,63 @@ installsitearch (sitearch.U): those systems using AFS. For extra portability, only this variable should be used in makefiles. +installsitebin (sitebin.U): + This variable is usually the same as sitebinexp, 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. + 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. +installstyle (installstyle.U): + This variable describes the "style" of the perl installation. + This is intended to be useful for tools that need to + manipulate entire perl distributions. Perl itself doesn't use + this to find its libraries -- the library directories are + stored directly in Config.pm. Currently, there are only two + styles: "lib" and "lib/perl5". The default library locations + (e.g. privlib, sitelib) are either $prefix/lib or + $prefix/lib/perl5. The former is useful if $prefix is a + directory dedicated to perl (e.g. /opt/perl), while the latter + is useful if $prefix is shared by many packages, e.g. if + $prefix=/usr/local. + This may later be extended to include other information, so + be careful with pattern-matching on the results. + For compatibility with perl5.005 and earlier, the default + setting is based on whether or not $prefix contains the string + "perl". + +installusrbinperl (instubperl.U): + This variable tells whether Perl should be installed also as + /usr/bin/perl in addition to + $installbin/perl + +installvendorbin (vendorbin.U): + This variable is really the same as vendorbinexp 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. + 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. +ivdformat (perlxvf.U): + This variable contains the format string used for printing + a Perl IV as a signed decimal integer. + +ivsize (perlxv.U): + This variable is the size of an IV in bytes. + +ivtype (perlxv.U): + This variable contains the C type used for Perl's IV. + known_extensions (Extensions.U): This variable holds a list of all XS extensions included in the package. @@ -1755,8 +2271,13 @@ ldflags (ccflags.U): This variable contains any additional C loader flags desired by the user. It is up to the Makefile to use this. +ldlibpthname (libperl.U): + This variable holds the name of the shared library + search path, often LD_LIBRARY_PATH. To get an empty + string, the hints file must set this to 'none'. + less (Loc.U): - This variable is be used internally by Configure to determine the + This variable is used internally by Configure to determine the full pathname (if any) of the less program. After Configure runs, the value is reset to a plain "less" and is not useful. @@ -1775,8 +2296,8 @@ libperl (libperl.U): library. libpth (libpth.U): - This variable holds the general path used to find libraries. It is - intended to be used by other units. + This variable holds the general path (space-separated) used to find + libraries. It is intended to be used by other units. libs (libs.U): This variable holds the additional libraries we want to use. @@ -1788,9 +2309,8 @@ libswanted (Myinit.U): ahead of ucb or bsd libraries for SVR4. line (Loc.U): - This variable is be used internally by Configure to determine the - full pathname (if any) of the line program. After Configure runs, - the value is reset to a plain "line" and is not useful. + This variable is defined but not used by Configure. + The value is a plain '' and is not useful. lint (Loc.U): This variable is defined but not used by Configure. @@ -1801,7 +2321,7 @@ lkflags (ccflags.U): the user. It is up to the Makefile to use this. ln (Loc.U): - This variable is be used internally by Configure to determine the + This variable is used internally by Configure to determine the full pathname (if any) of the ln program. After Configure runs, the value is reset to a plain "ln" and is not useful. @@ -1818,9 +2338,9 @@ locincpth (ccflags.U): It's not much, but it parallels the loclibpth stuff in libpth.U. loclibpth (libpth.U): - This variable holds the paths used to find local libraries. It is - prepended to libpth, and is intended to be easily set from the - command line. + This variable holds the paths (space-separated) used to find local + libraries. It is prepended to libpth, and is intended to be easily + set from the command line. longdblsize (d_longdbl.U): This variable contains the value of the LONG_DOUBLESIZE symbol, which @@ -1845,10 +2365,15 @@ lpr (Loc.U): The value is a plain '' and is not useful. ls (Loc.U): - This variable is be used internally by Configure to determine the + This variable is used internally by Configure to determine the full pathname (if any) of the ls program. After Configure runs, the value is reset to a plain "ls" and is not useful. +lseeksize (lseektype.U): + This variable defines lseektype to be something like off_t, long, + or whatever type is used to declare lseek offset's type in the + kernel (which also appears to be lseek's return type). + lseektype (lseektype.U): This variable defines lseektype to be something like off_t, long, or whatever type is used to declare lseek offset's type in the @@ -1863,7 +2388,7 @@ mailx (Loc.U): The value is a plain '' and is not useful. make (Loc.U): - This variable is be used internally by Configure to determine the + This variable is used internally by Configure to determine the full pathname (if any) of the make program. After Configure runs, the value is reset to a plain "make" and is not useful. @@ -1923,6 +2448,11 @@ man3ext (man3dir.U): 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. + medium (models.U): This variable contains a flag which will tell the C compiler and loader to produce a program running with a medium memory model. If the @@ -1934,7 +2464,7 @@ mips_type (usrinc.U): Possible values are "BSD 4.3" and "System V". mkdir (Loc.U): - This variable is be used internally by Configure to determine the + This variable is used internally by Configure to determine the full pathname (if any) of the mkdir program. After Configure runs, the value is reset to a plain "mkdir" and is not useful. @@ -1949,10 +2479,15 @@ modetype (modetype.U): modes for system calls. more (Loc.U): - This variable is be used internally by Configure to determine the + This variable is used internally by Configure to determine the full pathname (if any) of the more program. After Configure runs, the value is reset to a plain "more" and is not useful. +multiarch (multiarch.U): + This variable conditionally defines the MULTIARCH symbol + which signifies the presence of multiplatform files. + This is normally set by hints files. + mv (Loc.U): This variable is defined but not used by Configure. The value is a plain '' and is not useful. @@ -1982,7 +2517,7 @@ myuname (Oldconfig.U): n (n.U): This variable contains the '-n' flag if that is what causes the echo command to suppress newline. Otherwise it is null. Correct usage is - $echo $n "prompt for a question: $c". + $echo $n "prompt for a question: $c". netdb_hlen_type (netdbtype.U): This variable holds the type used for the 2nd argument to @@ -2006,7 +2541,7 @@ netdb_net_type (netdbtype.U): This is only useful if you have getnetbyaddr(), naturally. nm (Loc.U): - This variable is be used internally by Configure to determine the + This variable is used internally by Configure to determine the full pathname (if any) of the nm program. After Configure runs, the value is reset to a plain "nm" and is not useful. @@ -2026,10 +2561,16 @@ nonxs_ext (Extensions.U): in the package. All of them will be built. nroff (Loc.U): - This variable is be used internally by Configure to determine the + This variable is used internally by Configure to determine the full pathname (if any) of the nroff program. After Configure runs, the value is reset to a plain "nroff" and is not useful. +nvsize (perlxv.U): + This variable is the size of an NV in bytes. + +nvtype (perlxv.U): + This variable contains the C type used for Perl's NV. + o_nonblock (nblock_io.U): This variable bears the symbol value to be used during open() or fcntl() to turn on non-blocking I/O for a file descriptor. If you wish to switch @@ -2039,6 +2580,12 @@ o_nonblock (nblock_io.U): obj_ext (Unix.U): This is an old synonym for _o. +old_pthread_create_joinable (d_pthrattrj.U): + This variable defines the constant to use for creating joinable + (aka undetached) pthreads. Unused if pthread.h defines + PTHREAD_CREATE_JOINABLE. If used, possible values are + PTHREAD_CREATE_UNDETACHED and __UNDETACHED. + optimize (ccflags.U): This variable contains any optimizer/debugger flag that should be used. It is up to the Makefile to use it. @@ -2076,20 +2623,38 @@ passcat (nis.U): This variable contains a command that produces the text of the /etc/passwd file. This is normally "cat /etc/passwd", but can be "ypcat passwd" when NIS is used. + On some systems, such as os390, there may be no equivalent + command, in which case this variable is unset. patchlevel (patchlevel.U): The patchlevel level of this package. The value of patchlevel comes from the patchlevel.h file. + In a version number such as 5.6.1, this is the "6". + In patchlevel.h, this is referred to as the "PERL_VERSION". path_sep (Unix.U): This is an old synonym for p_ in Head.U, the character used to separate elements in the command shell search PATH. perl (Loc.U): - This variable is be used internally by Configure to determine the + This variable is used internally by Configure to determine the full pathname (if any) of the perl program. After Configure runs, the value is reset to a plain "perl" 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 + perladmin (perladmin.U): Electronic mail address of the perl5 administrator. @@ -2099,7 +2664,7 @@ perlpath (perlpath.U): shell scripts and in the "eval 'exec'" idiom. pg (Loc.U): - This variable is be used internally by Configure to determine the + This variable is used internally by Configure to determine the full pathname (if any) of the pg program. After Configure runs, the value is reset to a plain "pg" and is not useful. @@ -2155,10 +2720,26 @@ ptrsize (ptrsize.U): This variable contains the value of the PTRSIZE symbol, which indicates to the C program how many bytes there are in a pointer. -randbits (randbits.U): - This variable contains the eventual value of the RANDBITS symbol, - which indicates to the C program how many bits of random number - the rand() function produces. +quadkind (quadtype.U): + This variable, if defined, encodes the type of a quad: + 1 = int, 2 = long, 3 = long long, 4 = int64_t. + +quadtype (quadtype.U): + This variable defines Quad_t to be something like long, int, + long long, int64_t, or whatever type is used for 64-bit integers. + +randbits (randfunc.U): + Indicates how many bits are produced by the function used to + generate normalized random numbers. + +randfunc (randfunc.U): + Indicates the name of the random number function to use. + Values include drand48, random, and rand. In C programs, + the 'Drand01' macro is defined to generate uniformly distributed + random numbers over the range [0., 1.[ (see drand01 and nrand). + +randseedtype (randfunc.U): + Indicates the type of the argument of the seedfunc. ranlib (orderlib.U): This variable is set to the pathname of the ranlib program, if it is @@ -2172,7 +2753,7 @@ rd_nodata (nblock_io.U): no data and an EOF.. Sigh! rm (Loc.U): - This variable is be used internally by Configure to determine the + This variable is used internally by Configure to determine the full pathname (if any) of the rm program. After Configure runs, the value is reset to a plain "rm" and is not useful. @@ -2185,6 +2766,10 @@ runnm (usenm.U): nm extraction should be performed or not, according to the value of usenm and the flags on the Configure command line. +sched_yield (d_pthread_y.U): + This variable defines the way to yield the execution + of the current thread. + scriptdir (scriptdir.U): This variable holds the name of the directory in which the user wants to put publicly scripts for the package in question. It is either @@ -2197,10 +2782,21 @@ scriptdirexp (scriptdir.U): at configuration time, for programs not wanting to bother with it. sed (Loc.U): - This variable is be used internally by Configure to determine the + This variable is used internally by Configure to determine the full pathname (if any) of the sed program. After Configure runs, the value is reset to a plain "sed" and is not useful. +seedfunc (randfunc.U): + Indicates the random number generating seed function. + Values include srand48, srandom, and srand. + +selectminbits (selectminbits.U): + This variable holds the minimum number of bits operated by select. + That is, if you do select(n, ...), how many bits at least will be + cleared in the masks if some activity is detected. Usually this + is either n or 32*ceil(n/32), especially many little-endians do + the latter. This is only useful if you have select(), naturally. + selecttype (selecttype.U): This variable holds the type used for the 2nd, 3rd, and 4th arguments to select. Usually, this is 'fd_set *', if HAS_FD_SET @@ -2208,9 +2804,8 @@ selecttype (selecttype.U): have select(), naturally. sendmail (Loc.U): - This variable is be used internally by Configure to determine the - full pathname (if any) of the sendmail program. After Configure runs, - the value is reset to a plain "sendmail" and is not useful. + This variable is defined but not used by Configure. + The value is a plain '' and is not useful. sh (sh.U): This variable contains the full pathname of the shell used @@ -2244,11 +2839,11 @@ shrpenv (libperl.U): One way to do this on some systems is to set the environment variable LD_RUN_PATH to the directory that will be the final location of the shared libperl.so. The makefile can use this with something like - $shrpenv $(CC) -o perl perlmain.o $libperl $libs + $shrpenv $(CC) -o perl perlmain.o $libperl $libs Typical values are - shrpenv="env LD_RUN_PATH=$archlibexp/CORE" + shrpenv="env LD_RUN_PATH=$archlibexp/CORE" or - shrpenv='' + shrpenv='' See the main perl Makefile.SH for actual working usage. Alternatively, we might be able to use a command line option such as -R $archlibexp/CORE (Solaris, NetBSD) or -Wl,-rpath @@ -2258,6 +2853,10 @@ shsharp (spitshell.U): This variable tells further Configure units whether your sh can handle # comments. +sig_count (sig_name.U): + This variable holds a number larger than the largest valid + signal number. This is usually the same as the NSIG macro. + 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 @@ -2271,12 +2870,18 @@ sig_name_init (sig_name.U): is removed. See sig_num. sig_num (sig_name.U): - This variable holds the signal numbers, comma separated. A 0 is + 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. +sig_num_init (sig_name.U): + This variable holds the signal numbers, enclosed in double quotes and + separated by commas, suitable for use in the SIG_NUM definition + below. A "ZERO" is prepended to the list, and the list is + terminated with a plain 0. + signal_t (d_voidsig.U): This variable holds the type of the signal handler (void or int). @@ -2285,21 +2890,55 @@ sitearch (sitearch.U): which is the name of the private library for this package. It may have a ~ on the front. It is up to the makefile to eventually create this directory while performing installation (with ~ substitution). + The standard distribution will put nothing in this directory. + After perl has been installed, users may install their own local + architecture-dependent modules in this directory with + MakeMaker Makefile.PL + or equivalent. See INSTALL for details. sitearchexp (sitearch.U): This variable is the ~name expanded version of sitearch, so that you may use it directly in Makefiles or shell scripts. +sitebin (sitebin.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 + executables in this directory with + MakeMaker Makefile.PL + or equivalent. See INSTALL for details. + +sitebinexp (sitebin.U): + This is the same as the sitebin variable, but is filename expanded at + configuration time, for use in your 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 have a ~ on the front. It is up to the makefile to eventually create this directory while performing installation (with ~ substitution). + The standard distribution will put nothing in this directory. + After perl has been installed, users may install their own local + architecture-independent modules in this directory with + MakeMaker Makefile.PL + or equivalent. See INSTALL for details. sitelibexp (sitelib.U): This variable is the ~name expanded version of sitelib, so that you may use it directly in Makefiles or shell scripts. +siteprefix (siteprefix.U): + This variable holds the full absolute path of the directory below + which the user will install add-on packages. + See INSTALL for usage and examples. + +siteprefixexp (siteprefix.U): + This variable holds the full absolute path of the directory below + which the user will install add-on packages. Derived from siteprefix. + sizetype (sizetype.U): This variable defines sizetype to be something like size_t, unsigned long, or whatever type is used to declare length @@ -2329,7 +2968,7 @@ socketlib (d_socket.U): This variable has the names of any libraries needed for socket support. sort (Loc.U): - This variable is be used internally by Configure to determine the + This variable is used internally by Configure to determine the full pathname (if any) of the sort program. After Configure runs, the value is reset to a plain "sort" and is not useful. @@ -2348,6 +2987,54 @@ split (models.U): machines that support separation of instruction and data space. It is up to the Makefile to use this. +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. + +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. + +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. + +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. + +sPRIX64 (quadfio.U): + This variable, if defined, contains the string used by stdio to + format 64-bit hExADECimAl numbers (format 'X') for output. + src (src.U): This variable holds the path to the package source. It is up to the Makefile to use this variable and set VPATH accordingly to @@ -2364,8 +3051,8 @@ startperl (startperl.U): script to make sure (hopefully) that it runs with perl and not some shell. Of course, that leading line must be followed by the classical perl idiom: - eval 'exec perl -S $0 ${1+"$@"}' - if $running_under_some_shell; + eval 'exec perl -S $0 ${1+"$@"}' + if $running_under_some_shell; to guarantee perl startup should the shell execute the script. Note that this magic incatation is not understood by csh. @@ -2408,6 +3095,10 @@ stdio_ptr (d_stdstdio.U): _ptr field (or equivalent) of stdio.h's FILE structure. This will be used to define the macro FILE_ptr(fp). +stdio_stream_array (stdio_streams.U): + This variable tells the name of the array holding the stdio streams. + Usual values include _iob, __iob, and __sF. + strings (i_string.U): This variable holds the full path of the string header that will be used. Typically /usr/include/string.h or /usr/include/strings.h. @@ -2419,6 +3110,7 @@ submit (Loc.U): subversion (patchlevel.U): The subversion level of this package. The value of subversion comes from the patchlevel.h file. + In a version number such as 5.6.1, this is the "1". This is unique to perl. sysman (sysman.U): @@ -2440,12 +3132,11 @@ tbl (Loc.U): The value is a plain '' and is not useful. tee (Loc.U): - This variable is be used internally by Configure to determine the - full pathname (if any) of the tee program. After Configure runs, - the value is reset to a plain "tee" and is not useful. + This variable is defined but not used by Configure. + The value is a plain '' and is not useful. test (Loc.U): - This variable is be used internally by Configure to determine the + This variable is used internally by Configure to determine the full pathname (if any) of the test program. After Configure runs, the value is reset to a plain "test" and is not useful. @@ -2458,12 +3149,12 @@ timetype (d_time.U): included). Anyway, the type Time_t should be used. touch (Loc.U): - This variable is be used internally by Configure to determine the + This variable is used internally by Configure to determine the full pathname (if any) of the touch program. After Configure runs, the value is reset to a plain "touch" and is not useful. tr (Loc.U): - This variable is be used internally by Configure to determine the + This variable is used internally by Configure to determine the full pathname (if any) of the tr program. After Configure runs, the value is reset to a plain "tr" and is not useful. @@ -2477,24 +3168,100 @@ troff (Loc.U): This variable is defined but not used by Configure. The value is a plain '' and is not useful. +u16size (perlxv.U): + This variable is the size of an U16 in bytes. + +u16type (perlxv.U): + This variable contains the C type used for Perl's U16. + +u32size (perlxv.U): + This variable is the size of an U32 in bytes. + +u32type (perlxv.U): + This variable contains the C type used for Perl's U32. + +u64size (perlxv.U): + This variable is the size of an U64 in bytes. + +u64type (perlxv.U): + This variable contains the C type used for Perl's U64. + +u8size (perlxv.U): + This variable is the size of an U8 in bytes. + +u8type (perlxv.U): + This variable contains the C type used for Perl's U8. + +uidformat (uidf.U): + This variable contains the format string used for printing a Uid_t. + +uidsign (uidsign.U): + This variable contains the signedness of a uidtype. + 1 for unsigned, -1 for signed. + +uidsize (uidsize.U): + This variable contains the size of a uidtype in bytes. + uidtype (uidtype.U): This variable defines Uid_t to be something like uid_t, int, ushort, or whatever type is used to declare user ids in the kernel. uname (Loc.U): - This variable is be used internally by Configure to determine the + This variable is used internally by Configure to determine the full pathname (if any) of the uname program. After Configure runs, the value is reset to a plain "uname" and is not useful. uniq (Loc.U): - This variable is be used internally by Configure to determine the + This variable is used internally by Configure to determine the full pathname (if any) of the uniq program. After Configure runs, the value is reset to a plain "uniq" and is not useful. +uquadtype (quadtype.U): + This variable defines Uquad_t to be something like unsigned long, + unsigned int, unsigned long long, uint64_t, or whatever type is + used for 64-bit integers. + +use5005threads (usethreads.U): + This variable conditionally defines the USE_5005THREADS symbol, + and indicates that Perl should be built to use the 5.005-based + threading implementation. + +use64bits (use64bits.U): + This variable conditionally defines the USE_64_BITS symbol, + and indicates that 64-bit integer types should be used + when available. + usedl (dlsrc.U): - This variable indicates if the the system supports dynamic + This variable indicates if the system supports dynamic loading of some sort. See also dlsrc and dlobj. +useithreads (usethreads.U): + This variable conditionally defines the USE_ITHREADS symbol, + and indicates that Perl should be built to use the interpreter-based + threading implementation. + +uselargefiles (uselfs.U): + This variable conditionally defines the USE_LARGE_FILES symbol, + and indicates that large file interfaces should be used when + available. The use64bits symbol will also be turned on if necessary. + +uselongdouble (uselongdbl.U): + This variable conditionally defines the USE_LONG_DOUBLE symbol, + and indicates that long doubles should be used when available. + +uselonglong (uselonglong.U): + This variable conditionally defines the USE_LONG_LONG symbol, + and indicates that long longs should be used when available. + +usemorebits (usemorebits.U): + This variable conditionally defines the USE_MORE_BITS symbol, + and indicates that explicit 64-bit interfaces and long doubles + should be used when available. + +usemultiplicity (usemultiplicity.U): + This variable conditionally defines the MULTIPLICITY symbol, + and indicates that Perl should be built to use multiplicity. + usemymalloc (mallocsrc.U): This variable contains y if the malloc that comes with this package is desired over the system's version of malloc. People often include @@ -2536,10 +3303,18 @@ useshrplib (libperl.U): This variable is set to 'yes' if the user wishes to build a shared libperl, and 'no' otherwise. +usesocks (usesocks.U): + This variable conditionally defines the USE_SOCKS symbol, + and indicates that Perl should be built to use SOCKS. + usethreads (usethreads.U): This variable conditionally defines the USE_THREADS symbol, and indicates that Perl should be built to use threads. +usevendorprefix (vendorprefix.U): + This variable tells whether the vendorprefix + and consequently other vendor* paths are in use. + usevfork (d_vfork.U): This variable is set to true when the user accepts to use vfork. It is set to false when no vfork is available or when the user @@ -2553,12 +3328,65 @@ uuname (Loc.U): This variable is defined but not used by Configure. The value is a plain '' and is not useful. +uvoformat (perlxvf.U): + This variable contains the format string used for printing + a Perl UV as an unsigned octal integer. + +uvsize (perlxv.U): + This variable is the size of a UV in bytes. + +uvtype (perlxv.U): + This variable contains the C type used for Perl's UV. + +uvuformat (perlxvf.U): + This variable contains the format string used for printing + a Perl UV as an unsigned decimal integer. + +uvxformat (perlxvf.U): + This variable contains the format string used for printing + a Perl UV as an unsigned hexadecimal integer. + +vendorbin (vendorbin.U): + This variable contains the eventual value of the VENDORBIN 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 + binaries in this directory with + MakeMaker Makefile.PL INSTALLDIRS=vendor + or equivalent. See INSTALL for details. + +vendorbinexp (vendorbin.U): + This variable is the ~name expanded version of vendorbin, 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. + The standard distribution will put nothing in this directory. + Vendors who distribute perl may wish to place their own + modules in this directory with + MakeMaker Makefile.PL INSTALLDIRS=vendor + or equivalent. See INSTALL for details. + +vendorlibexp (vendorlib.U): + This variable is the ~name expanded version of vendorlib, 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. + See INSTALL for usage and examples. + +vendorprefixexp (vendorprefix.U): + This variable holds the full absolute path of the directory below + which the vendor will install add-on packages. Derived from vendorprefix. + version (patchlevel.U): - The full version number of this package. This combines - baserev, patchlevel, and subversion to get the full - version number, including any possible subversions. Care - is taken to use the C locale in order to get something - like 5.004 instead of 5,004. This is unique to perl. + The full version number of this package, such as 5.6.1 (or 5_6_1). + This combines baserev, patchlevel, and subversion to get the + full version number, including any possible subversions. + This is suitable for use as a directory name, and hence is + filesystem dependent. vi (Loc.U): This variable is defined but not used by Configure. @@ -2569,12 +3397,17 @@ voidflags (voidflags.U): which indicates how much support of the void type is given by this compiler. See VOIDFLAGS for more info. +xlibpth (libpth.U): + This variable holds extra path (space-separated) used to find + libraries on this platform, for example CPU-specific libraries + (on multi-CPU platforms) may be listed here. + zcat (Loc.U): This variable is defined but not used by Configure. The value is a plain '' and is not useful. zip (Loc.U): - This variable is be used internally by Configure to determine the + This variable is used internally by Configure to determine the full pathname (if any) of the zip program. After Configure runs, the value is reset to a plain "zip" and is not useful.