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