Porting/Glossary

   1 This file contains a description of all the shell variables whose value is
   2 determined by the Configure script.  Variables intended for use in C
   3 programs (e.g. I_UNISTD) are already described in config_h.SH.
   4
   5 _a (Unix.U):
   6         This variable defines the extension used for ordinary libraries.
   7         For unix, it is '.a'.  The '.' is included.  Other possible
   8         values include '.lib'.
   9
  10 _exe (Unix.U):
  11         This variable defines the extension used for executable files.
  12         For unix it is empty.  Other possible values include '.exe'.
  13
  14 _o (Unix.U):
  15         This variable defines the extension used for object files.
  16         For unix, it is '.o'.  The '.' is included.  Other possible
  17         values include '.obj'.
  18
  19 afs (afs.U):
  20         This variable is set to 'true' if AFS (Andrew File System) is used
  21         on the system, 'false' otherwise.  It is possible to override this
  22         with a hint value or command line option, but you'd better know
  23         what you are doing.
  24
  25 alignbytes (alignbytes.U):
  26         This variable holds the number of bytes required to align a
  27         double. Usual values are 2, 4 and 8.
  28
  29 aphostname (d_gethname.U):
  30         Thie variable contains the command which can be used to compute the
  31         host name. The command is fully qualified by its absolute path, to make
  32         it safe when used by a process with super-user privileges.
  33
  34 archlib (archlib.U):
  35         This variable holds the name of the directory in which the user wants
  36         to put architecture-dependent public library files for $package.
  37         It is most often a local directory such as /usr/local/lib.
  38         Programs using this variable must be prepared to deal
  39         with filename expansion.
  40
  41 archlibexp (archlib.U):
  42         This variable is the same as the archlib variable, but is
  43         filename expanded at configuration time, for convenient use.
  44
  45 archname (archname.U):
  46         This variable is a short name to characterize the current
  47         architecture.  It is used mainly to construct the default archlib.
  48
  49 archobjs (Unix.U):
  50         This variable defines any additional objects that must be linked
  51         in with the program on this architecture.  On unix, it is usually
  52         empty.  It is typically used to include emulations of unix calls
  53         or other facilities.  For perl on OS/2, for example, this would
  54         include os2/os2.obj.
  55
  56 baserev (baserev.U):
  57         The base revision level of this package, from the .package file.
  58
  59 bin (bin.U):
  60         This variable holds the name of the directory in which the user wants
  61         to put publicly executable images for the package in question.  It
  62         is most often a local directory such as /usr/local/bin. Programs using
  63         this variable must be prepared to deal with ~name substitution.
  64
  65 binexp (bin.U):
  66         This is the same as the bin variable, but is filename expanded at
  67         configuration time, for use in your makefiles.
  68
  69 byteorder (byteorder.U):
  70         This variable holds the byte order. In the following, larger digits
  71         indicate more significance.  The variable byteorder is either 4321
  72         on a big-endian machine, or 1234 on a little-endian, or 87654321
  73         on a Cray ... or 3412 with weird order !
  74
  75 c (n.U):
  76         This variable contains the \c string if that is what causes the echo
  77         command to suppress newline.  Otherwise it is null.  Correct usage is
  78             $echo $n "prompt for a question: $c".
  79
  80 castflags (d_castneg.U):
  81         This variable contains a flag that precise difficulties the
  82         compiler has casting odd floating values to unsigned long:
  83                 0 = ok
  84                 1 = couldn't cast < 0
  85                 2 = couldn't cast >= 0x80000000
  86                 4 = couldn't cast in argument expression list
  87
  88 cc (cc.U):
  89         This variable holds the name of a command to execute a C compiler which
  90         can resolve multiple global references that happen to have the same
  91         name.  Usual values are "cc", "Mcc", "cc -M", and "gcc".
  92
  93 cccdlflags (dlsrc.U):
  94         This variable contains any special flags that might need to be
  95         passed with cc -c to compile modules to be used to create a shared
  96         library that will be used for dynamic loading.  For hpux, this
  97         should be +z.  It is up to the makefile to use it.
  98
  99 ccdlflags (dlsrc.U):
 100         This variable contains any special flags that might need to be
 101         passed to cc to link with a shared library for dynamic loading.
 102         It is up to the makefile to use it.  For sunos 4.1, it should
 103         be empty.
 104
 105 ccflags (ccflags.U):
 106         This variable contains any additional C compiler flags desired by
 107         the user.  It is up to the Makefile to use this.
 108
 109 cf_by (cf_who.U):
 110         Login name of the person who ran the Configure script and answered the
 111         questions. This is used to tag both config.sh and config_h.SH.
 112
 113 cf_email (cf_email.U):
 114         Electronic mail address of the person who ran Configure. This can be
 115         used by units that require the user's e-mail, like MailList.U.
 116
 117 cf_time (cf_who.U):
 118         Holds the output of the "date" command when the configuration file was
 119         produced. This is used to tag both config.sh and config_h.SH.
 120
 121 clocktype (d_times.U):
 122         This variable holds the type returned by times(). It can be long,
 123         or clock_t on BSD sites (in which case <sys/types.h> should be
 124         included).
 125
 126 contains (contains.U):
 127         This variable holds the command to do a grep with a proper return
 128         status.  On most sane systems it is simply "grep".  On insane systems
 129         it is a grep followed by a cat followed by a test.  This variable
 130         is primarily for the use of other Configure units.
 131
 132 cpp_stuff (cpp_stuff.U):
 133         This variable contains an identification of the catenation mechanism
 134         used by the C preprocessor.
 135
 136 cppflags (ccflags.U):
 137         This variable holds the flags that will be passed to the C pre-
 138         processor. It is up to the Makefile to use it.
 139
 140 cpplast (cppstdin.U):
 141         This variable has the same functionality as cppminus, only it applies to
 142         cpprun and not cppstdin.
 143
 144 cppminus (cppstdin.U):
 145         This variable contains the second part of the string which will invoke
 146         the C preprocessor on the standard input and produce to standard
 147         output.  This variable will have the value "-" if cppstdin needs a minus
 148         to specify standard input, otherwise the value is "".
 149
 150 cpprun (cppstdin.U):
 151         This variable contains the command which will invoke a C preprocessor
 152         on standard input and put the output to stdout. It is guaranteed not
 153         to be a wrapper and may be a null string if no preprocessor can be
 154         made directly available. This preprocessor might be different from the
 155         one used by the C compiler. Don't forget to append cpplast after the
 156         preprocessor options.
 157
 158 cppstdin (cppstdin.U):
 159         This variable contains the command which will invoke the C
 160         preprocessor on standard input and put the output to stdout.
 161         It is primarily used by other Configure units that ask about
 162         preprocessor symbols.
 163
 164 cryptlib (d_crypt.U):
 165         This variable holds -lcrypt or the path to a libcrypt.a archive if
 166         the crypt() function is not defined in the standard C library. It is
 167         up to the Makefile to use this.
 168
 169 d_Gconvert (d_gconvert.U):
 170         This variable holds what Gconvert is defined as to convert
 171         floating point numbers into strings. It could be 'gconvert'
 172         or a more complex macro emulating gconvert with gcvt() or sprintf.
 173
 174 d_access (d_access.U):
 175         This variable conditionally defines HAS_ACCESS if the access() system
 176         call is available to check for access permissions using real IDs.
 177
 178 d_alarm (d_alarm.U):
 179         This variable conditionally defines the HAS_ALARM symbol, which
 180         indicates to the C program that the alarm() routine is available.
 181
 182 d_archlib (archlib.U):
 183         This variable conditionally defines ARCHLIB to hold the pathname
 184         of architecture-dependent library files for $package.  If
 185         $archlib is the same as $privlib, then this is set to undef.
 186
 187 d_attribut (d_attribut.U):
 188         This variable conditionally defines HASATTRIBUTE, which
 189         indicates the C compiler can check for function attributes,
 190         such as printf formats.
 191
 192 d_bcmp (d_bcmp.U):
 193         This variable conditionally defines the HAS_BCMP symbol if
 194         the bcmp() routine is available to compare strings.
 195
 196 d_bcopy (d_bcopy.U):
 197         This variable conditionally defines the HAS_BCOPY symbol if
 198         the bcopy() routine is available to copy strings.
 199
 200 d_bsd (Guess.U):
 201         This symbol conditionally defines the symbol BSD when running on a
 202         BSD system.
 203
 204 d_bsdgetpgrp (d_getpgrp.U):
 205         This variable conditionally defines USE_BSD_GETPGRP if
 206         getpgrp needs one arguments whereas USG one needs none.
 207
 208 d_bsdsetpgrp (d_setpgrp.U):
 209         This variable conditionally defines USE_BSD_SETPGRP if
 210         setpgrp needs two arguments whereas USG one needs none.
 211         See also d_setpgid for a POSIX interface.
 212
 213 d_bzero (d_bzero.U):
 214         This variable conditionally defines the HAS_BZERO symbol if
 215         the bzero() routine is available to set memory to 0.
 216
 217 d_casti32 (d_casti32.U):
 218         This variable conditionally defines CASTI32, which indicates
 219         whether the C compiler can cast large floats to 32-bit ints.
 220
 221 d_castneg (d_castneg.U):
 222         This variable conditionally defines CASTNEG, which indicates
 223         wether the C compiler can cast negative float to unsigned.
 224
 225 d_charvspr (d_vprintf.U):
 226         This variable conditionally defines CHARVSPRINTF if this system
 227         has vsprintf returning type (char*).  The trend seems to be to
 228         declare it as "int vsprintf()".
 229
 230 d_chown (d_chown.U):
 231         This variable conditionally defines the HAS_CHOWN symbol, which
 232         indicates to the C program that the chown() routine is available.
 233
 234 d_chroot (d_chroot.U):
 235         This variable conditionally defines the HAS_CHROOT symbol, which
 236         indicates to the C program that the chroot() routine is available.
 237
 238 d_chsize (d_chsize.U):
 239         This variable conditionally defines the CHSIZE symbol, which
 240         indicates to the C program that the chsize() routine is available
 241         to truncate files.  You might need a -lx to get this routine.
 242
 243 d_closedir (d_closedir.U):
 244         This variable conditionally defines HAS_CLOSEDIR if closedir() is
 245         available.
 246
 247 d_const (d_const.U):
 248         This variable conditionally defines the HASCONST symbol, which
 249         indicates to the C program that this C compiler knows about the
 250         const type.
 251
 252 d_crypt (d_crypt.U):
 253         This variable conditionally defines the CRYPT symbol, which
 254         indicates to the C program that the crypt() routine is available
 255         to encrypt passwords and the like.
 256
 257 d_csh (d_csh.U):
 258         This variable conditionally defines the CSH symbol, which
 259         indicates to the C program that the C-shell exists.
 260
 261 d_cuserid (d_cuserid.U):
 262         This variable conditionally defines the HAS_CUSERID symbol, which
 263         indicates to the C program that the cuserid() routine is available
 264         to get character login names.
 265
 266 d_dbl_dig (d_dbl_dig.U):
 267         This variable conditionally defines d_dbl_dig if this system's
 268         header files provide DBL_DIG, which is the number of significant
 269         digits in a double precision number.
 270
 271 d_difftime (d_difftime.U):
 272         This variable conditionally defines the HAS_DIFFTIME symbol, which
 273         indicates to the C program that the difftime() routine is available.
 274
 275 d_dirnamlen (i_dirent.U):
 276         This variable conditionally defines DIRNAMLEN, which indicates
 277         to the C program that the length of directory entry names is
 278         provided by a d_namelen field.
 279
 280 d_dlerror (d_dlerror.U):
 281         This variable conditionally defines the HAS_DLERROR symbol, which
 282         indicates to the C program that the dlerror() routine is available.
 283
 284 d_dlopen (d_dlopen.U):
 285         This variable conditionally defines the HAS_DLOPEN symbol, which
 286         indicates to the C program that the dlopen() routine is available.
 287
 288 d_dlsymun (d_dlsymun.U):
 289         This variable conditionally defines DLSYM_NEEDS_UNDERSCORE, which
 290         indicates that we need to prepend an underscore to the symbol
 291         name before calling dlsym().
 292
 293 d_dosuid (d_dosuid.U):
 294         This variable conditionally defines the symbol DOSUID, which
 295         tells the C program that it should insert setuid emulation code
 296         on hosts which have setuid #! scripts disabled.
 297
 298 d_dup2 (d_dup2.U):
 299         This variable conditionally defines HAS_DUP2 if dup2() is
 300         available to duplicate file descriptors.
 301
 302 d_endhent (d_endhent.U):
 303         This variable conditionally defines HAS_ENDHOSTENT if endhostent() is
 304         available to close whatever was being used for host queries.
 305
 306 d_endnent (d_endnent.U):
 307         This variable conditionally defines HAS_ENDNETENT if endnetent() is
 308         available to close whatever was being used for network queries.
 309
 310 d_endpent (d_endpent.U):
 311         This variable conditionally defines HAS_ENDPROTOENT if endprotoent() is
 312         available to close whatever was being used for protocol queries.
 313
 314 d_endsent (d_endsent.U):
 315         This variable conditionally defines HAS_ENDSERVENT if endservent() is
 316         available to close whatever was being used for service queries.
 317
 318 d_eofnblk (nblock_io.U):
 319         This variable conditionally defines EOF_NONBLOCK if EOF can be seen
 320         when reading from a non-blocking I/O source.
 321
 322 d_eunice (Guess.U):
 323         This variable conditionally defines the symbols EUNICE and VAX, which
 324         alerts the C program that it must deal with ideosyncracies of VMS.
 325
 326 d_fchmod (d_fchmod.U):
 327         This variable conditionally defines the HAS_FCHMOD symbol, which
 328         indicates to the C program that the fchmod() routine is available
 329         to change mode of opened files.
 330
 331 d_fchown (d_fchown.U):
 332         This variable conditionally defines the HAS_FCHOWN symbol, which
 333         indicates to the C program that the fchown() routine is available
 334         to change ownership of opened files.
 335
 336 d_fcntl (d_fcntl.U):
 337         This variable conditionally defines the HAS_FCNTL symbol, and indicates
 338         whether the fcntl() function exists
 339
 340 d_fd_macros (d_fd_set.U):
 341         This variable contains the eventual value of the HAS_FD_MACROS symbol,
 342         which indicates if your C compiler knows about the macros which
 343         manipulate an fd_set.
 344
 345 d_fd_set (d_fd_set.U):
 346         This variable contains the eventual value of the HAS_FD_SET symbol,
 347         which indicates if your C compiler knows about the fd_set typedef.
 348
 349 d_fds_bits (d_fd_set.U):
 350         This variable contains the eventual value of the HAS_FDS_BITS symbol,
 351         which indicates if your fd_set typedef contains the fds_bits member.
 352         If you have an fd_set typedef, but the dweebs who installed it did
 353         a half-fast job and neglected to provide the macros to manipulate
 354         an fd_set, HAS_FDS_BITS will let us know how to fix the gaffe.
 355
 356 d_fgetpos (d_fgetpos.U):
 357         This variable conditionally defines HAS_FGETPOS if fgetpos() is
 358         available to get the file position indicator.
 359
 360 d_flexfnam (d_flexfnam.U):
 361         This variable conditionally defines the FLEXFILENAMES symbol, which
 362         indicates that the system supports filenames longer than 14 characters.
 363
 364 d_flock (d_flock.U):
 365         This variable conditionally defines HAS_FLOCK if flock() is
 366         available to do file locking.
 367
 368 d_fork (d_fork.U):
 369         This variable conditionally defines the HAS_FORK symbol, which
 370         indicates to the C program that the fork() routine is available.
 371
 372 d_fpathconf (d_pathconf.U):
 373         This variable conditionally defines the HAS_FPATHCONF symbol, which
 374         indicates to the C program that the pathconf() routine is available
 375         to determine file-system related limits and options associated
 376         with a given open file descriptor.
 377
 378 d_fsetpos (d_fsetpos.U):
 379         This variable conditionally defines HAS_FSETPOS if fsetpos() is
 380         available to set the file position indicator.
 381
 382 d_ftime (d_ftime.U):
 383         This variable conditionally defines the HAS_FTIME symbol, which indicates
 384         that the ftime() routine exists.  The ftime() routine is basically
 385         a sub-second accuracy clock.
 386
 387 d_getgrps (d_getgrps.U):
 388         This variable conditionally defines the HAS_GETGROUPS symbol, which
 389         indicates to the C program that the getgroups() routine is available
 390         to get the list of process groups.
 391
 392 d_gethbyaddr (d_gethbyad.U):
 393         This variable conditionally defines the HAS_GETHOSTBYADDR symbol, which
 394         indicates to the C program that the gethostbyaddr() routine is available
 395         to look up hosts by their IP addresses.
 396
 397 d_gethbyname (d_gethbynm.U):
 398         This variable conditionally defines the HAS_GETHOSTBYNAME symbol, which
 399         indicates to the C program that the gethostbyname() routine is available
 400         to look up host names in some data base or other.
 401
 402 d_gethent (d_gethent.U):
 403         This variable conditionally defines HAS_GETHOSTENT if gethostent() is
 404         available to look up host names in some data base or another.
 405
 406 d_gethname (d_gethname.U):
 407         This variable conditionally defines the HAS_GETHOSTNAME symbol, which
 408         indicates to the C program that the gethostname() routine may be
 409         used to derive the host name.
 410
 411 d_gethostprotos (d_gethostprotos.U):
 412         This variable conditionally defines the HAS_GETHOST_PROTOS symbol,
 413         which indicates to the C program that <netdb.h> supplies
 414         prototypes for the various gethost*() functions.
 415         See also netdbtype.U for probing for various netdb types.
 416
 417 d_getlogin (d_getlogin.U):
 418         This variable conditionally defines the HAS_GETLOGIN symbol, which
 419         indicates to the C program that the getlogin() routine is available
 420         to get the login name.
 421
 422 d_getnbyaddr (d_getnbyad.U):
 423         This variable conditionally defines the HAS_GETNETBYADDR symbol, which
 424         indicates to the C program that the getnetbyaddr() routine is available
 425         to look up networks by their IP addresses.
 426
 427 d_getnbyname (d_getnbynm.U):
 428         This variable conditionally defines the HAS_GETNETBYNAME symbol, which
 429         indicates to the C program that the getnetbyname() routine is available
 430         to look up networks by their names.
 431
 432 d_getnent (d_getnent.U):
 433         This variable conditionally defines HAS_GETNETENT if getnetent() is
 434         available to look up network names in some data base or another.
 435
 436 d_getnetprotos (d_getnetprotos.U):
 437         This variable conditionally defines the HAS_GETNET_PROTOS symbol,
 438         which indicates to the C program that <netdb.h> supplies
 439         prototypes for the various getnet*() functions.
 440         See also netdbtype.U for probing for various netdb types.
 441
 442 d_getpbyname (d_getprotby.U):
 443         This variable conditionally defines the HAS_GETPROTOBYNAME
 444         symbol, which indicates to the C program that the
 445         getprotobyname() routine is available to look up protocols
 446         by their name.
 447
 448 d_getpbynumber (d_getprotby.U):
 449         This variable conditionally defines the HAS_GETPROTOBYNUMBER
 450         symbol, which indicates to the C program that the
 451         getprotobynumber() routine is available to look up protocols
 452         by their number.
 453
 454 d_getpent (d_getpent.U):
 455         This variable conditionally defines HAS_GETPROTOENT if getprotoent() is
 456         available to look up protocols in some data base or another.
 457
 458 d_getpgid (d_getpgid.U):
 459         This variable conditionally defines the HAS_GETPGID symbol, which
 460         indicates to the C program that the getpgid(pid) function
 461         is available to get the process group id.
 462
 463 d_getpgrp2 (d_getpgrp2.U):
 464         This variable conditionally defines the HAS_GETPGRP2 symbol, which
 465         indicates to the C program that the getpgrp2() (as in DG/UX) routine
 466         is available to get the current process group.
 467
 468 d_getpgrp (d_getpgrp.U):
 469         This variable conditionally defines HAS_GETPGRP if getpgrp() is
 470         available to get the current process group.
 471
 472 d_getppid (d_getppid.U):
 473         This variable conditionally defines the HAS_GETPPID symbol, which
 474         indicates to the C program that the getppid() routine is available
 475         to get the parent process ID.
 476
 477 d_getprior (d_getprior.U):
 478         This variable conditionally defines HAS_GETPRIORITY if getpriority()
 479         is available to get a process's priority.
 480
 481 d_getprotoprotos (d_getprotoprotos.U):
 482         This variable conditionally defines the HAS_GETPROTO_PROTOS symbol,
 483         which indicates to the C program that <netdb.h> supplies
 484         prototypes for the various getproto*() functions.
 485         See also netdbtype.U for probing for various netdb types.
 486
 487 d_getsbyname (d_getsrvby.U):
 488         This variable conditionally defines the HAS_GETSERVBYNAME
 489         symbol, which indicates to the C program that the
 490         getservbyname() routine is available to look up services
 491         by their name.
 492
 493 d_getsbyport (d_getsrvby.U):
 494         This variable conditionally defines the HAS_GETSERVBYPORT
 495         symbol, which indicates to the C program that the
 496         getservbyport() routine is available to look up services
 497         by their port.
 498
 499 d_getsent (d_getsent.U):
 500         This variable conditionally defines HAS_GETSERVENT if getservent() is
 501         available to look up network services in some data base or another.
 502
 503 d_getservprotos (d_getservprotos.U):
 504         This variable conditionally defines the HAS_GETSERV_PROTOS symbol,
 505         which indicates to the C program that <netdb.h> supplies
 506         prototypes for the various getserv*() functions.
 507         See also netdbtype.U for probing for various netdb types.
 508
 509 d_gettimeod (d_ftime.U):
 510         This variable conditionally defines the HAS_GETTIMEOFDAY symbol, which
 511         indicates that the gettimeofday() system call exists (to obtain a
 512         sub-second accuracy clock). You should probably include <sys/resource.h>.
 513
 514 d_gnulibc (d_gnulibc.U):
 515         Defined if we're dealing with the GNU C Library.
 516
 517 d_htonl (d_htonl.U):
 518         This variable conditionally defines HAS_HTONL if htonl() and its
 519         friends are available to do network order byte swapping.
 520
 521 d_index (d_strchr.U):
 522         This variable conditionally defines HAS_INDEX if index() and
 523         rindex() are available for string searching.
 524
 525 d_inetaton (d_inetaton.U):
 526         This variable conditionally defines the HAS_INET_ATON symbol, which
 527         indicates to the C program that the inet_aton() function is available
 528         to parse IP address "dotted-quad" strings.
 529
 530 d_isascii (d_isascii.U):
 531         This variable conditionally defines the HAS_ISASCII constant,
 532         which indicates to the C program that isascii() is available.
 533
 534 d_killpg (d_killpg.U):
 535         This variable conditionally defines the HAS_KILLPG symbol, which
 536         indicates to the C program that the killpg() routine is available
 537         to kill process groups.
 538
 539 d_link (d_link.U):
 540         This variable conditionally defines HAS_LINK if link() is
 541         available to create hard links.
 542
 543 d_locconv (d_locconv.U):
 544         This variable conditionally defines HAS_LOCALECONV if localeconv() is
 545         available for numeric and monetary formatting conventions.
 546
 547 d_lockf (d_lockf.U):
 548         This variable conditionally defines HAS_LOCKF if lockf() is
 549         available to do file locking.
 550
 551 d_longdbl (d_longdbl.U):
 552         This variable conditionally defines HAS_LONG_DOUBLE if
 553         the long double type is supported.
 554
 555 d_longlong (d_longlong.U):
 556         This variable conditionally defines HAS_LONG_LONG if
 557         the long long type is supported.
 558
 559 d_lstat (d_lstat.U):
 560         This variable conditionally defines HAS_LSTAT if lstat() is
 561         available to do file stats on symbolic links.
 562
 563 d_mblen (d_mblen.U):
 564         This variable conditionally defines the HAS_MBLEN symbol, which
 565         indicates to the C program that the mblen() routine is available
 566         to find the number of bytes in a multibye character.
 567
 568 d_mbstowcs (d_mbstowcs.U):
 569         This variable conditionally defines the HAS_MBSTOWCS symbol, which
 570         indicates to the C program that the mbstowcs() routine is available
 571         to convert a multibyte string into a wide character string.
 572
 573 d_mbtowc (d_mbtowc.U):
 574         This variable conditionally defines the HAS_MBTOWC symbol, which
 575         indicates to the C program that the mbtowc() routine is available
 576         to convert multibyte to a wide character.
 577
 578 d_memcmp (d_memcmp.U):
 579         This variable conditionally defines the HAS_MEMCMP symbol, which
 580         indicates to the C program that the memcmp() routine is available
 581         to compare blocks of memory.
 582
 583 d_memcpy (d_memcpy.U):
 584         This variable conditionally defines the HAS_MEMCPY symbol, which
 585         indicates to the C program that the memcpy() routine is available
 586         to copy blocks of memory.
 587
 588 d_memmove (d_memmove.U):
 589         This variable conditionally defines the HAS_MEMMOVE symbol, which
 590         indicates to the C program that the memmove() routine is available
 591         to copy potentatially overlapping blocks of memory.
 592
 593 d_memset (d_memset.U):
 594         This variable conditionally defines the HAS_MEMSET symbol, which
 595         indicates to the C program that the memset() routine is available
 596         to set blocks of memory.
 597
 598 d_mkdir (d_mkdir.U):
 599         This variable conditionally defines the HAS_MKDIR symbol, which
 600         indicates to the C program that the mkdir() routine is available
 601         to create directories..
 602
 603 d_mkfifo (d_mkfifo.U):
 604         This variable conditionally defines the HAS_MKFIFO symbol, which
 605         indicates to the C program that the mkfifo() routine is available.
 606
 607 d_mkstemp (d_mkstemp.U):
 608         This variable conditionally defines the HAS_MKSTEMP symbol, which
 609         indicates to the C program that the mkstemp() routine is available
 610         to create and open a unique tempporary file.
 611
 612 d_mktime (d_mktime.U):
 613         This variable conditionally defines the HAS_MKTIME symbol, which
 614         indicates to the C program that the mktime() routine is available.
 615
 616 d_msg (d_msg.U):
 617         This variable conditionally defines the HAS_MSG symbol, which
 618         indicates that the entire msg*(2) library is present.
 619
 620 d_msgctl (d_msgctl.U):
 621         This variable conditionally defines the HAS_MSGCTL symbol, which
 622         indicates to the C program that the msgctl() routine is available.
 623
 624 d_msgget (d_msgget.U):
 625         This variable conditionally defines the HAS_MSGGET symbol, which
 626         indicates to the C program that the msgget() routine is available.
 627
 628 d_msgrcv (d_msgrcv.U):
 629         This variable conditionally defines the HAS_MSGRCV symbol, which
 630         indicates to the C program that the msgrcv() routine is available.
 631
 632 d_msgsnd (d_msgsnd.U):
 633         This variable conditionally defines the HAS_MSGSND symbol, which
 634         indicates to the C program that the msgsnd() routine is available.
 635
 636 d_mymalloc (mallocsrc.U):
 637         This variable conditionally defines MYMALLOC in case other parts
 638         of the source want to take special action if MYMALLOC is used.
 639         This may include different sorts of profiling or error detection.
 640
 641 d_nice (d_nice.U):
 642         This variable conditionally defines the HAS_NICE symbol, which
 643         indicates to the C program that the nice() routine is available.
 644
 645 d_oldpthreads (usethreads.U):
 646         This variable conditionally defines the OLD_PTHREADS_API symbol,
 647         and indicates that Perl should be built to use the old
 648         draft POSIX threads API.  This is only potneially meaningful if
 649         usethreads is set.
 650
 651 d_oldsock (d_socket.U):
 652         This variable conditionally defines the OLDSOCKET symbol, which
 653         indicates that the BSD socket interface is based on 4.1c and not 4.2.
 654
 655 d_open3 (d_open3.U):
 656         This variable conditionally defines the HAS_OPEN3 manifest constant,
 657         which indicates to the C program that the 3 argument version of
 658         the open(2) function is available.
 659
 660 d_pathconf (d_pathconf.U):
 661         This variable conditionally defines the HAS_PATHCONF symbol, which
 662         indicates to the C program that the pathconf() routine is available
 663         to determine file-system related limits and options associated
 664         with a given filename.
 665
 666 d_pause (d_pause.U):
 667         This variable conditionally defines the HAS_PAUSE symbol, which
 668         indicates to the C program that the pause() routine is available
 669         to suspend a process until a signal is received.
 670
 671 d_phostname (d_gethname.U):
 672         This variable conditionally defines the PHOSTNAME symbol, which
 673         contains the shell command which, when fed to popen(), may be
 674         used to derive the host name.
 675
 676 d_pipe (d_pipe.U):
 677         This variable conditionally defines the HAS_PIPE symbol, which
 678         indicates to the C program that the pipe() routine is available
 679         to create an inter-process channel.
 680
 681 d_poll (d_poll.U):
 682         This variable conditionally defines the HAS_POLL symbol, which
 683         indicates to the C program that the poll() routine is available
 684         to poll active file descriptors.
 685
 686 d_portable (d_portable.U):
 687         This variable conditionally defines the PORTABLE symbol, which
 688         indicates to the C program that it should not assume that it is
 689         running on the machine it was compiled on.
 690
 691 d_pthread_yield (d_pthread_y.U):
 692         This variable conditionally defines the HAS_PTHREAD_YIELD
 693         symbol if the pthread_yield routine is available to yield
 694         the execution of the current thread.
 695
 696 d_pthreads_created_joinable (d_pthreadj.U):
 697         This variable conditionally defines the PTHREADS_CREATED_JOINABLE
 698         symbol if pthreads are created in the joinable (aka undetached)
 699         state.
 700
 701 d_pwage (i_pwd.U):
 702         This varaible conditionally defines PWAGE, which indicates
 703         that struct passwd contains pw_age.
 704
 705 d_pwchange (i_pwd.U):
 706         This varaible conditionally defines PWCHANGE, which indicates
 707         that struct passwd contains pw_change.
 708
 709 d_pwclass (i_pwd.U):
 710         This varaible conditionally defines PWCLASS, which indicates
 711         that struct passwd contains pw_class.
 712
 713 d_pwcomment (i_pwd.U):
 714         This varaible conditionally defines PWCOMMENT, which indicates
 715         that struct passwd contains pw_comment.
 716
 717 d_pwexpire (i_pwd.U):
 718         This varaible conditionally defines PWEXPIRE, which indicates
 719         that struct passwd contains pw_expire.
 720
 721 d_pwquota (i_pwd.U):
 722         This varaible conditionally defines PWQUOTA, which indicates
 723         that struct passwd contains pw_quota.
 724
 725 d_readdir (d_readdir.U):
 726         This variable conditionally defines HAS_READDIR if readdir() is
 727         available to read directory entries.
 728
 729 d_readlink (d_readlink.U):
 730         This variable conditionally defines the HAS_READLINK symbol, which
 731         indicates to the C program that the readlink() routine is available
 732         to read the value of a symbolic link.
 733
 734 d_rename (d_rename.U):
 735         This variable conditionally defines the HAS_RENAME symbol, which
 736         indicates to the C program that the rename() routine is available
 737         to rename files.
 738
 739 d_rewinddir (d_readdir.U):
 740         This variable conditionally defines HAS_REWINDDIR if rewinddir() is
 741         available.
 742
 743 d_rmdir (d_rmdir.U):
 744         This variable conditionally defines HAS_RMDIR if rmdir() is
 745         available to remove directories.
 746
 747 d_safebcpy (d_safebcpy.U):
 748         This variable conditionally defines the HAS_SAFE_BCOPY symbol if
 749         the bcopy() routine can do overlapping copies.
 750
 751 d_safemcpy (d_safemcpy.U):
 752         This variable conditionally defines the HAS_SAFE_MEMCPY symbol if
 753         the memcpy() routine can do overlapping copies.
 754
 755 d_sanemcmp (d_sanemcmp.U):
 756         This variable conditionally defines the HAS_SANE_MEMCMP symbol if
 757         the memcpy() routine is available and can be used to compare relative
 758         magnitudes of chars with their high bits set.
 759
 760 d_sched_yield (d_pthread_y.U):
 761         This variable conditionally defines the HAS_SCHED_YIELD
 762         symbol if the sched_yield routine is available to yield
 763         the execution of the current thread.
 764
 765 d_seekdir (d_readdir.U):
 766         This variable conditionally defines HAS_SEEKDIR if seekdir() is
 767         available.
 768
 769 d_select (d_select.U):
 770         This variable conditionally defines HAS_SELECT if select() is
 771         available to select active file descriptors. A <sys/time.h>
 772         inclusion may be necessary for the timeout field.
 773
 774 d_sem (d_sem.U):
 775         This variable conditionally defines the HAS_SEM symbol, which
 776         indicates that the entire sem*(2) library is present.
 777
 778 d_semctl (d_semctl.U):
 779         This variable conditionally defines the HAS_SEMCTL symbol, which
 780         indicates to the C program that the semctl() routine is available.
 781
 782 d_semget (d_semget.U):
 783         This variable conditionally defines the HAS_SEMGET symbol, which
 784         indicates to the C program that the semget() routine is available.
 785
 786 d_semop (d_semop.U):
 787         This variable conditionally defines the HAS_SEMOP symbol, which
 788         indicates to the C program that the semop() routine is available.
 789
 790 d_setegid (d_setegid.U):
 791         This variable conditionally defines the HAS_SETEGID symbol, which
 792         indicates to the C program that the setegid() routine is available
 793         to change the effective gid of the current program.
 794
 795 d_seteuid (d_seteuid.U):
 796         This variable conditionally defines the HAS_SETEUID symbol, which
 797         indicates to the C program that the seteuid() routine is available
 798         to change the effective uid of the current program.
 799
 800 d_setgrps (d_setgrps.U):
 801         This variable conditionally defines the HAS_SETGROUPS symbol, which
 802         indicates to the C program that the setgroups() routine is available
 803         to set the list of process groups.
 804
 805 d_sethent (d_sethent.U):
 806         This variable conditionally defines HAS_SETHOSTENT if sethostent() is
 807         available.
 808
 809 d_setlinebuf (d_setlnbuf.U):
 810         This variable conditionally defines the HAS_SETLINEBUF symbol, which
 811         indicates to the C program that the setlinebuf() routine is available
 812         to change stderr or stdout from block-buffered or unbuffered to a
 813         line-buffered mode.
 814
 815 d_setlocale (d_setlocale.U):
 816         This variable conditionally defines HAS_SETLOCALE if setlocale() is
 817         available to handle locale-specific ctype implementations.
 818
 819 d_setnent (d_setnent.U):
 820         This variable conditionally defines HAS_SETNETENT if setnetent() is
 821         available.
 822
 823 d_setpent (d_setpent.U):
 824         This variable conditionally defines HAS_SETPROTOENT if setprotoent() is
 825         available.
 826
 827 d_setpgid (d_setpgid.U):
 828         This variable conditionally defines the HAS_SETPGID symbol if the
 829         setpgid(pid, gpid) function is available to set process group ID.
 830
 831 d_setpgrp2 (d_setpgrp2.U):
 832         This variable conditionally defines the HAS_SETPGRP2 symbol, which
 833         indicates to the C program that the setpgrp2() (as in DG/UX) routine
 834         is available to set the current process group.
 835
 836 d_setpgrp (d_setpgrp.U):
 837         This variable conditionally defines HAS_SETPGRP if setpgrp() is
 838         available to set the current process group.
 839
 840 d_setprior (d_setprior.U):
 841         This variable conditionally defines HAS_SETPRIORITY if setpriority()
 842         is available to set a process's priority.
 843
 844 d_setregid (d_setregid.U):
 845         This variable conditionally defines HAS_SETREGID if setregid() is
 846         available to change the real and effective gid of the current
 847         process.
 848
 849 d_setresgid (d_setregid.U):
 850         This variable conditionally defines HAS_SETRESGID if setresgid() is
 851         available to change the real, effective and saved gid of the current
 852         process.
 853
 854 d_setresuid (d_setreuid.U):
 855         This variable conditionally defines HAS_SETREUID if setresuid() is
 856         available to change the real, effective and saved uid of the current
 857         process.
 858
 859 d_setreuid (d_setreuid.U):
 860         This variable conditionally defines HAS_SETREUID if setreuid() is
 861         available to change the real and effective uid of the current
 862         process.
 863
 864 d_setrgid (d_setrgid.U):
 865         This variable conditionally defines the HAS_SETRGID symbol, which
 866         indicates to the C program that the setrgid() routine is available
 867         to change the real gid of the current program.
 868
 869 d_setruid (d_setruid.U):
 870         This variable conditionally defines the HAS_SETRUID symbol, which
 871         indicates to the C program that the setruid() routine is available
 872         to change the real uid of the current program.
 873
 874 d_setsent (d_setsent.U):
 875         This variable conditionally defines HAS_SETSERVENT if setservent() is
 876         available.
 877
 878 d_setsid (d_setsid.U):
 879         This variable conditionally defines HAS_SETSID if setsid() is
 880         available to set the process group ID.
 881
 882 d_setvbuf (d_setvbuf.U):
 883         This variable conditionally defines the HAS_SETVBUF symbol, which
 884         indicates to the C program that the setvbuf() routine is available
 885         to change buffering on an open stdio stream.
 886
 887 d_sfio (d_sfio.U):
 888         This variable conditionally defines the USE_SFIO symbol,
 889         and indicates whether sfio is available (and should be used).
 890
 891 d_shm (d_shm.U):
 892         This variable conditionally defines the HAS_SHM symbol, which
 893         indicates that the entire shm*(2) library is present.
 894
 895 d_shmat (d_shmat.U):
 896         This variable conditionally defines the HAS_SHMAT symbol, which
 897         indicates to the C program that the shmat() routine is available.
 898
 899 d_shmatprototype (d_shmat.U):
 900         This variable conditionally defines the HAS_SHMAT_PROTOTYPE
 901         symbol, which indicates that sys/shm.h has a prototype for
 902         shmat.
 903
 904 d_shmctl (d_shmctl.U):
 905         This variable conditionally defines the HAS_SHMCTL symbol, which
 906         indicates to the C program that the shmctl() routine is available.
 907
 908 d_shmdt (d_shmdt.U):
 909         This variable conditionally defines the HAS_SHMDT symbol, which
 910         indicates to the C program that the shmdt() routine is available.
 911
 912 d_shmget (d_shmget.U):
 913         This variable conditionally defines the HAS_SHMGET symbol, which
 914         indicates to the C program that the shmget() routine is available.
 915
 916 d_sigaction (d_sigaction.U):
 917         This variable conditionally defines the HAS_SIGACTION symbol, which
 918         indicates that the Vr4 sigaction() routine is available.
 919
 920 d_sigsetjmp (d_sigsetjmp.U):
 921         This variable conditionally defines the HAS_SIGSETJMP symbol,
 922         which indicates that the sigsetjmp() routine is available to
 923         call setjmp() and optionally save the process's signal mask.
 924
 925 d_socket (d_socket.U):
 926         This variable conditionally defines HAS_SOCKET, which indicates
 927         that the BSD socket interface is supported.
 928
 929 d_sockpair (d_socket.U):
 930         This variable conditionally defines the HAS_SOCKETPAIR symbol, which
 931         indicates that the BSD socketpair() is supported.
 932
 933 d_statblks (d_statblks.U):
 934         This variable conditionally defines USE_STAT_BLOCKS if this system
 935         has a stat structure declaring st_blksize and st_blocks.
 936
 937 d_stdio_cnt_lval (d_stdstdio.U):
 938         This variable conditionally defines STDIO_CNT_LVALUE if the
 939         FILE_cnt macro can be used as an lvalue.
 940
 941 d_stdio_ptr_lval (d_stdstdio.U):
 942         This variable conditionally defines STDIO_PTR_LVALUE if the
 943         FILE_ptr macro can be used as an lvalue.
 944
 945 d_stdiobase (d_stdstdio.U):
 946         This variable conditionally defines USE_STDIO_BASE if this system
 947         has a FILE structure declaring a usable _base field (or equivalent)
 948         in stdio.h.
 949
 950 d_stdstdio (d_stdstdio.U):
 951         This variable conditionally defines USE_STDIO_PTR if this system
 952         has a FILE structure declaring usable _ptr and _cnt fields (or
 953         equivalent) in stdio.h.
 954
 955 d_strchr (d_strchr.U):
 956         This variable conditionally defines HAS_STRCHR if strchr() and
 957         strrchr() are available for string searching.
 958
 959 d_strcoll (d_strcoll.U):
 960         This variable conditionally defines HAS_STRCOLL if strcoll() is
 961         available to compare strings using collating information.
 962
 963 d_strctcpy (d_strctcpy.U):
 964         This variable conditionally defines the USE_STRUCT_COPY symbol, which
 965         indicates to the C program that this C compiler knows how to copy
 966         structures.
 967
 968 d_strerrm (d_strerror.U):
 969         This variable holds what Strerrr is defined as to translate an error
 970         code condition into an error message string. It could be 'strerror'
 971         or a more complex macro emulating strrror with sys_errlist[], or the
 972         "unknown" string when both strerror and sys_errlist are missing.
 973
 974 d_strerror (d_strerror.U):
 975         This variable conditionally defines HAS_STRERROR if strerror() is
 976         available to translate error numbers to strings.
 977
 978 d_strtod (d_strtod.U):
 979         This variable conditionally defines the HAS_STRTOD symbol, which
 980         indicates to the C program that the strtod() routine is available
 981         to provide better numeric string conversion than atof().
 982
 983 d_strtol (d_strtol.U):
 984         This variable conditionally defines the HAS_STRTOL symbol, which
 985         indicates to the C program that the strtol() routine is available
 986         to provide better numeric string conversion than atoi() and friends.
 987
 988 d_strtoul (d_strtoul.U):
 989         This variable conditionally defines the HAS_STRTOUL symbol, which
 990         indicates to the C program that the strtoul() routine is available
 991         to provide conversion of strings to unsigned long.
 992
 993 d_strxfrm (d_strxfrm.U):
 994         This variable conditionally defines HAS_STRXFRM if strxfrm() is
 995         available to transform strings.
 996
 997 d_suidsafe (d_dosuid.U):
 998         This variable conditionally defines SETUID_SCRIPTS_ARE_SECURE_NOW
 999         if setuid scripts can be secure.  This test looks in /dev/fd/.
