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 alignbytes (alignbytes.U):
   6         This variable holds the number of bytes required to align a
   7         double. Usual values are 2, 4 and 8.
   8
   9 ar (Unix.U):
  10         This variable defines the command to use to create an archive
  11         library.  For unix, it is 'ar'.
  12
  13 archlib (archlib.U):
  14         This variable holds the name of the directory in which the user wants
  15         to put architecture-dependent public library files for $package.
  16         It is most often a local directory such as /usr/local/lib.
  17         Programs using this variable must be prepared to deal
  18         with filename expansion.
  19
  20 archlibexp (archlib.U):
  21         This variable is the same as the archlib variable, but is
  22         filename expanded at configuration time, for convenient use.
  23
  24 archobjs (Unix.U):
  25         This variable defines any additional objects that must be linked
  26         in with the program on this architecture.  On unix, it is usually
  27         empty.  It is typically used to include emulations of unix calls
  28         or other facilities.  For perl on OS/2, for example, this would
  29         include os2/os2.obj.
  30
  31 bin (bin.U):
  32         This variable holds the name of the directory in which the user wants
  33         to put publicly executable images for the package in question.  It
  34         is most often a local directory such as /usr/local/bin. Programs using
  35         this variable must be prepared to deal with ~name substitution.
  36
  37 byteorder (byteorder.U):
  38         This variable holds the byte order. In the following, larger digits
  39         indicate more significance.  The variable byteorder is either 4321
  40         on a big-endian machine, or 1234 on a little-endian, or 87654321
  41         on a Cray ... or 3412 with weird order !
  42
  43 c (n.U):
  44         This variable contains the \c string if that is what causes the echo
  45         command to suppress newline.  Otherwise it is null.  Correct usage is
  46             $echo $n "prompt for a question: $c".
  47
  48 castflags (d_castneg.U):
  49         This variable contains a flag that precise difficulties the
  50         compiler has casting odd floating values to unsigned long:
  51                 0 = ok
  52                 1 = couldn't cast < 0
  53                 2 = couldn't cast >= 0x80000000
  54                 4 = couldn't cast in argument expression list
  55
  56 cc (cc.U):
  57         This variable holds the name of a command to execute a C compiler which
  58         can resolve multiple global references that happen to have the same
  59         name.  Usual values are "cc", "Mcc", "cc -M", and "gcc".
  60
  61 cccdlflags (dlsrc.U):
  62         This variable contains any special flags that might need to be
  63         passed with cc -c to compile modules to be used to create a shared
  64         library that will be used for dynamic loading.  For hpux, this
  65         should be +z.  It is up to the makefile to use it.
  66
  67 ccdlflags (dlsrc.U):
  68         This variable contains any special flags that might need to be
  69         passed to cc to link with a shared library for dynamic loading.
  70         It is up to the makefile to use it.  For sunos 4.1, it should
  71         be empty.
  72
  73 ccflags (ccflags.U):
  74         This variable contains any additional C compiler flags desired by
  75         the user.  It is up to the Makefile to use this.
  76
  77 cf_by (cf_who.U):
  78         Login name of the person who ran the Configure script and answered the
  79         questions. This is used to tag both config.sh and config_h.SH.
  80
  81 cf_time (cf_who.U):
  82         Holds the output of the "date" command when the configuration file was
  83         produced. This is used to tag both config.sh and config_h.SH.
  84
  85 cpp_stuff (cpp_stuff.U):
  86         This variable contains an identification of the catenation mechanism
  87         used by the C preprocessor.
  88
  89 cppflags (ccflags.U):
  90         This variable holds the flags that will be passed to the C pre-
  91         processor. It is up to the Makefile to use it.
  92
  93 cppminus (cppstdin.U):
  94         This variable contains the second part of the string which will invoke
  95         the C preprocessor on the standard input and produce to standard
  96         output.  This variable will have the value "-" if cppstdin needs a minus
  97         to specify standard input, otherwise the value is "".
  98
  99 cppstdin (cppstdin.U):
 100         This variable contains the command which will invoke the C
 101         preprocessor on standard input and put the output to stdout.
 102         It is primarily used by other Configure units that ask about
 103         preprocessor symbols.
 104
 105 cryptlib (d_crypt.U):
 106         This variable holds -lcrypt or the path to a libcrypt.a archive if
 107         the crypt() function is not defined in the standard C library. It is
 108         up to the Makefile to use this.
 109
 110 d_Gconvert (d_gconvert.U):
 111         This variable holds what Gconvert is defined as to convert
 112         floating point numbers into strings. It could be 'gconvert'
 113         or a more complex macro emulating gconvert with gcvt() or sprintf.
 114
 115 d_access (d_access.U):
 116         This variable conditionally defines HAS_ACCESS if the access() system
 117         call is available to check for access permissions using real IDs.
 118
 119 d_alarm (d_alarm.U):
 120         This variable conditionally defines the HAS_ALARM symbol, which
 121         indicates to the C program that the alarm() routine is available.
 122
 123 d_archlib (archlib.U):
 124         This variable conditionally defines ARCHLIB to hold the pathname
 125         of architecture-dependent library files for $package.  If
 126         $archlib is the same as $privlib, then this is set to undef.
 127
 128 d_bcmp (d_bcmp.U):
 129         This variable conditionally defines the HAS_BCMP symbol if
 130         the bcmp() routine is available to compare strings.
 131
 132 d_bcopy (d_bcopy.U):
 133         This variable conditionally defines the HAS_BCOPY symbol if
 134         the bcopy() routine is available to copy strings.
 135
 136 d_bsdpgrp (d_setpgrp.U):
 137         This variable conditionally defines USE_BSDPGRP if the notion of
 138         process group is the BSD one. This means setpgrp needs two arguments
 139         whereas USG one needs none.
 140
 141 d_bzero (d_bzero.U):
 142         This variable conditionally defines the HAS_BZERO symbol if
 143         the bzero() routine is available to set memory to 0.
 144
 145 d_casti32 (d_casti32.U):
 146         This variable conditionally defines CASTI32, which indicates
 147         whether the C compiler can cast large floats to 32-bit ints.
 148
 149 d_castneg (d_castneg.U):
 150         This variable conditionally defines CASTNEG, which indicates
 151         wether the C compiler can cast negative float to unsigned.
 152
 153 d_charvspr (d_vprintf.U):
 154         This variable conditionally defines CHARVSPRINTF if this system
 155         has vsprintf returning type (char*).  The trend seems to be to
 156         declare it as "int vsprintf()".
 157
 158 d_chown (d_chown.U):
 159         This variable conditionally defines the HAS_CHOWN symbol, which
 160         indicates to the C program that the chown() routine is available.
 161
 162 d_chroot (d_chroot.U):
 163         This variable conditionally defines the HAS_CHROOT symbol, which
 164         indicates to the C program that the chroot() routine is available.
 165
 166 d_chsize (d_chsize.U):
 167         This variable conditionally defines the CHSIZE symbol, which
 168         indicates to the C program that the chsize() routine is available
 169         to truncate files.  You might need a -lx to get this routine.
 170
 171 d_const (d_const.U):
 172         This variable conditionally defines the HASCONST symbol, which
 173         indicates to the C program that this C compiler knows about the
 174         const type.
 175
 176 d_crypt (d_crypt.U):
 177         This variable conditionally defines the CRYPT symbol, which
 178         indicates to the C program that the crypt() routine is available
 179         to encrypt passwords and the like.
 180
 181 d_csh (d_csh.U):
 182         This variable conditionally defines the CSH symbol, which
 183         indicates to the C program that the C-shell exists.
 184
 185 d_cuserid (d_cuserid.U):
 186         This variable conditionally defines the HAS_CUSERID symbol, which
 187         indicates to the C program that the cuserid() routine is available
 188         to get character login names.
 189
 190 d_dbl_dig (d_dbl_dig.U):
 191         This variable conditionally defines d_dbl_dig if this system's
 192         header files provide DBL_DIG, which is the number of significant
 193         digits in a double precision number.
 194
 195 d_difftime (d_difftime.U):
 196         This variable conditionally defines the HAS_DIFFTIME symbol, which
 197         indicates to the C program that the difftime() routine is available.
 198
 199 d_dirnamlen (i_dirent.U):
 200         This variable conditionally defines DIRNAMLEN, which indicates
 201         to the C program that the length of directory entry names is
 202         provided by a d_namelen field.
 203
 204 d_dlerror (d_dlerror.U):
 205         This variable conditionally defines the HAS_DLERROR symbol, which
 206         indicates to the C program that the dlerror() routine is available.
 207
 208 d_dlsymun (d_dlsymun.U):
 209         This variable conditionally defines DLSYM_NEEDS_UNDERSCORE, which
 210         indicates that we need to prepend an underscore to the symbol
 211         name before calling dlsym().
 212
 213 d_dosuid (d_dosuid.U):
 214         This variable conditionally defines the symbol DOSUID, which
 215         tells the C program that it should insert setuid emulation code
 216         on hosts which have setuid #! scripts disabled.
 217
 218 d_dup2 (d_dup2.U):
 219         This variable conditionally defines HAS_DUP2 if dup2() is
 220         available to duplicate file descriptors.
 221
 222 d_eofnblk (nblock_io.U):
 223         This variable conditionally defines EOF_NONBLOCK if EOF can be seen
 224         when reading from a non-blocking I/O source.
 225
 226 d_fchmod (d_fchmod.U):
 227         This variable conditionally defines the HAS_FCHMOD symbol, which
 228         indicates to the C program that the fchmod() routine is available
 229         to change mode of opened files.
 230
 231 d_fchown (d_fchown.U):
 232         This variable conditionally defines the HAS_FCHOWN symbol, which
 233         indicates to the C program that the fchown() routine is available
 234         to change ownership of opened files.
 235
 236 d_fcntl (d_fcntl.U):
 237         This variable conditionally defines the HAS_FCNTL symbol, and indicates
 238         whether the fcntl() function exists
 239
 240 d_fgetpos (d_fgetpos.U):
 241         This variable conditionally defines HAS_FGETPOS if fgetpos() is
 242         available to get the file position indicator.
 243
 244 d_flexfnam (d_flexfnam.U):
 245         This variable conditionally defines the FLEXFILENAMES symbol, which
 246         indicates that the system supports filenames longer than 14 characters.
 247
 248 d_flock (d_flock.U):
 249         This variable conditionally defines HAS_FLOCK if flock() is
 250         available to do file locking.
 251
 252 d_fork (d_fork.U):
 253         This variable conditionally defines the HAS_FORK symbol, which
 254         indicates to the C program that the fork() routine is available.
 255
 256 d_fpathconf (d_pathconf.U):
 257         This variable conditionally defines the HAS_FPATHCONF symbol, which
 258         indicates to the C program that the pathconf() routine is available
 259         to determine file-system related limits and options associated
 260         with a given open file descriptor.
 261
 262 d_fsetpos (d_fsetpos.U):
 263         This variable conditionally defines HAS_FSETPOS if fsetpos() is
 264         available to set the file position indicator.
 265
 266 d_gethent (d_gethent.U):
 267         This variable conditionally defines HAS_GETHOSTENT if gethostent() is
 268         available to dup file descriptors.
 269
 270 d_getlogin (d_getlogin.U):
 271         This variable conditionally defines the HAS_GETLOGIN symbol, which
 272         indicates to the C program that the getlogin() routine is available
 273         to get the login name.
 274
 275 d_getpgrp (d_getpgrp.U):
 276         This variable conditionally defines HAS_GETPGRP if getpgrp() is
 277         available to get the current process group.
 278
 279 d_getpgrp2 (d_getpgrp2.U):
 280         This variable conditionally defines the HAS_GETPGRP2 symbol, which
 281         indicates to the C program that the getpgrp2() (as in DG/UX) routine
 282         is available to get the current process group.
 283
 284 d_getppid (d_getppid.U):
 285         This variable conditionally defines the HAS_GETPPID symbol, which
 286         indicates to the C program that the getppid() routine is available
 287         to get the parent process ID.
 288
 289 d_getprior (d_getprior.U):
 290         This variable conditionally defines HAS_GETPRIORITY if getpriority()
 291         is available to get a process's priority.
 292
 293 d_htonl (d_htonl.U):
 294         This variable conditionally defines HAS_HTONL if htonl() and its
 295         friends are available to do network order byte swapping.
 296
 297 d_index (d_strchr.U):
 298         This variable conditionally defines HAS_INDEX if index() and
 299         rindex() are available for string searching.
 300
 301 d_isascii (d_isascii.U):
 302         This variable conditionally defines the HAS_ISASCII constant,
 303         which indicates to the C program that isascii() is available.
 304
 305 d_killpg (d_killpg.U):
 306         This variable conditionally defines the HAS_KILLPG symbol, which
 307         indicates to the C program that the killpg() routine is available
 308         to kill process groups.
 309
 310 d_link (d_link.U):
 311         This variable conditionally defines HAS_LINK if link() is
 312         available to create hard links.
 313
 314 d_locconv (d_locconv.U):
 315         This variable conditionally defines HAS_LOCALECONV if localeconv() is
 316         available for numeric and monetary formatting conventions.
 317
 318 d_lockf (d_lockf.U):
 319         This variable conditionally defines HAS_LOCKF if lockf() is
 320         available to do file locking.
 321
 322 d_lstat (d_lstat.U):
 323         This variable conditionally defines HAS_LSTAT if lstat() is
 324         available to do file stats on symbolic links.
 325
 326 d_mblen (d_mblen.U):
 327         This variable conditionally defines the HAS_MBLEN symbol, which
 328         indicates to the C program that the mblen() routine is available
 329         to find the number of bytes in a multibye character.
 330
 331 d_mbstowcs (d_mbstowcs.U):
 332         This variable conditionally defines the HAS_MBSTOWCS symbol, which
 333         indicates to the C program that the mbstowcs() routine is available
 334         to convert a multibyte string into a wide character string.
 335
 336 d_mbtowc (d_mbtowc.U):
 337         This variable conditionally defines the HAS_MBTOWC symbol, which
 338         indicates to the C program that the mbtowc() routine is available
 339         to convert multibyte to a wide character.
 340
 341 d_memcmp (d_memcmp.U):
 342         This variable conditionally defines the HAS_MEMCMP symbol, which
 343         indicates to the C program that the memcmp() routine is available
 344         to compare blocks of memory.
 345
 346 d_memcpy (d_memcpy.U):
 347         This variable conditionally defines the HAS_MEMCPY symbol, which
 348         indicates to the C program that the memcpy() routine is available
 349         to copy blocks of memory.
 350
 351 d_memmove (d_memmove.U):
 352         This variable conditionally defines the HAS_MEMMOVE symbol, which
 353         indicates to the C program that the memmove() routine is available
 354         to copy potentatially overlapping blocks of memory.
 355
 356 d_memset (d_memset.U):
 357         This variable conditionally defines the HAS_MEMSET symbol, which
 358         indicates to the C program that the memset() routine is available
 359         to set blocks of memory.
 360
 361 d_mkdir (d_mkdir.U):
 362         This variable conditionally defines the HAS_MKDIR symbol, which
 363         indicates to the C program that the mkdir() routine is available
 364         to create directories..
 365
 366 d_mkfifo (d_mkfifo.U):
 367         This variable conditionally defines the HAS_MKFIFO symbol, which
 368         indicates to the C program that the mkfifo() routine is available.
 369
 370 d_mktime (d_mktime.U):
 371         This variable conditionally defines the HAS_MKTIME symbol, which
 372         indicates to the C program that the mktime() routine is available.
 373
 374 d_msg (d_msg.U):
 375         This variable conditionally defines the HAS_MSG symbol, which
 376         indicates that the entire msg*(2) library is present.
 377
 378 d_mymalloc (mallocsrc.U):
 379         This variable conditionally defines MYMALLOC in case other parts
 380         of the source want to take special action if MYMALLOC is used.
 381         This may include different sorts of profiling or error detection.
 382
 383 d_nice (d_nice.U):
 384         This variable conditionally defines the HAS_NICE symbol, which
 385         indicates to the C program that the nice() routine is available.
 386
 387 d_oldarchlib (oldarchlib.U):
 388         This variable conditionally defines OLDARCHLIB to hold the pathname
 389         of architecture-dependent library files for a previous
 390         version of $package.
 391
 392 d_open3 (d_open3.U):
 393         This variable conditionally defines the HAS_OPEN3 manifest constant,
 394         which indicates to the C program that the 3 argument version of
 395         the open(2) function is available.
 396
 397 d_pathconf (d_pathconf.U):
 398         This variable conditionally defines the HAS_PATHCONF symbol, which
 399         indicates to the C program that the pathconf() routine is available
 400         to determine file-system related limits and options associated
 401         with a given filename.
 402
 403 d_pause (d_pause.U):
 404         This variable conditionally defines the HAS_PAUSE symbol, which
 405         indicates to the C program that the pause() routine is available
 406         to suspend a process until a signal is received.
 407
 408 d_pipe (d_pipe.U):
 409         This variable conditionally defines the HAS_PIPE symbol, which
 410         indicates to the C program that the pipe() routine is available
 411         to create an inter-process channel.
 412
 413 d_poll (d_poll.U):
 414         This variable conditionally defines the HAS_POLL symbol, which
 415         indicates to the C program that the poll() routine is available
 416         to poll active file descriptors.
 417
 418 d_pwage (i_pwd.U):
 419         This varaible conditionally defines PWAGE, which indicates
 420         that struct passwd contains pw_age.
 421
 422 d_pwchange (i_pwd.U):
 423         This varaible conditionally defines PWCHANGE, which indicates
 424         that struct passwd contains pw_change.
 425
 426 d_pwclass (i_pwd.U):
 427         This varaible conditionally defines PWCLASS, which indicates
 428         that struct passwd contains pw_class.
 429
 430 d_pwcomment (i_pwd.U):
 431         This varaible conditionally defines PWCOMMENT, which indicates
 432         that struct passwd contains pw_comment.
 433
 434 d_pwexpire (i_pwd.U):
 435         This varaible conditionally defines PWEXPIRE, which indicates
 436         that struct passwd contains pw_expire.
 437
 438 d_pwquota (i_pwd.U):
 439         This varaible conditionally defines PWQUOTA, which indicates
 440         that struct passwd contains pw_quota.
 441
 442 d_readdir (d_readdir.U):
 443         This variable conditionally defines HAS_READDIR if readdir() is
 444         available to read directory entries.
 445
 446 d_readlink (d_readlink.U):
 447         This variable conditionally defines the HAS_READLINK symbol, which
 448         indicates to the C program that the readlink() routine is available
 449         to read the value of a symbolic link.
 450
 451 d_rename (d_rename.U):
 452         This variable conditionally defines the HAS_RENAME symbol, which
 453         indicates to the C program that the rename() routine is available
 454         to rename files.
 455
 456 d_rewinddir (d_readdir.U):
 457         This variable conditionally defines HAS_REWINDDIR if rewinddir() is
 458         available.
 459
 460 d_rmdir (d_rmdir.U):
 461         This variable conditionally defines HAS_RMDIR if rmdir() is
 462         available to remove directories.
 463
 464 d_safebcpy (d_safebcpy.U):
 465         This variable conditionally defines the HAS_SAFE_BCOPY symbol if
 466         the bcopy() routine can do overlapping copies.
 467
 468 d_safemcpy (d_safemcpy.U):
 469         This variable conditionally defines the HAS_SAFE_MEMCPY symbol if
 470         the memcpy() routine can do overlapping copies.
 471
 472 d_seekdir (d_readdir.U):
 473         This variable conditionally defines HAS_SEEKDIR if seekdir() is
 474         available.
 475
 476 d_select (d_select.U):
 477         This variable conditionally defines HAS_SELECT if select() is
 478         available to select active file descriptors. A <sys/time.h>
 479         inclusion may be necessary for the timeout field.
 480
 481 d_sem (d_sem.U):
 482         This variable conditionally defines the HAS_SEM symbol, which
 483         indicates that the entire sem*(2) library is present.
 484
 485 d_setegid (d_setegid.U):
 486         This variable conditionally defines the HAS_SETEGID symbol, which
 487         indicates to the C program that the setegid() routine is available
 488         to change the effective gid of the current program.
 489
 490 d_seteuid (d_seteuid.U):
 491         This variable conditionally defines the HAS_SETEUID symbol, which
 492         indicates to the C program that the seteuid() routine is available
 493         to change the effective uid of the current program.
 494
 495 d_setlinebuf (d_setlnbuf.U):
 496         This variable conditionally defines the HAS_SETLINEBUF symbol, which
 497         indicates to the C program that the setlinebuf() routine is available
 498         to change stderr or stdout from block-buffered or unbuffered to a
 499         line-buffered mode.
 500
 501 d_setlocale (d_setlocale.U):
 502         This variable conditionally defines HAS_SETLOCALE if setlocale() is
 503         available to handle locale-specific ctype implementations.
 504
 505 d_setpgid (d_setpgid.U):
 506         This variable conditionally defines HAS_SETPGID if setpgid() is
 507         available to set process group ID.
 508
 509 d_setpgrp (d_setpgrp.U):
 510         This variable conditionally defines HAS_SETPGRP if setpgrp() is
 511         available to set the current process group.
 512
 513 d_setpgrp2 (d_setpgrp2.U):
 514         This variable conditionally defines the HAS_SETPGRP2 symbol, which
 515         indicates to the C program that the setpgrp2() (as in DG/UX) routine
 516         is available to set the current process group.
 517
 518 d_setprior (d_setprior.U):
 519         This variable conditionally defines HAS_SETPRIORITY if setpriority()
 520         is available to set a process's priority.
 521
 522 d_setregid (d_setregid.U):
 523         This variable conditionally defines HAS_SETREGID if setregid() is
 524         available to change the real and effective gid of the current
 525         process.
 526
 527 d_setresgid (d_setregid.U):
 528         This variable conditionally defines HAS_SETRESGID if setresgid() is
 529         available to change the real, effective and saved gid of the current
 530         process.
 531
 532 d_setresuid (d_setreuid.U):
 533         This variable conditionally defines HAS_SETREUID if setresuid() is
 534         available to change the real, effective and saved uid of the current
 535         process.
 536
 537 d_setreuid (d_setreuid.U):
 538         This variable conditionally defines HAS_SETREUID if setreuid() is
 539         available to change the real and effective uid of the current
 540         process.
 541
 542 d_setrgid (d_setrgid.U):
 543         This variable conditionally defines the HAS_SETRGID symbol, which
 544         indicates to the C program that the setrgid() routine is available
 545         to change the real gid of the current program.
 546
 547 d_setruid (d_setruid.U):
 548         This variable conditionally defines the HAS_SETRUID symbol, which
 549         indicates to the C program that the setruid() routine is available
 550         to change the real uid of the current program.
 551
 552 d_setsid (d_setsid.U):
 553         This variable conditionally defines HAS_SETSID if setsid() is
 554         available to set the process group ID.
 555
 556 d_sfio (d_sfio.U):
 557         This variable conditionally defines the USE_SFIO symbol,
 558         and indicates whether sfio is available (and should be used).
 559
 560 d_shm (d_shm.U):
 561         This variable conditionally defines the HAS_SHM symbol, which
 562         indicates that the entire shm*(2) library is present.
 563
 564 d_shmatprototype (d_shmat.U):
 565         This variable conditionally defines the HAS_SHMAT_PROTOTYPE
 566         symbol, which indicates that sys/shm.h has a prototype for
 567         shmat.
 568
 569 d_sigaction (d_sigaction.U):
 570         This variable conditionally defines the HAS_SIGACTION symbol, which
 571         indicates that the Vr4 sigaction() routine is available.
 572
 573 d_sigsetjmp (d_sigsetjmp.U):
 574         This variable conditionally defines the HAS_SIGSETJMP symbol,
 575         which indicates that the sigsetjmp() routine is available to
 576         call setjmp() and optionally save the process's signal mask.
 577
 578 d_socket (d_socket.U):
 579         This variable conditionally defines HAS_SOCKET, which indicates
 580         that the BSD socket interface is supported.
 581
 582 d_sockpair (d_socket.U):
 583         This variable conditionally defines the HAS_SOCKETPAIR symbol, which
 584         indicates that the BSD socketpair() is supported.
 585
 586 d_statblks (d_statblks.U):
 587         This variable conditionally defines USE_STAT_BLOCKS if this system
 588         has a stat structure declaring st_blksize and st_blocks.
 589
 590 d_stdio_cnt_lval (d_stdstdio.U):
 591         This variable conditionally defines STDIO_CNT_LVALUE if the
 592         FILE_cnt macro can be used as an lvalue.
 593
 594 d_stdio_ptr_lval (d_stdstdio.U):
 595         This variable conditionally defines STDIO_PTR_LVALUE if the
 596         FILE_ptr macro can be used as an lvalue.
 597
 598 d_stdiobase (d_stdstdio.U):
 599         This variable conditionally defines USE_STDIO_BASE if this system
 600         has a FILE structure declaring a usable _base field (or equivalent)
 601         in stdio.h.
 602
 603 d_stdstdio (d_stdstdio.U):
 604         This variable conditionally defines USE_STDIO_PTR if this system
 605         has a FILE structure declaring usable _ptr and _cnt fields (or
 606         equivalent) in stdio.h.
 607
 608 d_strchr (d_strchr.U):
 609         This variable conditionally defines HAS_STRCHR if strchr() and
 610         strrchr() are available for string searching.
 611
 612 d_strcoll (d_strcoll.U):
 613         This variable conditionally defines HAS_STRCOLL if strcoll() is
 614         available to compare strings using collating information.
 615
 616 d_strctcpy (d_strctcpy.U):
 617         This variable conditionally defines the USE_STRUCT_COPY symbol, which
 618         indicates to the C program that this C compiler knows how to copy
 619         structures.
 620
 621 d_strerrm (d_strerror.U):
 622         This variable holds what Strerrr is defined as to translate an error
 623         code condition into an error message string. It could be 'strerror'
 624         or a more complex macro emulating strrror with sys_errlist[], or the
 625         "unknown" string when both strerror and sys_errlist are missing.
 626
 627 d_strerror (d_strerror.U):
 628         This variable conditionally defines HAS_STRERROR if strerror() is
 629         available to translate error numbers to strings.
 630
 631 d_strxfrm (d_strxfrm.U):
 632         This variable conditionally defines HAS_STRXFRM if strxfrm() is
 633         available to transform strings.
 634
 635 d_suidsafe (d_dosuid.U):
 636         This variable conditionally defines SETUID_SCRIPTS_ARE_SECURE_NOW
 637         if setuid scripts can be secure.  This test looks in /dev/fd/.
 638
 639 d_symlink (d_symlink.U):
 640         This variable conditionally defines the HAS_SYMLINK symbol, which
 641         indicates to the C program that the symlink() routine is available
 642         to create symbolic links.
 643
 644 d_syscall (d_syscall.U):
 645         This variable conditionally defines HAS_SYSCALL if syscall() is
 646         available call arbitrary system calls.
 647
 648 d_sysconf (d_sysconf.U):
 649         This variable conditionally defines the HAS_SYSCONF symbol, which
 650         indicates to the C program that the sysconf() routine is available
 651         to determine system related limits and options.
 652
 653 d_syserrlst (d_strerror.U):
 654         This variable conditionally defines HAS_SYS_ERRLIST if sys_errlist[] is
 655         available to translate error numbers to strings.
 656
 657 d_system (d_system.U):
 658         This variable conditionally defines HAS_SYSTEM if system() is
 659         available to issue a shell command.
 660
 661 d_tcgetpgrp (d_tcgtpgrp.U):
 662         This variable conditionally defines the HAS_TCGETPGRP symbol, which
 663         indicates to the C program that the tcgetpgrp() routine is available.
 664         to get foreground process group ID.
 665
 666 d_tcsetpgrp (d_tcstpgrp.U):
 667         This variable conditionally defines the HAS_TCSETPGRP symbol, which
 668         indicates to the C program that the tcsetpgrp() routine is available
 669         to set foreground process group ID.
 670
 671 d_telldir (d_readdir.U):
 672         This variable conditionally defines HAS_TELLDIR if telldir() is
 673         available.
 674
 675 d_times (d_times.U):
 676         This variable conditionally defines the HAS_TIMES symbol, which indicates
 677         that the times() routine exists.  The times() routine is normaly
 678         provided on UNIX systems. You may have to include <sys/times.h>.
 679
 680 d_truncate (d_truncate.U):
 681         This variable conditionally defines HAS_TRUNCATE if truncate() is
 682         available to truncate files.
 683
 684 d_tzname (d_tzname.U):
 685         This variable conditionally defines HAS_TZNAME if tzname[] is
 686         available to access timezone names.
 687
 688 d_umask (d_umask.U):
 689         This variable conditionally defines the HAS_UMASK symbol, which
 690         indicates to the C program that the umask() routine is available.
 691         to set and get the value of the file creation mask.
 692
 693 d_uname (d_gethname.U):
 694         This variable conditionally defines the HAS_UNAME symbol, which
 695         indicates to the C program that the uname() routine may be
 696         used to derive the host name.
 697
 698 d_vfork (d_vfork.U):
 699         This variable conditionally defines the HAS_VFORK symbol, which
 700         indicates the vfork() routine is available.
 701
 702 d_void_closedir (d_closedir.U):
 703         This variable conditionally defines VOID_CLOSEDIR if closedir()
 704         does not return a value.
 705
 706 d_volatile (d_volatile.U):
 707         This variable conditionally defines the HASVOLATILE symbol, which
 708         indicates to the C program that this C compiler knows about the
 709         volatile declaration.
 710
 711 d_vprintf (d_vprintf.U):
 712         This variable conditionally defines the HAS_VPRINTF symbol, which
 713         indicates to the C program that the vprintf() routine is available
 714         to printf with a pointer to an argument list.
 715
 716 d_wait4 (d_wait4.U):
 717         This variable conditionally defines the HAS_WAIT4 symbol, which
 718         indicates the wait4() routine is available.
 719
 720 d_waitpid (d_waitpid.U):
 721         This variable conditionally defines HAS_WAITPID if waitpid() is
 722         available to wait for child process.
 723
 724 d_wcstombs (d_wcstombs.U):
 725         This variable conditionally defines the HAS_WCSTOMBS symbol, which
 726         indicates to the C program that the wcstombs() routine is available
 727         to convert wide character strings to multibyte strings.
 728
 729 d_wctomb (d_wctomb.U):
 730         This variable conditionally defines the HAS_WCTOMB symbol, which
 731         indicates to the C program that the wctomb() routine is available
 732         to convert a wide character to a multibyte.
 733
 734 db_hashtype (i_db.U):
 735         This variable contains the type of the hash structure element
 736         in the <db.h> header file.  In older versions of DB, it was
 737         int, while in newer ones it is u_int32_t.
 738
 739 db_prefixtype (i_db.U):
 740         This variable contains the type of the prefix structure element
 741         in the <db.h> header file.  In older versions of DB, it was
 742         int, while in newer ones it is size_t.
 743
 744 direntrytype (i_dirent.U):
 745         This symbol is set to 'struct direct' or 'struct dirent' depending on
 746         whether dirent is available or not. You should use this pseudo type to
 747         portably declare your directory entries.
 748
 749 dlext (dlext.U):
 750         This variable contains the extension that is to be used for the
 751         dynamically loaded modules that perl generaties.
 752
 753 dlsrc (dlsrc.U):
 754         This variable contains the name of the dynamic loading file that
 755         will be used with the package.
 756
 757 dynamic_ext (Extensions.U):
 758         This variable holds a list of extension files we want to
 759         link dynamically into the package.  It is used by Makefile.
 760
 761 eagain (nblock_io.U):
 762         This variable bears the symbolic errno code set by read() when no
 763         data is present on the file and non-blocking I/O was enabled (otherwise,
 764         read() blocks naturally).
 765
 766 eunicefix (Init.U):
 767         When running under Eunice this variable contains a command which will
 768         convert a shell script to the proper form of text file for it to be
 769         executable by the shell.  On other systems it is a no-op.
 770
 771 exe_ext (Unix.U):
 772         This variable defines the extension used for executable files.
 773         For unix it is empty.  Other possible values include '.exe'.
 774
 775 firstmakefile (Unix.U):
 776         This variable defines the first file searched by make.  On unix,
 777         it is makefile (then Makefile).  On case-insensitive systems,
 778         it might be something else.  This is only used to deal with
 779         convoluted make depend tricks.
 780
 781 fpostype (fpostype.U):
 782         This variable defines Fpos_t to be something like fpost_t, long,
 783         uint, or whatever type is used to declare file positions in libc.
 784
 785 freetype (mallocsrc.U):
 786         This variable contains the return type of free().  It is usually
 787         void, but occasionally int.
 788
 789 full_csh (d_csh.U):
 790         This variable contains the full pathname to 'csh', whether or
 791         not the user has specified 'portability'.  This is only used
 792         in the compiled C program, and we assume that all systems which
 793         can share this executable will have the same full pathname to
 794         'csh.'
 795
 796 full_sed (Loc_sed.U):
 797         This variable contains the full pathname to 'sed', whether or
 798         not the user has specified 'portability'.  This is only used
 799         in the compiled C program, and we assume that all systems which
 800         can share this executable will have the same full pathname to
 801         'sed.'
 802
 803 gidtype (gidtype.U):
 804         This variable defines Gid_t to be something like gid_t, int,
 805         ushort, or whatever type is used to declare the return type
 806         of getgid().  Typically, it is the type of group ids in the kernel.
 807
 808 groupstype (groupstype.U):
 809         This variable defines Groups_t to be something like gid_t, int,
 810         ushort, or whatever type is used for the second argument to
 811         getgroups().  Usually, this is the same of gidtype, but
 812         sometimes it isn't.
 813
 814 i_dirent (i_dirent.U):
 815         This variable conditionally defines I_DIRENT, which indicates
 816         to the C program that it should include <dirent.h>.
 817
 818 i_dlfcn (i_dlfcn.U):
 819         This variable conditionally defines the I_DLFCN symbol, which
 820         indicates to the C program that <dlfcn.h> exists and should
 821         be included.
 822
 823 i_fcntl (i_fcntl.U):
 824         This variable controls the value of I_FCNTL (which tells
 825         the C program to include <fcntl.h>).
 826
 827 i_float (i_float.U):
 828         This variable conditionally defines the I_FLOAT symbol, and indicates
 829         whether a C program may include <float.h> to get symbols like DBL_MAX
 830         or DBL_MIN, i.e. machine dependent floating point values.
 831
 832 i_grp (i_grp.U):
 833         This variable conditionally defines the I_GRP symbol, and indicates
 834         whether a C program should include <grp.h>.
 835
 836 i_limits (i_limits.U):
 837         This variable conditionally defines the I_LIMITS symbol, and indicates
 838         whether a C program may include <limits.h> to get symbols like WORD_BIT
 839         and friends.
 840
 841 i_locale (i_locale.U):
 842         This variable conditionally defines the I_LOCALE symbol,
 843         and indicates whether a C program should include <locale.h>.
 844
 845 i_math (i_math.U):
 846         This variable conditionally defines the I_MATH symbol, and indicates
 847         whether a C program may include <math.h>.
 848
 849 i_memory (i_memory.U):
 850         This variable conditionally defines the I_MEMORY symbol, and indicates
 851         whether a C program should include <memory.h>.
 852
 853 i_neterrno (i_neterrno.U):
 854         This variable conditionally defines the I_NET_ERRNO symbol, which
 855         indicates to the C program that <net/errno.h> exists and should
 856         be included.
 857
 858 i_niin (i_niin.U):
 859         This variable conditionally defines I_NETINET_IN, which indicates
 860         to the C program that it should include <netinet/in.h>. Otherwise,
 861         you may try <sys/in.h>.
 862
 863 i_pwd (i_pwd.U):
 864         This variable conditionally defines I_PWD, which indicates
 865         to the C program that it should include <pwd.h>.
 866
 867 i_rpcsvcdbm (i_dbm.U):
 868         This variable conditionally defines the I_RPCSVC_DBM symbol, which
 869         indicates to the C program that <rpcsvc/dbm.h> exists and should
 870         be included.  Some System V systems might need this instead of <dbm.h>.
 871
 872 i_sfio (i_sfio.U):
 873         This variable conditionally defines the I_SFIO symbol,
 874         and indicates whether a C program should include <sfio.h>.
 875
 876 i_sgtty (i_termio.U):
 877         This variable conditionally defines the I_SGTTY symbol, which
 878         indicates to the C program that it should include <sgtty.h> rather
 879         than <termio.h>.
 880
 881 i_stdarg (i_varhdr.U):
 882         This variable conditionally defines the I_STDARG symbol, which
 883         indicates to the C program that <stdarg.h> exists and should
 884         be included.
 885
 886 i_stddef (i_stddef.U):
 887         This variable conditionally defines the I_STDDEF symbol, which
 888         indicates to the C program that <stddef.h> exists and should
 889         be included.
 890
 891 i_stdlib (i_stdlib.U):
 892         This variable conditionally defines the I_STDLIB symbol, which
 893         indicates to the C program that <stdlib.h> exists and should
 894         be included.
 895
 896 i_string (i_string.U):
 897         This variable conditionally defines the I_STRING symbol, which
 898         indicates that <string.h> should be included rather than <strings.h>.
 899
 900 i_sysdir (i_sysdir.U):
 901         This variable conditionally defines the I_SYS_DIR symbol, and indicates
 902         whether a C program should include <sys/dir.h>.
 903
 904 i_sysfile (i_sysfile.U):
 905         This variable conditionally defines the I_SYS_FILE symbol, and indicates
 906         whether a C program should include <sys/file.h> to get R_OK and friends.
 907
 908 i_sysioctl (i_sysioctl.U):
 909         This variable conditionally defines the I_SYS_IOCTL symbol, which
 910         indicates to the C program that <sys/ioctl.h> exists and should
 911         be included.
 912
 913 i_sysndir (i_sysndir.U):
 914         This variable conditionally defines the I_SYS_NDIR symbol, and indicates
 915         whether a C program should include <sys/ndir.h>.
 916
 917 i_sysparam (i_sysparam.U):
 918         This variable conditionally defines the I_SYS_PARAM symbol, and indicates
 919         whether a C program should include <sys/param.h>.
 920
 921 i_sysresrc (i_sysresrc.U):
 922         This variable conditionally defines the I_SYS_RESOURCE symbol,
 923         and indicates whether a C program should include <sys/resource.h>.
 924
 925 i_sysselct (i_sysselct.U):
 926         This variable conditionally defines I_SYS_SELECT, which indicates
 927         to the C program that it should include <sys/select.h> in order to
 928         get the definition of struct timeval.
 929
 930 i_sysstat (i_sysstat.U):
 931         This variable conditionally defines the I_SYS_STAT symbol,
 932         and indicates whether a C program should include <sys/stat.h>.
 933
 934 i_systime (i_time.U):
 935         This variable conditionally defines I_SYS_TIME, which indicates
 936         to the C program that it should include <sys/time.h>.
 937
 938 i_systimek (i_time.U):
 939         This variable conditionally defines I_SYS_TIME_KERNEL, which
 940         indicates to the C program that it should include <sys/time.h>
 941         with KERNEL defined.
 942
 943 i_systimes (i_systimes.U):
 944         This variable conditionally defines the I_SYS_TIMES symbol, and indicates
 945         whether a C program should include <sys/times.h>.
 946
 947 i_systypes (i_systypes.U):
 948         This variable conditionally defines the I_SYS_TYPES symbol,
 949         and indicates whether a C program should include <sys/types.h>.
 950
 951 i_sysun (i_sysun.U):
 952         This variable conditionally defines I_SYS_UN, which indicates
 953         to the C program that it should include <sys/un.h> to get UNIX
 954         domain socket definitions.
 955
 956 i_syswait (i_syswait.U):
 957         This variable conditionally defines I_SYS_WAIT, which indicates
 958         to the C program that it should include <sys/wait.h>.
 959
 960 i_termio (i_termio.U):
 961         This variable conditionally defines the I_TERMIO symbol, which
 962         indicates to the C program that it should include <termio.h> rather
 963         than <sgtty.h>.
 964
 965 i_termios (i_termio.U):
 966         This variable conditionally defines the I_TERMIOS symbol, which
 967         indicates to the C program that the POSIX <termios.h> file is
 968         to be included.
 969
 970 i_time (i_time.U):
 971         This variable conditionally defines I_TIME, which indicates
 972         to the C program that it should include <time.h>.
 973
 974 i_unistd (i_unistd.U):
 975         This variable conditionally defines the I_UNISTD symbol, and indicates
 976         whether a C program should include <unistd.h>.
 977
 978 i_utime (i_utime.U):
 979         This variable conditionally defines the I_UTIME symbol, and indicates
 980         whether a C program should include <utime.h>.
 981
 982 i_values (i_values.U):
 983         This variable conditionally defines the I_VALUES symbol, and indicates
 984         whether a C program may include <values.h> to get symbols like MAXLONG
 985         and friends.
 986
 987 i_varargs (i_varhdr.U):
 988         This variable conditionally defines I_VARARGS, which indicates
 989         to the C program that it should include <varargs.h>.
 990
 991 i_varhdr (i_varhdr.U):
 992         Contains the name of the header to be included to get va_dcl definition.
 993         Typically one of varargs.h or stdarg.h.
 994
 995 i_vfork (i_vfork.U):
 996         This variable conditionally defines the I_VFORK symbol, and indicates
 997         whether a C program should include vfork.h.
 998
 999 installbin (bin.U):
