This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Update Math-BigInt to CPAN version 1.999816
[perl5.git] / Porting / Glossary
index 1e1deab..e285e52 100644 (file)
@@ -41,10 +41,6 @@ alignbytes (alignbytes.U):
        double-- or a long double when applicable. Usual values are
        2, 4 and 8.  The default is eight, for safety.
 
-ansi2knr (ansi2knr.U):
-       This variable is set if the user needs to run ansi2knr.
-       Currently, this is not supported, so we just abort.
-
 aphostname (d_gethname.U):
        This variable contains the command which can be used to compute the
        host name. The command is fully qualified by its absolute path, to make
@@ -397,6 +393,10 @@ 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_accept4 (d_accept4.U):
+       This variable conditionally defines HAS_ACCEPT4 if accept4() is
+       available to accept socket connections.
+
 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.
@@ -508,6 +508,11 @@ d_bsdsetpgrp (d_setpgrp.U):
        setpgrp needs two arguments whereas USG one needs none.
        See also d_setpgid for a POSIX interface.
 
+d_builtin_add_overflow (d_builtin_overflow.U):
+       This variable conditionally defines HAS_BUILTIN_ADD_OVERFLOW, which
+       indicates that the compiler supports __builtin_add_overflow(x,y,&z)
+       for safely adding x and y into z while checking for overflow.
+
 d_builtin_choose_expr (d_builtin.U):
        This conditionally defines HAS_BUILTIN_CHOOSE_EXPR, which
        indicates that the compiler supports __builtin_choose_expr(x,y,z).
@@ -522,6 +527,16 @@ d_builtin_expect (d_builtin.U):
        __builtin_expect to provide the compiler with branch prediction
        information.
 
+d_builtin_mul_overflow (d_builtin_overflow.U):
+       This variable conditionally defines HAS_BUILTIN_MUL_OVERFLOW, which
+       indicates that the compiler supports __builtin_mul_overflow(x,y,&z)
+       for safely multiplying x and y into z while checking for overflow.
+
+d_builtin_sub_overflow (d_builtin_overflow.U):
+       This variable conditionally defines HAS_BUILTIN_SUB_OVERFLOW, which
+       indicates that the compiler supports __builtin_sub_overflow(x,y,&z)
+       for safely subtracting y from x into z while checking for overflow.
+
 d_c99_variadic_macros (d_c99_variadic.U):
        This variable conditionally defines the HAS_C99_VARIADIC_MACROS
        symbol, which indicates to the C program that C99 variadic macros
@@ -540,11 +555,6 @@ d_cbrt (d_cbrt.U):
        indicates to the C program that the cbrt() (cube root) function
        is available.
 
-d_charvspr (d_vprintf.U):
-       This variable conditionally defines CHARVSPRINTF if this system
-       has vsprintf returning type (char*).  The trend seems to be to
-       declare it as "int vsprintf()".
-
 d_chown (d_chown.U):
        This variable conditionally defines the HAS_CHOWN symbol, which
        indicates to the C program that the chown() routine is available.
@@ -574,11 +584,6 @@ 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
-       const type.
-
 d_copysign (d_copysign.U):
        This variable conditionally defines the HAS_COPYSIGN symbol, which
        indicates to the C program that the copysign() routine is available.
@@ -630,11 +635,6 @@ d_cuserid (d_cuserid.U):
        indicates to the C program that the cuserid() routine is available
        to get character login names.
 
-d_dbl_dig (d_dbl_dig.U):
-       This variable conditionally defines d_dbl_dig if this system's
-       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
@@ -692,7 +692,7 @@ d_double_has_inf (longdblfio.U):
        which indicates that the double type has an infinity.
 
 d_double_has_nan (longdblfio.U):
-       This variable conditionally defines the symbol DOUBLE_HAS_INF
+       This variable conditionally defines the symbol DOUBLE_HAS_NAN
        which indicates that the double type has a not-a-number.
 
 d_double_has_negative_zero (longdblfio.U):
@@ -734,6 +734,10 @@ d_dup2 (d_dup2.U):
        This variable conditionally defines HAS_DUP2 if dup2() is
        available to duplicate file descriptors.
 
+d_dup3 (d_dup3.U):
+       This variable conditionally defines HAS_DUP3 if dup3() is
+       available to duplicate file descriptors.
+
 d_duplocale (d_newlocale.U):
        This variable conditionally defines the HAS_DUPLOCALE symbol, which
        indicates to the C program that the duplocale() routine is available
@@ -1382,10 +1386,6 @@ d_inc_version_list (inc_version_list.U):
        This variable conditionally defines PERL_INC_VERSION_LIST.
        It is set to undef when PERL_INC_VERSION_LIST is empty.
 