1000
1001 d_symlink (d_symlink.U):
1002         This variable conditionally defines the HAS_SYMLINK symbol, which
1003         indicates to the C program that the symlink() routine is available
1004         to create symbolic links.
1005
1006 d_syscall (d_syscall.U):
1007         This variable conditionally defines HAS_SYSCALL if syscall() is
1008         available call arbitrary system calls.
1009
1010 d_sysconf (d_sysconf.U):
1011         This variable conditionally defines the HAS_SYSCONF symbol, which
1012         indicates to the C program that the sysconf() routine is available
1013         to determine system related limits and options.
1014
1015 d_sysernlst (d_strerror.U):
1016         This variable conditionally defines HAS_SYS_ERRNOLIST if sys_errnolist[]
1017         is available to translate error numbers to the symbolic name.
1018
1019 d_syserrlst (d_strerror.U):
1020         This variable conditionally defines HAS_SYS_ERRLIST if sys_errlist[] is
1021         available to translate error numbers to strings.
1022
1023 d_system (d_system.U):
1024         This variable conditionally defines HAS_SYSTEM if system() is
1025         available to issue a shell command.
1026
1027 d_tcgetpgrp (d_tcgtpgrp.U):
1028         This variable conditionally defines the HAS_TCGETPGRP symbol, which
1029         indicates to the C program that the tcgetpgrp() routine is available.
1030         to get foreground process group ID.
1031
1032 d_tcsetpgrp (d_tcstpgrp.U):
1033         This variable conditionally defines the HAS_TCSETPGRP symbol, which
1034         indicates to the C program that the tcsetpgrp() routine is available
1035         to set foreground process group ID.
1036
1037 d_telldir (d_readdir.U):
1038         This variable conditionally defines HAS_TELLDIR if telldir() is
1039         available.
1040
1041 d_time (d_time.U):
1042         This variable conditionally defines the HAS_TIME symbol, which indicates
1043         that the time() routine exists.  The time() routine is normaly
1044         provided on UNIX systems.
1045
1046 d_times (d_times.U):
1047         This variable conditionally defines the HAS_TIMES symbol, which indicates
1048         that the times() routine exists.  The times() routine is normaly
1049         provided on UNIX systems. You may have to include <sys/times.h>.
1050
1051 d_truncate (d_truncate.U):
1052         This variable conditionally defines HAS_TRUNCATE if truncate() is
1053         available to truncate files.
1054
1055 d_tzname (d_tzname.U):
1056         This variable conditionally defines HAS_TZNAME if tzname[] is
1057         available to access timezone names.
1058
1059 d_umask (d_umask.U):
1060         This variable conditionally defines the HAS_UMASK symbol, which
1061         indicates to the C program that the umask() routine is available.
1062         to set and get the value of the file creation mask.
1063
1064 d_uname (d_gethname.U):
1065         This variable conditionally defines the HAS_UNAME symbol, which
1066         indicates to the C program that the uname() routine may be
1067         used to derive the host name.
1068
1069 d_vfork (d_vfork.U):
1070         This variable conditionally defines the HAS_VFORK symbol, which
1071         indicates the vfork() routine is available.
1072
1073 d_void_closedir (d_closedir.U):
1074         This variable conditionally defines VOID_CLOSEDIR if closedir()
1075         does not return a value.
1076
1077 d_voidsig (d_voidsig.U):
1078         This variable conditionally defines VOIDSIG if this system
1079         declares "void (*signal(...))()" in signal.h.  The old way was to
1080         declare it as "int (*signal(...))()".
1081
1082 d_voidtty (i_sysioctl.U):
1083         This variable conditionally defines USE_IOCNOTTY to indicate that the
1084         ioctl() call with TIOCNOTTY should be used to void tty association.
1085         Otherwise (on USG probably), it is enough to close the standard file
1086         decriptors and do a setpgrp().
1087
1088 d_volatile (d_volatile.U):
1089         This variable conditionally defines the HASVOLATILE symbol, which
1090         indicates to the C program that this C compiler knows about the
1091         volatile declaration.
1092
1093 d_vprintf (d_vprintf.U):
1094         This variable conditionally defines the HAS_VPRINTF symbol, which
1095         indicates to the C program that the vprintf() routine is available
1096         to printf with a pointer to an argument list.
1097
1098 d_wait4 (d_wait4.U):
1099         This variable conditionally defines the HAS_WAIT4 symbol, which
1100         indicates the wait4() routine is available.
1101
1102 d_waitpid (d_waitpid.U):
1103         This variable conditionally defines HAS_WAITPID if waitpid() is
1104         available to wait for child process.
1105
1106 d_wcstombs (d_wcstombs.U):
1107         This variable conditionally defines the HAS_WCSTOMBS symbol, which
1108         indicates to the C program that the wcstombs() routine is available
1109         to convert wide character strings to multibyte strings.
1110
1111 d_wctomb (d_wctomb.U):
1112         This variable conditionally defines the HAS_WCTOMB symbol, which
1113         indicates to the C program that the wctomb() routine is available
1114         to convert a wide character to a multibyte.
1115
1116 d_xenix (Guess.U):
1117         This variable conditionally defines the symbol XENIX, which alerts
1118         the C program that it runs under Xenix.
1119
1120 db_hashtype (i_db.U):
1121         This variable contains the type of the hash structure element
1122         in the <db.h> header file.  In older versions of DB, it was
1123         int, while in newer ones it is u_int32_t.
1124
1125 db_prefixtype (i_db.U):
1126         This variable contains the type of the prefix structure element
1127         in the <db.h> header file.  In older versions of DB, it was
1128         int, while in newer ones it is size_t.
1129
1130 direntrytype (i_dirent.U):
1131         This symbol is set to 'struct direct' or 'struct dirent' depending on
1132         whether dirent is available or not. You should use this pseudo type to
1133         portably declare your directory entries.
1134
1135 dlext (dlext.U):
1136         This variable contains the extension that is to be used for the
1137         dynamically loaded modules that perl generaties.
1138
1139 dlsrc (dlsrc.U):
1140         This variable contains the name of the dynamic loading file that
1141         will be used with the package.
1142
1143 doublesize (doublesize.U):
1144         This variable contains the value of the DOUBLESIZE symbol, which
1145         indicates to the C program how many bytes there are in a double.
1146
1147 dynamic_ext (Extensions.U):
1148         This variable holds a list of extension files we want to
1149         link dynamically into the package.  It is used by Makefile.
1150
1151 eagain (nblock_io.U):
1152         This variable bears the symbolic errno code set by read() when no
1153         data is present on the file and non-blocking I/O was enabled (otherwise,
1154         read() blocks naturally).
1155
1156 eunicefix (Init.U):
1157         When running under Eunice this variable contains a command which will
1158         convert a shell script to the proper form of text file for it to be
1159         executable by the shell.  On other systems it is a no-op.
1160
1161 exe_ext (Unix.U):
1162         This is an old synonym for _exe.
1163
1164 extensions (Extensions.U):
1165         This variable holds a list of all extension files
1166         linked into the package.  It is propagated to Config.pm
1167         and is typically used to test whether a particular extesion
1168         is available.
1169
1170 firstmakefile (Unix.U):
1171         This variable defines the first file searched by make.  On unix,
1172         it is makefile (then Makefile).  On case-insensitive systems,
1173         it might be something else.  This is only used to deal with
1174         convoluted make depend tricks.
1175
1176 fpostype (fpostype.U):
1177         This variable defines Fpos_t to be something like fpost_t, long,
1178         uint, or whatever type is used to declare file positions in libc.
1179
1180 freetype (mallocsrc.U):
1181         This variable contains the return type of free().  It is usually
1182         void, but occasionally int.
1183
1184 full_csh (d_csh.U):
1185         This variable contains the full pathname to 'csh', whether or
1186         not the user has specified 'portability'.  This is only used
1187         in the compiled C program, and we assume that all systems which
1188         can share this executable will have the same full pathname to
1189         'csh.'
1190
1191 full_sed (Loc_sed.U):
1192         This variable contains the full pathname to 'sed', whether or
1193         not the user has specified 'portability'.  This is only used
1194         in the compiled C program, and we assume that all systems which
1195         can share this executable will have the same full pathname to
1196         'sed.'
1197
1198 gccversion (cc.U):
1199         If GNU cc (gcc) is used, this variable holds '1' or '2' to
1200         indicate whether the compiler is version 1 or 2.  This is used in
1201         setting some of the default cflags.  It is set to '' if not gcc.
1202
1203 gidtype (gidtype.U):
1204         This variable defines Gid_t to be something like gid_t, int,
1205         ushort, or whatever type is used to declare the return type
1206         of getgid().  Typically, it is the type of group ids in the kernel.
1207
1208 groupcat (nis.U):
1209         This variable contains a command that produces the text of the
1210         /etc/group file.  This is normally "cat /etc/group", but can be
1211         "ypcat group" when NIS is used.
1212
1213 groupstype (groupstype.U):
1214         This variable defines Groups_t to be something like gid_t, int,
1215         ushort, or whatever type is used for the second argument to
1216         getgroups() and setgroups().  Usually, this is the same as
1217         gidtype (gid_t), but sometimes it isn't.
1218
1219 h_fcntl (h_fcntl.U):
1220         This is variable gets set in various places to tell i_fcntl that
1221         <fcntl.h> should be included.
1222
1223 h_sysfile (h_sysfile.U):
1224         This is variable gets set in various places to tell i_sys_file that
1225         <sys/file.h> should be included.
1226
1227 hint (Oldconfig.U):
1228         Gives the type of hints used for previous answers. May be one of
1229         "default", "recommended" or "previous".
1230
1231 hostcat (nis.U):
1232         This variable contains a command that produces the text of the
1233         /etc/hosts file.  This is normally "cat /etc/hosts", but can be
1234         "ypcat hosts" when NIS is used.
1235
1236 huge (models.U):
1237         This variable contains a flag which will tell the C compiler and loader
1238         to produce a program running with a huge memory model.  If the
1239         huge model is not supported, contains the flag to produce large
1240         model programs.  It is up to the Makefile to use this.
1241
1242 i_bsdioctl (i_sysioctl.U):
1243         This variable conditionally defines the I_SYS_BSDIOCTL symbol, which
1244         indicates to the C program that <sys/bsdioctl.h> exists and should
1245         be included.
1246
1247 i_db (i_db.U):
1248         This variable conditionally defines the I_DB symbol, and indicates
1249         whether a C program may include Berkeley's DB include file <db.h>.
1250
1251 i_dbm (i_dbm.U):
1252         This variable conditionally defines the I_DBM symbol, which
1253         indicates to the C program that <dbm.h> exists and should
1254         be included.
1255
1256 i_dirent (i_dirent.U):
1257         This variable conditionally defines I_DIRENT, which indicates
1258         to the C program that it should include <dirent.h>.
1259
1260 i_dld (i_dld.U):
1261         This variable conditionally defines the I_DLD symbol, which
1262         indicates to the C program that <dld.h> (GNU dynamic loading)
1263         exists and should be included.
1264
1265 i_dlfcn (i_dlfcn.U):
1266         This variable conditionally defines the I_DLFCN symbol, which
1267         indicates to the C program that <dlfcn.h> exists and should
1268         be included.
1269
1270 i_fcntl (i_fcntl.U):
1271         This variable controls the value of I_FCNTL (which tells
1272         the C program to include <fcntl.h>).
1273
1274 i_float (i_float.U):
1275         This variable conditionally defines the I_FLOAT symbol, and indicates
1276         whether a C program may include <float.h> to get symbols like DBL_MAX
1277         or DBL_MIN, i.e. machine dependent floating point values.
1278
1279 i_gdbm (i_gdbm.U):
1280         This variable conditionally defines the I_GDBM symbol, which
1281         indicates to the C program that <gdbm.h> exists and should
1282         be included.
1283
1284 i_grp (i_grp.U):
1285         This variable conditionally defines the I_GRP symbol, and indicates
1286         whether a C program should include <grp.h>.
1287
1288 i_limits (i_limits.U):
1289         This variable conditionally defines the I_LIMITS symbol, and indicates
1290         whether a C program may include <limits.h> to get symbols like WORD_BIT
1291         and friends.
1292
1293 i_locale (i_locale.U):
1294         This variable conditionally defines the I_LOCALE symbol,
1295         and indicates whether a C program should include <locale.h>.
1296
1297 i_malloc (i_malloc.U):
1298         This variable conditionally defines the I_MALLOC symbol, and indicates
1299         whether a C program should include <malloc.h>.
1300
1301 i_math (i_math.U):
1302         This variable conditionally defines the I_MATH symbol, and indicates
1303         whether a C program may include <math.h>.
1304
1305 i_memory (i_memory.U):
1306         This variable conditionally defines the I_MEMORY symbol, and indicates
1307         whether a C program should include <memory.h>.
1308
1309 i_ndbm (i_ndbm.U):
1310         This variable conditionally defines the I_NDBM symbol, which
1311         indicates to the C program that <ndbm.h> exists and should
1312         be included.
1313
1314 i_netdb (i_netdb.U):
1315         This variable conditionally defines the I_NETDB symbol, and indicates
1316         whether a C program should include <netdb.h>.
1317
1318 i_neterrno (i_neterrno.U):
1319         This variable conditionally defines the I_NET_ERRNO symbol, which
1320         indicates to the C program that <net/errno.h> exists and should
1321         be included.
1322
1323 i_niin (i_niin.U):
1324         This variable conditionally defines I_NETINET_IN, which indicates
1325         to the C program that it should include <netinet/in.h>. Otherwise,
1326         you may try <sys/in.h>.
1327
1328 i_pwd (i_pwd.U):
1329         This variable conditionally defines I_PWD, which indicates
1330         to the C program that it should include <pwd.h>.
1331
1332 i_rpcsvcdbm (i_dbm.U):
1333         This variable conditionally defines the I_RPCSVC_DBM symbol, which
1334         indicates to the C program that <rpcsvc/dbm.h> exists and should
1335         be included.  Some System V systems might need this instead of <dbm.h>.
1336
1337 i_sfio (i_sfio.U):
1338         This variable conditionally defines the I_SFIO symbol,
1339         and indicates whether a C program should include <sfio.h>.
1340
1341 i_sgtty (i_termio.U):
1342         This variable conditionally defines the I_SGTTY symbol, which
1343         indicates to the C program that it should include <sgtty.h> rather
1344         than <termio.h>.
1345
1346 i_stdarg (i_varhdr.U):
1347         This variable conditionally defines the I_STDARG symbol, which
1348         indicates to the C program that <stdarg.h> exists and should
1349         be included.
1350
1351 i_stddef (i_stddef.U):
1352         This variable conditionally defines the I_STDDEF symbol, which
1353         indicates to the C program that <stddef.h> exists and should
1354         be included.
1355
1356 i_stdlib (i_stdlib.U):
1357         This variable conditionally defines the I_STDLIB symbol, which
1358         indicates to the C program that <stdlib.h> exists and should
1359         be included.
1360
1361 i_string (i_string.U):
1362         This variable conditionally defines the I_STRING symbol, which
1363         indicates that <string.h> should be included rather than <strings.h>.
1364
1365 i_sysdir (i_sysdir.U):
1366         This variable conditionally defines the I_SYS_DIR symbol, and indicates
1367         whether a C program should include <sys/dir.h>.
1368
1369 i_sysfile (i_sysfile.U):
1370         This variable conditionally defines the I_SYS_FILE symbol, and indicates
1371         whether a C program should include <sys/file.h> to get R_OK and friends.
1372
1373 i_sysfilio (i_sysioctl.U):
1374         This variable conditionally defines the I_SYS_FILIO symbol, which
1375         indicates to the C program that <sys/filio.h> exists and should
1376         be included in preference to <sys/ioctl.h>.
1377
1378 i_sysin (i_niin.U):
1379         This variable conditionally defines I_SYS_IN, which indicates
1380         to the C program that it should include <sys/in.h> instead of
1381         <netinet/in.h>.
1382
1383 i_sysioctl (i_sysioctl.U):
1384         This variable conditionally defines the I_SYS_IOCTL symbol, which
1385         indicates to the C program that <sys/ioctl.h> exists and should
1386         be included.
1387
1388 i_sysndir (i_sysndir.U):
1389         This variable conditionally defines the I_SYS_NDIR symbol, and indicates
1390         whether a C program should include <sys/ndir.h>.
1391
1392 i_sysparam (i_sysparam.U):
1393         This variable conditionally defines the I_SYS_PARAM symbol, and indicates
1394         whether a C program should include <sys/param.h>.
1395
1396 i_sysresrc (i_sysresrc.U):
1397         This variable conditionally defines the I_SYS_RESOURCE symbol,
1398         and indicates whether a C program should include <sys/resource.h>.
1399
1400 i_sysselct (i_sysselct.U):
1401         This variable conditionally defines I_SYS_SELECT, which indicates
1402         to the C program that it should include <sys/select.h> in order to
1403         get the definition of struct timeval.
1404
1405 i_syssockio (i_sysioctl.U):
1406         This variable conditionally defines I_SYS_SOCKIO to indicate to the
1407         C program that socket ioctl codes may be found in <sys/sockio.h>
1408         instead of <sys/ioctl.h>.
1409
1410 i_sysstat (i_sysstat.U):
1411         This variable conditionally defines the I_SYS_STAT symbol,
1412         and indicates whether a C program should include <sys/stat.h>.
1413
1414 i_systime (i_time.U):
1415         This variable conditionally defines I_SYS_TIME, which indicates
1416         to the C program that it should include <sys/time.h>.
1417
1418 i_systimek (i_time.U):
1419         This variable conditionally defines I_SYS_TIME_KERNEL, which
1420         indicates to the C program that it should include <sys/time.h>
1421         with KERNEL defined.
1422
1423 i_systimes (i_systimes.U):
1424         This variable conditionally defines the I_SYS_TIMES symbol, and indicates
1425         whether a C program should include <sys/times.h>.
1426
1427 i_systypes (i_systypes.U):
1428         This variable conditionally defines the I_SYS_TYPES symbol,
1429         and indicates whether a C program should include <sys/types.h>.
1430
1431 i_sysun (i_sysun.U):
1432         This variable conditionally defines I_SYS_UN, which indicates
1433         to the C program that it should include <sys/un.h> to get UNIX
1434         domain socket definitions.
1435
1436 i_syswait (i_syswait.U):
1437         This variable conditionally defines I_SYS_WAIT, which indicates
1438         to the C program that it should include <sys/wait.h>.
1439
1440 i_termio (i_termio.U):
1441         This variable conditionally defines the I_TERMIO symbol, which
1442         indicates to the C program that it should include <termio.h> rather
1443         than <sgtty.h>.
1444
1445 i_termios (i_termio.U):
1446         This variable conditionally defines the I_TERMIOS symbol, which
1447         indicates to the C program that the POSIX <termios.h> file is
1448         to be included.
1449
1450 i_time (i_time.U):
1451         This variable conditionally defines I_TIME, which indicates
1452         to the C program that it should include <time.h>.
1453
1454 i_unistd (i_unistd.U):
1455         This variable conditionally defines the I_UNISTD symbol, and indicates
1456         whether a C program should include <unistd.h>.
1457
1458 i_utime (i_utime.U):
1459         This variable conditionally defines the I_UTIME symbol, and indicates
1460         whether a C program should include <utime.h>.
1461
1462 i_values (i_values.U):
1463         This variable conditionally defines the I_VALUES symbol, and indicates
1464         whether a C program may include <values.h> to get symbols like MAXLONG
1465         and friends.
1466
1467 i_varargs (i_varhdr.U):
1468         This variable conditionally defines I_VARARGS, which indicates
1469         to the C program that it should include <varargs.h>.
1470
1471 i_varhdr (i_varhdr.U):
1472         Contains the name of the header to be included to get va_dcl definition.
1473         Typically one of varargs.h or stdarg.h.
1474
1475 i_vfork (i_vfork.U):
1476         This variable conditionally defines the I_VFORK symbol, and indicates
1477         whether a C program should include vfork.h.
1478
1479 incpath (usrinc.U):
1480         This variable must preceed the normal include path to get hte
1481         right one, as in "$incpath/usr/include" or "$incpath/usr/lib".
1482         Value can be "" or "/bsd43" on mips.
1483
1484 installarchlib (archlib.U):
1485         This variable is really the same as archlibexp but may differ on
1486         those systems using AFS. For extra portability, only this variable
1487         should be used in makefiles.
1488
1489 installbin (bin.U):
1490         This variable is the same as binexp unless AFS is running in which case
1491         the user is explicitely prompted for it. This variable should always
1492         be used in your makefiles for maximum portability.
1493
1494 installman1dir (man1dir.U):
1495         This variable is really the same as man1direxp, unless you are using
1496         AFS in which case it points to the read/write location whereas
1497         man1direxp only points to the read-only access location. For extra
1498         portability, you should only use this variable within your makefiles.
1499
1500 installman3dir (man3dir.U):
1501         This variable is really the same as man3direxp, unless you are using
1502         AFS in which case it points to the read/write location whereas
1503         man3direxp only points to the read-only access location. For extra
1504         portability, you should only use this variable within your makefiles.
1505
1506 installprivlib (privlib.U):
1507         This variable is really the same as privlibexp but may differ on
1508         those systems using AFS. For extra portability, only this variable
1509         should be used in makefiles.
1510
1511 installscript (scriptdir.U):
1512         This variable is usually the same as scriptdirexp, unless you are on
1513         a system running AFS, in which case they may differ slightly. You
1514         should always use this variable within your makefiles for portability.
1515
1516 installsitearch (sitearch.U):
1517         This variable is really the same as sitearchexp but may differ on
1518         those systems using AFS. For extra portability, only this variable
1519         should be used in makefiles.
1520
1521 installsitelib (sitelib.U):
1522         This variable is really the same as sitelibexp but may differ on
1523         those systems using AFS. For extra portability, only this variable
1524         should be used in makefiles.
1525
1526 intsize (intsize.U):
1527         This variable contains the value of the INTSIZE symbol, which
1528         indicates to the C program how many bytes there are in an int.
1529
1530 known_extensions (Extensions.U):
1531         This variable holds a list of all extensions included in
1532         the package.
1533
1534 large (models.U):
1535         This variable contains a flag which will tell the C compiler and loader
1536         to produce a program running with a large memory model.  It is up to
1537         the Makefile to use this.
1538
1539 ld (dlsrc.U):
1540         This variable indicates the program to be used to link
1541         libraries for dynamic loading.  On some systems, it is 'ld'.
1542         On ELF systems, it should be $cc.  Mostly, we'll try to respect
1543         the hint file setting.
1544
1545 lddlflags (dlsrc.U):
1546         This variable contains any special flags that might need to be
1547         passed to $ld to create a shared library suitable for dynamic
1548         loading.  It is up to the makefile to use it.  For hpux, it
1549         should be -b.  For sunos 4.1, it is empty.
1550
1551 ldflags (ccflags.U):
1552         This variable contains any additional C loader flags desired by
1553         the user.  It is up to the Makefile to use this.
1554
1555 lib_ext (Unix.U):
1556         This is an old synonym for _a.
1557
1558 libc (libc.U):
1559         This variable contains the location of the C library.
1560
1561 libperl (libperl.U):
1562         The perl executable is obtained by linking perlmain.c with
1563         libperl, any static extensions (usually just DynaLoader),
1564         and any other libraries needed on this system.  libperl
1565         is usually libperl.a, but can also be libperl.so.xxx if
1566         the user wishes to build a perl executable with a shared
1567         library.
1568
1569 libpth (libpth.U):
1570         This variable holds the general path used to find libraries. It is
1571         intended to be used by other units.
1572
1573 libs (libs.U):
1574         This variable holds the additional libraries we want to use.
1575         It is up to the Makefile to deal with it.
1576
1577 libswanted (Myinit.U):
1578         This variable holds a list of all the libraries we want to
1579         search.  The order is chosen to pick up the c library
1580         ahead of ucb or bsd libraries for SVR4.
1581
1582 lkflags (ccflags.U):
1583         This variable contains any additional C partial linker flags desired by
1584         the user.  It is up to the Makefile to use this.
1585
1586 lns (lns.U):
1587         This variable holds the name of the command to make
1588         symbolic links (if they are supported).  It can be used
1589         in the Makefile. It is either 'ln -s' or 'ln'
1590
1591 locincpth (ccflags.U):
1592         This variable contains a list of additional directories to be
1593         searched by the compiler.  The appropriate -I directives will
1594         be added to ccflags.  This is intended to simplify setting
1595         local directories from the Configure command line.
1596         It's not much, but it parallels the loclibpth stuff in libpth.U.
1597
1598 loclibpth (libpth.U):
1599         This variable holds the paths used to find local libraries.  It is
1600         prepended to libpth, and is intended to be easily set from the
1601         command line.
1602
1603 longdblsize (d_longdbl.U):
1604         This variable contains the value of the LONG_DOUBLESIZE symbol, which
1605         indicates to the C program how many bytes there are in a long double,
1606         if this system supports long doubles.
1607
1608 longlongsize (d_longlong.U):
1609         This variable contains the value of the LONGLONGSIZE symbol, which
1610         indicates to the C program how many bytes there are in a long long,
1611         if this system supports long long.
1612
1613 longsize (intsize.U):
1614         This variable contains the value of the LONGSIZE symbol, which
1615         indicates to the C program how many bytes there are in a long.
1616
1617 lseektype (lseektype.U):
1618         This variable defines lseektype to be something like off_t, long,
1619         or whatever type is used to declare lseek offset's type in the
1620         kernel (which also appears to be lseek's return type).
1621
1622 make_set_make (make.U):
1623         Some versions of 'make' set the variable MAKE.  Others do not.
1624         This variable contains the string to be included in Makefile.SH
1625         so that MAKE is set if needed, and not if not needed.
1626         Possible values are:
1627         make_set_make='#'               # If your make program handles this for you,
1628         make_set_make="MAKE=$make"      # if it doesn't.
1629         I used a comment character so that we can distinguish a
1630         'set' value (from a previous config.sh or Configure -D option)
1631         from an uncomputed value.
1632
1633 mallocobj (mallocsrc.U):
1634         This variable contains the name of the malloc.o that this package
1635         generates, if that malloc.o is preferred over the system malloc.
1636         Otherwise the value is null.  This variable is intended for generating
1637         Makefiles.  See mallocsrc.
1638
1639 mallocsrc (mallocsrc.U):
1640         This variable contains the name of the malloc.c that comes with
1641         the package, if that malloc.c is preferred over the system malloc.
1642         Otherwise the value is null.  This variable is intended for generating
1643         Makefiles.
1644
1645 malloctype (mallocsrc.U):
1646         This variable contains the kind of ptr returned by malloc and realloc.
1647
1648 man1dir (man1dir.U):
1649         This variable contains the name of the directory in which manual
1650         source pages are to be put.  It is the responsibility of the
1651         Makefile.SH to get the value of this into the proper command.
1652         You must be prepared to do the ~name expansion yourself.
1653
1654 man1direxp (man1dir.U):
1655         This variable is the same as the man1dir variable, but is filename
1656         expanded at configuration time, for convenient use in makefiles.
1657
1658 man1ext (man1dir.U):
1659         This variable contains the extension that the manual page should
1660         have: one of 'n', 'l', or '1'.  The Makefile must supply the '.'.
1661         See man1dir.
1662
1663 man3dir (man3dir.U):
1664         This variable contains the name of the directory in which manual
1665         source pages are to be put.  It is the responsibility of the
1666         Makefile.SH to get the value of this into the proper command.
1667         You must be prepared to do the ~name expansion yourself.
1668
1669 man3direxp (man3dir.U):
1670         This variable is the same as the man3dir variable, but is filename
1671         expanded at configuration time, for convenient use in makefiles.
1672
1673 man3ext (man3dir.U):
1674         This variable contains the extension that the manual page should
1675         have: one of 'n', 'l', or '3'.  The Makefile must supply the '.'.
1676         See man3dir.
1677
1678 medium (models.U):
1679         This variable contains a flag which will tell the C compiler and loader
1680         to produce a program running with a medium memory model.  If the
1681         medium model is not supported, contains the flag to produce large
1682         model programs.  It is up to the Makefile to use this.
1683
1684 mips_type (usrinc.U):
1685         This variable holds the environment type for the mips system.
1686         Possible values are "BSD 4.3" and "System V".
1687
1688 models (models.U):
1689         This variable contains the list of memory models supported by this
1690         system.  Possible component values are none, split, unsplit, small,
1691         medium, large, and huge.  The component values are space separated.
1692
1693 modetype (modetype.U):
1694         This variable defines modetype to be something like mode_t,
1695         int, unsigned short, or whatever type is used to declare file
1696         modes for system calls.
1697
1698 myarchname (archname.U):
1699         This variable holds the architecture name computed by Configure in
1700         a previous run. It is not intended to be perused by any user and
1701         should never be set in a hint file.
1702
1703 mydomain (myhostname.U):
1704         This variable contains the eventual value of the MYDOMAIN symbol,
1705         which is the domain of the host the program is going to run on.
1706         The domain must be appended to myhostname to form a complete host name.
1707         The dot comes with mydomain, and need not be supplied by the program.
1708
1709 myhostname (myhostname.U):
1710         This variable contains the eventual value of the MYHOSTNAME symbol,
1711         which is the name of the host the program is going to run on.
1712         The domain is not kept with hostname, but must be gotten from mydomain.
1713         The dot comes with mydomain, and need not be supplied by the program.
1714
1715 myuname (Oldconfig.U):
1716         The output of 'uname -a' if available, otherwise the hostname. On Xenix,
1717         pseudo variables assignments in the output are stripped, thank you. The
1718         whole thing is then lower-cased.
1719
1720 n (n.U):
1721         This variable contains the -n flag if that is what causes the echo
1722         command to suppress newline.  Otherwise it is null.  Correct usage is
1723             $echo $n "prompt for a question: $c".
1724
1725 netdb_hlen_type (netdbtype.U):
1726         This variable holds the type used for the 2nd argument to
1727         gethostbyaddr().  Usually, this is int or size_t or unsigned.
1728         This is only useful if you have gethostbyaddr(), naturally.
1729
1730 netdb_host_type (netdbtype.U):
1731         This variable holds the type used for the 1st argument to
1732         gethostbyaddr().  Usually, this is char * or void *,  possibly
1733         with or without a const prefix.
1734         This is only useful if you have gethostbyaddr(), naturally.
1735
1736 netdb_name_type (netdbtype.U):
1737         This variable holds the type used for the argument to
1738         gethostbyname().  Usually, this is char * or const char *.
1739         This is only useful if you have gethostbyname(), naturally.
1740
1741 netdb_net_type (netdbtype.U):
1742         This variable holds the type used for the 1st argument to
1743         getnetbyaddr().  Usually, this is int or long.
1744         This is only useful if you have getnetbyaddr(), naturally.
1745
1746 nm_opt (usenm.U):
1747         This variable holds the options that may be necessary for nm.
1748
1749 nm_so_opt (usenm.U):
1750         This variable holds the options that may be necessary for nm
1751         to work on a shared library but that can not be used on an
1752         archive library.  Currently, this is only used by Linux, where
1753         nm --dynamic is *required* to get symbols from an ELF library which
1754         has been stripped, but nm --dynamic is *fatal* on an archive library.
1755         Maybe Linux should just always set usenm=false.
1756
1757 o_nonblock (nblock_io.U):
1758         This variable bears the symbol value to be used during open() or fcntl()
1759         to turn on non-blocking I/O for a file descriptor. If you wish to switch
1760         between blocking and non-blocking, you may try ioctl(FIOSNBIO) instead,
1761         but that is only supported by some devices.
1762
1763 obj_ext (Unix.U):
1764         This is an old synonym for _o.
1765
1766 optimize (ccflags.U):
1767         This variable contains any optimizer/debugger flag that should be used.
1768         It is up to the Makefile to use it.
1769
1770 orderlib (orderlib.U):
1771         This variable is "true" if the components of libraries must be ordered
1772         (with `lorder $* | tsort`) before placing them in an archive.  Set to
1773         "false" if ranlib or ar can generate random libraries.
1774
1775 osname (Oldconfig.U):
1776         This variable contains the operating system name (e.g. sunos,
1777         solaris, hpux, etc.).  It can be useful later on for setting
1778         defaults.  Any spaces are replaced with underscores.  It is set
1779         to a null string if we can't figure it out.
1780
1781 osvers (Oldconfig.U):
1782         This variable contains the operating system version (e.g.
1783         4.1.3, 5.2, etc.).  It is primarily used for helping select
1784         an appropriate hints file, but might be useful elsewhere for
1785         setting defaults.  It is set to '' if we can't figure it out.
1786         We try to be flexible about how much of the version number
1787         to keep, e.g. if 4.1.1, 4.1.2, and 4.1.3 are essentially the
1788         same for this package, hints files might just be os_4.0 or
1789         os_4.1, etc., not keeping separate files for each little release.
1790
1791 package (package.U):
1792         This variable contains the name of the package being constructed.
1793         It is primarily intended for the use of later Configure units.
1794
1795 pager (pager.U):
1796         This variable contains the name of the preferred pager on the system.
1797         Usual values are (the full pathnames of) more, less, pg, or cat.
1798
1799 passcat (nis.U):
1800         This variable contains a command that produces the text of the
1801         /etc/passwd file.  This is normally "cat /etc/passwd", but can be
1802         "ypcat passwd" when NIS is used.
1803
1804 patchlevel (patchlevel.U):
1805         The patchlevel level of this package.
1806         The value of patchlevel comes from the patchlevel.h file.
1807
1808 path_sep (Unix.U):
1809         This is an old synonym for p_ in Head.U, the character
1810         used to separate elements in the command shell search PATH.
1811
1812 perladmin (perladmin.U):
1813         Electronic mail address of the perl5 administrator.
1814
1815 perlpath (perlpath.U):
1816         This variable contains the eventual value of the PERLPATH symbol,
1817         which contains the name of the perl interpreter to be used in
1818         shell scripts and in the "eval 'exec'" idiom.
1819
1820 phostname (myhostname.U):
1821         This variable contains the eventual value of the PHOSTNAME symbol,
1822         which is a command that can be fed to popen() to get the host name.
1823         The program should probably not presume that the domain is or isn't
1824         there already.
1825
1826 pidtype (pidtype.U):
1827         This variable defines PIDTYPE to be something like pid_t, int,
1828         ushort, or whatever type is used to declare process ids in the kernel.
1829
1830 plibpth (libpth.U):
1831         Holds the private path used by Configure to find out the libraries.
1832         Its value is prepend to libpth. This variable takes care of special
1833         machines, like the mips.  Usually, it should be empty.
1834
1835 prefix (prefix.U):
1836         This variable holds the name of the directory below which the
1837         user will install the package.  Usually, this is /usr/local, and
1838         executables go in /usr/local/bin, library stuff in /usr/local/lib,
1839         man pages in /usr/local/man, etc.  It is only used to set defaults
1840         for things in bin.U, mansrc.U, privlib.U, or scriptdir.U.
1841
1842 prefixexp (prefix.U):
1843         This variable holds the full absolute path of the directory below
1844         which the user will install the package.  Derived from prefix.
1845
1846 privlib (privlib.U):
1847         This variable contains the eventual value of the PRIVLIB symbol,
1848         which is the name of the private library for this package.  It may
1849         have a ~ on the front. It is up to the makefile to eventually create
1850         this directory while performing installation (with ~ substitution).
1851
1852 privlibexp (privlib.U):
1853         This variable is the ~name expanded version of privlib, so that you
1854         may use it directly in Makefiles or shell scripts.
1855
1856 prototype (prototype.U):
1857         This variable holds the eventual value of CAN_PROTOTYPE, which
1858         indicates the C compiler can handle funciton prototypes.
1859
1860 ptrsize (ptrsize.U):
1861         This variable contains the value of the PTRSIZE symbol, which
1862         indicates to the C program how many bytes there are in a pointer.
1863
1864 randbits (randbits.U):
1865         This variable contains the eventual value of the RANDBITS symbol,
1866         which indicates to the C program how many bits of random number
1867         the rand() function produces.
1868
1869 ranlib (orderlib.U):
1870         This variable is set to the pathname of the ranlib program, if it is
1871         needed to generate random libraries.  Set to ":" if ar can generate
1872         random libraries or if random libraries are not supported
1873
1874 rd_nodata (nblock_io.U):
1875         This variable holds the return code from read() when no data is
1876         present. It should be -1, but some systems return 0 when O_NDELAY is
1877         used, which is a shame because you cannot make the difference between
1878         no data and an EOF.. Sigh!
1879
1880 runnm (usenm.U):
1881         This variable contains 'true' or 'false' depending whether the
1882         nm extraction should be performed or not, according to the value
1883         of usenm and the flags on the Configure command line.
1884
1885 scriptdir (scriptdir.U):
1886         This variable holds the name of the directory in which the user wants
1887         to put publicly scripts for the package in question.  It is either
1888         the same directory as for binaries, or a special one that can be
1889         mounted across different architectures, like /usr/share. Programs
1890         must be prepared to deal with ~name expansion.
1891
1892 scriptdirexp (scriptdir.U):
1893         This variable is the same as scriptdir, but is filename expanded
1894         at configuration time, for programs not wanting to bother with it.
1895
1896 selecttype (selecttype.U):
1897         This variable holds the type used for the 2nd, 3rd, and 4th
1898         arguments to select.  Usually, this is 'fd_set *', if HAS_FD_SET
1899         is defined, and 'int *' otherwise.  This is only useful if you
1900         have select(), naturally.
1901
1902 sh (sh.U):
1903         This variable contains the full pathname of the shell used
1904         on this system to execute Bourne shell scripts.  Usually, this will be
1905         /bin/sh, though it's possible that some systems will have /bin/ksh,
1906         /bin/pdksh, /bin/ash, /bin/bash, or even something such as
1907         D:/bin/sh.exe.
1908         This unit comes before Options.U, so you can't set sh with a -D
1909         option, though you can override this (and startsh)
1910         with -O -Dsh=/bin/whatever -Dstartsh=whatever
1911
1912 sharpbang (spitshell.U):
1913         This variable contains the string #! if this system supports that
1914         construct.
1915
1916 shmattype (d_shmat.U):
1917         This symbol contains the type of pointer returned by shmat().
1918         It can be 'void *' or 'char *'.
1919
1920 shortsize (intsize.U):
1921         This variable contains the value of the SHORTSIZE symbol which
1922         indicates to the C program how many bytes there are in a short.
1923
1924 shrpenv (libperl.U):
1925         If the user builds a shared libperl.so, then we need to tell the
1926         'perl' executable where it will be able to find the installed libperl.so.
1927         One way to do this on some systems is to set the environment variable
1928         LD_RUN_PATH to the directory that will be the final location of the
1929         shared libperl.so.  The makefile can use this with something like
1930                 $shrpenv $(CC) -o perl perlmain.o $libperl $libs
1931         Typical values are
1932                 shrpenv="env LD_RUN_PATH=$archlibexp/CORE"
1933         or
1934                 shrpenv=''
1935         See the main perl Makefile.SH for actual working usage.
1936         Alternatively, we might be able to use a command line option such
1937         as -R $archlibexp/CORE (Solaris, NetBSD) or -Wl,-rpath
1938         $archlibexp/CORE (Linux).
1939
1940 shsharp (spitshell.U):
1941         This variable tells further Configure units whether your sh can
1942         handle # comments.
1943
1944 sig_name (sig_name.U):
1945         This variable holds the signal names, space separated. The leading
1946         SIG in signal name is removed.  A ZERO is prepended to the
1947         list.  This is currently not used.
1948
1949 sig_name_init (sig_name.U):
1950         This variable holds the signal names, enclosed in double quotes and
1951         separated by commas, suitable for use in the SIG_NAME definition
1952         below.  A "ZERO" is prepended to the list, and the list is
1953         terminated with a plain 0.  The leading SIG in signal names
1954         is removed. See sig_num.
1955
1956 sig_num (sig_name.U):
1957         This variable holds the signal numbers, comma separated. A 0 is
1958         prepended to the list (corresponding to the fake SIGZERO), and
1959         the list is terminated with a 0.  Those numbers correspond to
1960         the value of the signal listed in the same place within the
1961         sig_name list.
1962
1963 signal_t (d_voidsig.U):
1964         This variable holds the type of the signal handler (void or int).
1965
1966 sitearch (sitearch.U):
1967         This variable contains the eventual value of the SITEARCH symbol,
1968         which is the name of the private library for this package.  It may
1969         have a ~ on the front. It is up to the makefile to eventually create
1970         this directory while performing installation (with ~ substitution).
1971
1972 sitearchexp (sitearch.U):
1973         This variable is the ~name expanded version of sitearch, so that you
1974         may use it directly in Makefiles or shell scripts.
1975
1976 sitelib (sitelib.U):
1977         This variable contains the eventual value of the SITELIB symbol,
1978         which is the name of the private library for this package.  It may
1979         have a ~ on the front. It is up to the makefile to eventually create
1980         this directory while performing installation (with ~ substitution).
1981
1982 sitelibexp (sitelib.U):
1983         This variable is the ~name expanded version of sitelib, so that you
1984         may use it directly in Makefiles or shell scripts.
1985
1986 sizetype (sizetype.U):
1987         This variable defines sizetype to be something like size_t,
1988         unsigned long, or whatever type is used to declare length
1989         parameters for string functions.
1990
1991 small (models.U):
1992         This variable contains a flag which will tell the C compiler and loader
1993         to produce a program running with a small memory model.  It is up to
1994         the Makefile to use this.
1995
1996 so (so.U):
1997         This variable holds the extension used to identify shared libraries
1998         (also known as shared objects) on the system. Usually set to 'so'.
1999
2000 sockethdr (d_socket.U):
2001         This variable has any cpp -I flags needed for socket support.
2002
2003 socketlib (d_socket.U):
2004         This variable has the names of any libraries needed for socket support.
2005
2006 spackage (package.U):
2007         This variable contains the name of the package being constructed,
2008         with the first letter uppercased, i.e. suitable for starting
2009         sentences.
2010
2011 spitshell (spitshell.U):
2012         This variable contains the command necessary to spit out a runnable
2013         shell on this system.  It is either cat or a grep -v for # comments.
2014
2015 split (models.U):
2016         This variable contains a flag which will tell the C compiler and loader
2017         to produce a program that will run in separate I and D space, for those
2018         machines that support separation of instruction and data space.  It is
2019         up to the Makefile to use this.
2020
2021 src (src.U):
2022         This variable holds the path to the package source. It is up to
2023         the Makefile to use this variable and set VPATH accordingly to
2024         find the sources remotely.
2025
2026 ssizetype (ssizetype.U):
2027         This variable defines ssizetype to be something like ssize_t,
2028         long or int.  It is used by functions that return a count
2029         of bytes or an error condition.  It must be a signed type.
2030         We will pick a type such that sizeof(SSize_t) == sizeof(Size_t).
2031
2032 startperl (startperl.U):
2033         This variable contains the string to put on the front of a perl
2034         script to make sure (hopefully) that it runs with perl and not some
2035         shell. Of course, that leading line must be followed by the classical
2036         perl idiom:
2037                 eval 'exec perl -S $0 ${1+"$@"}'
2038                         if $running_under_some_shell;
2039         to guarantee perl startup should the shell execute the script. Note
2040         that this magic incatation is not understood by csh.
2041
2042 startsh (startsh.U):
2043         This variable contains the string to put on the front of a shell
2044         script to make sure (hopefully) that it runs with sh and not some
2045         other shell.
2046
2047 static_ext (Extensions.U):
2048         This variable holds a list of extension files we want to
2049         link statically into the package.  It is used by Makefile.
2050
2051 stdchar (stdchar.U):
2052         This variable conditionally defines STDCHAR to be the type of char
2053         used in stdio.h.  It has the values "unsigned char" or "char".
2054
2055 stdio_base (d_stdstdio.U):
2056         This variable defines how, given a FILE pointer, fp, to access the
2057         _base field (or equivalent) of stdio.h's FILE structure.  This will
2058         be used to define the macro FILE_base(fp).
2059
2060 stdio_bufsiz (d_stdstdio.U):
2061         This variable defines how, given a FILE pointer, fp, to determine
2062         the number of bytes store in the I/O buffer pointer to by the
2063         _base field (or equivalent) of stdio.h's FILE structure.  This will
2064         be used to define the macro FILE_bufsiz(fp).
2065
2066 stdio_cnt (d_stdstdio.U):
2067         This variable defines how, given a FILE pointer, fp, to access the
2068         _cnt field (or equivalent) of stdio.h's FILE structure.  This will
2069         be used to define the macro FILE_cnt(fp).
2070
2071 stdio_filbuf (d_stdstdio.U):
2072         This variable defines how, given a FILE pointer, fp, to tell
2073         stdio to refill it's internal buffers (?).  This will
2074         be used to define the macro FILE_filbuf(fp).
2075
2076 stdio_ptr (d_stdstdio.U):
2077         This variable defines how, given a FILE pointer, fp, to access the
2078         _ptr field (or equivalent) of stdio.h's FILE structure.  This will
2079         be used to define the macro FILE_ptr(fp).
2080
2081 strings (i_string.U):
2082         This variable holds the full path of the string header that will be
2083         used. Typically /usr/include/string.h or /usr/include/strings.h.
2084
2085 subversion (patchlevel.U):
2086         The subversion level of this package.
2087         The value of subversion comes from the patchlevel.h file.
2088         This is unique to perl.
2089
2090 sysman (sysman.U):
2091         This variable holds the place where the manual is located on this
2092         system. It is not the place where the user wants to put his manual
2093         pages. Rather it is the place where Configure may look to find manual
2094         for unix commands (section 1 of the manual usually). See mansrc.
2095
2096 timeincl (i_time.U):
2097         This variable holds the full path of the included time header(s).
2098
2099 timetype (d_time.U):
2100         This variable holds the type returned by time(). It can be long,
2101         or time_t on BSD sites (in which case <sys/types.h> should be
2102         included). Anyway, the type Time_t should be used.
2103
2104 uidtype (uidtype.U):
2105         This variable defines Uid_t to be something like uid_t, int,
2106         ushort, or whatever type is used to declare user ids in the kernel.
2107
2108 usedl (dlsrc.U):
2109         This variable indicates if the the system supports dynamic
2110         loading of some sort.  See also dlsrc and dlobj.
2111
2112 usemymalloc (mallocsrc.U):
2113         This variable contains y if the malloc that comes with this package
2114         is desired over the system's version of malloc.  People often include
2115         special versions of malloc for effiency, but such versions are often
2116         less portable.  See also mallocsrc and mallocobj.
2117         If this is 'y', then -lmalloc is removed from $libs.
2118
2119 usenm (usenm.U):
2120         This variable contains 'true' or 'false' depending whether the
2121         nm extraction is wanted or not.
2122
2123 useopcode (Extensions.U):
2124         This variable holds either 'true' or 'false' to indicate
2125         whether the Opcode extension should be used.  The sole
2126         use for this currently is to allow an easy mechanism
2127         for users to skip the Opcode extension from the Configure
2128         command line.
2129
2130 useperlio (useperlio.U):
2131         This variable conditionally defines the USE_PERLIO symbol,
2132         and indicates that the PerlIO abstraction should be
2133         used throughout.
2134
2135 useposix (Extensions.U):
2136         This variable holds either 'true' or 'false' to indicate
2137         whether the POSIX extension should be used.  The sole
2138         use for this currently is to allow an easy mechanism
2139         for hints files to indicate that POSIX will not compile
2140         on a particular system.
2141
2142 usesfio (d_sfio.U):
2143         This variable is set to true when the user agrees to use sfio.
2144         It is set to false when sfio is not available or when the user
2145         explicitely requests not to use sfio.  It is here primarily so
2146         that command-line settings can override the auto-detection of
2147         d_sfio without running into a "WHOA THERE".
2148
2149 useshrplib (libperl.U):
2150         This variable is set to 'yes' if the user wishes
2151         to build a shared libperl, and 'no' otherwise.
2152
2153 usethreads (usethreads.U):
2154         This variable conditionally defines the USE_THREADS symbol,
2155         and indicates that Perl should be built to use threads.
2156
2157 usevfork (d_vfork.U):
2158         This variable is set to true when the user accepts to use vfork.
2159         It is set to false when no vfork is available or when the user
2160         explicitely requests not to use vfork.
2161
2162 usrinc (usrinc.U):
2163         This variable holds the path of the include files, which is
2164         usually /usr/include. It is mainly used by other Configure units.
2165
2166 voidflags (voidflags.U):
2167         This variable contains the eventual value of the VOIDFLAGS symbol,
2168         which indicates how much support of the void type is given by this
2169         compiler.  See VOIDFLAGS for more info.
2170