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