-d_index (d_strchr.U):
-       This variable conditionally defines HAS_INDEX if index() and
-       rindex() are available for string searching.
-
 d_inetaton (d_inetaton.U):
        This variable conditionally defines the HAS_INET_ATON symbol, which
        indicates to the C program that the inet_aton() function is available
@@ -1543,6 +1543,10 @@ d_llroundl (d_llroundl.U):
        indicates to the C program that the llroundl() routine is available
        to return the long long value nearest to x away from zero.
 
+d_localeconv_l (d_localeconv_l.U):
+       This variable conditionally defines the HAS_LOCALECONV_L symbol, which
+       indicates to the C program that the localeconv_l() routine is available.
+
 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.
@@ -1660,6 +1664,16 @@ d_mblen (d_mblen.U):
        indicates to the C program that the mblen() routine is available
        to find the number of bytes in a multibye character.
 
+d_mbrlen (d_mbrlen.U):
+       This variable conditionally defines the HAS_MBRLEN symbol if the
+       mbrlen() routine is available to be used to get the length of
+       multi-byte character strings.
+
+d_mbrtowc (d_mbrtowc.U):
+       This variable conditionally defines the HAS_MBRTOWC symbol if the
+       mbrtowc() routine is available to be used to convert a multi-byte
+       character into a wide character.
+
 d_mbstowcs (d_mbstowcs.U):
        This variable conditionally defines the HAS_MBSTOWCS symbol, which
        indicates to the C program that the mbstowcs() routine is available
@@ -1696,6 +1710,11 @@ d_mkfifo (d_mkfifo.U):
        This variable conditionally defines the HAS_MKFIFO symbol, which
        indicates to the C program that the mkfifo() routine is available.
 
+d_mkostemp (d_mkostemp.U):
+       This variable conditionally defines HAS_MKOSTEMP if mkostemp() is
+       available to exclusively create and open a uniquely named (with a
+       suffix) temporary file.
+
 d_mkstemp (d_mkstemp.U):
        This variable conditionally defines the HAS_MKSTEMP symbol, which
        indicates to the C program that the mkstemp() routine is available
@@ -1799,6 +1818,10 @@ d_nan (d_nan.U):
        This variable conditionally defines HAS_NAN if nan() is
        available to generate NaN.
 
+d_nanosleep (d_nanosleep.U):
+       This variable conditionally defines HAS_NANOSLEEP
+       if nanosleep() is available to sleep with 1E-9 sec accuracy.
+
 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
@@ -1904,6 +1927,11 @@ d_pipe (d_pipe.U):
        indicates to the C program that the pipe() routine is available
        to create an inter-process channel.
 
+d_pipe2 (d_pipe2.U):
+       This variable conditionally defines the HAS_PIPE2 symbol, which
+       indicates to the C program that the pipe2() routine is available
+       to create an inter-process channel.
+
 d_poll (d_poll.U):
        This variable conditionally defines the HAS_POLL symbol, which
        indicates to the C program that the poll() routine is available
@@ -2480,12 +2508,6 @@ 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_sprintf_returns_strlen (d_sprintf_len.U):
-       This variable defines whether sprintf returns the length of the string
-       (as per the ANSI spec). Some C libraries retain compatibility with
-       pre-ANSI C and return a pointer to the passed in buffer; for these
-       this variable will be undef.
-
 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.
@@ -2572,24 +2594,10 @@ d_stdstdio (d_stdstdio.U):
        has a FILE structure declaring usable _ptr and _cnt fields (or
        equivalent) in stdio.h.
 
-d_strchr (d_strchr.U):
-       This variable conditionally defines HAS_STRCHR if strchr() and
-       strrchr() are available for string searching.
-
 d_strcoll (d_strcoll.U):
        This variable conditionally defines HAS_STRCOLL if strcoll() is
        available to compare strings using collating information.
 
-d_strerrm (d_strerror.U):
-       This variable holds what Strerror is defined as to translate an error
-       code condition into an error message string. It could be 'strerror'
-       or a more complex macro emulating strerror with sys_errlist[], or the
-       "unknown" string when both strerror and sys_errlist are missing.
-
-d_strerror (d_strerror.U):
-       This variable conditionally defines HAS_STRERROR if strerror() is
-       available to translate error numbers to strings.
-
 d_strerror_l (d_strerror_l.U):
        This variable conditionally defines the HAS_STRERROR_L symbol, which
        indicates to the C program that the strerror_l() routine is available
