This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
In UNICOS division is really lossy, better use
[perl5.git] / Porting / Glossary
index 4507f19..a706e72 100644 (file)
@@ -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
@@ -237,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.
@@ -258,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
@@ -326,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
@@ -433,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.
@@ -465,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.
@@ -540,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
@@ -578,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.
@@ -586,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.
 
@@ -857,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.
@@ -991,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.
@@ -1061,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.
@@ -1184,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
@@ -1261,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
@@ -1492,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.
@@ -1511,6 +1585,18 @@ 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
@@ -1640,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
@@ -1717,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 <sys/sem.h>.
 
+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.
@@ -1804,6 +1906,20 @@ db_prefixtype (i_db.U):
        in the <db.h> 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 <db.h> header file.
+
+db_version_minor (i_db.U):
+       This variable contains the minor version number of
+       Berkeley DB found in the <db.h> 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 <db.h> header file.
+       For DB version 1 this is always 0.
+
 defvoidused (voidflags.U):
        This variable contains the default value of the VOIDUSED symbol (15).
 
@@ -1879,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
@@ -1915,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
@@ -2071,6 +2196,14 @@ i_float (i_float.U):
        whether a C program may include <float.h> 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 <fp.h>.
+
+i_fp_class (i_fp_class.U):
+       This variable conditionally defines the I_FP_CLASS symbol, and indicates
+       whether a C program should include <fp_class.h>.
+
 i_gdbm (i_gdbm.U):
        This variable conditionally defines the I_GDBM symbol, which
        indicates to the C program that <gdbm.h> exists and should
@@ -2092,6 +2225,10 @@ i_inttypes (i_inttypes.U):
        This variable conditionally defines the I_INTTYPES symbol,
        and indicates whether a C program should include <inttypes.h>.
 
+i_langinfo (i_langinfo.U):
+       This variable conditionally defines the I_LANGINFO symbol,
+       and indicates whether a C program should include <langinfo.h>.
+
 i_libutil (i_libutil.U):
        This variable conditionally defines the I_LIBUTIL symbol, and indicates
        whether a C program should include <libutil.h>.
@@ -2976,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
@@ -3120,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
@@ -3464,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):
@@ -3505,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.
@@ -3526,6 +3681,12 @@ timetype (d_time.U):
        or time_t on BSD sites (in which case <sys/types.h> 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,
@@ -3622,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.
@@ -3679,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
@@ -3695,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):
@@ -3797,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.