1000         This variable is the same as binexp unless AFS is running in which case
1001         the user is explicitely prompted for it. This variable should always
1002         be used in your makefiles for maximum portability.
1003
1004 installprivlib (privlib.U):
1005         This variable is really the same as privlibexp but may differ on
1006         those systems using AFS. For extra portability, only this variable
1007         should be used in makefiles.
1008
1009 intsize (intsize.U):
1010         This variable contains the value of the INTSIZE symbol,
1011         which indicates to the C program how many bytes there are
1012         in an integer.
1013
1014 large (models.U):
1015         This variable contains a flag which will tell the C compiler and loader
1016         to produce a program running with a large memory model.  It is up to
1017         the Makefile to use this.
1018
1019 ld (dlsrc.U):
1020         This variable indicates the program to be used to link
1021         libraries for dynamic loading.  On some systems, it is 'ld'.
1022         On ELF systems, it should be $cc.  Mostly, we'll try to respect
1023         the hint file setting.
1024
1025 lddlflags (dlsrc.U):
1026         This variable contains any special flags that might need to be
1027         passed to $ld to create a shared library suitable for dynamic
1028         loading.  It is up to the makefile to use it.  For hpux, it
1029         should be -b.  For sunos 4.1, it is empty.
1030
1031 ldflags (ccflags.U):
1032         This variable contains any additional C loader flags desired by
1033         the user.  It is up to the Makefile to use this.
1034
1035 lib_ext (Unix.U):
1036         This variable defines the extension used for ordinary libraries.
1037         For unix, it is '.a'.  The '.' is included.  Other possible
1038         values include '.lib'.
1039
1040 libperl (libperl.U):
1041         The perl executable is obtained by linking perlmain.c with
1042         libperl, any static extensions (usually just DynaLoader),
1043         and any other libraries needed on this system.  libperl
1044         is usually libperl.a, but can also be libperl.so.xxx if
1045         the user wishes to build a perl executable with a shared
1046         library.
1047
1048 libs (libs.U):
1049         This variable holds the additional libraries we want to use.
1050         It is up to the Makefile to deal with it.
1051
1052 lns (lns.U):
1053         This variable holds the name of the command to make
1054         symbolic links (if they are supported).  It can be used
1055         in the Makefile. It is either 'ln -s' or 'ln'
1056
1057 lseektype (lseektype.U):
1058         This variable defines lseektype to be something like off_t, long,
1059         or whatever type is used to declare lseek offset's type in the
1060         kernel (which also appears to be lseek's return type).
1061
1062 make (make.U):
1063         This variable sets the path to the 'make' command.  It is
1064         here rather than in Loc.U so that users can override it
1065         with  Configure -Dmake=pmake, or equivalent.
1066
1067 make_set_make (make.U):
1068         Some versions of 'make' set the variable MAKE.  Others do not.
1069         This variable contains the string to be included in Makefile.SH
1070         so that MAKE is set if needed, and not if not needed.
1071         Possible values are:
1072         make_set_make='#'       # If your make program handles this for you,
1073         make_set_make=$make     # if it doesn't.
1074         I used a comment character so that we can distinguish a
1075         'set' value (from a previous config.sh or Configure -D option)
1076         from an uncomputed value.
1077
1078 mallocobj (mallocsrc.U):
1079         This variable contains the name of the malloc.o that this package
1080         generates, if that malloc.o is preferred over the system malloc.
1081         Otherwise the value is null.  This variable is intended for generating
1082         Makefiles.  See mallocsrc.
1083
1084 mallocsrc (mallocsrc.U):
1085         This variable contains the name of the malloc.c that comes with
1086         the package, if that malloc.c is preferred over the system malloc.
1087         Otherwise the value is null.  This variable is intended for generating
1088         Makefiles.
1089
1090 malloctype (mallocsrc.U):
1091         This variable contains the kind of ptr returned by malloc and realloc.
1092
1093 man1dir (man1dir.U):
1094         This variable contains the name of the directory in which manual
1095         source pages are to be put.  It is the responsibility of the
1096         Makefile.SH to get the value of this into the proper command.
1097         You must be prepared to do the ~name expansion yourself.
1098
1099 man1ext (man1dir.U):
1100         This variable contains the extension that the manual page should
1101         have: one of 'n', 'l', or '1'.  The Makefile must supply the '.'.
1102         See man1dir.
1103
1104 man3dir (man3dir.U):
1105         This variable contains the name of the directory in which manual
1106         source pages are to be put.  It is the responsibility of the
1107         Makefile.SH to get the value of this into the proper command.
1108         You must be prepared to do the ~name expansion yourself.
1109
1110 man3ext (man3dir.U):
1111         This variable contains the extension that the manual page should
1112         have: one of 'n', 'l', or '3'.  The Makefile must supply the '.'.
1113         See man3dir.
1114
1115 modetype (modetype.U):
1116         This variable defines modetype to be something like mode_t,
1117         int, unsigned short, or whatever type is used to declare file
1118         modes for system calls.
1119
1120 n (n.U):
1121         This variable contains the -n flag if that is what causes the echo
1122         command to suppress newline.  Otherwise it is null.  Correct usage is
1123             $echo $n "prompt for a question: $c".
1124
1125 o_nonblock (nblock_io.U):
1126         This variable bears the symbol value to be used during open() or fcntl()
1127         to turn on non-blocking I/O for a file descriptor. If you wish to switch
1128         between blocking and non-blocking, you may try ioctl(FIOSNBIO) instead,
1129         but that is only supported by some devices.
1130
1131 oldarchlib (oldarchlib.U):
1132         This variable holds the name of the directory in which perl5.000
1133         and perl5.001 stored
1134         architecture-dependent public library files.
1135
1136 oldarchlibexp (oldarchlib.U):
1137         This variable is the same as the oldarchlib variable, but is
1138         filename expanded at configuration time, for convenient use.
1139
1140 optimize (ccflags.U):
1141         This variable contains any optimizer/debugger flag that should be used.
1142         It is up to the Makefile to use it.
1143
1144 osname (Oldconfig.U):
1145         This variable contains the operating system name (e.g. sunos,
1146         solaris, hpux, etc.).  It can be useful later on for setting
1147         defaults.  Any spaces are replaced with underscores.  It is set
1148         to a null string if we can't figure it out.
1149
1150 pager (pager.U):
1151         This variable contains the name of the preferred pager on the system.
1152         Usual values are (the full pathnames of) more, less, pg, or cat.
1153
1154 path_sep (Unix.U):
1155         This variable defines the character used to separate elements in
1156         the shell's PATH environment variable.  On Unix, it is ':'.
1157         This is probably identical to Head.U's p_ variable and can
1158         probably be dropped.
1159
1160 perladmin (perladmin.U):
1161         Electronic mail address of the perl5 administrator.
1162
1163 prefix (prefix.U):
1164         This variable holds the name of the directory below which the
1165         user will install the package.  Usually, this is /usr/local, and
1166         executables go in /usr/local/bin, library stuff in /usr/local/lib,
1167         man pages in /usr/local/man, etc.  It is only used to set defaults
1168         for things in bin.U, mansrc.U, privlib.U, or scriptdir.U.
1169
1170 privlib (privlib.U):
1171         This variable contains the eventual value of the PRIVLIB symbol,
1172         which is the name of the private library for this package.  It may
1173         have a ~ on the front. It is up to the makefile to eventually create
1174         this directory while performing installation (with ~ substitution).
1175
1176 privlibexp (privlib.U):
1177         This variable is the ~name expanded version of privlib, so that you
1178         may use it directly in Makefiles or shell scripts.
1179
1180 prototype (prototype.U):
1181         This variable holds the eventual value of CAN_PROTOTYPE, which
1182         indicates the C compiler can handle funciton prototypes.
1183
1184 randbits (randbits.U):
1185         This variable contains the eventual value of the RANDBITS symbol,
1186         which indicates to the C program how many bits of random number
1187         the rand() function produces.
1188
1189 ranlib (orderlib.U):
1190         This variable is set to the pathname of the ranlib program, if it is
1191         needed to generate random libraries.  Set to ":" if ar can generate
1192         random libraries or if random libraries are not supported
1193
1194 rd_nodata (nblock_io.U):
1195         This variable holds the return code from read() when no data is
1196         present. It should be -1, but some systems return 0 when O_NDELAY is
1197         used, which is a shame because you cannot make the difference between
1198         no data and an EOF.. Sigh!
1199
1200 scriptdir (scriptdir.U):
1201         This variable holds the name of the directory in which the user wants
1202         to put publicly scripts for the package in question.  It is either
1203         the same directory as for binaries, or a special one that can be
1204         mounted across different architectures, like /usr/share. Programs
1205         must be prepared to deal with ~name expansion.
1206
1207 selecttype (selecttype.U):
1208         This variable holds the type used for the 2nd, 3rd, and 4th
1209         arguments to select.  Usually, this is 'fd_set *', if HAS_FD_SET
1210         is defined, and 'int *' otherwise.  This is only useful if you
1211         have select(), naturally.
1212
1213 sh (sh.U):
1214         This variable contains the full pathname of the shell used
1215         on this system to execute Bourne shell scripts.  Usually, this will be
1216         /bin/sh, though it's possible that some systems will have /bin/ksh,
1217         /bin/pdksh, /bin/ash, /bin/bash, or even something such as
1218         D:/bin/sh.exe.
1219         This unit comes before Options.U, so you can't set sh with a -D
1220         option, though you can override this (and startsh)
1221         with -O -Dsh=/bin/whatever -Dstartsh=whatever
1222
1223 shmattype (d_shmat.U):
1224         This symbol contains the type of pointer returned by shmat().
1225         It can be 'void *' or 'char *'.
1226
1227 sig_name (sig_name.U):
1228         This variable holds the signal names, space separated. The leading
1229         SIG in signals name is removed. See sig_num.
1230
1231 sig_num (sig_name.U):
1232         This variable holds the signal numbers, space separated. Those numbers
1233         correspond to the value of the signal listed in the same place within
1234         the sig_name list.
1235
1236 signal_t (d_voidsig.U):
1237         This variable holds the type of the signal handler (void or int).
1238
1239 sitearch (sitearch.U):
1240         This variable contains the eventual value of the SITEARCH symbol,
1241         which is the name of the private library for this package.  It may
1242         have a ~ on the front. It is up to the makefile to eventually create
1243         this directory while performing installation (with ~ substitution).
1244
1245 sitearchexp (sitearch.U):
1246         This variable is the ~name expanded version of sitearch, so that you
1247         may use it directly in Makefiles or shell scripts.
1248
1249 sitelib (sitelib.U):
1250         This variable contains the eventual value of the SITELIB symbol,
1251         which is the name of the private library for this package.  It may
1252         have a ~ on the front. It is up to the makefile to eventually create
1253         this directory while performing installation (with ~ substitution).
1254
1255 sitelibexp (sitelib.U):
1256         This variable is the ~name expanded version of sitelib, so that you
1257         may use it directly in Makefiles or shell scripts.
1258
1259 sizetype (sizetype.U):
1260         This variable defines sizetype to be something like size_t,
1261         unsigned long, or whatever type is used to declare length
1262         parameters for string functions.
1263
1264 small (models.U):
1265         This variable contains a flag which will tell the C compiler and loader
1266         to produce a program running with a small memory model.  It is up to
1267         the Makefile to use this.
1268
1269 spitshell (spitshell.U):
1270         This variable contains the command necessary to spit out a runnable
1271         shell on this system.  It is either cat or a grep -v for # comments.
1272
1273 split (models.U):
1274         This variable contains a flag which will tell the C compiler and loader
1275         to produce a program that will run in separate I and D space, for those
1276         machines that support separation of instruction and data space.  It is
1277         up to the Makefile to use this.
1278
1279 ssizetype (ssizetype.U):
1280         This variable defines ssizetype to be something like ssize_t,
1281         long or int.  It is used by functions that return a count
1282         of bytes or an error condition.  It must be a signed type.
1283         We will pick a type such that sizeof(SSize_t) == sizeof(Size_t).
1284
1285 startperl (startperl.U):
1286         This variable contains the string to put on the front of a perl
1287         script to make sure (hopefully) that it runs with perl and not some
1288         shell. Of course, that leading line must be followed by the classical
1289         perl idiom:
1290                 eval 'exec perl -S $0 "$@"'
1291                         if $running_under_some_shell;
1292         to guarantee perl startup should the shell execute the script. Note
1293         that this magic incatation is not understood by csh.
1294
1295 startsh (startsh.U):
1296         This variable contains the string to put on the front of a shell
1297         script to make sure (hopefully) that it runs with sh and not some
1298         other shell.
1299
1300 static_ext (Extensions.U):
1301         This variable holds a list of extension files we want to
1302         link statically into the package.  It is used by Makefile.
1303
1304 stdchar (stdchar.U):
1305         This variable conditionally defines STDCHAR to be the type of char
1306         used in stdio.h.  It has the values "unsigned char" or "char".
1307
1308 timetype (d_time.U):
1309         This variable holds the type returned by time(). It can be long,
1310         or time_t on BSD sites (in which case <sys/types.h> should be
1311         included). Anyway, the type Time_t should be used.
1312
1313 uidtype (uidtype.U):
1314         This variable defines Uid_t to be something like uid_t, int,
1315         ushort, or whatever type is used to declare user ids in the kernel.
1316
1317 useperlio (useperlio.U):
1318         This variable conditionally defines the USE_PERLIO symbol,
1319         and indicates that the PerlIO abstraction should be
1320         used throughout.
1321
1322 useshrplib (libperl.U):
1323         This variable is set to 'yes' if the user wishes
1324         to build a shared libperl, and 'no' otherwise.
1325
1326 voidflags (voidflags.U):
1327         This variable contains the eventual value of the VOIDFLAGS symbol,
1328         which indicates how much support of the void type is given by this
1329         compiler.  See VOIDFLAGS for more info.
1330