@@ -2613,6 +2621,10 @@ d_strlcpy (d_strlcpy.U):
        This variable conditionally defines the HAS_STRLCPY symbol, which
        indicates to the C program that the strlcpy () routine is available.
 
+d_strnlen (d_strnlen.U):
+       This variable conditionally defines the HAS_STRNLEN symbol, which
+       indicates to the C program that the strnlen () 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
@@ -2627,6 +2639,10 @@ d_strtold (d_strtold.U):
        This variable conditionally defines the HAS_STRTOLD symbol, which
        indicates to the C program that the strtold() routine is available.
 
+d_strtold_l (d_strtold_l.U):
+       This variable conditionally defines the HAS_STRTOLD_L symbol, which
+       indicates to the C program that the strtold_l() routine is available.
+
 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.
@@ -2713,6 +2729,11 @@ d_tgamma (d_tgamma.U):
        indicates to the C program that the tgamma() routine is available
        for the gamma function.  See also d_lgamma.
 
+d_thread_safe_nl_langinfo_l (d_nl_langinfo_l.U):
+       This variable contains the eventual value of the
+       HAS_THREAD_SAFE_NL_LANGINFO_L symbol, which indicates if the
+       nl_langinfo_l() function exists and is thread-safe.
+
 d_time (d_time.U):
        This variable conditionally defines the HAS_TIME symbol, which indicates
        that the time() routine exists.  The time() routine is normally
@@ -2848,11 +2869,6 @@ d_voidtty (i_sysioctl.U):
        Otherwise (on USG probably), it is enough to close the standard file
        descriptors and do a setpgrp().
 
-d_vprintf (d_vprintf.U):
-       This variable conditionally defines the HAS_VPRINTF symbol, which
-       indicates to the C program that the vprintf() routine is available
-       to printf with a pointer to an argument list.
-
 d_vsnprintf (d_snprintf.U):
        This variable conditionally defines the HAS_VSNPRINTF symbol, which
        indicates to the C program that the vsnprintf () library function
@@ -3432,11 +3448,6 @@ i_arpainet (i_arpainet.U):
        This variable conditionally defines the I_ARPA_INET symbol,
        and indicates whether a C program should include <arpa/inet.h>.
 
-i_assert (i_assert.U):
-       This variable conditionally defines the I_ASSERT symbol, which
-       indicates to the C program that <assert.h> exists and could be
-       included.
-
 i_bfd (i_bfd.U):
        This variable conditionally defines the I_BFD symbol, and
        indicates whether a C program can include <bfd.h>.
@@ -3481,11 +3492,6 @@ i_fenv (i_fenv.U):
        indicates to the C program that <fenv.h> exists and should
        be included.
 
-i_float (i_float.U):
-       This variable conditionally defines the I_FLOAT symbol, and indicates
-       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>.
@@ -3531,11 +3537,6 @@ i_libutil (i_libutil.U):
        This variable conditionally defines the I_LIBUTIL symbol, and indicates
        whether a C program should include <libutil.h>.
 
-i_limits (i_limits.U):
-       This variable conditionally defines the I_LIMITS symbol, and indicates
-       whether a C program may include <limits.h> to get symbols like WORD_BIT
-       and friends.
-
 i_locale (i_locale.U):
        This variable conditionally defines the I_LOCALE symbol,
        and indicates whether a C program should include <locale.h>.
@@ -3552,14 +3553,6 @@ i_mallocmalloc (i_mallocmalloc.U):
        This variable conditionally defines the I_MALLOCMALLOC symbol,
        and indicates whether a C program should include <malloc/malloc.h>.
 
-i_math (i_math.U):
-       This variable conditionally defines the I_MATH symbol, and indicates
-       whether a C program may include <math.h>.
-
-i_memory (i_memory.U):
-       This variable conditionally defines the I_MEMORY symbol, and indicates
-       whether a C program should include <memory.h>.
-
 i_mntent (i_mntent.U):
        This variable conditionally defines the I_MNTENT symbol, and indicates
        whether a C program should include <mntent.h>.
@@ -3625,34 +3618,18 @@ i_socks (i_socks.U):
        This variable conditionally defines the I_SOCKS symbol, and indicates
        whether a C program should include <socks.h>.
 
-i_stdarg (i_varhdr.U):
-       This variable conditionally defines the I_STDARG symbol, which
-       indicates to the C program that <stdarg.h> exists and should
-       be included.
-
 i_stdbool (i_stdbool.U):
        This variable conditionally defines the I_STDBOOL symbol, which
        indicates to the C program that <stdbool.h> exists and should
        be included.
 
