X-Git-Url: https://perl5.git.perl.org/perl5.git/blobdiff_plain/640374d0dfc3428416b596d67c06b3c817f44bd8..6cf89afa34f7978c2a9aa74aacf9a7b22c527281:/Porting/Glossary diff --git a/Porting/Glossary b/Porting/Glossary index d903a74..a706e72 100644 --- a/Porting/Glossary +++ b/Porting/Glossary @@ -243,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. @@ -328,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 @@ -435,6 +431,10 @@ 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. @@ -467,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. @@ -542,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 @@ -580,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. @@ -588,16 +606,38 @@ 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. @@ -859,6 +899,14 @@ 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. @@ -993,6 +1041,13 @@ 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. @@ -1063,6 +1118,10 @@ 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. @@ -1186,6 +1245,11 @@ d_PRIXU64 (quadfio.U): 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 symbol if the pthread_yield routine is available to yield @@ -1244,10 +1308,6 @@ 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_realpath (d_realpath.U): - This variable conditionally defines the HAS_REALPATH symbol, which - indicates to the C program that the realpath() 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. @@ -1267,11 +1327,13 @@ 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 @@ -1498,6 +1560,12 @@ 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. @@ -1517,6 +1585,12 @@ 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 @@ -1652,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 @@ -1729,10 +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. @@ -1905,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 @@ -1941,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 @@ -2097,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 @@ -2118,6 +2225,10 @@ 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 . @@ -3154,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 @@ -3498,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): @@ -3539,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. @@ -3560,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, @@ -3656,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. @@ -3713,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 @@ -3729,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): @@ -3831,6 +3969,15 @@ 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.