pthread_condattr_init in thread.h for OLD_PTHREADS_API.
[p5sagit/p5-mst-13.2.git] / Porting / Glossary
index 62818c6..c71c199 100644 (file)
@@ -34,6 +34,10 @@ 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.
 
+bincompat3 (bincompat3.U):
+       This variable contains y if Perl 5.004 should be binary-compatible
+       with Perl 5.003.
+
 byteorder (byteorder.U):
        This variable holds the byte order. In the following, larger digits
        indicate more significance.  The variable byteorder is either 4321
@@ -133,11 +137,25 @@ d_bcopy (d_bcopy.U):
        This variable conditionally defines the HAS_BCOPY symbol if
        the bcopy() routine is available to copy strings.
 
+d_bincompat3 (bincompat3.U):
+       This variable conditionally defines BINCOMPAT3 so that embed.h
+       can take special action if Perl 5.004 should be binary-compatible
+       with Perl 5.003.
+
+d_bsdgetpgrp (d_getpgrp.U):
+       This variable conditionally defines USE_BSD_GETPGRP if
+       getpgrp needs one arguments whereas USG one needs none.
+
 d_bsdpgrp (d_setpgrp.U):
        This variable conditionally defines USE_BSDPGRP if the notion of
        process group is the BSD one. This means setpgrp needs two arguments
        whereas USG one needs none.
 
+d_bsdsetpgrp (d_setpgrp.U):
+       This variable conditionally defines USE_BSD_SETPGRP if
+       setpgrp needs two arguments whereas USG one needs none.
+       See also d_setpgid for a POSIX interface.
+
 d_bzero (d_bzero.U):
        This variable conditionally defines the HAS_BZERO symbol if
        the bzero() routine is available to set memory to 0.
@@ -263,15 +281,30 @@ d_fsetpos (d_fsetpos.U):
        This variable conditionally defines HAS_FSETPOS if fsetpos() is
        available to set the file position indicator.
 
+d_ftime (d_ftime.U):
+       This variable conditionally defines the HAS_FTIME symbol, which
+       indicates that the ftime() routine exists.  The ftime() routine is
+       basically a sub-second accuracy clock.
+
 d_gethent (d_gethent.U):
        This variable conditionally defines HAS_GETHOSTENT if gethostent() is
        available to dup file descriptors.
 
+d_gettimeod (d_ftime.U):
+       This variable conditionally defines the HAS_GETTIMEOFDAY symbol, which
+       indicates that the gettimeofday() system call exists (to obtain a
+       sub-second accuracy clock).
+
 d_getlogin (d_getlogin.U):
        This variable conditionally defines the HAS_GETLOGIN symbol, which
        indicates to the C program that the getlogin() routine is available
        to get the login name.
 
+d_getpgid (d_getpgid.U):
+       This variable conditionally defines the HAS_GETPGID symbol, which
+       indicates to the C program that the getpgid(pid) function
+       is available to get the process group id.
+
 d_getpgrp (d_getpgrp.U):
        This variable conditionally defines HAS_GETPGRP if getpgrp() is
        available to get the current process group.
@@ -298,6 +331,11 @@ 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
+       to parse IP address "dotted-quad" strings.
+
 d_isascii (d_isascii.U):
        This variable conditionally defines the HAS_ISASCII constant,
        which indicates to the C program that isascii() is available.
@@ -469,6 +507,11 @@ d_safemcpy (d_safemcpy.U):
        This variable conditionally defines the HAS_SAFE_MEMCPY symbol if
        the memcpy() routine can do overlapping copies.
 
+d_sanemcmp (d_sanemcmp.U):
+       This variable conditionally defines the HAS_SANE_MEMCMP symbol if
+       the memcpy() routine is available and can be used to compare relative
+       magnitudes of chars with their high bits set.
+
 d_seekdir (d_readdir.U):
        This variable conditionally defines HAS_SEEKDIR if seekdir() is
        available.
