X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=Porting%2FGlossary;h=167d4d3e5a14edf36ba3b3fb159d744d90570f53;hb=55c474ba7687e845183c20351357b0cf4f16fdef;hp=4c6fc600505b539f6c1793222eafb17cc898522a;hpb=233e16ceab6589cdfcfeefabef027f39026bb05f;p=p5sagit%2Fp5-mst-13.2.git diff --git a/Porting/Glossary b/Porting/Glossary index 4c6fc60..167d4d3 100644 --- a/Porting/Glossary +++ b/Porting/Glossary @@ -34,7 +34,7 @@ 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. + tests for AFSness in the configure and test process. alignbytes (alignbytes.U): This variable holds the number of bytes required to align a @@ -142,7 +142,7 @@ baserev (baserev.U): bash (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. bin (bin.U): This variable holds the name of the directory in which the user wants @@ -150,6 +150,11 @@ 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. +bin_ELF (dlsrc.U): + This variable saves the result from configure if generated binaries + are in ELF format. Only set to defined when the test has actually + been performed, and the result was positive. + binexp (bin.U): This is the same as the bin variable, but is filename expanded at configuration time, for use in your makefiles. @@ -244,13 +249,9 @@ cf_time (cf_who.U): Holds the output of the "date" command when the configuration file was produced. This is used to tag both config.sh and config_h.SH. -charsize (charsize.U): - This variable contains the value of the CHARSIZE symbol, which - indicates to the C program how many bytes there are in a character. - chgrp (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. chmod (Loc.U): This variable is used internally by Configure to determine the @@ -259,7 +260,7 @@ chmod (Loc.U): chown (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. clocktype (d_times.U): This variable holds the type returned by times(). It can be long, @@ -273,7 +274,7 @@ comm (Loc.U): compress (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. contains (contains.U): This variable holds the command to do a grep with a proper return @@ -288,7 +289,7 @@ cp (Loc.U): cpio (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. cpp (Loc.U): This variable is used internally by Configure to determine the @@ -393,6 +394,10 @@ 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_asctime64 (d_timefuncs64.U): + This variable conditionally defines the HAS_ASCTIME64 symbol, which + indicates to the C program that the asctime64 () routine is available. + d_asctime_r (d_asctime_r.U): This variable conditionally defines the HAS_ASCTIME_R symbol, which indicates to the C program that the asctime_r() @@ -406,6 +411,11 @@ 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_attribute_deprecated (d_attribut.U): + This variable conditionally defines HASATTRIBUTE_DEPRECATED, which + indicates that GCC can handle the attribute for marking deprecated + APIs + d_attribute_format (d_attribut.U): This variable conditionally defines HASATTRIBUTE_FORMAT, which indicates the C compiler can check for printf-like formats. @@ -567,6 +577,10 @@ d_ctermid_r (d_ctermid_r.U): which indicates to the C program that the ctermid_r() routine is available. +d_ctime64 (d_timefuncs64.U): + This variable conditionally defines the HAS_CTIME64 symbol, which + indicates to the C program that the ctime64 () routine is available. + d_ctime_r (d_ctime_r.U): This variable conditionally defines the HAS_CTIME_R symbol, which indicates to the C program that the ctime_r() @@ -592,6 +606,10 @@ 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_difftime64 (d_timefuncs64.U): + This variable conditionally defines the HAS_DIFFTIME64 symbol, which + indicates to the C program that the difftime64 () routine is available. + d_dir_dd_fd (d_dir_dd_fd.U): This variable conditionally defines the HAS_DIR_DD_FD symbol, which indicates that the DIR directory stream type contains a member @@ -868,6 +886,29 @@ d_Gconvert (d_gconvert.U): call-back unit so that long doubles can be formatted without loss of precision. +d_gdbm_ndbm_h_uses_prototypes (i_ndbm.U): + This variable conditionally defines the NDBM_H_USES_PROTOTYPES symbol, + which indicates that the gdbm-ndbm.h include file uses real ANSI C + prototypes instead of K&R style function declarations. K&R style + declarations are unsupported in C++, so the include file requires + special handling when using a C++ compiler and this variable is + undefined. Consult the different d_*ndbm_h_uses_prototypes variables + to get the same information for alternative ndbm.h include files. + +d_gdbmndbm_h_uses_prototypes (i_ndbm.U): + This variable conditionally defines the NDBM_H_USES_PROTOTYPES symbol, + which indicates that the gdbm/ndbm.h include file uses real ANSI C + prototypes instead of K&R style function declarations. K&R style + declarations are unsupported in C++, so the include file requires + special handling when using a C++ compiler and this variable is + undefined. Consult the different d_*ndbm_h_uses_prototypes variables + to get the same information for alternative ndbm.h include files. + +d_getaddrinfo (d_getaddrinfo.U): + This variable conditionally defines the HAS_GETADDRINFO symbol, + which indicates to the C program that the getaddrinfo() function + is available. + d_getcwd (d_getcwd.U): This variable conditionally defines the HAS_GETCWD symbol, which indicates to the C program that the getcwd() routine is available @@ -970,6 +1011,11 @@ d_getmntent (d_getmntent.U): indicates to the C program that the getmntent() routine is available to iterate through mounted files to get their mount info. +d_getnameinfo (d_getnameinfo.U): + This variable conditionally defines the HAS_GETNAMEINFO symbol, + which indicates to the C program that the getnameinfo() function + is available. + d_getnbyaddr (d_getnbyad.U): This variable conditionally defines the HAS_GETNETBYADDR symbol, which indicates to the C program that the getnetbyaddr() routine is available @@ -1144,6 +1190,10 @@ d_gettimeod (d_ftime.U): indicates that the gettimeofday() system call exists (to obtain a sub-second accuracy clock). You should probably include . +d_gmtime64 (d_timefuncs64.U): + This variable conditionally defines the HAS_GMTIME64 symbol, which + indicates to the C program that the gmtime64 () routine is available. + d_gmtime_r (d_gmtime_r.U): This variable conditionally defines the HAS_GMTIME_R symbol, which indicates to the C program that the gmtime_r() @@ -1183,6 +1233,16 @@ 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_inetntop (d_inetntop.U): + This variable conditionally defines the HAS_INETNTOP symbol, + which indicates to the C program that the inet_ntop() function + is available. + +d_inetpton (d_inetpton.U): + This variable conditionally defines the HAS_INETPTON symbol, + which indicates to the C program that the inet_pton() function + is available. + d_int64_t (d_int64_t.U): This symbol will be defined if the C compiler supports int64_t. @@ -1230,6 +1290,10 @@ d_link (d_link.U): This variable conditionally defines HAS_LINK if link() is available to create hard links. +d_localtime64 (d_timefuncs64.U): + This variable conditionally defines the HAS_LOCALTIME64 symbol, which + indicates to the C program that the localtime64 () routine is available. + d_localtime_r (d_localtime_r.U): This variable conditionally defines the HAS_LOCALTIME_R symbol, which indicates to the C program that the localtime_r() @@ -1346,6 +1410,10 @@ d_mktime (d_mktime.U): This variable conditionally defines the HAS_MKTIME symbol, which indicates to the C program that the mktime() routine is available. +d_mktime64 (d_timefuncs64.U): + This variable conditionally defines the HAS_MKTIME64 symbol, which + indicates to the C program that the mktime64 () routine is available. + d_mmap (d_mmap.U): This variable conditionally defines HAS_MMAP if mmap() is available to map a file into memory. @@ -1433,6 +1501,23 @@ 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_ndbm (i_ndbm.U): + This variable conditionally defines the HAS_NDBM symbol, which + indicates that both the ndbm.h include file and an appropriate ndbm + library exist. Consult the different i_*ndbm variables + to find out the actual include location. Sometimes, a system has the + header file but not the library. This variable will only be set if + the system has both. + +d_ndbm_h_uses_prototypes (i_ndbm.U): + This variable conditionally defines the NDBM_H_USES_PROTOTYPES symbol, + which indicates that the ndbm.h include file uses real ANSI C + prototypes instead of K&R style function declarations. K&R style + declarations are unsupported in C++, so the include file requires + special handling when using a C++ compiler and this variable is + undefined. Consult the different d_*ndbm_h_uses_prototypes variables + to get the same information for alternative ndbm.h include files. + 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. @@ -1937,6 +2022,11 @@ d_sigaction (d_sigaction.U): This variable conditionally defines the HAS_SIGACTION symbol, which indicates that the Vr4 sigaction() routine is available. +d_signbit (d_signbit.U): + This variable conditionally defines the HAS_SIGNBIT symbol, which + indicates to the C program that the signbit() routine is available + and safe to use with perl's intern NV type. + d_sigprocmask (d_sigprocmask.U): This variable conditionally defines HAS_SIGPROCMASK if sigprocmask() is available to examine or change the signal mask @@ -2204,6 +2294,10 @@ d_time (d_time.U): that the time() routine exists. The time() routine is normaly provided on UNIX systems. +d_timegm (d_timegm.U): + This variable conditionally defines the HAS_TIMEGM symbol, which + indicates to the C program that the timegm () routine is available. + d_times (d_times.U): This variable conditionally defines the HAS_TIMES symbol, which indicates that the times() routine exists. The times() routine is normaly @@ -2413,6 +2507,9 @@ drand48_r_proto (d_drand48_r.U): REENTRANT_PROTO_T_ABC macros of reentr.h if d_drand48_r is defined. +dtrace (usedtrace.U): + This variable holds the location of the dtrace executable. + dynamic_ext (Extensions.U): This variable holds a list of XS extension files we want to link dynamically into the package. It is used by Makefile. @@ -2440,7 +2537,7 @@ egrep (Loc.U): emacs (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. endgrent_r_proto (d_endgrent_r.U): This variable encodes the prototype of endgrent_r. @@ -2497,6 +2594,10 @@ extensions (Extensions.U): and is typically used to test whether a particular extesion is available. +extern_C (Csym.U): + ANSI C requires 'extern' where C++ requires 'extern "C"'. This + variable can be used in Configure to do the right thing. + extras (Extras.U): This variable holds a list of extra modules to install. @@ -2513,7 +2614,7 @@ fflushNULL (fflushall.U): find (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. firstmakefile (Unix.U): This variable defines the first file searched by make. On unix, @@ -2523,7 +2624,7 @@ firstmakefile (Unix.U): flex (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. fpossize (fpossize.U): This variable contains the size of a fpostype in bytes. @@ -2823,6 +2924,11 @@ i_arpainet (i_arpainet.U): This variable conditionally defines the I_ARPA_INET symbol, and indicates whether a C program should include . +i_assert (i_assert.U): + This variable conditionally defines the I_ASSERT symbol, which + indicates to the C program that exists and could be + included. + i_bsdioctl (i_sysioctl.U): This variable conditionally defines the I_SYS_BSDIOCTL symbol, which indicates to the C program that exists and should @@ -2877,6 +2983,18 @@ i_gdbm (i_gdbm.U): indicates to the C program that exists and should be included. +i_gdbm_ndbm (i_ndbm.U): + This variable conditionally defines the I_GDBM_NDBM symbol, which + indicates to the C program that exists and should + be included. This is the location of the ndbm.h compatibility file + in Debian 4.0. + +i_gdbmndbm (i_ndbm.U): + This variable conditionally defines the I_GDBMNDBM symbol, which + indicates to the C program that exists and should + be included. This was the location of the ndbm.h compatibility file + in RedHat 7.1. + i_grp (i_grp.U): This variable conditionally defines the I_GRP symbol, and indicates whether a C program should include . @@ -2914,6 +3032,10 @@ i_malloc (i_malloc.U): This variable conditionally defines the I_MALLOC symbol, and indicates whether a C program should include . +i_mallocmalloc (i_mallocmalloc.U): + This variable conditionally defines the I_MALLOCMALLOC symbol, + and indicates whether a C program should include . + i_math (i_math.U): This variable conditionally defines the I_MATH symbol, and indicates whether a C program may include . @@ -3061,6 +3183,10 @@ i_sysparam (i_sysparam.U): This variable conditionally defines the I_SYS_PARAM symbol, and indicates whether a C program should include . +i_syspoll (i_syspoll.U): + This variable conditionally defines the I_SYS_POLL symbol, which + indicates to the C program that it should include . + i_sysresrc (i_sysresrc.U): This variable conditionally defines the I_SYS_RESOURCE symbol, and indicates whether a C program should include . @@ -3204,7 +3330,7 @@ incpath (usrinc.U): inews (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. initialinstalllocation (bin.U): When userelocatableinc is true, this variable holds the location @@ -3418,7 +3544,7 @@ known_extensions (Extensions.U): ksh (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. ld (dlsrc.U): This variable indicates the program to be used to link @@ -3500,11 +3626,11 @@ libswanted_uselargefiles (uselfs.U): line (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. lint (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. lkflags (ccflags.U): This variable contains any additional C partial linker flags desired by @@ -3554,11 +3680,11 @@ longsize (intsize.U): lp (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. lpr (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. ls (Loc.U): This variable is used internally by Configure to determine the @@ -3593,11 +3719,11 @@ madlysrc (mad.U): mail (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. mailx (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. make (Loc.U): This variable is used internally by Configure to determine the @@ -3614,7 +3740,7 @@ make_set_make (make.U): make_set_make="MAKE=$make" # if it doesn't. - This uses a comment character to distinguish a + This uses a comment character so that we can distinguish a 'set' value (from a previous config.sh or Configure '-D' option) from an uncomputed value. @@ -3663,11 +3789,6 @@ man3ext (man3dir.U): have: one of 'n', 'l', or '3'. The Makefile must supply the '.'. See man3dir. -Mcc (Loc.U): - This variable is used internally by Configure to determine the - full pathname (if any) of the Mcc program. After Configure runs, - the value is reset to a plain "Mcc" and is not useful. - mips_type (usrinc.U): This variable holds the environment type for the mips system. Possible values are "BSD 4.3" and "System V". @@ -3707,7 +3828,7 @@ multiarch (multiarch.U): mv (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. myarchname (archname.U): This variable holds the architecture name computed by Configure in @@ -3791,6 +3912,11 @@ 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. +nv_overflows_integers_at (perlxv.U): + This variable gives the largest integer value that NVs can hold + as a constant floating point expression. + If it could not be determined, it holds the value 0. + nv_preserves_uv_bits (perlxv.U): This variable indicates how many of bits type uvtype a variable nvtype can preserve. @@ -3902,7 +4028,7 @@ path_sep (Unix.U): perl (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. perl5 (perl5.U): This variable contains the full path (if any) to a previously @@ -4001,11 +4127,11 @@ plibpth (libpth.U): pmake (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. pr (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. prefix (prefix.U): This variable holds the name of the directory below which the @@ -4101,9 +4227,13 @@ rm (Loc.U): full pathname (if any) of the rm program. After Configure runs, the value is reset to a plain "rm" and is not useful. +rm_try (Unix.U): + This is a cleanup variable for try test programs. + Internal Configure use only. + rmail (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. run (Cross.U): This variable contains the command used by Configure @@ -4155,7 +4285,7 @@ selecttype (selecttype.U): sendmail (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. setgrent_r_proto (d_setgrent_r.U): This variable encodes the prototype of setgrent_r. @@ -4199,6 +4329,14 @@ setservent_r_proto (d_setservent_r.U): REENTRANT_PROTO_T_ABC macros of reentr.h if d_setservent_r is defined. +sGMTIME_max (time_size.U): + This variable defines the maximum value of the time_t offset that + the system function gmtime () accepts + +sGMTIME_min (time_size.U): + This variable defines the minimum value of the time_t offset that + the system function gmtime () accepts + sh (sh.U): This variable contains the full pathname of the shell used on this system to execute Bourne shell scripts. Usually, this will be @@ -4211,7 +4349,7 @@ sh (sh.U): shar (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. sharpbang (spitshell.U): This variable contains the string #! if this system supports that @@ -4425,11 +4563,19 @@ sizetype (sizetype.U): sleep (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. + +sLOCALTIME_max (time_size.U): + This variable defines the maximum value of the time_t offset that + the system function localtime () accepts + +sLOCALTIME_min (time_size.U): + This variable defines the minimum value of the time_t offset that + the system function localtime () accepts smail (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. so (so.U): This variable holds the extension used to identify shared libraries @@ -4529,9 +4675,9 @@ srandom_r_proto (d_srandom_r.U): is defined. 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. + This variable holds the (possibly relative) path of the package source. + It is up to the Makefile to use this variable and set VPATH accordingly + to find the sources remotely. Use $pkgsrc to have an absolute path. sSCNfldbl (longdblfio.U): This variable, if defined, contains the string used by stdio to @@ -4608,7 +4754,7 @@ strings (i_string.U): submit (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. subversion (patchlevel.U): The subversion level of this package. @@ -4625,11 +4771,11 @@ sysman (sysman.U): tail (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. tar (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. targetarch (Cross.U): If cross-compiling, this variable contains the target architecture. @@ -4637,11 +4783,11 @@ targetarch (Cross.U): tbl (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. tee (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. test (Loc.U): This variable is used internally by Configure to determine the @@ -4686,7 +4832,7 @@ trnl (trnl.U): troff (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. ttyname_r_proto (d_ttyname_r.U): This variable encodes the prototype of ttyname_r. @@ -4774,10 +4920,18 @@ usecrosscompile (Cross.U): This variable conditionally defines the USE_CROSS_COMPILE symbol, and indicates that Perl has been cross-compiled. +usedevel (Devel.U): + This variable indicates that Perl was configured with development + features enabled. This should not be done for production builds. + usedl (dlsrc.U): This variable indicates if the system supports dynamic loading of some sort. See also dlsrc and dlobj. +usedtrace (usedtrace.U): + This variable indicates whether we are compiling with dtrace + support. See also dtrace. + usefaststdio (usefaststdio.U): This variable conditionally defines the USE_FAST_STDIO symbol, and indicates that Perl should be built to use 'fast stdio'. @@ -4893,7 +5047,7 @@ usrinc (usrinc.U): uuname (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. uvoformat (perlxvf.U): This variable contains the format string used for printing @@ -5065,7 +5219,7 @@ versiononly (versiononly.U): vi (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. voidflags (voidflags.U): This variable contains the eventual value of the VOIDFLAGS symbol, @@ -5087,7 +5241,7 @@ yaccflags (yacc.U): zcat (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. zip (Loc.U): This variable is used internally by Configure to determine the