X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=Porting%2FGlossary;h=71d97f8ea97d7e15ac06a47495285c82153f163f;hb=5bc457ce78ccec3d76158b92af16e3fadd82c224;hp=0b8a099dc7161b0617f0b7b943e21508d162b3cd;hpb=29209bc5efc823322ed539ae434cba1765cb5082;p=p5sagit%2Fp5-mst-13.2.git diff --git a/Porting/Glossary b/Porting/Glossary index 0b8a099..71d97f8 100644 --- a/Porting/Glossary +++ b/Porting/Glossary @@ -26,7 +26,8 @@ afs (afs.U): alignbytes (alignbytes.U): This variable holds the number of bytes required to align a - double. Usual values are 2, 4 and 8. + double-- or a long double when applicable. Usual values are + 2, 4 and 8. The default is eight, for safety. ansi2knr (ansi2knr.U): This variable is set if the user needs to run ansi2knr. @@ -37,17 +38,52 @@ aphostname (d_gethname.U): 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. @@ -77,7 +113,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. @@ -94,6 +130,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. @@ -103,7 +143,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. @@ -127,7 +167,7 @@ castflags (d_castneg.U): 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,8 +194,6 @@ ccflags (ccflags.U): 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): @@ -170,6 +208,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. @@ -188,7 +230,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. @@ -196,6 +238,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 @@ -203,7 +249,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. @@ -212,7 +258,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. @@ -221,9 +267,9 @@ cpp_stuff (cpp_stuff.U): used by the C preprocessor. cppccsymbols (Cppsym.U): - The variable contains the symbols defined by the C compiler when - when it calls cpp. The symbols defined by the cc alone or cpp - alone are not in this list, see ccsymbols and cppsymbols. + The variable contains the symbols defined by both + the bare C compiler and during a compilation that + includes stdio.h. The list is a space-separated list of symbol=value tokens. cppflags (ccflags.U): @@ -255,9 +301,8 @@ cppstdin (cppstdin.U): 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 variable contains the symbols during a compilation + that includes stdio.h. The list is a space-separated list of symbol=value tokens. crosscompile (crosscompile.U): @@ -271,7 +316,7 @@ cryptlib (d_crypt.U): 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. @@ -292,6 +337,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, @@ -305,6 +358,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. @@ -352,10 +411,6 @@ d_closedir (d_closedir.U): This variable conditionally defines HAS_CLOSEDIR if closedir() is available. -d_cmsghdr_s (d_socket.U): - This variable conditionally defines the HAS_STRUCT_CMSGHDR symbol, - which indicates that the the struct cmsghdr is supported. - d_const (d_const.U): This variable conditionally defines the HASCONST symbol, which indicates to the C program that this C compiler knows about the @@ -380,25 +435,10 @@ d_dbl_dig (d_dbl_dig.U): header files provide DBL_DIG, which is the number of significant digits in a double precision number. -d_dbmclose64 (dbm64.U): - This variable conditionally defines the HAS_DBMCLOSE64 symbol, which - indicates to the C program that the dbmclose64() routine is available. - -d_dbminit64 (dbm64.U): - This variable conditionally defines the HAS_DBMINIT64 symbol, which - indicates to the C program that the dbminit64() routine is available. - -d_delete64 (dbm64.U): - This variable conditionally defines the HAS_DELETE64 symbol, which - indicates to the C program that the delete64() routine is available. - d_difftime (d_difftime.U): This variable conditionally defines the HAS_DIFFTIME symbol, which indicates to the C program that the difftime() routine is available. -d_dirent64_s (io64.U): - This symbol will be defined if the C compiler supports struct dirent64. - d_dirnamlen (i_dirent.U): This variable conditionally defines DIRNAMLEN, which indicates to the C program that the length of directory entry names is @@ -504,37 +544,18 @@ d_fds_bits (d_fd_set.U): a half-fast job and neglected to provide the macros to manipulate an fd_set, HAS_FDS_BITS will let us know how to fix the gaffe. -d_fetch64 (dbm64.U): - This variable conditionally defines the HAS_FETCH64 symbol, which - indicates to the C program that the fetch64() routine is available. - -d_fgetpos64 (stdio64.U): - This variable conditionally defines the HAS_FGETPOS64 symbol, which - indicates to the C program that the fgetpos64() routine is available. - d_fgetpos (d_fgetpos.U): This variable conditionally defines HAS_FGETPOS if fgetpos() is available to get the file position indicator. -d_firstkey64 (dbm64.U): - This variable conditionally defines the HAS_FIRSTKEY64 symbol, which - indicates to the C program that the firstkey64() routine is available. - d_flexfnam (d_flexfnam.U): This variable conditionally defines the FLEXFILENAMES symbol, which indicates that the system supports filenames longer than 14 characters. -d_flock64_s (io64.U): - This symbol will be defined if the C compiler supports struct flock64. - d_flock (d_flock.U): This variable conditionally defines HAS_FLOCK if flock() is available to do file locking. -d_fopen64 (stdio64.U): - This variable conditionally defines the HAS_FOPEN64 symbol, which - indicates to the C program that the fopen64() routine is available. - d_fork (d_fork.U): This variable conditionally defines the HAS_FORK symbol, which indicates to the C program that the fork() routine is available. @@ -545,35 +566,22 @@ d_fpathconf (d_pathconf.U): to determine file-system related limits and options associated with a given open file descriptor. -d_freopen64 (stdio64.U): - This variable conditionally defines the HAS_FREOPEN64 symbol, which - indicates to the C program that the freopen64() routine is available. - -d_fseek64 (stdio64.U): - This variable conditionally defines the HAS_FSEEK64 symbol, which - indicates to the C program that the fseek64() routine is available. +d_fpos64_t (d_fpos64_t.U): + This symbol will be defined if the C compiler supports fpos64_t. -d_fseeko64 (stdio64.U): - This variable conditionally defines the HAS_FSEEKO64 symbol, which - indicates to the C program that the fseeko64() routine is available. +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_fsetpos64 (stdio64.U): - This variable conditionally defines the HAS_FSETPOS64 symbol, which - indicates to the C program that the fsetpos64() 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_fstat64 (io64.U): - This variable conditionally defines the HAS_FSTAT64 symbol, which - indicates to the C program that the fstat64() routine is available. - -d_fstatfs (d_statfs.U): +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. @@ -581,14 +589,6 @@ 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_ftell64 (stdio64.U): - This variable conditionally defines the HAS_FTELL64 symbol, which - indicates to the C program that the ftell64() routine is available. - -d_ftello64 (stdio64.U): - This variable conditionally defines the HAS_FTELLO64 symbol, which - indicates to the C program that the ftello64() 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. @@ -598,10 +598,6 @@ d_ftime (d_ftime.U): that the ftime() routine exists. The ftime() routine is basically a sub-second accuracy clock. -d_ftruncate64 (io64.U): - This variable conditionally defines the HAS_FTRUNCATE64 symbol, which - indicates to the C program that the ftruncate64() routine is available. - d_Gconvert (d_gconvert.U): This variable holds what Gconvert is defined as to convert floating point numbers into strings. It could be 'gconvert' @@ -611,6 +607,15 @@ d_Gconvert (d_gconvert.U): d_Gconvert='gcvt((x),(n),(b))' d_Gconvert='sprintf((b),"%.*g",(n),(x))' +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 + to get the current working directory. + +d_getfsstat (d_getfsstat.U): + This variable conditionally defines the HAS_GETFSSTAT symbol, which + indicates to the C program that the getfsstat() routine is available. + 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 @@ -651,10 +656,15 @@ 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 iterate through mounted files to get their mount info. d_getnbyaddr (d_getnbyad.U): This variable conditionally defines the HAS_GETNETBYADDR symbol, which @@ -777,6 +787,10 @@ d_htonl (d_htonl.U): This variable conditionally defines HAS_HTONL if htonl() and its friends are available to do network order byte swapping. +d_iconv (d_iconv.U): + This variable conditionally defines the HAS_ICONV symbol, which + indicates to the C program that the iconv() routine is available. + d_index (d_strchr.U): This variable conditionally defines HAS_INDEX if index() and rindex() are available for string searching. @@ -786,16 +800,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_ino64_t (io64.U): - This symbol will be defined if the C compiler supports ino64_t. - -d_int64t (i_inttypes.U): +d_int64_t (d_int64_t.U): This symbol will be defined if the C compiler supports int64_t. -d_iovec_s (i_sysuio.U): - This variable conditionally defines the HAS_STRUCT_IOVEC symbol, - which indicates that the struct iovec is supported. - d_isascii (d_isascii.U): This variable conditionally defines the HAS_ISASCII constant, which indicates to the C program that isascii() is available. @@ -810,22 +817,19 @@ 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. -d_llseek (io64.U): - This variable conditionally defines the HAS_LLSEEK symbol, which - indicates to the C program that the llseek() routine is available. - d_locconv (d_locconv.U): This variable conditionally defines HAS_LOCALECONV if localeconv() is available for numeric and monetary formatting conventions. -d_lockf64 (io64.U): - This variable conditionally defines the HAS_LOCKF64 symbol, which - indicates to the C program that the lockf64() routine is available. - d_lockf (d_lockf.U): This variable conditionally defines HAS_LOCKF if lockf() is available to do file locking. @@ -838,22 +842,16 @@ d_longlong (d_longlong.U): This variable conditionally defines HAS_LONG_LONG if the long long type is supported. -d_lseek64 (io64.U): - This variable conditionally defines the HAS_LSEEK64 symbol, which - indicates to the C program that the lseek64() routine is available. - -d_lstat64 (io64.U): - This variable conditionally defines the HAS_LSTAT64 symbol, which - indicates to the C program that the lstat64() routine is available. +d_lseekproto (d_lseekproto.U): + This variable conditionally defines the HAS_LSEEK_PROTO symbol, + which indicates to the C program that the system provides + a prototype for the lseek() function. Otherwise, it is + up to the program to supply one. d_lstat (d_lstat.U): This variable conditionally defines HAS_LSTAT if lstat() is available to do file stats on symbolic links. -d_madvise (d_madvise.U): - This variable conditionally defines HAS_MADVISE if madvise() is - available to map a file into memory. - 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 @@ -899,10 +897,26 @@ d_mkdir (d_mkdir.U): indicates to the C program that the mkdir() routine is available to create directories.. +d_mkdtemp (d_mkdtemp.U): + This variable conditionally defines the HAS_MKDTEMP symbol, which + indicates to the C program that the mkdtemp() routine is available + to exclusively create a uniquely named temporary directory. + d_mkfifo (d_mkfifo.U): This variable conditionally defines the HAS_MKFIFO symbol, which indicates to the C program that the mkfifo() routine is available. +d_mkstemp (d_mkstemp.U): + This variable conditionally defines the HAS_MKSTEMP symbol, which + indicates to the C program that the mkstemp() routine is available + to exclusively create and open a uniquely named temporary file. + +d_mkstemps (d_mkstemps.U): + This variable conditionally defines the HAS_MKSTEMPS symbol, which + indicates to the C program that the mkstemps() routine is available + to exclusively create and open a uniquely named (with a suffix) + temporary file. + d_mktime (d_mktime.U): This variable conditionally defines the HAS_MKTIME symbol, which indicates to the C program that the mktime() routine is available. @@ -952,10 +966,6 @@ d_msgget (d_msgget.U): This variable conditionally defines the HAS_MSGGET symbol, which indicates to the C program that the msgget() routine is available. -d_msghdr_s (d_socket.U): - This variable conditionally defines the HAS_STRUCT_MSGHDR symbol, - which indicates that the struct msghdr is supported. - d_msgrcv (d_msgrcv.U): This variable conditionally defines the HAS_MSGRCV symbol, which indicates to the C program that the msgrcv() routine is available. @@ -977,19 +987,16 @@ d_mymalloc (mallocsrc.U): of the source want to take special action if MYMALLOC is used. This may include different sorts of profiling or error detection. -d_nextkey64 (dbm64.U): - This variable conditionally defines the HAS_NEXTKEY64 symbol, which - indicates to the C program that the nextkey64() routine is available. - 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_nv_preserves_uv (perlxv.U): + This variable indicates whether a variable of type nvtype + can preserve all the bits a variable of type uvtype. -d_offset_t (io64.U): - This symbol will be defined if the C compiler supports offset_t. +d_off64_t (d_off64_t.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. @@ -998,7 +1005,7 @@ d_old_pthread_create_joinable (d_pthrattrj.U): 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): @@ -1010,14 +1017,6 @@ d_open3 (d_open3.U): which indicates to the C program that the 3 argument version of the open(2) function is available. -d_open64 (io64.U): - This variable conditionally defines the HAS_OPEN64 symbol, which - indicates to the C program that the open64() routine is available. - -d_opendir64 (io64.U): - This variable conditionally defines the HAS_OPENDIR64 symbol, which - indicates to the C program that the opendir64() routine is available. - d_pathconf (d_pathconf.U): This variable conditionally defines the HAS_PATHCONF symbol, which indicates to the C program that the pathconf() routine is available @@ -1049,6 +1048,55 @@ 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 @@ -1086,9 +1134,9 @@ d_pwquota (i_pwd.U): This variable conditionally defines PWQUOTA, which indicates that struct passwd contains pw_quota. -d_readdir64 (io64.U): - This variable conditionally defines the HAS_READDIR64 symbol, which - indicates to the C program that the readdir64() 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 @@ -1099,14 +1147,6 @@ d_readlink (d_readlink.U): indicates to the C program that the readlink() routine is available to read the value of a symbolic link. -d_readv (d_readv.U): - This variable conditionally defines the HAS_READV symbol, which - indicates to the C program that the readv() routine is available. - -d_recvmsg (d_socket.U): - This variable conditionally defines the HAS_RECVMSG symbol, - which indicates that the recvmsg is supported. - d_rename (d_rename.U): This variable conditionally defines the HAS_RENAME symbol, which indicates to the C program that the rename() routine is available @@ -1143,10 +1183,6 @@ d_scm_rights (d_socket.U): 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_seekdir64 (io64.U): - This variable conditionally defines the HAS_SEEKDIR64 symbol, which - indicates to the C program that the seekdir64() routine is available. - d_seekdir (d_readdir.U): This variable conditionally defines HAS_SEEKDIR if seekdir() is available. @@ -1180,10 +1216,6 @@ d_semop (d_semop.U): This variable conditionally defines the HAS_SEMOP symbol, which indicates to the C program that the semop() routine is available. -d_sendmsg (d_socket.U): - This variable conditionally defines the HAS_SENDMSG symbol, - which indicates that the sendmsg is supported. - d_setegid (d_setegid.U): This variable conditionally defines the HAS_SETEGID symbol, which indicates to the C program that the setegid() routine is available @@ -1337,29 +1369,32 @@ d_socket (d_socket.U): This variable conditionally defines HAS_SOCKET, which indicates that the BSD socket interface is supported. +d_socklen_t (d_socklen_t.U): + This symbol will be defined if the C compiler supports socklen_t. + d_sockpair (d_socket.U): This variable conditionally defines the HAS_SOCKETPAIR symbol, which indicates that the BSD socketpair() is supported. -d_stat64 (io64.U): - This variable conditionally defines the HAS_STAT64 symbol, which - indicates to the C program that the stat64() routine is available. +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. -d_statfs (d_statfs.U): - This variable conditionally defines the HAS_STATFS symbol, which - indicates to the C program that the statfs() routine is available. - -d_statfsflags (d_statfs.U): - This variable conditionally defines the HAS_STRUCT_STATFS_FLAGS +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. @@ -1386,10 +1421,6 @@ d_stdstdio (d_stdstdio.U): has a FILE structure declaring usable _ptr and _cnt fields (or equivalent) in stdio.h. -d_store64 (dbm64.U): - This variable conditionally defines the HAS_STORE64 symbol, which - indicates to the C program that the store64() routine is available. - d_strchr (d_strchr.U): This variable conditionally defines HAS_STRCHR if strchr() and strrchr() are available for string searching. @@ -1423,11 +1454,27 @@ 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_strtoll (d_strtoll.U): + This variable conditionally defines the HAS_STRTOLL symbol, which + indicates to the C program that the strtoll() 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. @@ -1472,10 +1519,6 @@ d_tcsetpgrp (d_tcstpgrp.U): indicates to the C program that the tcsetpgrp() routine is available to set foreground process group ID. -d_telldir64 (io64.U): - This variable conditionally defines the HAS_TELLDIR64 symbol, which - indicates to the C program that the telldir64() routine is available. - d_telldir (d_readdir.U): This variable conditionally defines HAS_TELLDIR if telldir() is available. @@ -1496,14 +1539,6 @@ d_times (d_times.U): that the times() routine exists. The times() routine is normaly provided on UNIX systems. You may have to include . -d_tmpfile64 (stdio64.U): - This variable conditionally defines the HAS_TMPFILE64 symbol, which - indicates to the C program that the tmpfile64() routine is available. - -d_truncate64 (io64.U): - This variable conditionally defines the HAS_TRUNCATE64 symbol, which - indicates to the C program that the truncate64() routine is available. - d_truncate (d_truncate.U): This variable conditionally defines HAS_TRUNCATE if truncate() is available to truncate files. @@ -1526,6 +1561,16 @@ 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. @@ -1573,16 +1618,12 @@ d_wctomb (d_wctomb.U): indicates to the C program that the wctomb() routine is available to convert a wide character to a multibyte. -d_writev (d_writev.U): - This variable conditionally defines the HAS_WRITEV symbol, which - indicates to the C program that the writev() routine is available. - d_xenix (Guess.U): This variable conditionally defines the symbol XENIX, which alerts 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. @@ -1639,12 +1680,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. @@ -1661,7 +1702,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. @@ -1696,8 +1737,11 @@ 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): @@ -1728,6 +1772,16 @@ 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 @@ -1739,7 +1793,7 @@ glibpth (libpth.U): 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. @@ -1747,6 +1801,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, @@ -1755,7 +1811,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. @@ -1775,6 +1831,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 @@ -1782,6 +1840,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 . @@ -1832,6 +1914,10 @@ i_grp (i_grp.U): This variable conditionally defines the I_GRP symbol, and indicates whether a C program should include . +i_iconv (i_iconv.U): + This variable conditionally defines the I_ICONV 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 . @@ -1893,7 +1979,7 @@ i_poll (i_poll.U): whether a C program should include . i_pthread (i_pthread.U): - This variable conditionally defines the I_PTHREADEAD symbol, + This variable conditionally defines the I_PTHREAD symbol, and indicates whether a C program should include . i_pwd (i_pwd.U): @@ -1968,10 +2054,18 @@ i_sysioctl (i_sysioctl.U): indicates to the C program that exists and should be included. +i_syslog (i_syslog.U): + This variable conditionally defines the I_SYSLOG symbol, + and indicates whether a C program should include . + i_sysmman (i_sysmman.U): This variable conditionally defines the I_SYS_MMAN symbol, and indicates whether a C program should include . +i_sysmode (i_sysmode.U): + This variable conditionally defines the I_SYSMODE symbol, + and indicates whether a C program should include . + i_sysmount (i_sysmount.U): This variable conditionally defines the I_SYSMOUNT symbol, and indicates whether a C program should include . @@ -2006,6 +2100,10 @@ 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 . @@ -2036,6 +2134,14 @@ i_sysun (i_sysun.U): to the C program that it should include to get UNIX domain socket definitions. +i_sysutsname (i_sysutsname.U): + This variable conditionally defines the I_SYSUTSNAME symbol, + and indicates whether a C program should include . + +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 . @@ -2058,6 +2164,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 . @@ -2084,6 +2194,21 @@ ignore_versioned_solibs (libs.U): 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. The elements in + the list are separated by spaces. 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. + +inc_version_list_init (inc_version_list.U): + This variable holds the same list as inc_version_list, but + each item is enclosed in double quotes and separated by commas, + suitable for use in the PERL_INC_VERSION_LIST initialization. + 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". @@ -2115,6 +2240,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 @@ -2130,20 +2267,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. @@ -2173,8 +2353,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. @@ -2200,6 +2385,21 @@ libs (libs.U): This variable holds the additional libraries we want to use. It is up to the Makefile to deal with it. +libsdirs (libs.U): + This variable holds the directory names aka dirnames of the libraries + we found and accepted, duplicates are removed. + +libsfiles (libs.U): + This variable holds the filenames aka basenames of the libraries + we found and accepted. + +libsfound (libs.U): + This variable holds the full pathnames of the libraries + we found and accepted. + +libspath (libs.U): + This variable holds the directory names probed for libraries. + libswanted (Myinit.U): This variable holds a list of all the libraries we want to search. The order is chosen to pick up the c library @@ -2218,7 +2418,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. @@ -2262,7 +2462,7 @@ 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. @@ -2285,7 +2485,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. @@ -2346,7 +2546,7 @@ man3ext (man3dir.U): See man3dir. Mcc (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 Mcc program. After Configure runs, the value is reset to a plain "Mcc" and is not useful. @@ -2361,7 +2561,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. @@ -2381,7 +2581,7 @@ 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. @@ -2443,7 +2643,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. @@ -2463,10 +2663,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 @@ -2519,19 +2725,42 @@ 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 "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. +perl5 (perl5.U): + This variable contains the full path (if any) to a previously + installed perl5.005 or later suitable for running the script + to determine inc_version_list. + perl (Loc.U): This variable is defined but not used by Configure. The value is a plain '' 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. @@ -2541,7 +2770,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. @@ -2560,6 +2789,21 @@ plibpth (libpth.U): 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. @@ -2597,6 +2841,14 @@ 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. +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. @@ -2621,8 +2873,13 @@ rd_nodata (nblock_io.U): used, which is a shame because you cannot make the difference between no data and an EOF.. Sigh! +revision (patchlevel.U): + The value of revision comes from the patchlevel.h file. + In a version number such as 5.6.1, this is the "5". + In patchlevel.h, this is referred to as "PERL_REVISION". + 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. @@ -2651,7 +2908,7 @@ 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. @@ -2759,21 +3016,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 @@ -2802,8 +3093,13 @@ sockethdr (d_socket.U): socketlib (d_socket.U): This variable has the names of any libraries needed for socket support. +socksizetype (socksizetype.U): + This variable holds the type used for the size argument + for various socket calls like accept. Usual values include + socklen_t, size_t, and int. + 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. @@ -2822,6 +3118,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 @@ -2897,6 +3241,8 @@ 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". + In patchlevel.h, this is referred to as "PERL_SUBVERSION". This is unique to perl. sysman (sysman.U): @@ -2922,7 +3268,7 @@ tee (Loc.U): 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. @@ -2935,12 +3281,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. @@ -2954,29 +3300,105 @@ 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. -use64bits (use64bits.U): - This variable conditionally defines the USE_64_BITS symbol, - and indicates that explicit 64-bit interfaces should be used - when available. +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. + +use64bitall (use64bits.U): + This variable conditionally defines the USE_64_BIT_ALL symbol, + and indicates that 64-bit integer types should be used + when available. The maximal possible + 64-bitness is employed: LP64 or ILP64, meaning that you will + be able to use more than 2 gigabytes of memory. This mode is + even more binary incompatible than USE_64_BIT_INT. You may not + be able to run the resulting executable in a 32-bit CPU at all or + you may need at least to reboot your OS to 64-bit mode. + +use64bitint (use64bits.U): + This variable conditionally defines the USE_64_BIT_INT symbol, + and indicates that 64-bit integer types should be used + when available. The minimal possible 64-bitness + is employed, just enough to get 64-bit integers into Perl. + This may mean using for example "long longs", while your memory + may still be limited to 2 gigabytes. 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. + +uselongdouble (uselongdbl.U): + This variable conditionally defines the USE_LONG_DOUBLE symbol, + and indicates that long doubles 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. @@ -3030,6 +3452,10 @@ 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 @@ -3043,12 +3469,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 revision, 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. @@ -3064,12 +3543,29 @@ xlibpth (libpth.U): 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 (such as + bincompat) 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. + 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.