@@ -503,8 +546,9 @@ d_setlocale (d_setlocale.U):
        available to handle locale-specific ctype implementations.
 
 d_setpgid (d_setpgid.U):
-       This variable conditionally defines HAS_SETPGID if setpgid() is
-       available to set process group ID.
+       This variable conditionally defines the HAS_SETPGID symbol, which
+       indicates to the C program that the setpgid(pid, gpid) function
+       is available to set the process group id.
 
 d_setpgrp (d_setpgrp.U):
        This variable conditionally defines HAS_SETPGRP if setpgrp() is
@@ -628,6 +672,21 @@ d_strerror (d_strerror.U):
        This variable conditionally defines HAS_STRERROR if strerror() is
        available to translate error numbers to strings.
 
+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
+       to provide better numeric string conversion than atof().
+
+d_strtol (d_strtol.U):
+       This variable conditionally defines the HAS_STRTOL symbol, which
+       indicates to the C program that the strtol() routine is available
+       to provide better numeric string conversion than atoi() and friends.
+
+d_strtoul (d_strtoul.U):
+       This variable conditionally defines the HAS_STRTOUL symbol, which
+       indicates to the C program that the strtoul() routine is available
+       to provide conversion of strings to unsigned long.
+
 d_strxfrm (d_strxfrm.U):
        This variable conditionally defines HAS_STRXFRM if strxfrm() is
        available to transform strings.
@@ -1054,6 +1113,11 @@ lns (lns.U):
        symbolic links (if they are supported).  It can be used
        in the Makefile. It is either 'ln -s' or 'ln'
 
+longsize (intsize.U):
+       This variable contains the value of the LONGSIZE symbol,
+       which indicates to the C program how many bytes there are
+       in a long integer.
+
 lseektype (lseektype.U):
        This variable defines lseektype to be something like off_t, long, 
        or whatever type is used to declare lseek offset's type in the
@@ -1160,6 +1224,11 @@ path_sep (Unix.U):
 perladmin (perladmin.U):
        Electronic mail address of the perl5 administrator.
 
+perlpath (perlpath.U):
+       This variable contains the eventual value of the PERLPATH symbol,
+       which contains the name of the perl interpreter to be used in
+       shell scripts and in the "eval 'exec'" idiom.
+
 prefix (prefix.U):
        This variable holds the name of the directory below which the
        user will install the package.  Usually, this is /usr/local, and
@@ -1224,6 +1293,27 @@ shmattype (d_shmat.U):
        This symbol contains the type of pointer returned by shmat().
        It can be 'void *' or 'char *'.
 
+shortsize (intsize.U):
+       This variable contains the value of the SHORTSIZE symbol,
+       which indicates to the C program how many bytes there are
+       in a short integer.
+
+shrpenv (libperl.U):
+       If the user builds a shared libperl.so, then we need to tell the
+       'perl' executable where it will be able to find the installed libperl.so. 
+       One way to do this on some systems is to set the environment variable
+       LD_RUN_PATH to the directory that will be the final location of the
+       shared libperl.so.  The makefile can use this with something like
+               $shrpenv $(CC) -o perl perlmain.o $libperl $libs
+       Typical values are
+               shrpenv="env LD_RUN_PATH=$archlibexp/CORE"
+       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, NetBSD) or -Wl,-rpath
+       $archlibexp/CORE (Linux).
+
 sig_name (sig_name.U):
        This variable holds the signal names, space separated. The leading
        SIG in signals name is removed. See sig_num.
@@ -1287,7 +1377,7 @@ startperl (startperl.U):
        script to make sure (hopefully) that it runs with perl and not some
        shell. Of course, that leading line must be followed by the classical
        perl idiom:
-               eval 'exec perl -S $0 "$@"'
+               eval 'exec /usr/bin/perl -S $0 ${1+"$@"}'
                        if $running_under_some_shell;
        to guarantee perl startup should the shell execute the script. Note
        that this magic incatation is not understood by csh.