X-Git-Url: https://perl5.git.perl.org/perl5.git/blobdiff_plain/8c99d73ee7ce90de2561496f683f3850d1269e1d..6cf89afa34f7978c2a9aa74aacf9a7b22c527281:/Porting/Glossary diff --git a/Porting/Glossary b/Porting/Glossary index 2c948b8..a706e72 100644 --- a/Porting/Glossary +++ b/Porting/Glossary @@ -24,6 +24,12 @@ afs (afs.U): with a hint value or command line option, but you'd better know what you are doing. +afsroot (afs.U): + This variable is by default set to '/afs'. In the unlikely case + this is not the correct root, it is possible to override this with + a hint value or command line option. This will be used in subsequent + tests for AFSness in the Perl configure and test process. + alignbytes (alignbytes.U): This variable holds the number of bytes required to align a double-- or a long double when applicable. Usual values are @@ -131,16 +137,17 @@ bin (bin.U): 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. + This variable contains y if this version of Perl 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. bison (Loc.U): - This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + This variable is used internally by Configure to determine the + full pathname (if any) of the bison program. After Configure runs, + the value is reset to a plain "bison" and is not useful. byacc (Loc.U): This variable is used internally by Configure to determine the @@ -174,7 +181,8 @@ cat (Loc.U): cc (cc.U): This variable holds the name of a command to execute a C compiler which can resolve multiple global references that happen to have the same - name. Usual values are 'cc', 'Mcc', 'cc -M', and 'gcc'. + name. Usual values are 'cc' and 'gcc'. + Fervent ANSI compilers may be called 'c89'. AIX has xlc. cccdlflags (dlsrc.U): This variable contains any special flags that might need to be @@ -192,12 +200,28 @@ ccflags (ccflags.U): This variable contains any additional C compiler flags desired by the user. It is up to the Makefile to use this. +ccflags_uselargefiles (uselfs.U): + This variable contains the compiler flags needed by large file builds + and added to ccflags by hints files. + +ccname (Checkcc.U): + This can set either by hints files or by Configure. If using + gcc, this is gcc, and if not, usually equal to cc, unimpressive, no? + Some platforms, however, make good use of this by storing the + flavor of the C compiler being used here. For example if using + the Sun WorkShop suite, ccname will be 'workshop'. + 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. +ccversion (Checkcc.U): + This can set either by hints files or by Configure. If using + a (non-gcc) vendor cc, this variable may contain a version for + the compiler. + cf_by (cf_who.U): Login name of the person who ran the Configure script and answered the questions. This is used to tag both config.sh and config_h.SH. @@ -219,8 +243,9 @@ chgrp (Loc.U): The value is a plain '' and is not useful. chmod (Loc.U): - This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + This variable is used internally by Configure to determine the + full pathname (if any) of the chmod program. After Configure runs, + the value is reset to a plain "chmod" and is not useful. chown (Loc.U): This variable is defined but not used by Configure. @@ -240,10 +265,6 @@ 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 @@ -308,11 +329,6 @@ cppsymbols (Cppsym.U): not in this list, see ccsymbols and cppccsymbols. The list is a space-separated list of symbol=value tokens. -crosscompile (crosscompile.U): - This variable conditionally defines the CROSSCOMPILE symbol - which signifies that the build process is be a cross-compilation. - This is normally set by hints files or from Configure command line. - cryptlib (d_crypt.U): This variable holds -lcrypt or the path to a libcrypt.a archive if the crypt() function is not defined in the standard C library. It is @@ -323,6 +339,10 @@ csh (Loc.U): full pathname (if any) of the csh program. After Configure runs, the value is reset to a plain "csh" and is not useful. +d__fwalk (d__fwalk.U): + This variable conditionally defines HAS__FWALK if _fwalk() is + available to apply a function to all the file handles. + d_access (d_access.U): This variable conditionally defines HAS_ACCESS if the access() system call is available to check for access permissions using real IDs. @@ -363,9 +383,10 @@ d_bcopy (d_bcopy.U): 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. + can take special action if this version of Perl 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 @@ -410,10 +431,18 @@ d_chsize (d_chsize.U): indicates to the C program that the chsize() routine is available to truncate files. You might need a -lx to get this routine. +d_class (d_class.U): + This variable conditionally defines the HAS_CLASS symbol, which + indicates to the C program that the class() routine is available. + d_closedir (d_closedir.U): This variable conditionally defines HAS_CLOSEDIR if closedir() is available. +d_cmsghdr_s (d_cmsghdr_s.U): + This variable conditionally defines the HAS_STRUCT_CMSGHDR symbol, + which indicates that 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 @@ -438,6 +467,12 @@ 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_dbminitproto (d_dbminitproto.U): + This variable conditionally defines the HAS_DBMINIT_PROTO symbol, + which indicates to the C program that the system provides + a prototype for the dbminit() function. Otherwise, it is + up to the program to supply one. + 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. @@ -505,10 +540,6 @@ 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. @@ -517,6 +548,10 @@ d_eunice (Guess.U): This variable conditionally defines the symbols EUNICE and VAX, which alerts the C program that it must deal with ideosyncracies of VMS. +d_fchdir (d_fchdir.U): + This variable conditionally defines the HAS_FCHDIR symbol, which + indicates to the C program that the fchdir() routine is available. + d_fchmod (d_fchmod.U): This variable conditionally defines the HAS_FCHMOD symbol, which indicates to the C program that the fchmod() routine is available @@ -531,6 +566,10 @@ d_fcntl (d_fcntl.U): This variable conditionally defines the HAS_FCNTL symbol, and indicates whether the fcntl() function exists +d_fcntl_can_lock (d_fcntl_can_lock.U): + This variable conditionally defines the FCNTL_CAN_LOCK symbol + and indicates whether file locking with fcntl() works. + d_fd_macros (d_fd_set.U): This variable contains the eventual value of the HAS_FD_MACROS symbol, which indicates if your C compiler knows about the macros which @@ -551,6 +590,14 @@ d_fgetpos (d_fgetpos.U): This variable conditionally defines HAS_FGETPOS if fgetpos() is available to get the file position indicator. +d_finite (d_finite.U): + This variable conditionally defines the HAS_FINITE symbol, which + indicates to the C program that the finite() routine is available. + +d_finitel (d_finitel.U): + This variable conditionally defines the HAS_FINITEL symbol, which + indicates to the C program that the finitel() 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. @@ -559,19 +606,45 @@ d_flock (d_flock.U): This variable conditionally defines HAS_FLOCK if flock() is available to do file locking. +d_flockproto (d_flockproto.U): + This variable conditionally defines the HAS_FLOCK_PROTO symbol, + which indicates to the C program that the system provides + a prototype for the flock() function. Otherwise, it is + up to the program to supply one. + 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. +d_fp_class (d_fp_class.U): + This variable conditionally defines the HAS_FP_CLASS symbol, which + indicates to the C program that the fp_class() routine is available. + d_fpathconf (d_pathconf.U): This variable conditionally defines the HAS_FPATHCONF symbol, which indicates to the C program that the pathconf() routine is available to determine file-system related limits and options associated with a given open file descriptor. +d_fpclass (d_fpclass.U): + This variable conditionally defines the HAS_FPCLASS symbol, which + indicates to the C program that the fpclass() routine is available. + +d_fpclassify (d_fpclassify.U): + This variable conditionally defines the HAS_FPCLASSIFY symbol, which + indicates to the C program that the fpclassify() routine is available. + +d_fpclassl (d_fpclassl.U): + This variable conditionally defines the HAS_FPCLASSL symbol, which + indicates to the C program that the fpclassl() routine is available. + d_fpos64_t (d_fpos64_t.U): This symbol will be defined if the C compiler supports fpos64_t. +d_frexpl (d_frexpl.U): + This variable conditionally defines the HAS_FREXPL symbol, which + indicates to the C program that the frexpl() 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. @@ -592,6 +665,10 @@ 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_fsync (d_fsync.U): + This variable conditionally defines the HAS_FSYNC symbol, which + indicates to the C program that the fsync() 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. @@ -615,6 +692,10 @@ d_getcwd (d_getcwd.U): indicates to the C program that the getcwd() routine is available to get the current working directory. +d_getespwnam (d_getespwnam.U): + This variable conditionally defines HAS_GETESPWNAM if getespwnam() is + available to retrieve enchanced (shadow) password entries by name. + 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. @@ -654,6 +735,10 @@ d_gethostprotos (d_gethostprotos.U): prototypes for the various gethost*() functions. See also netdbtype.U for probing for various netdb types. +d_getitimer (d_getitimer.U): + This variable conditionally defines the HAS_GETITIMER symbol, which + indicates to the C program that the getitimer() routine is available. + d_getlogin (d_getlogin.U): This variable conditionally defines the HAS_GETLOGIN symbol, which indicates to the C program that the getlogin() routine is available @@ -689,6 +774,10 @@ d_getnetprotos (d_getnetprotos.U): prototypes for the various getnet*() functions. See also netdbtype.U for probing for various netdb types. +d_getpagsz (d_getpagsz.U): + This variable conditionally defines HAS_GETPAGESIZE if getpagesize() + is available to get the system page size. + d_getpbyname (d_getprotby.U): This variable conditionally defines the HAS_GETPROTOBYNAME symbol, which indicates to the C program that the @@ -734,6 +823,10 @@ d_getprotoprotos (d_getprotoprotos.U): prototypes for the various getproto*() functions. See also netdbtype.U for probing for various netdb types. +d_getprpwnam (d_getprpwnam.U): + This variable conditionally defines HAS_GETPRPWNAM if getprpwnam() is + available to retrieve protected (shadow) password entries by name. + d_getpwent (d_getpwent.U): This variable conditionally defines the HAS_GETPWENT symbol, which indicates to the C program that the getpwent() routine is available @@ -761,10 +854,6 @@ 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. @@ -810,6 +899,22 @@ d_isascii (d_isascii.U): This variable conditionally defines the HAS_ISASCII constant, which indicates to the C program that isascii() is available. +d_isfinite (d_isfinite.U): + This variable conditionally defines the HAS_ISFINITE symbol, which + indicates to the C program that the isfinite() routine is available. + +d_isinf (d_isinf.U): + This variable conditionally defines the HAS_ISINF symbol, which + indicates to the C program that the isinf() routine is available. + +d_isnan (d_isnan.U): + This variable conditionally defines the HAS_ISNAN symbol, which + indicates to the C program that the isnan() routine is available. + +d_isnanl (d_isnanl.U): + This variable conditionally defines the HAS_ISNANL symbol, which + indicates to the C program that the isnanl() routine is available. + d_killpg (d_killpg.U): This variable conditionally defines the HAS_KILLPG symbol, which indicates to the C program that the killpg() routine is available @@ -932,6 +1037,17 @@ d_mmap (d_mmap.U): This variable conditionally defines HAS_MMAP if mmap() is available to map a file into memory. +d_modfl (d_modfl.U): + This variable conditionally defines the HAS_MODFL symbol, which + indicates to the C program that the modfl() routine is available. + +d_modfl_pow32_bug (d_modfl.U): + This variable conditionally defines the HAS_MODFL_POW32_BUG symbol, + which indicates that modfl() is broken for long doubles >= pow(2, 32). + For example from 4294967303.150000 one would get 4294967302.000000 + and 1.150000. The bug has been seen in certain versions of glibc, + release 2.2.2 is known to be okay. + d_mprotect (d_mprotect.U): This variable conditionally defines HAS_MPROTECT if mprotect() is available to modify the access protection of a memory mapped file. @@ -973,6 +1089,10 @@ 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_msghdr_s.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. @@ -998,10 +1118,18 @@ 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_nl_langinfo (d_nl_langinfo.U): + This variable conditionally defines the HAS_NL_LANGINFO symbol, which + indicates to the C program that the nl_langinfo() routine is available. + 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_nv_preserves_uv_bits (perlxv.U): + This variable indicates how many of bits type uvtype + a variable nvtype can preserve. + d_off64_t (d_off64_t.U): This symbol will be defined if the C compiler supports off64_t. @@ -1035,6 +1163,11 @@ d_pause (d_pause.U): indicates to the C program that the pause() routine is available to suspend a process until a signal is received. +d_perl_otherlibdirs (otherlibdirs.U): + This variable conditionally defines PERL_OTHERLIBDIRS, which + contains a colon-separated set of paths for the perl binary to + include in @INC. See also otherlibdirs. + d_phostname (d_gethname.U): This variable conditionally defines the HAS_PHOSTNAME symbol, which contains the shell command which, when fed to popen(), may be @@ -1060,28 +1193,34 @@ d_PRId64 (quadfio.U): 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 + This variable conditionally defines the PERL_PRIfldbl 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 +d_PRIEUldbl (longdblfio.U): + This variable conditionally defines the PERL_PRIfldbl symbol, which indiciates that stdio has a symbol to print long doubles. + The 'U' in the name is to separate this from d_PRIeldbl so that even + case-blind systems can see the difference. d_PRIfldbl (longdblfio.U): - This variable conditionally defines the PERL_PRIfldlbl symbol, which + This variable conditionally defines the PERL_PRIfldbl symbol, which indiciates that stdio has a symbol to print long doubles. -d_PRIFldbl (longdblfio.U): - This variable conditionally defines the PERL_PRIfldlbl symbol, which +d_PRIFUldbl (longdblfio.U): + This variable conditionally defines the PERL_PRIfldbl symbol, which indiciates that stdio has a symbol to print long doubles. + The 'U' in the name is to separate this from d_PRIfldbl so that even + case-blind systems can see the difference. d_PRIgldbl (longdblfio.U): - This variable conditionally defines the PERL_PRIfldlbl symbol, which + This variable conditionally defines the PERL_PRIfldbl symbol, which indiciates that stdio has a symbol to print long doubles. -d_PRIGldbl (longdblfio.U): - This variable conditionally defines the PERL_PRIfldlbl symbol, which +d_PRIGUldbl (longdblfio.U): + This variable conditionally defines the PERL_PRIfldbl symbol, which indiciates that stdio has a symbol to print long doubles. + The 'U' in the name is to separate this from d_PRIgldbl so that even + case-blind systems can see the difference. d_PRIi64 (quadfio.U): This variable conditionally defines the PERL_PRIi64 symbol, which @@ -1100,9 +1239,16 @@ 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 +d_PRIXU64 (quadfio.U): + This variable conditionally defines the PERL_PRIXU64 symbol, which indiciates that stdio has a symbol to print 64-bit hExADECimAl numbers. + The 'U' in the name is to separate this from d_PRIx64 so that even + case-blind systems can see the difference. + +d_pthread_atfork (d_pthread_atfork.U): + This variable conditionally defines the HAS_PTHREAD_ATFORK symbol, + which indicates to the C program that the pthread_atfork() + routine is available. d_pthread_yield (d_pthread_y.U): This variable conditionally defines the HAS_PTHREAD_YIELD @@ -1158,6 +1304,14 @@ 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_recvmsg.U): + This variable conditionally defines the HAS_RECVMSG symbol, which + indicates to the C program that the recvmsg() routine is available. + 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 @@ -1173,17 +1327,25 @@ d_rmdir (d_rmdir.U): d_safebcpy (d_safebcpy.U): This variable conditionally defines the HAS_SAFE_BCOPY symbol if - the bcopy() routine can do overlapping copies. + the bcopy() routine can do overlapping copies. Normally, you + should probably use memmove(). d_safemcpy (d_safemcpy.U): This variable conditionally defines the HAS_SAFE_MEMCPY symbol if the memcpy() routine can do overlapping copies. + For overlapping copies, memmove() should be used, if available. d_sanemcmp (d_sanemcmp.U): This variable conditionally defines the HAS_SANE_MEMCMP symbol if the memcpy() routine is available and can be used to compare relative magnitudes of chars with their high bits set. +d_sbrkproto (d_sbrkproto.U): + This variable conditionally defines the HAS_SBRK_PROTO symbol, + which indicates to the C program that the system provides + a prototype for the sbrk() function. Otherwise, it is + up to the program to supply one. + d_sched_yield (d_pthread_y.U): This variable conditionally defines the HAS_SCHED_YIELD symbol if the sched_yield routine is available to yield @@ -1194,6 +1356,10 @@ 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_SCNfldbl (longdblfio.U): + This variable conditionally defines the PERL_PRIfldbl symbol, which + indiciates that stdio has a symbol to scan long doubles. + d_seekdir (d_readdir.U): This variable conditionally defines HAS_SEEKDIR if seekdir() is available. @@ -1227,6 +1393,10 @@ 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_sendmsg.U): + This variable conditionally defines the HAS_SENDMSG symbol, which + indicates to the C program that the sendmsg() routine is available. + 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 @@ -1251,6 +1421,10 @@ d_sethent (d_sethent.U): This variable conditionally defines HAS_SETHOSTENT if sethostent() is available. +d_setitimer (d_setitimer.U): + This variable conditionally defines the HAS_SETITIMER symbol, which + indicates to the C program that the setitimer() routine is available. + d_setlinebuf (d_setlnbuf.U): This variable conditionally defines the HAS_SETLINEBUF symbol, which indicates to the C program that the setlinebuf() routine is available @@ -1286,6 +1460,11 @@ d_setprior (d_setprior.U): This variable conditionally defines HAS_SETPRIORITY if setpriority() is available to set a process's priority. +d_setproctitle (d_setproctitle.U): + This variable conditionally defines the HAS_SETPROCTITLE symbol, + which indicates to the C program that the setproctitle() routine + is available. + d_setpwent (d_setpwent.U): This variable conditionally defines the HAS_SETPWENT symbol, which indicates to the C program that the setpwent() routine is available @@ -1329,10 +1508,6 @@ 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 @@ -1371,11 +1546,26 @@ d_sigaction (d_sigaction.U): This variable conditionally defines the HAS_SIGACTION symbol, which indicates that the Vr4 sigaction() routine is available. +d_sigprocmask (d_sigprocmask.U): + This variable conditionally defines HAS_SIGPROCMASK + if sigprocmask() is available to examine or change the signal mask + of the calling process. + d_sigsetjmp (d_sigsetjmp.U): This variable conditionally defines the HAS_SIGSETJMP symbol, which indicates that the sigsetjmp() routine is available to call setjmp() and optionally save the process's signal mask. +d_sockatmark (d_sockatmark.U): + This variable conditionally defines the HAS_SOCKATMARK symbol, which + indicates to the C program that the sockatmark() routine is available. + +d_sockatmarkproto (d_sockatmarkproto.U): + This variable conditionally defines the HAS_SOCKATMARK_PROTO symbol, + which indicates to the C program that the system provides + a prototype for the sockatmark() function. Otherwise, it is + up to the program to supply one. + d_socket (d_socket.U): This variable conditionally defines HAS_SOCKET, which indicates that the BSD socket interface is supported. @@ -1387,10 +1577,26 @@ d_sockpair (d_socket.U): This variable conditionally defines the HAS_SOCKETPAIR symbol, which indicates that the BSD socketpair() is supported. +d_socks5_init (d_socks5_init.U): + This variable conditionally defines the HAS_SOCKS5_INIT symbol, which + indicates to the C program that the socks5_init() 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_sresgproto (d_sresgproto.U): + This variable conditionally defines the HAS_SETRESGID_PROTO symbol, + which indicates to the C program that the system provides + a prototype for the setresgid() function. Otherwise, it is + up to the program to supply one. + +d_sresuproto (d_sresuproto.U): + This variable conditionally defines the HAS_SETRESUID_PROTO symbol, + which indicates to the C program that the system provides + a prototype for the setresuid() function. Otherwise, it is + up to the program to supply one. + d_statblks (d_statblks.U): This variable conditionally defines USE_STAT_BLOCKS if this system has a stat structure declaring @@ -1418,6 +1624,15 @@ d_stdio_ptr_lval (d_stdstdio.U): This variable conditionally defines STDIO_PTR_LVALUE if the FILE_ptr macro can be used as an lvalue. +d_stdio_ptr_lval_nochange_cnt (d_stdstdio.U): + This symbol is defined if using the FILE_ptr macro as an lvalue + to increase the pointer by n leaves File_cnt(fp) unchanged. + +d_stdio_ptr_lval_sets_cnt (d_stdstdio.U): + This symbol is defined if using the FILE_ptr macro as an lvalue + to increase the pointer by n has the side effect of decreasing the + value of File_cnt(fp) by n. + d_stdio_stream_array (stdio_streams.U): This variable tells whether there is an array holding the stdio streams. @@ -1455,6 +1670,10 @@ d_strerror (d_strerror.U): This variable conditionally defines HAS_STRERROR if strerror() is available to translate error numbers to strings. +d_strftime (d_strftime.U): + This variable conditionally defines the HAS_STRFTIME symbol, which + indicates to the C program that the strftime() routine is available. + d_strtod (d_strtod.U): This variable conditionally defines the HAS_STRTOD symbol, which indicates to the C program that the strtod() routine is available @@ -1473,6 +1692,10 @@ 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_strtoq (d_strtoq.U): + This variable conditionally defines the HAS_STRTOQ symbol, which + indicates to the C program that the strtoq() 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 @@ -1503,6 +1726,12 @@ d_syscall (d_syscall.U): This variable conditionally defines HAS_SYSCALL if syscall() is available call arbitrary system calls. +d_syscallproto (d_syscallproto.U): + This variable conditionally defines the HAS_SYSCALL_PROTO symbol, + which indicates to the C program that the system provides + a prototype for the syscall() function. Otherwise, it is + up to the program to supply one. + d_sysconf (d_sysconf.U): This variable conditionally defines the HAS_SYSCONF symbol, which indicates to the C program that the sysconf() routine is available @@ -1558,6 +1787,14 @@ d_tzname (d_tzname.U): This variable conditionally defines HAS_TZNAME if tzname[] is available to access timezone names. +d_u32align (d_u32align.U): + This variable tells whether you must access character data + through U32-aligned pointers. + +d_ualarm (d_ualarm.U): + This variable conditionally defines the HAS_UALARM symbol, which + indicates to the C program that the ualarm() routine is available. + d_umask (d_umask.U): This variable conditionally defines the HAS_UMASK symbol, which indicates to the C program that the umask() routine is available. @@ -1572,6 +1809,20 @@ d_union_semun (d_union_semun.U): This variable conditionally defines HAS_UNION_SEMUN if the union semun is defined by including . +d_unordered (d_unordered.U): + This variable conditionally defines the HAS_UNORDERED symbol, which + indicates to the C program that the unordered() routine is available. + +d_usleep (d_usleep.U): + This variable conditionally defines HAS_USLEEP if usleep() is + available to do high granularity sleeps. + +d_usleepproto (d_usleepproto.U): + This variable conditionally defines the HAS_USLEEP_PROTO symbol, + which indicates to the C program that the system provides + a prototype for the usleep() function. Otherwise, it is + up to the program to supply one. + d_ustat (d_ustat.U): This variable conditionally defines HAS_USTAT if ustat() is available to query file system statistics by dev_t. @@ -1632,6 +1883,10 @@ 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. @@ -1651,6 +1906,20 @@ db_prefixtype (i_db.U): in the header file. In older versions of DB, it was int, while in newer ones it is size_t. +db_version_major (i_db.U): + This variable contains the major version number of + Berkeley DB found in the header file. + +db_version_minor (i_db.U): + This variable contains the minor version number of + Berkeley DB found in the header file. + For DB version 1 this is always 0. + +db_version_patch (i_db.U): + This variable contains the patch version number of + Berkeley DB found in the header file. + For DB version 1 this is always 0. + defvoidused (voidflags.U): This variable contains the default value of the VOIDUSED symbol (15). @@ -1726,6 +1995,9 @@ extensions (Extensions.U): and is typically used to test whether a particular extesion is available. +extras (Extras.U): + This variable holds a list of extra modules to install. + fflushall (fflushall.U): This symbol, if defined, tells that to flush all pending stdio output one must loop through all @@ -1762,6 +2034,12 @@ freetype (mallocsrc.U): This variable contains the return type of free(). It is usually void, but occasionally int. +from (Cross.U): + This variable contains the command used by Configure + to copy files from the target host. Useful and available + only during Perl build. + The string ':' if not cross-compiling. + full_ar (Loc_ar.U): This variable contains the full pathname to 'ar', whether or not the user has specified 'portability'. This is only used @@ -1781,7 +2059,12 @@ full_sed (Loc_sed.U): can share this executable will have the same full pathname to 'sed.' -gccversion (cc.U): +gccosandvers (gccvers.U): + If GNU cc (gcc) is used, this variable the operating system and + version used to compile the gcc. It is set to '' if not gcc, + or if nothing useful can be parsed as the os version. + +gccversion (gccvers.U): If GNU cc (gcc) is used, this variable holds '1' or '2' to 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. @@ -1848,12 +2131,6 @@ hostcat (nis.U): 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 - to produce a program running with a huge memory model. If the - 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. @@ -1919,6 +2196,14 @@ i_float (i_float.U): whether a C program may include to get symbols like DBL_MAX or DBL_MIN, i.e. machine dependent floating point values. +i_fp (i_fp.U): + This variable conditionally defines the I_FP symbol, and indicates + whether a C program should include . + +i_fp_class (i_fp_class.U): + This variable conditionally defines the I_FP_CLASS symbol, and indicates + whether a C program should include . + i_gdbm (i_gdbm.U): This variable conditionally defines the I_GDBM symbol, which indicates to the C program that exists and should @@ -1940,6 +2225,14 @@ i_inttypes (i_inttypes.U): This variable conditionally defines the I_INTTYPES symbol, and indicates whether a C program should include . +i_langinfo (i_langinfo.U): + This variable conditionally defines the I_LANGINFO symbol, + and indicates whether a C program should include . + +i_libutil (i_libutil.U): + This variable conditionally defines the I_LIBUTIL symbol, and indicates + whether a C program should include . + i_limits (i_limits.U): This variable conditionally defines the I_LIMITS symbol, and indicates whether a C program may include to get symbols like WORD_BIT @@ -1996,6 +2289,10 @@ i_poll (i_poll.U): This variable conditionally defines the I_POLL symbol, and indicates whether a C program should include . +i_prot (i_prot.U): + This variable conditionally defines the I_PROT symbol, and indicates + whether a C program should include . + i_pthread (i_pthread.U): This variable conditionally defines the I_PTHREAD symbol, and indicates whether a C program should include . @@ -2341,6 +2638,11 @@ 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. +issymlink (issymlink.U): + This variable holds the test command to test for a symbolic link + (if they are supported). Typical values include 'test -h' and + 'test -L'. + ivdformat (perlxvf.U): This variable contains the format string used for printing a Perl IV as a signed decimal integer. @@ -2359,11 +2661,6 @@ ksh (Loc.U): This variable is defined but not used by Configure. The value is a plain '' and is not useful. -large (models.U): - This variable contains a flag which will tell the C compiler and loader - to produce a program running with a large memory model. It is up to - the Makefile to use this. - ld (dlsrc.U): This variable indicates the program to be used to link libraries for dynamic loading. On some systems, it is 'ld'. @@ -2380,6 +2677,10 @@ ldflags (ccflags.U): This variable contains any additional C loader flags desired by the user. It is up to the Makefile to use this. +ldflags_uselargefiles (uselfs.U): + This variable contains the loader flags needed by large file builds + and added to ldflags by hints files. + ldlibpthname (libperl.U): This variable holds the name of the shared library search path, often LD_LIBRARY_PATH. To get an empty @@ -2432,6 +2733,12 @@ libswanted (Myinit.U): search. The order is chosen to pick up the c library ahead of ucb or bsd libraries for SVR4. +libswanted_uselargefiles (uselfs.U): + This variable contains the libraries needed by large file builds + and added to ldflags by hints files. It is a space separated list + of the library names without the "lib" prefix or any suffix, just + like libswanted.. + line (Loc.U): This variable is defined but not used by Configure. The value is a plain '' and is not useful. @@ -2577,12 +2884,6 @@ Mcc (Loc.U): full pathname (if any) of the Mcc program. After Configure runs, the value is reset to a plain "Mcc" and is not useful. -medium (models.U): - This variable contains a flag which will tell the C compiler and loader - to produce a program running with a medium memory model. If the - medium model is not supported, contains the flag to produce large - model programs. It is up to the Makefile to use this. - mips_type (usrinc.U): This variable holds the environment type for the mips system. Possible values are "BSD 4.3" and "System V". @@ -2597,11 +2898,6 @@ mmaptype (d_mmap.U): (and simultaneously the type of the first argument). It can be 'void *' or 'caddr_t'. -models (models.U): - This variable contains the list of memory models supported by this - system. Possible component values are none, split, unsplit, small, - medium, large, and huge. The component values are space separated. - modetype (modetype.U): This variable defines modetype to be something like mode_t, int, unsigned short, or whatever type is used to declare file @@ -2648,6 +2944,15 @@ n (n.U): command to suppress newline. Otherwise it is null. Correct usage is $echo $n "prompt for a question: $c". +need_va_copy (need_va_copy.U): + This symbol, if defined, indicates that the system stores + the variable argument list datatype, va_list, in a format + that cannot be copied by simple assignment, so that some + other means must be used when copying is required. + As such systems vary in their provision (or non-provision) + of copying mechanisms, handy.h defines a platform- + independent macro, Perl_va_copy(src, dst), to do the job. + netdb_hlen_type (netdbtype.U): This variable holds the type used for the 2nd argument to gethostbyaddr(). Usually, this is int or size_t or unsigned. @@ -2694,6 +2999,30 @@ nroff (Loc.U): full pathname (if any) of the nroff program. After Configure runs, the value is reset to a plain "nroff" and is not useful. +nveformat (perlxvf.U): + This variable contains the format string used for printing + a Perl NV using %e-ish floating point format. + +nvEUformat (perlxvf.U): + This variable contains the format string used for printing + a Perl NV using %E-ish floating point format. + +nvfformat (perlxvf.U): + This variable confains the format string used for printing + a Perl NV using %f-ish floating point format. + +nvFUformat (perlxvf.U): + This variable confains the format string used for printing + a Perl NV using %F-ish floating point format. + +nvgformat (perlxvf.U): + This variable contains the format string used for printing + a Perl NV using %g-ish floating point format. + +nvGUformat (perlxvf.U): + This variable contains the format string used for printing + a Perl NV using %G-ish floating point format. + nvsize (perlxv.U): This variable is the size of an NV in bytes. @@ -2740,6 +3069,16 @@ osvers (Oldconfig.U): same for this package, hints files might just be os_4.0 or os_4.1, etc., not keeping separate files for each little release. +otherlibdirs (otherlibdirs.U): + This variable contains a colon-separated set of paths for the perl + binary to search for additional library files or modules. + These directories will be tacked to the end of @INC. + Perl will automatically search below each path for version- + and architecture-specific directories. See inc_version_list + for more details. + A value of ' ' means 'none' and is used to preserve this value + for the next run through Configure. + package (package.U): This variable contains the name of the package being constructed. It is primarily intended for the use of later Configure units. @@ -2774,6 +3113,14 @@ perl (Loc.U): This variable is defined but not used by Configure. The value is a plain '' and is not useful. +perl_patchlevel (patchlevel.U): + This is the Perl patch level, a numeric change identifier, + as defined by whichever source code maintenance system + is used to maintain the patches; currently Perforce. + It does not correlate with the Perl version numbers or + the maintenance versus development dichotomy except + by also being increasing. + PERL_REVISION (Oldsyms.U): In a Perl version number such as 5.6.2, this is the 5. This value is manually set in patchlevel.h @@ -2791,6 +3138,10 @@ PERL_VERSION (Oldsyms.U): perladmin (perladmin.U): Electronic mail address of the perl5 administrator. +perllibs (End.U): + The list of libraries needed by Perl only (any libraries needed + by extensions only will by dropped, if using dynamic loading). + perlpath (perlpath.U): This variable contains the eventual value of the PERLPATH symbol, which contains the name of the perl interpreter to be used in @@ -2914,6 +3265,12 @@ rmail (Loc.U): This variable is defined but not used by Configure. The value is a plain '' and is not useful. +run (Cross.U): + This variable contains the command used by Configure + to copy and execute a cross-compiled executable in the + target host. Useful and available only during Perl build. + Empty string '' if not cross-compiling. + runnm (usenm.U): This variable contains 'true' or 'false' depending whether the nm extraction should be performed or not, according to the value @@ -3035,6 +3392,10 @@ sig_num_init (sig_name.U): below. A "ZERO" is prepended to the list, and the list is terminated with a plain 0. +sig_size (sig_name.U): + This variable contains the number of elements of the sig_name + and sig_num arrays, excluding the final NULL entry. + signal_t (d_voidsig.U): This variable holds the type of the signal handler (void or int). @@ -3113,11 +3474,6 @@ smail (Loc.U): This variable is defined but not used by Configure. The value is a plain '' and is not useful. -small (models.U): - This variable contains a flag which will tell the C compiler and loader - to produce a program running with a small memory model. It is up to - the Makefile to use this. - so (so.U): This variable holds the extension used to identify shared libraries (also known as shared objects) on the system. Usually set to 'so'. @@ -3147,12 +3503,6 @@ spitshell (spitshell.U): This variable contains the command necessary to spit out a runnable shell on this system. It is either cat or a grep '-v' for # comments. -split (models.U): - This variable contains a flag which will tell the C compiler and loader - to produce a program that will run in separate I and D space, for those - 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. @@ -3161,25 +3511,31 @@ sPRIeldbl (longdblfio.U): This variable, if defined, contains the string used by stdio to format long doubles (format 'e') for output. -sPRIEldbl (longdblfio.U): +sPRIEUldbl (longdblfio.U): This variable, if defined, contains the string used by stdio to format long doubles (format 'E') for output. + The 'U' in the name is to separate this from sPRIeldbl so that even + case-blind systems can see the difference. sPRIfldbl (longdblfio.U): This variable, if defined, contains the string used by stdio to format long doubles (format 'f') for output. -sPRIFldbl (longdblfio.U): +sPRIFUldbl (longdblfio.U): This variable, if defined, contains the string used by stdio to format long doubles (format 'F') for output. + The 'U' in the name is to separate this from sPRIfldbl so that even + case-blind systems can see the difference. sPRIgldbl (longdblfio.U): This variable, if defined, contains the string used by stdio to format long doubles (format 'g') for output. -sPRIGldbl (longdblfio.U): +sPRIGUldbl (longdblfio.U): This variable, if defined, contains the string used by stdio to format long doubles (format 'G') for output. + The 'U' in the name is to separate this from sPRIgldbl so that even + case-blind systems can see the difference. sPRIi64 (quadfio.U): This variable, if defined, contains the string used by stdio to @@ -3197,15 +3553,21 @@ 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): +sPRIXU64 (quadfio.U): This variable, if defined, contains the string used by stdio to format 64-bit hExADECimAl numbers (format 'X') for output. + The 'U' in the name is to separate this from sPRIx64 so that even + case-blind systems can see the difference. 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 find the sources remotely. +sSCNfldbl (longdblfio.U): + This variable, if defined, contains the string used by stdio to + format long doubles (format 'f') for input. + ssizetype (ssizetype.U): This variable defines ssizetype to be something like ssize_t, long or int. It is used by functions that return a count @@ -3253,7 +3615,7 @@ stdio_cnt (d_stdstdio.U): stdio_filbuf (d_stdstdio.U): This variable defines how, given a FILE pointer, fp, to tell - stdio to refill it's internal buffers (?). This will + stdio to refill its internal buffers (?). This will be used to define the macro FILE_filbuf(fp). stdio_ptr (d_stdstdio.U): @@ -3294,6 +3656,10 @@ tar (Loc.U): This variable is defined but not used by Configure. The value is a plain '' and is not useful. +targetarch (Cross.U): + If cross-compiling, this variable contains the target architecture. + If not, this will be empty. + tbl (Loc.U): This variable is defined but not used by Configure. The value is a plain '' and is not useful. @@ -3315,6 +3681,12 @@ timetype (d_time.U): or time_t on BSD sites (in which case should be included). Anyway, the type Time_t should be used. +to (Cross.U): + This variable contains the command used by Configure + to copy to from the target host. Useful and available + only during Perl build. + The string ':' if not cross-compiling. + touch (Loc.U): This variable is used internally by Configure to determine the full pathname (if any) of the touch program. After Configure runs, @@ -3411,6 +3783,10 @@ use64bitint (use64bits.U): This may mean using for example "long longs", while your memory may still be limited to 2 gigabytes. +usecrosscompile (Cross.U): + This variable conditionally defines the USE_CROSS_COMPILE symbol, + and indicates that Perl has been cross-compiled. + usedl (dlsrc.U): This variable indicates if the system supports dynamic loading of some sort. See also dlsrc and dlobj. @@ -3468,6 +3844,13 @@ useposix (Extensions.U): for hints files to indicate that POSIX will not compile on a particular system. +usereentrant (usethreads.U): + This variable conditionally defines the USE_REENTRANT_API symbol, + which indicates that the thread code may try to use the various + _r versions of library functions. This is only potentially + meaningful if usethreads is set and is very experimental, it is + not even prompted for. + usesfio (d_sfio.U): This variable is set to true when the user agrees to use sfio. It is set to false when sfio is not available or when the user @@ -3484,7 +3867,7 @@ usesocks (usesocks.U): and indicates that Perl should be built to use SOCKS. usethreads (usethreads.U): - This variable conditionally defines the USE_THREADS symbol, + This variable conditionally defines the USE_5005THREADS symbol, and indicates that Perl should be built to use threads. usevendorprefix (vendorprefix.U): @@ -3520,7 +3903,11 @@ uvuformat (perlxvf.U): uvxformat (perlxvf.U): This variable contains the format string used for printing - a Perl UV as an unsigned hexadecimal integer. + a Perl UV as an unsigned hexadecimal integer in lowercase abcdef. + +uvXUformat (perlxvf.U): + This variable contains the format string used for printing + a Perl UV as an unsigned hexadecimal integer in uppercase ABCDEF. vendorarch (vendorarch.U): This variable contains the value of the PERL_VENDORARCH symbol. @@ -3582,6 +3969,27 @@ version (patchlevel.U): This is suitable for use as a directory name, and hence is filesystem dependent. +version_patchlevel_string (patchlevel.U): + This is a string combining version, subversion and + perl_patchlevel (if perl_patchlevel is non-zero). + It is typically something like + 'version 7 subversion 1' or + 'version 7 subversion 1 patchlevel 11224' + It is computed here to avoid duplication of code in myconfig.SH + and lib/Config.pm. + +versiononly (versiononly.U): + If set, this symbol indicates that only the version-specific + components of a perl installation should be installed. + This may be useful for making a test installation of a new + version without disturbing the existing installation. + Setting versiononly is equivalent to setting installperl's -v option. + In particular, the non-versioned scripts and programs such as + a2p, c2ph, h2xs, pod2*, and perldoc are not installed + (see INSTALL for a more complete list). Nor are the man + pages installed. + Usually, this is undef. + vi (Loc.U): This variable is defined but not used by Configure. The value is a plain '' and is not useful. @@ -3613,6 +4021,14 @@ xs_apiversion (xs_apiversion.U): though in principle we could go snooping around in old Config.pm files. +yacc (yacc.U): + This variable holds the name of the compiler compiler we + want to use in the Makefile. It can be yacc, byacc, or bison -y. + +yaccflags (yacc.U): + This variable contains any additional yacc flags desired by the + user. It is up to the Makefile to use this. + zcat (Loc.U): This variable is defined but not used by Configure. The value is a plain '' and is not useful.