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 97a5a8c..e285e52 100644 (file)
@@ -393,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.
@@ -504,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).
@@ -518,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
@@ -565,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.
@@ -621,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
@@ -683,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):
@@ -725,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
@@ -1373,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
@@ -1534,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.
@@ -1651,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
@@ -1687,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
@@ -1790,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
@@ -1895,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
@@ -2432,6 +2469,11 @@ d_sitearch (sitearch.U):
        of architecture-dependent library files for $package.  If
        $sitearch is the same as $archlib, then this is set to undef.
 
+d_snprintf (d_snprintf.U):
+       This variable conditionally defines the HAS_SNPRINTF symbol, which
+       indicates to the C program that the snprintf () library function
+       is available.
+
 d_sockaddr_in6 (d_socket.U):
        This variable conditionally defines the HAS_SOCKADDR_IN6 symbol, which
        indicates the availability of a struct sockaddr_in6.
@@ -2552,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
@@ -2593,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
@@ -2607,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.
@@ -2693,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
@@ -2828,6 +2869,11 @@ d_voidtty (i_sysioctl.U):
        Otherwise (on USG probably), it is enough to close the standard file
        descriptors and do a setpgrp().
 
+d_vsnprintf (d_snprintf.U):
+       This variable conditionally defines the HAS_VSNPRINTF symbol, which
+       indicates to the C program that the vsnprintf () library function
+       is available.
+
 d_wait4 (d_wait4.U):
        This variable conditionally defines the HAS_WAIT4 symbol, which
        indicates the wait4() routine is available.
@@ -3402,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>.
@@ -3451,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>.
@@ -3501,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>.
@@ -3522,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>.
@@ -3605,9 +3628,8 @@ i_stdint (i_stdint.U):
        indicates to the C program that <stdint.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>.
+i_stdlib (i_stdlib.U):
+       This variable unconditionally defines the I_STDLIB symbol.
 
 i_sunmath (i_sunmath.U):
        This variable conditionally defines the I_SUNMATH symbol, and indicates
@@ -3645,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,
@@ -3747,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):
@@ -3762,15 +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_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
@@ -4895,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).
@@ -5275,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.