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