-i_stddef (i_stddef.U):
-       This variable conditionally defines the I_STDDEF symbol, which
-       indicates to the C program that <stddef.h> exists and should
-       be included.
-
 i_stdint (i_stdint.U):
        This variable conditionally defines the I_STDINT symbol, which
        indicates to the C program that <stdint.h> exists and should
        be included.
 
 i_stdlib (i_stdlib.U):
-       This variable conditionally defines the I_STDLIB symbol, which
-       indicates to the C program that <stdlib.h> exists and should
-       be included.
-
-i_string (i_string.U):
-       This variable conditionally defines the I_STRING symbol, which
-       indicates that <string.h> should be included rather than <strings.h>.
+       This variable unconditionally defines the I_STDLIB symbol.
 
 i_sunmath (i_sunmath.U):
        This variable conditionally defines the I_SUNMATH symbol, and indicates
@@ -3690,8 +3667,8 @@ i_syslog (i_syslog.U):
        and indicates whether a C program should include <syslog.h>.
 
 i_sysmman (i_sysmman.U):
-       This variable conditionally defines the I_SYS_MMAN symbol, and
-       indicates whether a C program should include <sys/mman.h>.
+       This variable conditionally defines the I_SYS_MMAN symbol,
+       and indicates whether a C program should include <sys/mman.h>.
 
 i_sysmode (i_sysmode.U):
        This variable conditionally defines the I_SYSMODE symbol,
@@ -3792,7 +3769,7 @@ i_termios (i_termio.U):
        to be included.
 
 i_time (i_time.U):
-       This variable conditionally defines I_TIME, which indicates
+       This variable unconditionally defines I_TIME, which indicates
        to the C program that it should include <time.h>.
 
 i_unistd (i_unistd.U):
@@ -3807,23 +3784,14 @@ i_utime (i_utime.U):
        This variable conditionally defines the I_UTIME symbol, and indicates
        whether a C program should include <utime.h>.
 
-i_values (i_values.U):
-       This variable conditionally defines the I_VALUES symbol, and indicates
-       whether a C program may include <values.h> to get symbols like MAXLONG
-       and friends.
-
-i_varargs (i_varhdr.U):
-       This variable conditionally defines I_VARARGS, which indicates
-       to the C program that it should include <varargs.h>.
-
-i_varhdr (i_varhdr.U):
-       Contains the name of the header to be included to get va_dcl definition.
-       Typically one of varargs.h or stdarg.h.
-
 i_vfork (i_vfork.U):
        This variable conditionally defines the I_VFORK symbol, and indicates
        whether a C program should include vfork.h.
 
+i_wchar (i_wchar.U):
+       This variable conditionally defines the I_WCHAR symbol,
+       that indicates whether a C program may include <wchar.h>.
+
 i_xlocale (d_newlocale.U):
        This symbol, if defined, indicates to the C program that it should
        include <xlocale.h> to get uselocale() and its friends
@@ -4736,10 +4704,6 @@ procselfexe (d_procselfexe.U):
        of the symbolic link pointing to the absolute pathname of
        the executing program.
 
-prototype (prototype.U):
-       This variable holds the eventual value of CAN_PROTOTYPE, which
-       indicates the C compiler can handle function prototypes.
-
 ptrsize (ptrsize.U):
        This variable contains the value of the PTRSIZE symbol, which
        indicates to the C program how many bytes there are in a pointer.
@@ -4952,6 +4916,7 @@ shrpenv (libperl.U):
        or
        shrpenv=''
        See the main perl Makefile.SH for actual working usage.
+
        Alternatively, we might be able to use a command line option such
        as -R $archlibexp/CORE (Solaris) or -Wl,-rpath
        $archlibexp/CORE (Linux).
@@ -5332,10 +5297,6 @@ strerror_r_proto (d_strerror_r.U):
        REENTRANT_PROTO_T_ABC macros of reentr.h if d_strerror_r
        is defined.
 
-strings (i_string.U):
-       This variable holds the full path of the string header that will be
-       used. Typically /usr/include/string.h or /usr/include/strings.h.
-
 submit (Loc.U):
        This variable is defined but not used by Configure.
        The value is the empty string and is not useful.
@@ -5708,11 +5669,6 @@ uvXUformat (perlxvf.U):
        This variable contains the format string used for printing
        a Perl UV as an unsigned hexadecimal integer in uppercase ABCDEF.
 
-vaproto (vaproto.U):
-       This variable conditionally defines CAN_VAPROTO on systems supporting
-       prototype declaration of functions with a variable number of
-       arguments. See also prototype.
-
 vendorarch (vendorarch.U):
        This variable contains the value of the PERL_VENDORARCH symbol.
        It may have a ~ on the front.