X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=Porting%2FGlossary;h=4f97fab701a5bb86431f6a7a797610e04d0694f1;hb=98eae8f585b9800849b5e5482e2d405f21bab67e;hp=070027b9913de874f21b3b5107e6e8129eec680d;hpb=a71cd7cdf387023b3454db0a31c91c286865db8f;p=p5sagit%2Fp5-mst-13.2.git diff --git a/Porting/Glossary b/Porting/Glossary index 070027b..4f97fab 100644 --- a/Porting/Glossary +++ b/Porting/Glossary @@ -38,16 +38,18 @@ aphostname (d_gethname.U): 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. + MakeMaker will install add-on modules in a directory with the + PERL_APIVERSION version number. The value is set manually in + patchlevel.h. Normally, for maintenance releases, this is + just something like 5.005 or 5.6 or 5.7. That is, it does not + include the subversion number and does not change across + maintenance releases. This is so that add-on extensions can + be shared across maintenance versions. It is unclear how this + ought to work for developer versions. If a release breaks + binary compatibility, this number should be increased. 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 +79,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 +96,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 +109,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 +133,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. @@ -188,7 +194,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. @@ -203,7 +209,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 +218,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. @@ -271,7 +277,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 +298,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 +319,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. @@ -380,25 +400,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 @@ -462,6 +467,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. @@ -500,37 +509,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. @@ -541,34 +531,17 @@ 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_fseeko64 (stdio64.U): - This variable conditionally defines the HAS_FSEEKO64 symbol, which - indicates to the C program that the fseeko64() routine is available. +d_fpos64_t (io64.U): + This symbol will be defined if the C compiler supports fpos64_t. 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): This variable conditionally defines the HAS_FSTATFS symbol, which indicates to the C program that the fstatfs() routine is available. @@ -577,14 +550,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. @@ -594,10 +559,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' @@ -744,6 +705,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 @@ -774,9 +743,6 @@ 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): This symbol will be defined if the C compiler supports int64_t. @@ -798,6 +764,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. @@ -810,10 +781,6 @@ 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. @@ -826,14 +793,6 @@ 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_lstat (d_lstat.U): This variable conditionally defines HAS_LSTAT if lstat() is available to do file stats on symbolic links. @@ -965,10 +924,6 @@ 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. @@ -976,9 +931,6 @@ d_nice (d_nice.U): d_off64_t (io64.U): This symbol will be defined if the C compiler supports off64_t. -d_offset_t (io64.U): - This symbol will be defined if the C compiler supports offset_t. - d_old_pthread_create_joinable (d_pthrattrj.U): This variable conditionally defines pthread_create_joinable. undef if pthread.h defines PTHREAD_CREATE_JOINABLE. @@ -986,7 +938,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): @@ -998,14 +950,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 @@ -1037,6 +981,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 @@ -1074,10 +1067,6 @@ 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_readdir (d_readdir.U): This variable conditionally defines HAS_READDIR if readdir() is available to read directory entries. @@ -1131,10 +1120,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. @@ -1274,6 +1259,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 @@ -1325,10 +1314,6 @@ 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_statblks (d_statblks.U): This variable conditionally defines USE_STAT_BLOCKS if this system has a stat structure declaring @@ -1370,10 +1355,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. @@ -1412,6 +1393,10 @@ d_strtoul (d_strtoul.U): indicates to the C program that the strtoul() routine is available to provide conversion of strings to unsigned long. +d_strtoull (strtoull.U): + This variable conditionally defines the HAS_STRTOULL symbol, which + indicates to the C program that the strtoull() routine is available. + d_strxfrm (d_strxfrm.U): This variable conditionally defines HAS_STRXFRM if strxfrm() is available to transform strings. @@ -1456,10 +1441,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. @@ -1480,14 +1461,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. @@ -1510,6 +1483,9 @@ d_union_semun (d_union_semun.U): This variable conditionally defines HAS_UNION_SEMUN if the union semun is defined by including . +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. @@ -1566,7 +1542,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. @@ -1623,12 +1599,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. @@ -1645,7 +1621,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. @@ -1659,6 +1635,8 @@ 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 @@ -1721,7 +1699,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. @@ -1737,7 +1715,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. @@ -1875,7 +1853,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): @@ -1896,6 +1874,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 @@ -2089,6 +2075,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 @@ -2109,11 +2107,34 @@ installsitelib (sitelib.U): 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 +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. @@ -2147,8 +2168,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. @@ -2192,7 +2218,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. @@ -2236,7 +2262,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. @@ -2259,7 +2285,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. @@ -2320,7 +2346,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. @@ -2335,7 +2361,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. @@ -2355,7 +2381,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. @@ -2417,7 +2443,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. @@ -2437,7 +2463,7 @@ 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. @@ -2515,7 +2541,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. @@ -2534,6 +2560,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. @@ -2596,7 +2637,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. @@ -2625,7 +2666,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. @@ -2748,6 +2789,14 @@ 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. + +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 @@ -2777,7 +2826,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. @@ -2796,6 +2845,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 @@ -2896,7 +2993,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. @@ -2909,12 +3006,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. @@ -2928,17 +3025,21 @@ troff (Loc.U): This variable is defined but not used by Configure. The value is a plain '' and is not useful. +uidsign (uidsign.U): + This variable contains the signedness of a uidtype. + 1 for unsigned, -1 for signed. + 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. @@ -2951,6 +3052,20 @@ usedl (dlsrc.U): This variable indicates if the the system supports dynamic loading of some sort. See also dlsrc and dlobj. +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. + +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. @@ -2996,10 +3111,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 @@ -3013,6 +3136,26 @@ uuname (Loc.U): This variable is defined but not used by Configure. The value is a plain '' and is not useful. +vendorlib (vendorlib.U): + This variable contains the eventual value of the VENDORLIB 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). + Vendors who distribute perl binaries may place their own + extensions and modules in this directory. + +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. + +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 @@ -3034,12 +3177,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.