This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
MSG_PROXY for GNU/Hurd (previously we believed that
[perl5.git] / 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.  [`configpm'
4 generates pod documentation for Config.pm from this file--please try to keep
5 the formatting regular.]
6
7 _a (Unix.U):
8         This variable defines the extension used for ordinary libraries.
9         For unix, it is '.a'.  The '.' is included.  Other possible
10         values include '.lib'.
11
12 _exe (Unix.U):
13         This variable defines the extension used for executable files.
14         For unix it is empty.  Other possible values include '.exe'.
15
16 _o (Unix.U):
17         This variable defines the extension used for object files.
18         For unix, it is '.o'.  The '.' is included.  Other possible
19         values include '.obj'.
20
21 afs (afs.U):
22         This variable is set to 'true' if AFS (Andrew File System) is used
23         on the system, 'false' otherwise.  It is possible to override this
24         with a hint value or command line option, but you'd better know
25         what you are doing.
26
27 alignbytes (alignbytes.U):
28         This variable holds the number of bytes required to align a
29         double. Usual values are 2, 4 and 8.
30
31 ansi2knr (ansi2knr.U):
32         This variable is set if the user needs to run ansi2knr.  
33         Currently, this is not supported, so we just abort.
34
35 aphostname (d_gethname.U):
36         Thie variable contains the command which can be used to compute the
37         host name. The command is fully qualified by its absolute path, to make
38         it safe when used by a process with super-user privileges.
39
40 apiversion (patchlevel.U):
41         This is a number which identifies the lowest version of perl
42         to have an API (for XS extensions) compatible with the present
43         version.  For example, for 5.005_01, the apiversion should be
44         5.005, since 5.005_01 should be binary compatible with 5.005.
45         This should probably be incremented manually somehow, perhaps
46         from patchlevel.h.  For now, we'll guess maintenance subversions
47         will retain binary compatibility.
48
49 ar (Loc.U):
50         This variable is be used internally by Configure to determine the
51         full pathname (if any) of the ar program.  After Configure runs,
52         the value is reset to a plain "ar" and is not useful.
53
54 archlib (archlib.U):
55         This variable holds the name of the directory in which the user wants
56         to put architecture-dependent public library files for $package.
57         It is most often a local directory such as /usr/local/lib.
58         Programs using this variable must be prepared to deal
59         with filename expansion.
60
61 archlibexp (archlib.U):
62         This variable is the same as the archlib variable, but is
63         filename expanded at configuration time, for convenient use.
64
65 archname64 (use64bits.U):
66         This variable is used for the 64-bitness part of $archname.
67
68 archname (archname.U):
69         This variable is a short name to characterize the current
70         architecture.  It is used mainly to construct the default archlib.
71
72 archobjs (Unix.U):
73         This variable defines any additional objects that must be linked
74         in with the program on this architecture.  On unix, it is usually
75         empty.  It is typically used to include emulations of unix calls
76         or other facilities.  For perl on OS/2, for example, this would
77         include os2/os2.obj.
78
79 awk (Loc.U):
80         This variable is be used internally by Configure to determine the
81         full pathname (if any) of the awk program.  After Configure runs,
82         the value is reset to a plain "awk" and is not useful.
83
84 baserev (baserev.U):
85         The base revision level of this package, from the .package file.
86
87 bash (Loc.U):
88         This variable is defined but not used by Configure.
89         The value is a plain '' and is not useful.
90
91 bin (bin.U):
92         This variable holds the name of the directory in which the user wants
93         to put publicly executable images for the package in question.  It
94         is most often a local directory such as /usr/local/bin. Programs using
95         this variable must be prepared to deal with ~name substitution.
96
97 binexp (bin.U):
98         This is the same as the bin variable, but is filename expanded at
99         configuration time, for use in your makefiles.
100
101 bison (Loc.U):
102         This variable is defined but not used by Configure.
103         The value is a plain '' and is not useful.
104
105 byacc (Loc.U):
106         This variable is be used internally by Configure to determine the
107         full pathname (if any) of the byacc program.  After Configure runs,
108         the value is reset to a plain "byacc" and is not useful.
109
110 byteorder (byteorder.U):
111         This variable holds the byte order. In the following, larger digits
112         indicate more significance.  The variable byteorder is either 4321
113         on a big-endian machine, or 1234 on a little-endian, or 87654321
114         on a Cray ... or 3412 with weird order !
115
116 c (n.U):
117         This variable contains the \c string if that is what causes the echo
118         command to suppress newline.  Otherwise it is null.  Correct usage is
119             $echo $n "prompt for a question: $c".
120
121 castflags (d_castneg.U):
122         This variable contains a flag that precise difficulties the
123         compiler has casting odd floating values to unsigned long:
124                 0 = ok
125                 1 = couldn't cast < 0
126                 2 = couldn't cast >= 0x80000000
127                 4 = couldn't cast in argument expression list
128
129 cat (Loc.U):
130         This variable is be used internally by Configure to determine the
131         full pathname (if any) of the cat program.  After Configure runs,
132         the value is reset to a plain "cat" and is not useful.
133
134 cc (cc.U):
135         This variable holds the name of a command to execute a C compiler which
136         can resolve multiple global references that happen to have the same
137         name.  Usual values are 'cc', 'Mcc', 'cc -M', and 'gcc'.
138
139 cccdlflags (dlsrc.U):
140         This variable contains any special flags that might need to be
141         passed with 'cc -c' to compile modules to be used to create a shared
142         library that will be used for dynamic loading.  For hpux, this
143         should be +z.  It is up to the makefile to use it.
144
145 ccdlflags (dlsrc.U):
146         This variable contains any special flags that might need to be
147         passed to cc to link with a shared library for dynamic loading.
148         It is up to the makefile to use it.  For sunos 4.1, it should
149         be empty.
150
151 ccflags (ccflags.U):
152         This variable contains any additional C compiler flags desired by
153         the user.  It is up to the Makefile to use this.
154
155 cf_by (cf_who.U):
156         Login name of the person who ran the Configure script and answered the
157         questions. This is used to tag both config.sh and config_h.SH.
158
159 cf_email (cf_email.U):
160         Electronic mail address of the person who ran Configure. This can be
161         used by units that require the user's e-mail, like MailList.U.
162
163 cf_time (cf_who.U):
164         Holds the output of the "date" command when the configuration file was
165         produced. This is used to tag both config.sh and config_h.SH.
166
167 chgrp (Loc.U):
168         This variable is defined but not used by Configure.
169         The value is a plain '' and is not useful.
170
171 chmod (Loc.U):
172         This variable is defined but not used by Configure.
173         The value is a plain '' and is not useful.
174
175 chown (Loc.U):
176         This variable is defined but not used by Configure.
177         The value is a plain '' and is not useful.
178
179 clocktype (d_times.U):
180         This variable holds the type returned by times(). It can be long,
181         or clock_t on BSD sites (in which case <sys/types.h> should be
182         included).
183
184 comm (Loc.U):
185         This variable is be used internally by Configure to determine the
186         full pathname (if any) of the comm program.  After Configure runs,
187         the value is reset to a plain "comm" and is not useful.
188
189 compress (Loc.U):
190         This variable is defined but not used by Configure.
191         The value is a plain '' and is not useful.
192
193 contains (contains.U):
194         This variable holds the command to do a grep with a proper return
195         status.  On most sane systems it is simply "grep".  On insane systems
196         it is a grep followed by a cat followed by a test.  This variable
197         is primarily for the use of other Configure units.
198
199 cp (Loc.U):
200         This variable is be used internally by Configure to determine the
201         full pathname (if any) of the cp program.  After Configure runs,
202         the value is reset to a plain "cp" and is not useful.
203
204 cpio (Loc.U):
205         This variable is defined but not used by Configure.
206         The value is a plain '' and is not useful.
207
208 cpp (Loc.U):
209         This variable is be used internally by Configure to determine the
210         full pathname (if any) of the cpp program.  After Configure runs,
211         the value is reset to a plain "cpp" and is not useful.
212
213 cpp_stuff (cpp_stuff.U):
214         This variable contains an identification of the catenation mechanism
215         used by the C preprocessor.
216
217 cppflags (ccflags.U):
218         This variable holds the flags that will be passed to the C pre-
219         processor. It is up to the Makefile to use it.
220
221 cpplast (cppstdin.U):
222         This variable has the same functionality as cppminus, only it applies
223         to cpprun and not cppstdin.
224
225 cppminus (cppstdin.U):
226         This variable contains the second part of the string which will invoke
227         the C preprocessor on the standard input and produce to standard
228         output.  This variable will have the value "-" if cppstdin needs
229         a minus to specify standard input, otherwise the value is "".
230
231 cpprun (cppstdin.U):
232         This variable contains the command which will invoke a C preprocessor
233         on standard input and put the output to stdout. It is guaranteed not
234         to be a wrapper and may be a null string if no preprocessor can be
235         made directly available. This preprocessor might be different from the
236         one used by the C compiler. Don't forget to append cpplast after the
237         preprocessor options.
238
239 cppstdin (cppstdin.U):
240         This variable contains the command which will invoke the C
241         preprocessor on standard input and put the output to stdout.
242         It is primarily used by other Configure units that ask about
243         preprocessor symbols.
244
245 cryptlib (d_crypt.U):
246         This variable holds -lcrypt or the path to a libcrypt.a archive if
247         the crypt() function is not defined in the standard C library. It is
248         up to the Makefile to use this.
249
250 csh (Loc.U):
251         This variable is be used internally by Configure to determine the
252         full pathname (if any) of the csh program.  After Configure runs,
253         the value is reset to a plain "csh" and is not useful.
254
255 d_access (d_access.U):
256         This variable conditionally defines HAS_ACCESS if the access() system
257         call is available to check for access permissions using real IDs.
258
259 d_accessx (d_accessx.U):
260         This variable conditionally defines the HAS_ACCESSX symbol, which
261         indicates to the C program that the accessx() routine is available.
262
263 d_alarm (d_alarm.U):
264         This variable conditionally defines the HAS_ALARM symbol, which
265         indicates to the C program that the alarm() routine is available.
266
267 d_archlib (archlib.U):
268         This variable conditionally defines ARCHLIB to hold the pathname
269         of architecture-dependent library files for $package.  If
270         $archlib is the same as $privlib, then this is set to undef.
271
272 d_attribut (d_attribut.U):
273         This variable conditionally defines HASATTRIBUTE, which
274         indicates the C compiler can check for function attributes,
275         such as printf formats.
276
277 d_bcmp (d_bcmp.U):
278         This variable conditionally defines the HAS_BCMP symbol if
279         the bcmp() routine is available to compare strings.
280
281 d_bcopy (d_bcopy.U):
282         This variable conditionally defines the HAS_BCOPY symbol if
283         the bcopy() routine is available to copy strings.
284
285 d_bsd (Guess.U):
286         This symbol conditionally defines the symbol BSD when running on a
287         BSD system.
288
289 d_bsdgetpgrp (d_getpgrp.U):
290         This variable conditionally defines USE_BSD_GETPGRP if
291         getpgrp needs one arguments whereas USG one needs none.
292
293 d_bsdsetpgrp (d_setpgrp.U):
294         This variable conditionally defines USE_BSD_SETPGRP if
295         setpgrp needs two arguments whereas USG one needs none.
296         See also d_setpgid for a POSIX interface.
297
298 d_bzero (d_bzero.U):
299         This variable conditionally defines the HAS_BZERO symbol if
300         the bzero() routine is available to set memory to 0.
301
302 d_casti32 (d_casti32.U):
303         This variable conditionally defines CASTI32, which indicates
304         whether the C compiler can cast large floats to 32-bit ints.
305
306 d_castneg (d_castneg.U):
307         This variable conditionally defines CASTNEG, which indicates
308         wether the C compiler can cast negative float to unsigned.
309
310 d_charvspr (d_vprintf.U):
311         This variable conditionally defines CHARVSPRINTF if this system
312         has vsprintf returning type (char*).  The trend seems to be to
313         declare it as "int vsprintf()".
314
315 d_chown (d_chown.U):
316         This variable conditionally defines the HAS_CHOWN symbol, which
317         indicates to the C program that the chown() routine is available.
318
319 d_chroot (d_chroot.U):
320         This variable conditionally defines the HAS_CHROOT symbol, which
321         indicates to the C program that the chroot() routine is available.
322
323 d_chsize (d_chsize.U):
324         This variable conditionally defines the CHSIZE symbol, which
325         indicates to the C program that the chsize() routine is available
326         to truncate files.  You might need a -lx to get this routine.
327
328 d_closedir (d_closedir.U):
329         This variable conditionally defines HAS_CLOSEDIR if closedir() is
330         available.
331
332 d_cmsghdr_s (d_socket.U):
333         This variable conditionally defines the HAS_STRUCT_CMSGHDR symbol,
334         which indicates that the the struct cmsghdr is supported.
335
336 d_const (d_const.U):
337         This variable conditionally defines the HASCONST symbol, which
338         indicates to the C program that this C compiler knows about the
339         const type.
340
341 d_crypt (d_crypt.U):
342         This variable conditionally defines the CRYPT symbol, which
343         indicates to the C program that the crypt() routine is available
344         to encrypt passwords and the like.
345
346 d_csh (d_csh.U):
347         This variable conditionally defines the CSH symbol, which
348         indicates to the C program that the C-shell exists.
349
350 d_cuserid (d_cuserid.U):
351         This variable conditionally defines the HAS_CUSERID symbol, which
352         indicates to the C program that the cuserid() routine is available
353         to get character login names.
354
355 d_dbl_dig (d_dbl_dig.U):
356         This variable conditionally defines d_dbl_dig if this system's
357         header files provide DBL_DIG, which is the number of significant
358         digits in a double precision number.
359
360 d_dbmclose64 (dbm64.U):
361         This variable conditionally defines the HAS_DBMCLOSE64 symbol, which
362         indicates to the C program that the dbmclose64() routine is available.
363
364 d_dbminit64 (dbm64.U):
365         This variable conditionally defines the HAS_DBMINIT64 symbol, which
366         indicates to the C program that the dbminit64() routine is available.
367
368 d_delete64 (dbm64.U):
369         This variable conditionally defines the HAS_DELETE64 symbol, which
370         indicates to the C program that the delete64() routine is available.
371
372 d_difftime (d_difftime.U):
373         This variable conditionally defines the HAS_DIFFTIME symbol, which
374         indicates to the C program that the difftime() routine is available.
375
376 d_dirent64_s (io64.U):
377         This symbol will be defined if the C compiler supports struct dirent64.
378
379 d_dirnamlen (i_dirent.U):
380         This variable conditionally defines DIRNAMLEN, which indicates
381         to the C program that the length of directory entry names is
382         provided by a d_namelen field.
383
384 d_dlerror (d_dlerror.U):
385         This variable conditionally defines the HAS_DLERROR symbol, which
386         indicates to the C program that the dlerror() routine is available.
387
388 d_dlopen (d_dlopen.U):
389         This variable conditionally defines the HAS_DLOPEN symbol, which
390         indicates to the C program that the dlopen() routine is available.
391
392 d_dlsymun (d_dlsymun.U):
393         This variable conditionally defines DLSYM_NEEDS_UNDERSCORE, which
394         indicates that we need to prepend an underscore to the symbol
395         name before calling dlsym().
396
397 d_dosuid (d_dosuid.U):
398         This variable conditionally defines the symbol DOSUID, which
399         tells the C program that it should insert setuid emulation code
400         on hosts which have setuid #! scripts disabled.
401
402 d_drand48proto (d_drand48proto.U):
403         This variable conditionally defines the HAS_DRAND48_PROTO symbol,
404         which indicates to the C program that the system provides
405         a prototype for the drand48() function.  Otherwise, it is
406         up to the program to supply one.
407
408 d_dup2 (d_dup2.U):
409         This variable conditionally defines HAS_DUP2 if dup2() is
410         available to duplicate file descriptors.
411
412 d_eaccess (d_eaccess.U):
413         This variable conditionally defines the HAS_EACCESS symbol, which
414         indicates to the C program that the eaccess() routine is available.
415
416 d_endgrent (d_endgrent.U):
417         This variable conditionally defines the HAS_ENDGRENT symbol, which
418         indicates to the C program that the endgrent() routine is available
419         for sequential access of the group database.
420
421 d_endhent (d_endhent.U):
422         This variable conditionally defines HAS_ENDHOSTENT if endhostent() is
423         available to close whatever was being used for host queries.
424
425 d_endnent (d_endnent.U):
426         This variable conditionally defines HAS_ENDNETENT if endnetent() is
427         available to close whatever was being used for network queries.
428
429 d_endpent (d_endpent.U):
430         This variable conditionally defines HAS_ENDPROTOENT if endprotoent() is
431         available to close whatever was being used for protocol queries.
432
433 d_endpwent (d_endpwent.U):
434         This variable conditionally defines the HAS_ENDPWENT symbol, which
435         indicates to the C program that the endpwent() routine is available
436         for sequential access of the passwd database.
437
438 d_endsent (d_endsent.U):
439         This variable conditionally defines HAS_ENDSERVENT if endservent() is
440         available to close whatever was being used for service queries.
441
442 d_eofnblk (nblock_io.U):
443         This variable conditionally defines EOF_NONBLOCK if EOF can be seen
444         when reading from a non-blocking I/O source.
445
446 d_eunice (Guess.U):
447         This variable conditionally defines the symbols EUNICE and VAX, which
448         alerts the C program that it must deal with ideosyncracies of VMS.
449
450 d_fchmod (d_fchmod.U):
451         This variable conditionally defines the HAS_FCHMOD symbol, which
452         indicates to the C program that the fchmod() routine is available
453         to change mode of opened files.
454
455 d_fchown (d_fchown.U):
456         This variable conditionally defines the HAS_FCHOWN symbol, which
457         indicates to the C program that the fchown() routine is available
458         to change ownership of opened files.
459
460 d_fcntl (d_fcntl.U):
461         This variable conditionally defines the HAS_FCNTL symbol, and indicates
462         whether the fcntl() function exists
463
464 d_fd_macros (d_fd_set.U):
465         This variable contains the eventual value of the HAS_FD_MACROS symbol,
466         which indicates if your C compiler knows about the macros which
467         manipulate an fd_set.
468
469 d_fd_set (d_fd_set.U):
470         This variable contains the eventual value of the HAS_FD_SET symbol,
471         which indicates if your C compiler knows about the fd_set typedef.
472
473 d_fds_bits (d_fd_set.U):
474         This variable contains the eventual value of the HAS_FDS_BITS symbol,
475         which indicates if your fd_set typedef contains the fds_bits member.
476         If you have an fd_set typedef, but the dweebs who installed it did
477         a half-fast job and neglected to provide the macros to manipulate
478         an fd_set, HAS_FDS_BITS will let us know how to fix the gaffe.
479
480 d_fetch64 (dbm64.U):
481         This variable conditionally defines the HAS_FETCH64 symbol, which
482         indicates to the C program that the fetch64() routine is available.
483
484 d_fgetpos64 (stdio64.U):
485         This variable conditionally defines the HAS_FGETPOS64 symbol, which
486         indicates to the C program that the fgetpos64() routine is available.
487
488 d_fgetpos (d_fgetpos.U):
489         This variable conditionally defines HAS_FGETPOS if fgetpos() is
490         available to get the file position indicator.
491
492 d_firstkey64 (dbm64.U):
493         This variable conditionally defines the HAS_FIRSTKEY64 symbol, which
494         indicates to the C program that the firstkey64() routine is available.
495
496 d_flexfnam (d_flexfnam.U):
497         This variable conditionally defines the FLEXFILENAMES symbol, which
498         indicates that the system supports filenames longer than 14 characters.
499
500 d_flock64_s (io64.U):
501         This symbol will be defined if the C compiler supports struct flock64.
502
503 d_flock (d_flock.U):
504         This variable conditionally defines HAS_FLOCK if flock() is
505         available to do file locking.
506
507 d_fopen64 (stdio64.U):
508         This variable conditionally defines the HAS_FOPEN64 symbol, which
509         indicates to the C program that the fopen64() routine is available.
510
511 d_fork (d_fork.U):
512         This variable conditionally defines the HAS_FORK symbol, which
513         indicates to the C program that the fork() routine is available.
514
515 d_fpathconf (d_pathconf.U):
516         This variable conditionally defines the HAS_FPATHCONF symbol, which
517         indicates to the C program that the pathconf() routine is available
518         to determine file-system related limits and options associated
519         with a given open file descriptor.
520
521 d_freopen64 (stdio64.U):
522         This variable conditionally defines the HAS_FREOPEN64 symbol, which
523         indicates to the C program that the freopen64() routine is available.
524
525 d_fseek64 (stdio64.U):
526         This variable conditionally defines the HAS_FSEEK64 symbol, which
527         indicates to the C program that the fseek64() routine is available.
528
529 d_fseeko64 (stdio64.U):
530         This variable conditionally defines the HAS_FSEEKO64 symbol, which
531         indicates to the C program that the fseeko64() routine is available.
532
533 d_fseeko (d_fseeko.U):
534         This variable conditionally defines the HAS_FSEEKO symbol, which
535         indicates to the C program that the fseeko() routine is available.
536
537 d_fsetpos64 (stdio64.U):
538         This variable conditionally defines the HAS_FSETPOS64 symbol, which
539         indicates to the C program that the fsetpos64() routine is available.
540
541 d_fsetpos (d_fsetpos.U):
542         This variable conditionally defines HAS_FSETPOS if fsetpos() is
543         available to set the file position indicator.
544
545 d_fstat64 (io64.U):
546         This variable conditionally defines the HAS_FSTAT64 symbol, which
547         indicates to the C program that the fstat64() routine is available.
548
549 d_ftell64 (stdio64.U):
550         This variable conditionally defines the HAS_FTELL64 symbol, which
551         indicates to the C program that the ftell64() routine is available.
552
553 d_ftello64 (stdio64.U):
554         This variable conditionally defines the HAS_FTELLO64 symbol, which
555         indicates to the C program that the ftello64() routine is available.
556
557 d_ftello (d_ftello.U):
558         This variable conditionally defines the HAS_FTELLO symbol, which
559         indicates to the C program that the ftello() routine is available.
560
561 d_ftime (d_ftime.U):
562         This variable conditionally defines the HAS_FTIME symbol, which indicates
563         that the ftime() routine exists.  The ftime() routine is basically
564         a sub-second accuracy clock.
565
566 d_ftruncate64 (io64.U):
567         This variable conditionally defines the HAS_FTRUNCATE64 symbol, which
568         indicates to the C program that the ftruncate64() routine is available.
569
570 d_Gconvert (d_gconvert.U):
571         This variable holds what Gconvert is defined as to convert
572         floating point numbers into strings. It could be 'gconvert'
573         or a more complex macro emulating gconvert with gcvt() or sprintf.
574         Possible values are:
575                 d_Gconvert='gconvert((x),(n),(t),(b))'
576                 d_Gconvert='gcvt((x),(n),(b))'
577                 d_Gconvert='sprintf((b),"%.*g",(n),(x))'
578
579 d_getgrent (d_getgrent.U):
580         This variable conditionally defines the HAS_GETGRENT symbol, which
581         indicates to the C program that the getgrent() routine is available
582         for sequential access of the group database.
583
584 d_getgrps (d_getgrps.U):
585         This variable conditionally defines the HAS_GETGROUPS symbol, which
586         indicates to the C program that the getgroups() routine is available
587         to get the list of process groups.
588
589 d_gethbyaddr (d_gethbyad.U):
590         This variable conditionally defines the HAS_GETHOSTBYADDR symbol, which
591         indicates to the C program that the gethostbyaddr() routine is available
592         to look up hosts by their IP addresses.
593
594 d_gethbyname (d_gethbynm.U):
595         This variable conditionally defines the HAS_GETHOSTBYNAME symbol, which
596         indicates to the C program that the gethostbyname() routine is available
597         to look up host names in some data base or other.
598
599 d_gethent (d_gethent.U):
600         This variable conditionally defines HAS_GETHOSTENT if gethostent() is
601         available to look up host names in some data base or another.
602
603 d_gethname (d_gethname.U):
604         This variable conditionally defines the HAS_GETHOSTNAME symbol, which
605         indicates to the C program that the gethostname() routine may be
606         used to derive the host name.
607
608 d_gethostprotos (d_gethostprotos.U):
609         This variable conditionally defines the HAS_GETHOST_PROTOS symbol,
610         which indicates to the C program that <netdb.h> supplies
611         prototypes for the various gethost*() functions.  
612         See also netdbtype.U for probing for various netdb types.
613
614 d_getlogin (d_getlogin.U):
615         This variable conditionally defines the HAS_GETLOGIN symbol, which
616         indicates to the C program that the getlogin() routine is available
617         to get the login name.
618
619 d_getnbyaddr (d_getnbyad.U):
620         This variable conditionally defines the HAS_GETNETBYADDR symbol, which
621         indicates to the C program that the getnetbyaddr() routine is available
622         to look up networks by their IP addresses.
623
624 d_getnbyname (d_getnbynm.U):
625         This variable conditionally defines the HAS_GETNETBYNAME symbol, which
626         indicates to the C program that the getnetbyname() routine is available
627         to look up networks by their names.
628
629 d_getnent (d_getnent.U):
630         This variable conditionally defines HAS_GETNETENT if getnetent() is
631         available to look up network names in some data base or another.
632
633 d_getnetprotos (d_getnetprotos.U):
634         This variable conditionally defines the HAS_GETNET_PROTOS symbol,
635         which indicates to the C program that <netdb.h> supplies
636         prototypes for the various getnet*() functions.  
637         See also netdbtype.U for probing for various netdb types.
638
639 d_getpbyname (d_getprotby.U):
640         This variable conditionally defines the HAS_GETPROTOBYNAME 
641         symbol, which indicates to the C program that the 
642         getprotobyname() routine is available to look up protocols
643         by their name.
644
645 d_getpbynumber (d_getprotby.U):
646         This variable conditionally defines the HAS_GETPROTOBYNUMBER 
647         symbol, which indicates to the C program that the 
648         getprotobynumber() routine is available to look up protocols
649         by their number.
650
651 d_getpent (d_getpent.U):
652         This variable conditionally defines HAS_GETPROTOENT if getprotoent() is
653         available to look up protocols in some data base or another.
654
655 d_getpgid (d_getpgid.U):
656         This variable conditionally defines the HAS_GETPGID symbol, which
657         indicates to the C program that the getpgid(pid) function
658         is available to get the process group id.
659
660 d_getpgrp2 (d_getpgrp2.U):
661         This variable conditionally defines the HAS_GETPGRP2 symbol, which
662         indicates to the C program that the getpgrp2() (as in DG/UX) routine
663         is available to get the current process group.
664
665 d_getpgrp (d_getpgrp.U):
666         This variable conditionally defines HAS_GETPGRP if getpgrp() is
667         available to get the current process group.
668
669 d_getppid (d_getppid.U):
670         This variable conditionally defines the HAS_GETPPID symbol, which
671         indicates to the C program that the getppid() routine is available
672         to get the parent process ID.
673
674 d_getprior (d_getprior.U):
675         This variable conditionally defines HAS_GETPRIORITY if getpriority()
676         is available to get a process's priority.
677
678 d_getprotoprotos (d_getprotoprotos.U):
679         This variable conditionally defines the HAS_GETPROTO_PROTOS symbol,
680         which indicates to the C program that <netdb.h> supplies
681         prototypes for the various getproto*() functions.  
682         See also netdbtype.U for probing for various netdb types.
683
684 d_getpwent (d_getpwent.U):
685         This variable conditionally defines the HAS_GETPWENT symbol, which
686         indicates to the C program that the getpwent() routine is available
687         for sequential access of the passwd database.
688
689 d_getsbyname (d_getsrvby.U):
690         This variable conditionally defines the HAS_GETSERVBYNAME 
691         symbol, which indicates to the C program that the 
692         getservbyname() routine is available to look up services
693         by their name.
694
695 d_getsbyport (d_getsrvby.U):
696         This variable conditionally defines the HAS_GETSERVBYPORT 
697         symbol, which indicates to the C program that the 
698         getservbyport() routine is available to look up services
699         by their port.
700
701 d_getsent (d_getsent.U):
702         This variable conditionally defines HAS_GETSERVENT if getservent() is
703         available to look up network services in some data base or another.
704
705 d_getservprotos (d_getservprotos.U):
706         This variable conditionally defines the HAS_GETSERV_PROTOS symbol,
707         which indicates to the C program that <netdb.h> supplies
708         prototypes for the various getserv*() functions.  
709         See also netdbtype.U for probing for various netdb types.
710
711 d_gettimeod (d_ftime.U):
712         This variable conditionally defines the HAS_GETTIMEOFDAY symbol, which
713         indicates that the gettimeofday() system call exists (to obtain a
714         sub-second accuracy clock). You should probably include <sys/resource.h>.
715
716 d_gnulibc (d_gnulibc.U):
717         Defined if we're dealing with the GNU C Library.
718
719 d_grpasswd (i_grp.U):
720         This variable conditionally defines GRPASSWD, which indicates
721         that struct group in <grp.h> contains gr_passwd.
722
723 d_htonl (d_htonl.U):
724         This variable conditionally defines HAS_HTONL if htonl() and its
725         friends are available to do network order byte swapping.
726
727 d_index (d_strchr.U):
728         This variable conditionally defines HAS_INDEX if index() and
729         rindex() are available for string searching.
730
731 d_inetaton (d_inetaton.U):
732         This variable conditionally defines the HAS_INET_ATON symbol, which
733         indicates to the C program that the inet_aton() function is available
734         to parse IP address "dotted-quad" strings.
735
736 d_ino64t (io64.U):
737         This symbol will be defined if the C compiler supports ino64_t.
738
739 d_int64t (i_inttypes.U):
740             This symbol will be defined if the C compiler supports int64_t.
741
742 d_iovec_s (i_sysuio.U):
743         This variable conditionally defines the HAS_STRUCT_IOVEC symbol,
744         which indicates that the struct iovec is supported.
745
746 d_isascii (d_isascii.U):
747         This variable conditionally defines the HAS_ISASCII constant,
748         which indicates to the C program that isascii() is available.
749
750 d_killpg (d_killpg.U):
751         This variable conditionally defines the HAS_KILLPG symbol, which
752         indicates to the C program that the killpg() routine is available
753         to kill process groups.
754
755 d_lchown (d_lchown.U):
756         This variable conditionally defines the HAS_LCHOWN symbol, which
757         indicates to the C program that the lchown() routine is available
758         to operate on a symbolic link (instead of following the link).
759
760 d_link (d_link.U):
761         This variable conditionally defines HAS_LINK if link() is
762         available to create hard links.
763
764 d_locconv (d_locconv.U):
765         This variable conditionally defines HAS_LOCALECONV if localeconv() is
766         available for numeric and monetary formatting conventions.
767
768 d_lockf64 (io64.U):
769         This variable conditionally defines the HAS_LOCKF64 symbol, which
770         indicates to the C program that the lockf64() routine is available.
771
772 d_lockf (d_lockf.U):
773         This variable conditionally defines HAS_LOCKF if lockf() is
774         available to do file locking.
775
776 d_longdbl (d_longdbl.U):
777         This variable conditionally defines HAS_LONG_DOUBLE if 
778         the long double type is supported.
779
780 d_longlong (d_longlong.U):
781         This variable conditionally defines HAS_LONG_LONG if 
782         the long long type is supported.
783
784 d_lseek64 (io64.U):
785         This variable conditionally defines the HAS_LSEEK64 symbol, which
786         indicates to the C program that the lseek64() routine is available.
787
788 d_lstat64 (io64.U):
789         This variable conditionally defines the HAS_LSTAT64 symbol, which
790         indicates to the C program that the lstat64() routine is available.
791
792 d_lstat (d_lstat.U):
793         This variable conditionally defines HAS_LSTAT if lstat() is
794         available to do file stats on symbolic links.
795
796 d_mblen (d_mblen.U):
797         This variable conditionally defines the HAS_MBLEN symbol, which
798         indicates to the C program that the mblen() routine is available
799         to find the number of bytes in a multibye character.
800
801 d_mbstowcs (d_mbstowcs.U):
802         This variable conditionally defines the HAS_MBSTOWCS symbol, which
803         indicates to the C program that the mbstowcs() routine is available
804         to convert a multibyte string into a wide character string.
805
806 d_mbtowc (d_mbtowc.U):
807         This variable conditionally defines the HAS_MBTOWC symbol, which
808         indicates to the C program that the mbtowc() routine is available
809         to convert multibyte to a wide character.
810
811 d_memcmp (d_memcmp.U):
812         This variable conditionally defines the HAS_MEMCMP symbol, which
813         indicates to the C program that the memcmp() routine is available
814         to compare blocks of memory.
815
816 d_memcpy (d_memcpy.U):
817         This variable conditionally defines the HAS_MEMCPY symbol, which
818         indicates to the C program that the memcpy() routine is available
819         to copy blocks of memory.
820
821 d_memmove (d_memmove.U):
822         This variable conditionally defines the HAS_MEMMOVE symbol, which
823         indicates to the C program that the memmove() routine is available
824         to copy potentatially overlapping blocks of memory.
825
826 d_memset (d_memset.U):
827         This variable conditionally defines the HAS_MEMSET symbol, which
828         indicates to the C program that the memset() routine is available
829         to set blocks of memory.
830
831 d_mkdir (d_mkdir.U):
832         This variable conditionally defines the HAS_MKDIR symbol, which
833         indicates to the C program that the mkdir() routine is available
834         to create directories..
835
836 d_mkfifo (d_mkfifo.U):
837         This variable conditionally defines the HAS_MKFIFO symbol, which
838         indicates to the C program that the mkfifo() routine is available.
839
840 d_mktime (d_mktime.U):
841         This variable conditionally defines the HAS_MKTIME symbol, which
842         indicates to the C program that the mktime() routine is available.
843
844 d_msg (d_msg.U):
845         This variable conditionally defines the HAS_MSG symbol, which
846         indicates that the entire msg*(2) library is present.
847
848 d_msg_ctrunc (d_socket.U):
849         This variable conditionally defines the HAS_MSG_CTRUNC symbol,
850         which indicates that the MSG_CTRUNC is available.  #ifdef is
851         not enough because it may be an enum, glibc has been known to do this.
852
853 d_msg_dontroute (d_socket.U):
854         This variable conditionally defines the HAS_MSG_DONTROUTE symbol,
855         which indicates that the MSG_DONTROUTE is available.  #ifdef is
856         not enough because it may be an enum, glibc has been known to do this.
857
858 d_msg_oob (d_socket.U):
859         This variable conditionally defines the HAS_MSG_OOB symbol,
860         which indicates that the MSG_OOB is available.  #ifdef is
861         not enough because it may be an enum, glibc has been known to do this.
862
863 d_msg_peek (d_socket.U):
864         This variable conditionally defines the HAS_MSG_PEEK symbol,
865         which indicates that the MSG_PEEK is available.  #ifdef is
866         not enough because it may be an enum, glibc has been known to do this.
867
868 d_msg_proxy (d_socket.U):
869         This variable conditionally defines the HAS_MSG_PROXY symbol,
870         which indicates that the MSG_PROXY is available.  #ifdef is
871         not enough because it may be an enum, glibc has been known to do this.
872
873 d_msgctl (d_msgctl.U):
874         This variable conditionally defines the HAS_MSGCTL symbol, which
875         indicates to the C program that the msgctl() routine is available.
876
877 d_msgget (d_msgget.U):
878         This variable conditionally defines the HAS_MSGGET symbol, which
879         indicates to the C program that the msgget() routine is available.
880
881 d_msghdr_s (d_socket.U):
882         This variable conditionally defines the HAS_STRUCT_MSGHDR symbol,
883         which indicates that the struct msghdr is supported.
884
885 d_msgrcv (d_msgrcv.U):
886         This variable conditionally defines the HAS_MSGRCV symbol, which
887         indicates to the C program that the msgrcv() routine is available.
888
889 d_msgsnd (d_msgsnd.U):
890         This variable conditionally defines the HAS_MSGSND symbol, which
891         indicates to the C program that the msgsnd() routine is available.
892
893 d_mymalloc (mallocsrc.U):
894         This variable conditionally defines MYMALLOC in case other parts
895         of the source want to take special action if MYMALLOC is used.
896         This may include different sorts of profiling or error detection.
897
898 d_nextkey64 (dbm64.U):
899         This variable conditionally defines the HAS_NEXTKEY64 symbol, which
900         indicates to the C program that the nextkey64() routine is available.
901
902 d_nice (d_nice.U):
903         This variable conditionally defines the HAS_NICE symbol, which
904         indicates to the C program that the nice() routine is available.
905
906 d_off64t (io64.U):
907         This symbol will be defined if the C compiler supports off64_t.
908
909 d_oldpthreads (usethreads.U):
910         This variable conditionally defines the OLD_PTHREADS_API symbol,
911         and indicates that Perl should be built to use the old
912         draft POSIX threads API.  This is only potneially meaningful if
913         usethreads is set.
914
915 d_oldsock (d_socket.U):
916         This variable conditionally defines the OLDSOCKET symbol, which
917         indicates that the BSD socket interface is based on 4.1c and not 4.2.
918
919 d_open3 (d_open3.U):
920         This variable conditionally defines the HAS_OPEN3 manifest constant,
921         which indicates to the C program that the 3 argument version of
922         the open(2) function is available.
923
924 d_open64 (io64.U):
925         This variable conditionally defines the HAS_OPEN64 symbol, which
926         indicates to the C program that the open64() routine is available.
927
928 d_opendir64 (io64.U):
929         This variable conditionally defines the HAS_OPENDIR64 symbol, which
930         indicates to the C program that the opendir64() routine is available.
931
932 d_pathconf (d_pathconf.U):
933         This variable conditionally defines the HAS_PATHCONF symbol, which
934         indicates to the C program that the pathconf() routine is available
935         to determine file-system related limits and options associated
936         with a given filename.
937
938 d_pause (d_pause.U):
939         This variable conditionally defines the HAS_PAUSE symbol, which
940         indicates to the C program that the pause() routine is available
941         to suspend a process until a signal is received.
942
943 d_phostname (d_gethname.U):
944         This variable conditionally defines the PHOSTNAME symbol, which
945         contains the shell command which, when fed to popen(), may be
946         used to derive the host name.
947
948 d_pipe (d_pipe.U):
949         This variable conditionally defines the HAS_PIPE symbol, which
950         indicates to the C program that the pipe() routine is available
951         to create an inter-process channel.
952
953 d_poll (d_poll.U):
954         This variable conditionally defines the HAS_POLL symbol, which
955         indicates to the C program that the poll() routine is available
956         to poll active file descriptors.
957
958 d_portable (d_portable.U):
959         This variable conditionally defines the PORTABLE symbol, which
960         indicates to the C program that it should not assume that it is
961         running on the machine it was compiled on.
962
963 d_pthread_create_joinable (d_pthrattrj.U):
964         This variable conditionally defines pthread_create_joinable.
965         undef if pthread.h defines PTHREAD_CREATE_JOINABLE.
966
967 d_pthread_yield (d_pthread_y.U):
968         This variable conditionally defines the HAS_PTHREAD_YIELD
969         symbol if the pthread_yield routine is available to yield
970         the execution of the current thread.
971
972 d_pwage (i_pwd.U):
973         This variable conditionally defines PWAGE, which indicates
974         that struct passwd contains pw_age.
975
976 d_pwchange (i_pwd.U):
977         This variable conditionally defines PWCHANGE, which indicates
978         that struct passwd contains pw_change.
979
980 d_pwclass (i_pwd.U):
981         This variable conditionally defines PWCLASS, which indicates
982         that struct passwd contains pw_class.
983
984 d_pwcomment (i_pwd.U):
985         This variable conditionally defines PWCOMMENT, which indicates
986         that struct passwd contains pw_comment.
987
988 d_pwexpire (i_pwd.U):
989         This variable conditionally defines PWEXPIRE, which indicates
990         that struct passwd contains pw_expire.
991
992 d_pwgecos (i_pwd.U):
993         This variable conditionally defines PWGECOS, which indicates
994         that struct passwd contains pw_gecos.
995
996 d_pwpasswd (i_pwd.U):
997         This variable conditionally defines PWPASSWD, which indicates
998         that struct passwd contains pw_passwd.
999
1000 d_pwquota (i_pwd.U):
1001         This variable conditionally defines PWQUOTA, which indicates
1002         that struct passwd contains pw_quota.
1003
1004 d_readdir64 (io64.U):
1005         This variable conditionally defines the HAS_READDIR64 symbol, which
1006         indicates to the C program that the readdir64() routine is available.
1007
1008 d_readdir (d_readdir.U):
1009         This variable conditionally defines HAS_READDIR if readdir() is
1010         available to read directory entries.
1011
1012 d_readlink (d_readlink.U):
1013         This variable conditionally defines the HAS_READLINK symbol, which
1014         indicates to the C program that the readlink() routine is available
1015         to read the value of a symbolic link.
1016
1017 d_readv (d_readv.U):
1018         This variable conditionally defines the HAS_READV symbol, which
1019         indicates to the C program that the readv() routine is available.
1020
1021 d_recvmsg (d_socket.U):
1022         This variable conditionally defines the HAS_RECVMSG symbol,
1023         which indicates that the recvmsg is supported.
1024
1025 d_rename (d_rename.U):
1026         This variable conditionally defines the HAS_RENAME symbol, which
1027         indicates to the C program that the rename() routine is available
1028         to rename files.
1029
1030 d_rewinddir (d_readdir.U):
1031         This variable conditionally defines HAS_REWINDDIR if rewinddir() is
1032         available.
1033
1034 d_rmdir (d_rmdir.U):
1035         This variable conditionally defines HAS_RMDIR if rmdir() is
1036         available to remove directories.
1037
1038 d_safebcpy (d_safebcpy.U):
1039         This variable conditionally defines the HAS_SAFE_BCOPY symbol if
1040         the bcopy() routine can do overlapping copies.
1041
1042 d_safemcpy (d_safemcpy.U):
1043         This variable conditionally defines the HAS_SAFE_MEMCPY symbol if
1044         the memcpy() routine can do overlapping copies.
1045
1046 d_sanemcmp (d_sanemcmp.U):
1047         This variable conditionally defines the HAS_SANE_MEMCMP symbol if
1048         the memcpy() routine is available and can be used to compare relative
1049         magnitudes of chars with their high bits set.
1050
1051 d_sched_yield (d_pthread_y.U):
1052         This variable conditionally defines the HAS_SCHED_YIELD
1053         symbol if the sched_yield routine is available to yield
1054         the execution of the current thread.
1055
1056 d_scm_rights (d_socket.U):
1057         This variable conditionally defines the HAS_SCM_RIGHTS symbol,
1058         which indicates that the SCM_RIGHTS is available.  #ifdef is
1059         not enough because it may be an enum, glibc has been known to do this.
1060
1061 d_seekdir64 (io64.U):
1062         This variable conditionally defines the HAS_SEEKDIR64 symbol, which
1063         indicates to the C program that the seekdir64() routine is available.
1064
1065 d_seekdir (d_readdir.U):
1066         This variable conditionally defines HAS_SEEKDIR if seekdir() is
1067         available.
1068
1069 d_select (d_select.U):
1070         This variable conditionally defines HAS_SELECT if select() is
1071         available to select active file descriptors. A <sys/time.h>
1072         inclusion may be necessary for the timeout field.
1073
1074 d_sem (d_sem.U):
1075         This variable conditionally defines the HAS_SEM symbol, which
1076         indicates that the entire sem*(2) library is present.
1077
1078 d_semctl (d_semctl.U):
1079         This variable conditionally defines the HAS_SEMCTL symbol, which
1080         indicates to the C program that the semctl() routine is available.
1081
1082 d_semctl_semid_ds (d_union_senum.U):
1083         This variable conditionally defines USE_SEMCTL_SEMID_DS, which
1084         indicates that struct semid_ds * is to be used for semctl IPC_STAT.
1085
1086 d_semctl_semun (d_union_senum.U):
1087         This variable conditionally defines USE_SEMCTL_SEMUN, which
1088         indicates that union semun is to be used for semctl IPC_STAT.
1089
1090 d_semget (d_semget.U):
1091         This variable conditionally defines the HAS_SEMGET symbol, which
1092         indicates to the C program that the semget() routine is available.
1093
1094 d_semop (d_semop.U):
1095         This variable conditionally defines the HAS_SEMOP symbol, which
1096         indicates to the C program that the semop() routine is available.
1097
1098 d_sendmsg (d_socket.U):
1099         This variable conditionally defines the HAS_SENDMSG symbol,
1100         which indicates that the sendmsg is supported.
1101
1102 d_setegid (d_setegid.U):
1103         This variable conditionally defines the HAS_SETEGID symbol, which
1104         indicates to the C program that the setegid() routine is available
1105         to change the effective gid of the current program.
1106
1107 d_seteuid (d_seteuid.U):
1108         This variable conditionally defines the HAS_SETEUID symbol, which
1109         indicates to the C program that the seteuid() routine is available
1110         to change the effective uid of the current program.
1111
1112 d_setgrent (d_setgrent.U):
1113         This variable conditionally defines the HAS_SETGRENT symbol, which
1114         indicates to the C program that the setgrent() routine is available
1115         for initializing sequential access to the group database.
1116
1117 d_setgrps (d_setgrps.U):
1118         This variable conditionally defines the HAS_SETGROUPS symbol, which
1119         indicates to the C program that the setgroups() routine is available
1120         to set the list of process groups.
1121
1122 d_sethent (d_sethent.U):
1123         This variable conditionally defines HAS_SETHOSTENT if sethostent() is
1124         available.
1125
1126 d_setlinebuf (d_setlnbuf.U):
1127         This variable conditionally defines the HAS_SETLINEBUF symbol, which
1128         indicates to the C program that the setlinebuf() routine is available
1129         to change stderr or stdout from block-buffered or unbuffered to a
1130         line-buffered mode.
1131
1132 d_setlocale (d_setlocale.U):
1133         This variable conditionally defines HAS_SETLOCALE if setlocale() is
1134         available to handle locale-specific ctype implementations.
1135
1136 d_setnent (d_setnent.U):
1137         This variable conditionally defines HAS_SETNETENT if setnetent() is
1138         available.
1139
1140 d_setpent (d_setpent.U):
1141         This variable conditionally defines HAS_SETPROTOENT if setprotoent() is
1142         available.
1143
1144 d_setpgid (d_setpgid.U):
1145         This variable conditionally defines the HAS_SETPGID symbol if the
1146         setpgid(pid, gpid) function is available to set process group ID.
1147
1148 d_setpgrp2 (d_setpgrp2.U):
1149         This variable conditionally defines the HAS_SETPGRP2 symbol, which
1150         indicates to the C program that the setpgrp2() (as in DG/UX) routine
1151         is available to set the current process group.
1152
1153 d_setpgrp (d_setpgrp.U):
1154         This variable conditionally defines HAS_SETPGRP if setpgrp() is
1155         available to set the current process group.
1156
1157 d_setprior (d_setprior.U):
1158         This variable conditionally defines HAS_SETPRIORITY if setpriority()
1159         is available to set a process's priority.
1160
1161 d_setpwent (d_setpwent.U):
1162         This variable conditionally defines the HAS_SETPWENT symbol, which
1163         indicates to the C program that the setpwent() routine is available
1164         for initializing sequential access to the passwd database.
1165
1166 d_setregid (d_setregid.U):
1167         This variable conditionally defines HAS_SETREGID if setregid() is
1168         available to change the real and effective gid of the current
1169         process.
1170
1171 d_setresgid (d_setregid.U):
1172         This variable conditionally defines HAS_SETRESGID if setresgid() is
1173         available to change the real, effective and saved gid of the current
1174         process.
1175
1176 d_setresuid (d_setreuid.U):
1177         This variable conditionally defines HAS_SETREUID if setresuid() is
1178         available to change the real, effective and saved uid of the current
1179         process.
1180
1181 d_setreuid (d_setreuid.U):
1182         This variable conditionally defines HAS_SETREUID if setreuid() is
1183         available to change the real and effective uid of the current
1184         process.
1185
1186 d_setrgid (d_setrgid.U):
1187         This variable conditionally defines the HAS_SETRGID symbol, which
1188         indicates to the C program that the setrgid() routine is available
1189         to change the real gid of the current program.
1190
1191 d_setruid (d_setruid.U):
1192         This variable conditionally defines the HAS_SETRUID symbol, which
1193         indicates to the C program that the setruid() routine is available
1194         to change the real uid of the current program.
1195
1196 d_setsent (d_setsent.U):
1197         This variable conditionally defines HAS_SETSERVENT if setservent() is
1198         available.
1199
1200 d_setsid (d_setsid.U):
1201         This variable conditionally defines HAS_SETSID if setsid() is
1202         available to set the process group ID.
1203
1204 d_setvbuf (d_setvbuf.U):
1205         This variable conditionally defines the HAS_SETVBUF symbol, which
1206         indicates to the C program that the setvbuf() routine is available
1207         to change buffering on an open stdio stream.
1208
1209 d_sfio (d_sfio.U):
1210         This variable conditionally defines the USE_SFIO symbol,
1211         and indicates whether sfio is available (and should be used).
1212
1213 d_shm (d_shm.U):
1214         This variable conditionally defines the HAS_SHM symbol, which
1215         indicates that the entire shm*(2) library is present.
1216
1217 d_shmat (d_shmat.U):
1218         This variable conditionally defines the HAS_SHMAT symbol, which
1219         indicates to the C program that the shmat() routine is available.
1220
1221 d_shmatprototype (d_shmat.U):
1222         This variable conditionally defines the HAS_SHMAT_PROTOTYPE 
1223         symbol, which indicates that sys/shm.h has a prototype for
1224         shmat.
1225
1226 d_shmctl (d_shmctl.U):
1227         This variable conditionally defines the HAS_SHMCTL symbol, which
1228         indicates to the C program that the shmctl() routine is available.
1229
1230 d_shmdt (d_shmdt.U):
1231         This variable conditionally defines the HAS_SHMDT symbol, which
1232         indicates to the C program that the shmdt() routine is available.
1233
1234 d_shmget (d_shmget.U):
1235         This variable conditionally defines the HAS_SHMGET symbol, which
1236         indicates to the C program that the shmget() routine is available.
1237
1238 d_sigaction (d_sigaction.U):
1239         This variable conditionally defines the HAS_SIGACTION symbol, which
1240         indicates that the Vr4 sigaction() routine is available.
1241
1242 d_sigsetjmp (d_sigsetjmp.U):
1243         This variable conditionally defines the HAS_SIGSETJMP symbol,
1244         which indicates that the sigsetjmp() routine is available to
1245         call setjmp() and optionally save the process's signal mask.
1246
1247 d_socket (d_socket.U):
1248         This variable conditionally defines HAS_SOCKET, which indicates
1249         that the BSD socket interface is supported.
1250
1251 d_sockpair (d_socket.U):
1252         This variable conditionally defines the HAS_SOCKETPAIR symbol, which
1253         indicates that the BSD socketpair() is supported.
1254
1255 d_stat64 (io64.U):
1256         This variable conditionally defines the HAS_STAT64 symbol, which
1257         indicates to the C program that the stat64() routine is available.
1258
1259 d_statblks (d_statblks.U):
1260         This variable conditionally defines USE_STAT_BLOCKS
1261         if this system has a stat structure declaring
1262         st_blksize and st_blocks.
1263
1264 d_stdio_cnt_lval (d_stdstdio.U):
1265         This variable conditionally defines STDIO_CNT_LVALUE if the
1266         FILE_cnt macro can be used as an lvalue.
1267
1268 d_stdio_ptr_lval (d_stdstdio.U):
1269         This variable conditionally defines STDIO_PTR_LVALUE if the
1270         FILE_ptr macro can be used as an lvalue.
1271
1272 d_stdiobase (d_stdstdio.U):
1273         This variable conditionally defines USE_STDIO_BASE if this system
1274         has a FILE structure declaring a usable _base field (or equivalent)
1275         in stdio.h.
1276
1277 d_stdstdio (d_stdstdio.U):
1278         This variable conditionally defines USE_STDIO_PTR if this system
1279         has a FILE structure declaring usable _ptr and _cnt fields (or
1280         equivalent) in stdio.h.
1281
1282 d_store64 (dbm64.U):
1283         This variable conditionally defines the HAS_STORE64 symbol, which
1284         indicates to the C program that the store64() routine is available.
1285
1286 d_strchr (d_strchr.U):
1287         This variable conditionally defines HAS_STRCHR if strchr() and
1288         strrchr() are available for string searching.
1289
1290 d_strcoll (d_strcoll.U):
1291         This variable conditionally defines HAS_STRCOLL if strcoll() is
1292         available to compare strings using collating information.
1293
1294 d_strctcpy (d_strctcpy.U):
1295         This variable conditionally defines the USE_STRUCT_COPY symbol, which
1296         indicates to the C program that this C compiler knows how to copy
1297         structures.
1298
1299 d_strerrm (d_strerror.U):
1300         This variable holds what Strerrr is defined as to translate an error
1301         code condition into an error message string. It could be 'strerror'
1302         or a more complex macro emulating strrror with sys_errlist[], or the
1303         "unknown" string when both strerror and sys_errlist are missing.
1304
1305 d_strerror (d_strerror.U):
1306         This variable conditionally defines HAS_STRERROR if strerror() is
1307         available to translate error numbers to strings.
1308
1309 d_strtod (d_strtod.U):
1310         This variable conditionally defines the HAS_STRTOD symbol, which
1311         indicates to the C program that the strtod() routine is available
1312         to provide better numeric string conversion than atof().
1313
1314 d_strtol (d_strtol.U):
1315         This variable conditionally defines the HAS_STRTOL symbol, which
1316         indicates to the C program that the strtol() routine is available
1317         to provide better numeric string conversion than atoi() and friends.
1318
1319 d_strtoul (d_strtoul.U):
1320         This variable conditionally defines the HAS_STRTOUL symbol, which
1321         indicates to the C program that the strtoul() routine is available
1322         to provide conversion of strings to unsigned long.
1323
1324 d_strxfrm (d_strxfrm.U):
1325         This variable conditionally defines HAS_STRXFRM if strxfrm() is
1326         available to transform strings.
1327
1328 d_suidsafe (d_dosuid.U):
1329         This variable conditionally defines SETUID_SCRIPTS_ARE_SECURE_NOW
1330         if setuid scripts can be secure.  This test looks in /dev/fd/.
1331
1332 d_symlink (d_symlink.U):
1333         This variable conditionally defines the HAS_SYMLINK symbol, which
1334         indicates to the C program that the symlink() routine is available
1335         to create symbolic links.
1336
1337 d_syscall (d_syscall.U):
1338         This variable conditionally defines HAS_SYSCALL if syscall() is
1339         available call arbitrary system calls.
1340
1341 d_sysconf (d_sysconf.U):
1342         This variable conditionally defines the HAS_SYSCONF symbol, which
1343         indicates to the C program that the sysconf() routine is available
1344         to determine system related limits and options.
1345
1346 d_sysernlst (d_strerror.U):
1347         This variable conditionally defines HAS_SYS_ERRNOLIST if sys_errnolist[]
1348         is available to translate error numbers to the symbolic name.
1349
1350 d_syserrlst (d_strerror.U):
1351         This variable conditionally defines HAS_SYS_ERRLIST if sys_errlist[] is
1352         available to translate error numbers to strings.
1353
1354 d_system (d_system.U):
1355         This variable conditionally defines HAS_SYSTEM if system() is
1356         available to issue a shell command.
1357
1358 d_tcgetpgrp (d_tcgtpgrp.U):
1359         This variable conditionally defines the HAS_TCGETPGRP symbol, which
1360         indicates to the C program that the tcgetpgrp() routine is available.
1361         to get foreground process group ID.
1362
1363 d_tcsetpgrp (d_tcstpgrp.U):
1364         This variable conditionally defines the HAS_TCSETPGRP symbol, which
1365         indicates to the C program that the tcsetpgrp() routine is available
1366         to set foreground process group ID.
1367
1368 d_telldir64 (io64.U):
1369         This variable conditionally defines the HAS_TELLDIR64 symbol, which
1370         indicates to the C program that the telldir64() routine is available.
1371
1372 d_telldir (d_readdir.U):
1373         This variable conditionally defines HAS_TELLDIR if telldir() is
1374         available.
1375
1376 d_time (d_time.U):
1377         This variable conditionally defines the HAS_TIME symbol, which indicates
1378         that the time() routine exists.  The time() routine is normaly
1379         provided on UNIX systems.
1380
1381 d_times (d_times.U):
1382         This variable conditionally defines the HAS_TIMES symbol, which indicates
1383         that the times() routine exists.  The times() routine is normaly
1384         provided on UNIX systems. You may have to include <sys/times.h>.
1385
1386 d_tmpfile64 (stdio64.U):
1387         This variable conditionally defines the HAS_TMPFILE64 symbol, which
1388         indicates to the C program that the tmpfile64() routine is available.
1389
1390 d_truncate64 (io64.U):
1391         This variable conditionally defines the HAS_TRUNCATE64 symbol, which
1392         indicates to the C program that the truncate64() routine is available.
1393
1394 d_truncate (d_truncate.U):
1395         This variable conditionally defines HAS_TRUNCATE if truncate() is
1396         available to truncate files.
1397
1398 d_tzname (d_tzname.U):
1399         This variable conditionally defines HAS_TZNAME if tzname[] is
1400         available to access timezone names.
1401
1402 d_umask (d_umask.U):
1403         This variable conditionally defines the HAS_UMASK symbol, which
1404         indicates to the C program that the umask() routine is available.
1405         to set and get the value of the file creation mask.
1406
1407 d_uname (d_gethname.U):
1408         This variable conditionally defines the HAS_UNAME symbol, which
1409         indicates to the C program that the uname() routine may be
1410         used to derive the host name.
1411
1412 d_union_semun (d_union_senum.U):
1413         This variable conditionally defines HAS_UNION_SEMUN if the
1414         union semun is defined by including <sys/sem.h>.
1415
1416 d_vfork (d_vfork.U):
1417         This variable conditionally defines the HAS_VFORK symbol, which
1418         indicates the vfork() routine is available.
1419
1420 d_void_closedir (d_closedir.U):
1421         This variable conditionally defines VOID_CLOSEDIR if closedir()
1422         does not return a value.
1423
1424 d_voidsig (d_voidsig.U):
1425         This variable conditionally defines VOIDSIG if this system
1426         declares "void (*signal(...))()" in signal.h.  The old way was to
1427         declare it as "int (*signal(...))()".
1428
1429 d_voidtty (i_sysioctl.U):
1430         This variable conditionally defines USE_IOCNOTTY to indicate that the
1431         ioctl() call with TIOCNOTTY should be used to void tty association.
1432         Otherwise (on USG probably), it is enough to close the standard file
1433         decriptors and do a setpgrp().
1434
1435 d_volatile (d_volatile.U):
1436         This variable conditionally defines the HASVOLATILE symbol, which
1437         indicates to the C program that this C compiler knows about the
1438         volatile declaration.
1439
1440 d_vprintf (d_vprintf.U):
1441         This variable conditionally defines the HAS_VPRINTF symbol, which
1442         indicates to the C program that the vprintf() routine is available
1443         to printf with a pointer to an argument list.
1444
1445 d_wait4 (d_wait4.U):
1446         This variable conditionally defines the HAS_WAIT4 symbol, which
1447         indicates the wait4() routine is available.
1448
1449 d_waitpid (d_waitpid.U):
1450         This variable conditionally defines HAS_WAITPID if waitpid() is
1451         available to wait for child process.
1452
1453 d_wcstombs (d_wcstombs.U):
1454         This variable conditionally defines the HAS_WCSTOMBS symbol, which
1455         indicates to the C program that the wcstombs() routine is available
1456         to convert wide character strings to multibyte strings.
1457
1458 d_wctomb (d_wctomb.U):
1459         This variable conditionally defines the HAS_WCTOMB symbol, which
1460         indicates to the C program that the wctomb() routine is available
1461         to convert a wide character to a multibyte.
1462
1463 d_writev (d_writev.U):
1464         This variable conditionally defines the HAS_WRITEV symbol, which
1465         indicates to the C program that the writev() routine is available.
1466
1467 d_xenix (Guess.U):
1468         This variable conditionally defines the symbol XENIX, which alerts
1469         the C program that it runs under Xenix.
1470
1471 date (Loc.U):
1472         This variable is be used internally by Configure to determine the
1473         full pathname (if any) of the date program.  After Configure runs,
1474         the value is reset to a plain "date" and is not useful.
1475
1476 db_hashtype (i_db.U):
1477         This variable contains the type of the hash structure element
1478         in the <db.h> header file.  In older versions of DB, it was
1479         int, while in newer ones it is u_int32_t.
1480
1481 db_prefixtype (i_db.U):
1482         This variable contains the type of the prefix structure element
1483         in the <db.h> header file.  In older versions of DB, it was
1484         int, while in newer ones it is size_t.
1485
1486 direntrytype (i_dirent.U):
1487         This symbol is set to 'struct direct' or 'struct dirent' depending on
1488         whether dirent is available or not. You should use this pseudo type to
1489         portably declare your directory entries.
1490
1491 dlext (dlext.U):
1492         This variable contains the extension that is to be used for the
1493         dynamically loaded modules that perl generaties.
1494
1495 dlsrc (dlsrc.U):
1496         This variable contains the name of the dynamic loading file that
1497         will be used with the package.
1498
1499 doublesize (doublesize.U):
1500         This variable contains the value of the DOUBLESIZE symbol, which
1501         indicates to the C program how many bytes there are in a double.
1502
1503 drand01 (randfunc.U):
1504         Indicates the macro to be used to generate normalized
1505         random numbers.  Uses randfunc, often divided by
1506         (double) (((unsigned long) 1 << randbits)) in order to
1507         normalize the result.
1508         In C programs, the macro 'Drand01' is mapped to drand01.
1509
1510 dynamic_ext (Extensions.U):
1511         This variable holds a list of XS extension files we want to
1512         link dynamically into the package.  It is used by Makefile.
1513
1514 eagain (nblock_io.U):
1515         This variable bears the symbolic errno code set by read() when no
1516         data is present on the file and non-blocking I/O was enabled (otherwise,
1517         read() blocks naturally).
1518
1519 ebcdic (ebcdic.U):
1520         This variable conditionally defines EBCDIC if this
1521         system uses EBCDIC encoding.  Among other things, this
1522         means that the character ranges are not contiguous.
1523         See trnl.U
1524
1525 echo (Loc.U):
1526         This variable is be used internally by Configure to determine the
1527         full pathname (if any) of the echo program.  After Configure runs,
1528         the value is reset to a plain "echo" and is not useful.
1529
1530 egrep (Loc.U):
1531         This variable is be used internally by Configure to determine the
1532         full pathname (if any) of the egrep program.  After Configure runs,
1533         the value is reset to a plain "egrep" and is not useful.
1534
1535 emacs (Loc.U):
1536         This variable is defined but not used by Configure.
1537         The value is a plain '' and is not useful.
1538
1539 eunicefix (Init.U):
1540         When running under Eunice this variable contains a command which will
1541         convert a shell script to the proper form of text file for it to be
1542         executable by the shell.  On other systems it is a no-op.
1543
1544 exe_ext (Unix.U):
1545         This is an old synonym for _exe.
1546
1547 expr (Loc.U):
1548         This variable is be used internally by Configure to determine the
1549         full pathname (if any) of the expr program.  After Configure runs,
1550         the value is reset to a plain "expr" and is not useful.
1551
1552 extensions (Extensions.U):
1553         This variable holds a list of all extension files (both XS and
1554         non-xs linked into the package.  It is propagated to Config.pm
1555         and is typically used to test whether a particular extesion 
1556         is available.
1557
1558 find (Loc.U):
1559         This variable is defined but not used by Configure.
1560         The value is a plain '' and is not useful.
1561
1562 firstmakefile (Unix.U):
1563         This variable defines the first file searched by make.  On unix,
1564         it is makefile (then Makefile).  On case-insensitive systems,
1565         it might be something else.  This is only used to deal with
1566         convoluted make depend tricks.
1567
1568 flex (Loc.U):
1569         This variable is defined but not used by Configure.
1570         The value is a plain '' and is not useful.
1571
1572 fpostype (fpostype.U):
1573         This variable defines Fpos_t to be something like fpost_t, long, 
1574         uint, or whatever type is used to declare file positions in libc.
1575
1576 freetype (mallocsrc.U):
1577         This variable contains the return type of free().  It is usually
1578         void, but occasionally int.
1579
1580 full_csh (d_csh.U):
1581         This variable contains the full pathname to 'csh', whether or
1582         not the user has specified 'portability'.  This is only used
1583         in the compiled C program, and we assume that all systems which
1584         can share this executable will have the same full pathname to
1585         'csh.'
1586
1587 full_sed (Loc_sed.U):
1588         This variable contains the full pathname to 'sed', whether or
1589         not the user has specified 'portability'.  This is only used
1590         in the compiled C program, and we assume that all systems which
1591         can share this executable will have the same full pathname to
1592         'sed.'
1593
1594 gccversion (cc.U):
1595         If GNU cc (gcc) is used, this variable holds '1' or '2' to 
1596         indicate whether the compiler is version 1 or 2.  This is used in
1597         setting some of the default cflags.  It is set to '' if not gcc.
1598
1599 gidtype (gidtype.U):
1600         This variable defines Gid_t to be something like gid_t, int,
1601         ushort, or whatever type is used to declare the return type
1602         of getgid().  Typically, it is the type of group ids in the kernel.
1603
1604 grep (Loc.U):
1605         This variable is be used internally by Configure to determine the
1606         full pathname (if any) of the grep program.  After Configure runs,
1607         the value is reset to a plain "grep" and is not useful.
1608
1609 groupcat (nis.U):
1610         This variable contains a command that produces the text of the
1611         /etc/group file.  This is normally "cat /etc/group", but can be
1612         "ypcat group" when NIS is used.
1613
1614 groupstype (groupstype.U):
1615         This variable defines Groups_t to be something like gid_t, int, 
1616         ushort, or whatever type is used for the second argument to
1617         getgroups() and setgroups().  Usually, this is the same as
1618         gidtype (gid_t), but sometimes it isn't.
1619
1620 gzip (Loc.U):
1621         This variable is be used internally by Configure to determine the
1622         full pathname (if any) of the gzip program.  After Configure runs,
1623         the value is reset to a plain "gzip" and is not useful.
1624
1625 h_fcntl (h_fcntl.U):
1626         This is variable gets set in various places to tell i_fcntl that
1627         <fcntl.h> should be included.
1628
1629 h_sysfile (h_sysfile.U):
1630         This is variable gets set in various places to tell i_sys_file that
1631         <sys/file.h> should be included.
1632
1633 hint (Oldconfig.U):
1634         Gives the type of hints used for previous answers. May be one of
1635         "default", "recommended" or "previous".
1636
1637 hostcat (nis.U):
1638         This variable contains a command that produces the text of the
1639         /etc/hosts file.  This is normally "cat /etc/hosts", but can be
1640         "ypcat hosts" when NIS is used.
1641
1642 huge (models.U):
1643         This variable contains a flag which will tell the C compiler and loader
1644         to produce a program running with a huge memory model.  If the
1645         huge model is not supported, contains the flag to produce large
1646         model programs.  It is up to the Makefile to use this.
1647
1648 i_arpainet (i_arpainet.U):
1649         This variable conditionally defines the I_ARPA_INET symbol,
1650         and indicates whether a C program should include <arpa/inet.h>.
1651
1652 i_bsdioctl (i_sysioctl.U):
1653         This variable conditionally defines the I_SYS_BSDIOCTL symbol, which
1654         indicates to the C program that <sys/bsdioctl.h> exists and should
1655         be included.
1656
1657 i_db (i_db.U):
1658         This variable conditionally defines the I_DB symbol, and indicates
1659         whether a C program may include Berkeley's DB include file <db.h>.
1660
1661 i_dbm (i_dbm.U):
1662         This variable conditionally defines the I_DBM symbol, which
1663         indicates to the C program that <dbm.h> exists and should
1664         be included.
1665
1666 i_dirent (i_dirent.U):
1667         This variable conditionally defines I_DIRENT, which indicates
1668         to the C program that it should include <dirent.h>.
1669
1670 i_dld (i_dld.U):
1671         This variable conditionally defines the I_DLD symbol, which
1672         indicates to the C program that <dld.h> (GNU dynamic loading)
1673         exists and should be included.
1674
1675 i_dlfcn (i_dlfcn.U):
1676         This variable conditionally defines the I_DLFCN symbol, which
1677         indicates to the C program that <dlfcn.h> exists and should
1678         be included.
1679
1680 i_fcntl (i_fcntl.U):
1681         This variable controls the value of I_FCNTL (which tells
1682         the C program to include <fcntl.h>).
1683
1684 i_float (i_float.U):
1685         This variable conditionally defines the I_FLOAT symbol, and indicates
1686         whether a C program may include <float.h> to get symbols like DBL_MAX
1687         or DBL_MIN, i.e. machine dependent floating point values.
1688
1689 i_gdbm (i_gdbm.U):
1690         This variable conditionally defines the I_GDBM symbol, which
1691         indicates to the C program that <gdbm.h> exists and should
1692         be included.
1693
1694 i_grp (i_grp.U):
1695         This variable conditionally defines the I_GRP symbol, and indicates
1696         whether a C program should include <grp.h>.
1697
1698 i_inttypes (i_inttypes.U):
1699             This variable conditionally defines the I_INTTYPES symbol,
1700             and indicates whether a C program should include <inttypes.h>.
1701
1702 i_limits (i_limits.U):
1703         This variable conditionally defines the I_LIMITS symbol, and indicates
1704         whether a C program may include <limits.h> to get symbols like WORD_BIT
1705         and friends.
1706
1707 i_locale (i_locale.U):
1708         This variable conditionally defines the I_LOCALE symbol,
1709         and indicates whether a C program should include <locale.h>.
1710
1711 i_machcthr (i_machcthr.U):
1712             This variable conditionally defines the I_MACH_CTHREADS symbol,
1713             and indicates whether a C program should include <mach/cthreads.h>.
1714
1715 i_malloc (i_malloc.U):
1716         This variable conditionally defines the I_MALLOC symbol, and indicates
1717         whether a C program should include <malloc.h>.
1718
1719 i_math (i_math.U):
1720         This variable conditionally defines the I_MATH symbol, and indicates
1721         whether a C program may include <math.h>.
1722
1723 i_memory (i_memory.U):
1724         This variable conditionally defines the I_MEMORY symbol, and indicates
1725         whether a C program should include <memory.h>.
1726
1727 i_ndbm (i_ndbm.U):
1728         This variable conditionally defines the I_NDBM symbol, which
1729         indicates to the C program that <ndbm.h> exists and should
1730         be included.
1731
1732 i_netdb (i_netdb.U):
1733         This variable conditionally defines the I_NETDB symbol, and indicates
1734         whether a C program should include <netdb.h>.
1735
1736 i_neterrno (i_neterrno.U):
1737         This variable conditionally defines the I_NET_ERRNO symbol, which
1738         indicates to the C program that <net/errno.h> exists and should
1739         be included.
1740
1741 i_niin (i_niin.U):
1742         This variable conditionally defines I_NETINET_IN, which indicates
1743         to the C program that it should include <netinet/in.h>. Otherwise,
1744         you may try <sys/in.h>.
1745
1746 i_pwd (i_pwd.U):
1747         This variable conditionally defines I_PWD, which indicates
1748         to the C program that it should include <pwd.h>.
1749
1750 i_rpcsvcdbm (i_dbm.U):
1751         This variable conditionally defines the I_RPCSVC_DBM symbol, which
1752         indicates to the C program that <rpcsvc/dbm.h> exists and should
1753         be included.  Some System V systems might need this instead of <dbm.h>.
1754
1755 i_sfio (i_sfio.U):
1756         This variable conditionally defines the I_SFIO symbol,
1757         and indicates whether a C program should include <sfio.h>.
1758
1759 i_sgtty (i_termio.U):
1760         This variable conditionally defines the I_SGTTY symbol, which
1761         indicates to the C program that it should include <sgtty.h> rather
1762         than <termio.h>.
1763
1764 i_stdarg (i_varhdr.U):
1765         This variable conditionally defines the I_STDARG symbol, which
1766         indicates to the C program that <stdarg.h> exists and should
1767         be included.
1768
1769 i_stddef (i_stddef.U):
1770         This variable conditionally defines the I_STDDEF symbol, which
1771         indicates to the C program that <stddef.h> exists and should
1772         be included.
1773
1774 i_stdlib (i_stdlib.U):
1775         This variable conditionally defines the I_STDLIB symbol, which
1776         indicates to the C program that <stdlib.h> exists and should
1777         be included.
1778
1779 i_string (i_string.U):
1780         This variable conditionally defines the I_STRING symbol, which
1781         indicates that <string.h> should be included rather than <strings.h>.
1782
1783 i_sysaccess (i_sysaccess.U):
1784             This variable conditionally defines the I_SYS_ACCESS symbol,
1785             and indicates whether a C program should include <sys/access.h>.
1786
1787 i_sysdir (i_sysdir.U):
1788         This variable conditionally defines the I_SYS_DIR symbol, and indicates
1789         whether a C program should include <sys/dir.h>.
1790
1791 i_sysfile (i_sysfile.U):
1792         This variable conditionally defines the I_SYS_FILE symbol, and indicates
1793         whether a C program should include <sys/file.h> to get R_OK and friends.
1794
1795 i_sysfilio (i_sysioctl.U):
1796         This variable conditionally defines the I_SYS_FILIO symbol, which
1797         indicates to the C program that <sys/filio.h> exists and should
1798         be included in preference to <sys/ioctl.h>.
1799
1800 i_sysin (i_niin.U):
1801         This variable conditionally defines I_SYS_IN, which indicates
1802         to the C program that it should include <sys/in.h> instead of
1803         <netinet/in.h>.
1804
1805 i_sysioctl (i_sysioctl.U):
1806         This variable conditionally defines the I_SYS_IOCTL symbol, which
1807         indicates to the C program that <sys/ioctl.h> exists and should
1808         be included.
1809
1810 i_sysndir (i_sysndir.U):
1811         This variable conditionally defines the I_SYS_NDIR symbol, and indicates
1812         whether a C program should include <sys/ndir.h>.
1813
1814 i_sysparam (i_sysparam.U):
1815         This variable conditionally defines the I_SYS_PARAM symbol, and indicates
1816         whether a C program should include <sys/param.h>.
1817
1818 i_sysresrc (i_sysresrc.U):
1819         This variable conditionally defines the I_SYS_RESOURCE symbol,
1820         and indicates whether a C program should include <sys/resource.h>.
1821
1822 i_syssecrt (i_syssecrt.U):
1823             This variable conditionally defines the I_SYS_SECURITY symbol,
1824             and indicates whether a C program should include <sys/security.h>.
1825
1826 i_sysselct (i_sysselct.U):
1827         This variable conditionally defines I_SYS_SELECT, which indicates
1828         to the C program that it should include <sys/select.h> in order to
1829         get the definition of struct timeval.
1830
1831 i_syssockio (i_sysioctl.U):
1832         This variable conditionally defines I_SYS_SOCKIO to indicate to the
1833         C program that socket ioctl codes may be found in <sys/sockio.h>
1834         instead of <sys/ioctl.h>.
1835
1836 i_sysstat (i_sysstat.U):
1837         This variable conditionally defines the I_SYS_STAT symbol,
1838         and indicates whether a C program should include <sys/stat.h>.
1839
1840 i_systime (i_time.U):
1841         This variable conditionally defines I_SYS_TIME, which indicates
1842         to the C program that it should include <sys/time.h>.
1843
1844 i_systimek (i_time.U):
1845         This variable conditionally defines I_SYS_TIME_KERNEL, which
1846         indicates to the C program that it should include <sys/time.h>
1847         with KERNEL defined.
1848
1849 i_systimes (i_systimes.U):
1850         This variable conditionally defines the I_SYS_TIMES symbol, and indicates
1851         whether a C program should include <sys/times.h>.
1852
1853 i_systypes (i_systypes.U):
1854         This variable conditionally defines the I_SYS_TYPES symbol,
1855         and indicates whether a C program should include <sys/types.h>.
1856
1857 i_sysuio (i_sysuio.U):
1858         This variable conditionally defines the I_SYSUIO symbol, and indicates
1859         whether a C program should include <sys/uio.h>.
1860
1861 i_sysun (i_sysun.U):
1862         This variable conditionally defines I_SYS_UN, which indicates
1863         to the C program that it should include <sys/un.h> to get UNIX
1864         domain socket definitions.
1865
1866 i_syswait (i_syswait.U):
1867         This variable conditionally defines I_SYS_WAIT, which indicates
1868         to the C program that it should include <sys/wait.h>.
1869
1870 i_termio (i_termio.U):
1871         This variable conditionally defines the I_TERMIO symbol, which
1872         indicates to the C program that it should include <termio.h> rather
1873         than <sgtty.h>.
1874
1875 i_termios (i_termio.U):
1876         This variable conditionally defines the I_TERMIOS symbol, which
1877         indicates to the C program that the POSIX <termios.h> file is
1878         to be included.
1879
1880 i_time (i_time.U):
1881         This variable conditionally defines I_TIME, which indicates
1882         to the C program that it should include <time.h>.
1883
1884 i_unistd (i_unistd.U):
1885         This variable conditionally defines the I_UNISTD symbol, and indicates
1886         whether a C program should include <unistd.h>.
1887
1888 i_utime (i_utime.U):
1889         This variable conditionally defines the I_UTIME symbol, and indicates
1890         whether a C program should include <utime.h>.
1891
1892 i_values (i_values.U):
1893         This variable conditionally defines the I_VALUES symbol, and indicates
1894         whether a C program may include <values.h> to get symbols like MAXLONG
1895         and friends.
1896
1897 i_varargs (i_varhdr.U):
1898         This variable conditionally defines I_VARARGS, which indicates
1899         to the C program that it should include <varargs.h>.
1900
1901 i_varhdr (i_varhdr.U):
1902         Contains the name of the header to be included to get va_dcl definition.
1903         Typically one of varargs.h or stdarg.h.
1904
1905 i_vfork (i_vfork.U):
1906         This variable conditionally defines the I_VFORK symbol, and indicates
1907         whether a C program should include vfork.h.
1908
1909 ignore_versioned_solibs (libs.U):
1910         This variable should be non-empty if non-versioned shared
1911         libraries (libfoo.so.x.y) are to be ignored (because they
1912         cannot be linked against).
1913
1914 incpath (usrinc.U):
1915         This variable must preceed the normal include path to get hte
1916         right one, as in "$incpath/usr/include" or "$incpath/usr/lib".
1917         Value can be "" or "/bsd43" on mips.
1918
1919 inews (Loc.U):
1920         This variable is defined but not used by Configure.
1921         The value is a plain '' and is not useful.
1922
1923 installarchlib (archlib.U):
1924         This variable is really the same as archlibexp but may differ on
1925         those systems using AFS. For extra portability, only this variable
1926         should be used in makefiles.
1927
1928 installbin (bin.U):
1929         This variable is the same as binexp unless AFS is running in which case
1930         the user is explicitely prompted for it. This variable should always
1931         be used in your makefiles for maximum portability.
1932
1933 installman1dir (man1dir.U):
1934         This variable is really the same as man1direxp, unless you are using
1935         AFS in which case it points to the read/write location whereas
1936         man1direxp only points to the read-only access location. For extra
1937         portability, you should only use this variable within your makefiles.
1938
1939 installman3dir (man3dir.U):
1940         This variable is really the same as man3direxp, unless you are using
1941         AFS in which case it points to the read/write location whereas
1942         man3direxp only points to the read-only access location. For extra
1943         portability, you should only use this variable within your makefiles.
1944
1945 installprivlib (privlib.U):
1946         This variable is really the same as privlibexp but may differ on
1947         those systems using AFS. For extra portability, only this variable
1948         should be used in makefiles.
1949
1950 installscript (scriptdir.U):
1951         This variable is usually the same as scriptdirexp, unless you are on
1952         a system running AFS, in which case they may differ slightly. You
1953         should always use this variable within your makefiles for portability.
1954
1955 installsitearch (sitearch.U):
1956         This variable is really the same as sitearchexp but may differ on
1957         those systems using AFS. For extra portability, only this variable
1958         should be used in makefiles.
1959
1960 installsitelib (sitelib.U):
1961         This variable is really the same as sitelibexp but may differ on
1962         those systems using AFS. For extra portability, only this variable
1963         should be used in makefiles.
1964
1965 intsize (intsize.U):
1966         This variable contains the value of the INTSIZE symbol, which
1967         indicates to the C program how many bytes there are in an int.
1968
1969 known_extensions (Extensions.U):
1970         This variable holds a list of all XS extensions included in 
1971         the package.
1972
1973 ksh (Loc.U):
1974         This variable is defined but not used by Configure.
1975         The value is a plain '' and is not useful.
1976
1977 large (models.U):
1978         This variable contains a flag which will tell the C compiler and loader
1979         to produce a program running with a large memory model.  It is up to
1980         the Makefile to use this.
1981
1982 ld (dlsrc.U):
1983         This variable indicates the program to be used to link
1984         libraries for dynamic loading.  On some systems, it is 'ld'.
1985         On ELF systems, it should be $cc.  Mostly, we'll try to respect
1986         the hint file setting.
1987
1988 lddlflags (dlsrc.U):
1989         This variable contains any special flags that might need to be
1990         passed to $ld to create a shared library suitable for dynamic
1991         loading.  It is up to the makefile to use it.  For hpux, it
1992         should be '-b'.  For sunos 4.1, it is empty.
1993
1994 ldflags (ccflags.U):
1995         This variable contains any additional C loader flags desired by
1996         the user.  It is up to the Makefile to use this.
1997
1998 less (Loc.U):
1999         This variable is be used internally by Configure to determine the
2000         full pathname (if any) of the less program.  After Configure runs,
2001         the value is reset to a plain "less" and is not useful.
2002
2003 lib_ext (Unix.U):
2004         This is an old synonym for _a.
2005
2006 libc (libc.U):
2007         This variable contains the location of the C library.
2008
2009 libperl (libperl.U):
2010         The perl executable is obtained by linking perlmain.c with
2011         libperl, any static extensions (usually just DynaLoader),
2012         and any other libraries needed on this system.  libperl
2013         is usually libperl.a, but can also be libperl.so.xxx if
2014         the user wishes to build a perl executable with a shared
2015         library.
2016
2017 libpth (libpth.U):
2018         This variable holds the general path used to find libraries. It is
2019         intended to be used by other units.
2020
2021 libs (libs.U):
2022         This variable holds the additional libraries we want to use.
2023         It is up to the Makefile to deal with it.
2024
2025 libswanted (Myinit.U):
2026         This variable holds a list of all the libraries we want to
2027         search.  The order is chosen to pick up the c library
2028         ahead of ucb or bsd libraries for SVR4.
2029
2030 line (Loc.U):
2031         This variable is defined but not used by Configure.
2032         The value is a plain '' and is not useful.
2033
2034 lint (Loc.U):
2035         This variable is defined but not used by Configure.
2036         The value is a plain '' and is not useful.
2037
2038 lkflags (ccflags.U):
2039         This variable contains any additional C partial linker flags desired by
2040         the user.  It is up to the Makefile to use this.
2041
2042 ln (Loc.U):
2043         This variable is be used internally by Configure to determine the
2044         full pathname (if any) of the ln program.  After Configure runs,
2045         the value is reset to a plain "ln" and is not useful.
2046
2047 lns (lns.U):
2048         This variable holds the name of the command to make 
2049         symbolic links (if they are supported).  It can be used
2050         in the Makefile. It is either 'ln -s' or 'ln'
2051
2052 locincpth (ccflags.U):
2053         This variable contains a list of additional directories to be
2054         searched by the compiler.  The appropriate '-I' directives will
2055         be added to ccflags.  This is intended to simplify setting
2056         local directories from the Configure command line.
2057         It's not much, but it parallels the loclibpth stuff in libpth.U.
2058
2059 loclibpth (libpth.U):
2060         This variable holds the paths used to find local libraries.  It is
2061         prepended to libpth, and is intended to be easily set from the
2062         command line.
2063
2064 longdblsize (d_longdbl.U):
2065         This variable contains the value of the LONG_DOUBLESIZE symbol, which
2066         indicates to the C program how many bytes there are in a long double,
2067         if this system supports long doubles.
2068
2069 longlongsize (d_longlong.U):
2070         This variable contains the value of the LONGLONGSIZE symbol, which
2071         indicates to the C program how many bytes there are in a long long,
2072         if this system supports long long.
2073
2074 longsize (intsize.U):
2075         This variable contains the value of the LONGSIZE symbol, which
2076         indicates to the C program how many bytes there are in a long.
2077
2078 lp (Loc.U):
2079         This variable is defined but not used by Configure.
2080         The value is a plain '' and is not useful.
2081
2082 lpr (Loc.U):
2083         This variable is defined but not used by Configure.
2084         The value is a plain '' and is not useful.
2085
2086 ls (Loc.U):
2087         This variable is be used internally by Configure to determine the
2088         full pathname (if any) of the ls program.  After Configure runs,
2089         the value is reset to a plain "ls" and is not useful.
2090
2091 lseeksize (lseektype.U):
2092         This variable defines lseektype to be something like off_t, long, 
2093         or whatever type is used to declare lseek offset's type in the
2094         kernel (which also appears to be lseek's return type).
2095
2096 lseektype (lseektype.U):
2097         This variable defines lseektype to be something like off_t, long, 
2098         or whatever type is used to declare lseek offset's type in the
2099         kernel (which also appears to be lseek's return type).
2100
2101 mail (Loc.U):
2102         This variable is defined but not used by Configure.
2103         The value is a plain '' and is not useful.
2104
2105 mailx (Loc.U):
2106         This variable is defined but not used by Configure.
2107         The value is a plain '' and is not useful.
2108
2109 make (Loc.U):
2110         This variable is be used internally by Configure to determine the
2111         full pathname (if any) of the make program.  After Configure runs,
2112         the value is reset to a plain "make" and is not useful.
2113
2114 make_set_make (make.U):
2115         Some versions of 'make' set the variable MAKE.  Others do not.
2116         This variable contains the string to be included in Makefile.SH
2117         so that MAKE is set if needed, and not if not needed.
2118         Possible values are:
2119         make_set_make='#'               # If your make program handles this for you,
2120         make_set_make="MAKE=$make"      # if it doesn't.
2121         I used a comment character so that we can distinguish a
2122         'set' value (from a previous config.sh or Configure '-D' option)
2123         from an uncomputed value.
2124
2125 mallocobj (mallocsrc.U):
2126         This variable contains the name of the malloc.o that this package
2127         generates, if that malloc.o is preferred over the system malloc.
2128         Otherwise the value is null.  This variable is intended for generating
2129         Makefiles.  See mallocsrc.
2130
2131 mallocsrc (mallocsrc.U):
2132         This variable contains the name of the malloc.c that comes with
2133         the package, if that malloc.c is preferred over the system malloc.
2134         Otherwise the value is null.  This variable is intended for generating
2135         Makefiles.
2136
2137 malloctype (mallocsrc.U):
2138         This variable contains the kind of ptr returned by malloc and realloc.
2139
2140 man1dir (man1dir.U):
2141         This variable contains the name of the directory in which manual
2142         source pages are to be put.  It is the responsibility of the
2143         Makefile.SH to get the value of this into the proper command.
2144         You must be prepared to do the ~name expansion yourself.
2145
2146 man1direxp (man1dir.U):
2147         This variable is the same as the man1dir variable, but is filename
2148         expanded at configuration time, for convenient use in makefiles.
2149
2150 man1ext (man1dir.U):
2151         This variable contains the extension that the manual page should
2152         have: one of 'n', 'l', or '1'.  The Makefile must supply the '.'.
2153         See man1dir.
2154
2155 man3dir (man3dir.U):
2156         This variable contains the name of the directory in which manual
2157         source pages are to be put.  It is the responsibility of the
2158         Makefile.SH to get the value of this into the proper command.
2159         You must be prepared to do the ~name expansion yourself.
2160
2161 man3direxp (man3dir.U):
2162         This variable is the same as the man3dir variable, but is filename
2163         expanded at configuration time, for convenient use in makefiles.
2164
2165 man3ext (man3dir.U):
2166         This variable contains the extension that the manual page should
2167         have: one of 'n', 'l', or '3'.  The Makefile must supply the '.'.
2168         See man3dir.
2169
2170 Mcc (Loc.U):
2171         This variable is be used internally by Configure to determine the
2172         full pathname (if any) of the Mcc program.  After Configure runs,
2173         the value is reset to a plain "Mcc" and is not useful.
2174
2175 medium (models.U):
2176         This variable contains a flag which will tell the C compiler and loader
2177         to produce a program running with a medium memory model.  If the
2178         medium model is not supported, contains the flag to produce large
2179         model programs.  It is up to the Makefile to use this.
2180
2181 mips_type (usrinc.U):
2182         This variable holds the environment type for the mips system.
2183         Possible values are "BSD 4.3" and "System V".
2184
2185 mkdir (Loc.U):
2186         This variable is be used internally by Configure to determine the
2187         full pathname (if any) of the mkdir program.  After Configure runs,
2188         the value is reset to a plain "mkdir" and is not useful.
2189
2190 models (models.U):
2191         This variable contains the list of memory models supported by this
2192         system.  Possible component values are none, split, unsplit, small,
2193         medium, large, and huge.  The component values are space separated.
2194
2195 modetype (modetype.U):
2196         This variable defines modetype to be something like mode_t, 
2197         int, unsigned short, or whatever type is used to declare file 
2198         modes for system calls.
2199
2200 more (Loc.U):
2201         This variable is be used internally by Configure to determine the
2202         full pathname (if any) of the more program.  After Configure runs,
2203         the value is reset to a plain "more" and is not useful.
2204
2205 mv (Loc.U):
2206         This variable is defined but not used by Configure.
2207         The value is a plain '' and is not useful.
2208
2209 myarchname (archname.U):
2210         This variable holds the architecture name computed by Configure in
2211         a previous run. It is not intended to be perused by any user and
2212         should never be set in a hint file.
2213
2214 mydomain (myhostname.U):
2215         This variable contains the eventual value of the MYDOMAIN symbol,
2216         which is the domain of the host the program is going to run on.
2217         The domain must be appended to myhostname to form a complete host name.
2218         The dot comes with mydomain, and need not be supplied by the program.
2219
2220 myhostname (myhostname.U):
2221         This variable contains the eventual value of the MYHOSTNAME symbol,
2222         which is the name of the host the program is going to run on.
2223         The domain is not kept with hostname, but must be gotten from mydomain.
2224         The dot comes with mydomain, and need not be supplied by the program.
2225
2226 myuname (Oldconfig.U):
2227         The output of 'uname -a' if available, otherwise the hostname. On Xenix,
2228         pseudo variables assignments in the output are stripped, thank you. The
2229         whole thing is then lower-cased.
2230
2231 n (n.U):
2232         This variable contains the '-n' flag if that is what causes the echo
2233         command to suppress newline.  Otherwise it is null.  Correct usage is
2234             $echo $n "prompt for a question: $c".
2235
2236 netdb_hlen_type (netdbtype.U):
2237         This variable holds the type used for the 2nd argument to
2238         gethostbyaddr().  Usually, this is int or size_t or unsigned.
2239         This is only useful if you have gethostbyaddr(), naturally.
2240
2241 netdb_host_type (netdbtype.U):
2242         This variable holds the type used for the 1st argument to
2243         gethostbyaddr().  Usually, this is char * or void *,  possibly
2244         with or without a const prefix.
2245         This is only useful if you have gethostbyaddr(), naturally.
2246
2247 netdb_name_type (netdbtype.U):
2248         This variable holds the type used for the argument to
2249         gethostbyname().  Usually, this is char * or const char *.
2250         This is only useful if you have gethostbyname(), naturally.
2251
2252 netdb_net_type (netdbtype.U):
2253         This variable holds the type used for the 1st argument to
2254         getnetbyaddr().  Usually, this is int or long.
2255         This is only useful if you have getnetbyaddr(), naturally.
2256
2257 nm (Loc.U):
2258         This variable is be used internally by Configure to determine the
2259         full pathname (if any) of the nm program.  After Configure runs,
2260         the value is reset to a plain "nm" and is not useful.
2261
2262 nm_opt (usenm.U):
2263         This variable holds the options that may be necessary for nm.
2264
2265 nm_so_opt (usenm.U):
2266         This variable holds the options that may be necessary for nm
2267         to work on a shared library but that can not be used on an
2268         archive library.  Currently, this is only used by Linux, where
2269         nm --dynamic is *required* to get symbols from an ELF library which
2270         has been stripped, but nm --dynamic is *fatal* on an archive library.
2271         Maybe Linux should just always set usenm=false.
2272
2273 nonxs_ext (Extensions.U):
2274         This variable holds a list of all non-xs extensions included
2275         in the package.  All of them will be built.
2276
2277 nroff (Loc.U):
2278         This variable is be used internally by Configure to determine the
2279         full pathname (if any) of the nroff program.  After Configure runs,
2280         the value is reset to a plain "nroff" and is not useful.
2281
2282 o_nonblock (nblock_io.U):
2283         This variable bears the symbol value to be used during open() or fcntl()
2284         to turn on non-blocking I/O for a file descriptor. If you wish to switch
2285         between blocking and non-blocking, you may try ioctl(FIOSNBIO) instead,
2286         but that is only supported by some devices.
2287
2288 obj_ext (Unix.U):
2289         This is an old synonym for _o.
2290
2291 optimize (ccflags.U):
2292         This variable contains any optimizer/debugger flag that should be used.
2293         It is up to the Makefile to use it.
2294
2295 orderlib (orderlib.U):
2296         This variable is "true" if the components of libraries must be ordered
2297         (with `lorder $* | tsort`) before placing them in an archive.  Set to
2298         "false" if ranlib or ar can generate random libraries.
2299
2300 osname (Oldconfig.U):
2301         This variable contains the operating system name (e.g. sunos,
2302         solaris, hpux, etc.).  It can be useful later on for setting
2303         defaults.  Any spaces are replaced with underscores.  It is set
2304         to a null string if we can't figure it out.
2305
2306 osvers (Oldconfig.U):
2307         This variable contains the operating system version (e.g.
2308         4.1.3, 5.2, etc.).  It is primarily used for helping select
2309         an appropriate hints file, but might be useful elsewhere for
2310         setting defaults.  It is set to '' if we can't figure it out.
2311         We try to be flexible about how much of the version number
2312         to keep, e.g. if 4.1.1, 4.1.2, and 4.1.3 are essentially the
2313         same for this package, hints files might just be os_4.0 or
2314         os_4.1, etc., not keeping separate files for each little release.
2315
2316 package (package.U):
2317         This variable contains the name of the package being constructed.
2318         It is primarily intended for the use of later Configure units.
2319
2320 pager (pager.U):
2321         This variable contains the name of the preferred pager on the system.
2322         Usual values are (the full pathnames of) more, less, pg, or cat.
2323
2324 passcat (nis.U):
2325         This variable contains a command that produces the text of the
2326         /etc/passwd file.  This is normally "cat /etc/passwd", but can be
2327         "ypcat passwd" when NIS is used.
2328
2329 patchlevel (patchlevel.U):
2330         The patchlevel level of this package.
2331         The value of patchlevel comes from the patchlevel.h file.
2332
2333 path_sep (Unix.U):
2334         This is an old synonym for p_ in Head.U, the character
2335         used to separate elements in the command shell search PATH.
2336
2337 perl (Loc.U):
2338         This variable is defined but not used by Configure.
2339         The value is a plain '' and is not useful.
2340
2341 perladmin (perladmin.U):
2342         Electronic mail address of the perl5 administrator.
2343
2344 perlpath (perlpath.U):
2345         This variable contains the eventual value of the PERLPATH symbol,
2346         which contains the name of the perl interpreter to be used in
2347         shell scripts and in the "eval 'exec'" idiom.
2348
2349 pg (Loc.U):
2350         This variable is be used internally by Configure to determine the
2351         full pathname (if any) of the pg program.  After Configure runs,
2352         the value is reset to a plain "pg" and is not useful.
2353
2354 phostname (myhostname.U):
2355         This variable contains the eventual value of the PHOSTNAME symbol,
2356         which is a command that can be fed to popen() to get the host name.
2357         The program should probably not presume that the domain is or isn't
2358         there already.
2359
2360 pidtype (pidtype.U):
2361         This variable defines PIDTYPE to be something like pid_t, int, 
2362         ushort, or whatever type is used to declare process ids in the kernel.
2363
2364 plibpth (libpth.U):
2365         Holds the private path used by Configure to find out the libraries.
2366         Its value is prepend to libpth. This variable takes care of special
2367         machines, like the mips.  Usually, it should be empty.
2368
2369 pmake (Loc.U):
2370         This variable is defined but not used by Configure.
2371         The value is a plain '' and is not useful.
2372
2373 pr (Loc.U):
2374         This variable is defined but not used by Configure.
2375         The value is a plain '' and is not useful.
2376
2377 prefix (prefix.U):
2378         This variable holds the name of the directory below which the
2379         user will install the package.  Usually, this is /usr/local, and
2380         executables go in /usr/local/bin, library stuff in /usr/local/lib,
2381         man pages in /usr/local/man, etc.  It is only used to set defaults
2382         for things in bin.U, mansrc.U, privlib.U, or scriptdir.U.
2383
2384 prefixexp (prefix.U):
2385         This variable holds the full absolute path of the directory below
2386         which the user will install the package.  Derived from prefix.
2387
2388 privlib (privlib.U):
2389         This variable contains the eventual value of the PRIVLIB symbol,
2390         which is the name of the private library for this package.  It may
2391         have a ~ on the front. It is up to the makefile to eventually create
2392         this directory while performing installation (with ~ substitution).
2393
2394 privlibexp (privlib.U):
2395         This variable is the ~name expanded version of privlib, so that you
2396         may use it directly in Makefiles or shell scripts.
2397
2398 prototype (prototype.U):
2399         This variable holds the eventual value of CAN_PROTOTYPE, which
2400         indicates the C compiler can handle funciton prototypes.
2401
2402 pthread_create_joinable (d_pthrattrj.U):
2403         This variable defines the constant to use for creating joinable
2404         (aka undetached) pthreads.  Unused if pthread.h defines
2405         PTHREAD_CREATE_JOINABLE.  If used, possible values are
2406         PTHREAD_CREATE_UNDETACHED and __UNDETACHED.
2407
2408 ptrsize (ptrsize.U):
2409         This variable contains the value of the PTRSIZE symbol, which
2410         indicates to the C program how many bytes there are in a pointer.
2411
2412 randbits (randfunc.U):
2413         Indicates how many bits are produced by the function used to
2414         generate normalized random numbers.
2415
2416 randfunc (randfunc.U):
2417         Indicates the name of the random number function to use.
2418         Values include drand48, random, and rand. In C programs,
2419         the 'Drand01' macro is defined to generate uniformly distributed
2420         random numbers over the range [0., 1.[ (see drand01 and nrand).
2421
2422 randseedtype (randfunc.U):
2423         Indicates the type of the argument of the seedfunc.
2424
2425 ranlib (orderlib.U):
2426         This variable is set to the pathname of the ranlib program, if it is
2427         needed to generate random libraries.  Set to ":" if ar can generate
2428         random libraries or if random libraries are not supported
2429
2430 rd_nodata (nblock_io.U):
2431         This variable holds the return code from read() when no data is
2432         present. It should be -1, but some systems return 0 when O_NDELAY is
2433         used, which is a shame because you cannot make the difference between
2434         no data and an EOF.. Sigh!
2435
2436 rm (Loc.U):
2437         This variable is be used internally by Configure to determine the
2438         full pathname (if any) of the rm program.  After Configure runs,
2439         the value is reset to a plain "rm" and is not useful.
2440
2441 rmail (Loc.U):
2442         This variable is defined but not used by Configure.
2443         The value is a plain '' and is not useful.
2444
2445 runnm (usenm.U):
2446         This variable contains 'true' or 'false' depending whether the
2447         nm extraction should be performed or not, according to the value
2448         of usenm and the flags on the Configure command line.
2449
2450 sched_yield (d_pthread_y.U):
2451         This variable defines the way to yield the execution
2452         of the current thread.
2453
2454 scriptdir (scriptdir.U):
2455         This variable holds the name of the directory in which the user wants
2456         to put publicly scripts for the package in question.  It is either
2457         the same directory as for binaries, or a special one that can be
2458         mounted across different architectures, like /usr/share. Programs
2459         must be prepared to deal with ~name expansion.
2460
2461 scriptdirexp (scriptdir.U):
2462         This variable is the same as scriptdir, but is filename expanded
2463         at configuration time, for programs not wanting to bother with it.
2464
2465 sed (Loc.U):
2466         This variable is be used internally by Configure to determine the
2467         full pathname (if any) of the sed program.  After Configure runs,
2468         the value is reset to a plain "sed" and is not useful.
2469
2470 seedfunc (randfunc.U):
2471         Indicates the random number generating seed function.
2472         Values include srand48, srandom, and srand.
2473
2474 selectminbits (selectminbits.U):
2475         This variable holds the minimum number of bits operated by select.
2476         That is, if you do select(n, ...), how many bits at least will be
2477         cleared in the masks if some activity is detected.  Usually this
2478         is either n or 32*ceil(n/32), especially many little-endians do
2479         the latter.  This is only useful if you have select(), naturally.
2480
2481 selecttype (selecttype.U):
2482         This variable holds the type used for the 2nd, 3rd, and 4th
2483         arguments to select.  Usually, this is 'fd_set *', if HAS_FD_SET
2484         is defined, and 'int *' otherwise.  This is only useful if you 
2485         have select(), naturally.
2486
2487 sendmail (Loc.U):
2488         This variable is defined but not used by Configure.
2489         The value is a plain '' and is not useful.
2490
2491 sh (sh.U):
2492         This variable contains the full pathname of the shell used
2493         on this system to execute Bourne shell scripts.  Usually, this will be
2494         /bin/sh, though it's possible that some systems will have /bin/ksh,
2495         /bin/pdksh, /bin/ash, /bin/bash, or even something such as
2496         D:/bin/sh.exe.
2497         This unit comes before Options.U, so you can't set sh with a '-D'
2498         option, though you can override this (and startsh)
2499         with '-O -Dsh=/bin/whatever -Dstartsh=whatever'
2500
2501 shar (Loc.U):
2502         This variable is defined but not used by Configure.
2503         The value is a plain '' and is not useful.
2504
2505 sharpbang (spitshell.U):
2506         This variable contains the string #! if this system supports that
2507         construct.
2508
2509 shmattype (d_shmat.U):
2510         This symbol contains the type of pointer returned by shmat().
2511         It can be 'void *' or 'char *'.
2512
2513 shortsize (intsize.U):
2514         This variable contains the value of the SHORTSIZE symbol which
2515         indicates to the C program how many bytes there are in a short.
2516
2517 shrpenv (libperl.U):
2518         If the user builds a shared libperl.so, then we need to tell the
2519         'perl' executable where it will be able to find the installed libperl.so. 
2520         One way to do this on some systems is to set the environment variable
2521         LD_RUN_PATH to the directory that will be the final location of the
2522         shared libperl.so.  The makefile can use this with something like
2523                 $shrpenv $(CC) -o perl perlmain.o $libperl $libs
2524         Typical values are
2525                 shrpenv="env LD_RUN_PATH=$archlibexp/CORE"
2526         or
2527                 shrpenv=''
2528         See the main perl Makefile.SH for actual working usage.
2529         Alternatively, we might be able to use a command line option such
2530         as -R $archlibexp/CORE (Solaris, NetBSD) or -Wl,-rpath
2531         $archlibexp/CORE (Linux).
2532
2533 shsharp (spitshell.U):
2534         This variable tells further Configure units whether your sh can
2535         handle # comments.
2536
2537 sig_name (sig_name.U):
2538         This variable holds the signal names, space separated. The leading
2539         SIG in signal name is removed.  A ZERO is prepended to the
2540         list.  This is currently not used.
2541
2542 sig_name_init (sig_name.U):
2543         This variable holds the signal names, enclosed in double quotes and
2544         separated by commas, suitable for use in the SIG_NAME definition 
2545         below.  A "ZERO" is prepended to the list, and the list is 
2546         terminated with a plain 0.  The leading SIG in signal names
2547         is removed. See sig_num.
2548
2549 sig_num (sig_name.U):
2550         This variable holds the signal numbers, space separated. A ZERO is
2551         prepended to the list (corresponding to the fake SIGZERO), and 
2552         the list is terminated with a 0.  Those numbers correspond to 
2553         the value of the signal listed in the same place within the
2554         sig_name list.
2555
2556 sig_num_init (sig_name.U):
2557         This variable holds the signal numbers, enclosed in double quotes and
2558         separated by commas, suitable for use in the SIG_NUM definition 
2559         below.  A "ZERO" is prepended to the list, and the list is 
2560         terminated with a plain 0.
2561
2562 signal_t (d_voidsig.U):
2563         This variable holds the type of the signal handler (void or int).
2564
2565 sitearch (sitearch.U):
2566         This variable contains the eventual value of the SITEARCH symbol,
2567         which is the name of the private library for this package.  It may
2568         have a ~ on the front. It is up to the makefile to eventually create
2569         this directory while performing installation (with ~ substitution).
2570
2571 sitearchexp (sitearch.U):
2572         This variable is the ~name expanded version of sitearch, so that you
2573         may use it directly in Makefiles or shell scripts.
2574
2575 sitelib (sitelib.U):
2576         This variable contains the eventual value of the SITELIB symbol,
2577         which is the name of the private library for this package.  It may
2578         have a ~ on the front. It is up to the makefile to eventually create
2579         this directory while performing installation (with ~ substitution).
2580
2581 sitelibexp (sitelib.U):
2582         This variable is the ~name expanded version of sitelib, so that you
2583         may use it directly in Makefiles or shell scripts.
2584
2585 sizetype (sizetype.U):
2586         This variable defines sizetype to be something like size_t, 
2587         unsigned long, or whatever type is used to declare length 
2588         parameters for string functions.
2589
2590 sleep (Loc.U):
2591         This variable is defined but not used by Configure.
2592         The value is a plain '' and is not useful.
2593
2594 smail (Loc.U):
2595         This variable is defined but not used by Configure.
2596         The value is a plain '' and is not useful.
2597
2598 small (models.U):
2599         This variable contains a flag which will tell the C compiler and loader
2600         to produce a program running with a small memory model.  It is up to
2601         the Makefile to use this.
2602
2603 so (so.U):
2604         This variable holds the extension used to identify shared libraries
2605         (also known as shared objects) on the system. Usually set to 'so'.
2606
2607 sockethdr (d_socket.U):
2608         This variable has any cpp '-I' flags needed for socket support.
2609
2610 socketlib (d_socket.U):
2611         This variable has the names of any libraries needed for socket support.
2612
2613 sort (Loc.U):
2614         This variable is be used internally by Configure to determine the
2615         full pathname (if any) of the sort program.  After Configure runs,
2616         the value is reset to a plain "sort" and is not useful.
2617
2618 spackage (package.U):
2619         This variable contains the name of the package being constructed,
2620         with the first letter uppercased, i.e. suitable for starting
2621         sentences.
2622
2623 spitshell (spitshell.U):
2624         This variable contains the command necessary to spit out a runnable
2625         shell on this system.  It is either cat or a grep '-v' for # comments.
2626
2627 split (models.U):
2628         This variable contains a flag which will tell the C compiler and loader
2629         to produce a program that will run in separate I and D space, for those
2630         machines that support separation of instruction and data space.  It is
2631         up to the Makefile to use this.
2632
2633 src (src.U):
2634         This variable holds the path to the package source. It is up to
2635         the Makefile to use this variable and set VPATH accordingly to
2636         find the sources remotely.
2637
2638 ssizetype (ssizetype.U):
2639         This variable defines ssizetype to be something like ssize_t, 
2640         long or int.  It is used by functions that return a count 
2641         of bytes or an error condition.  It must be a signed type.
2642         We will pick a type such that sizeof(SSize_t) == sizeof(Size_t).
2643
2644 startperl (startperl.U):
2645         This variable contains the string to put on the front of a perl
2646         script to make sure (hopefully) that it runs with perl and not some
2647         shell. Of course, that leading line must be followed by the classical
2648         perl idiom:
2649                 eval 'exec perl -S $0 ${1+"$@"}'
2650                         if $running_under_some_shell;
2651         to guarantee perl startup should the shell execute the script. Note
2652         that this magic incatation is not understood by csh.
2653
2654 startsh (startsh.U):
2655         This variable contains the string to put on the front of a shell
2656         script to make sure (hopefully) that it runs with sh and not some
2657         other shell.
2658
2659 static_ext (Extensions.U):
2660         This variable holds a list of XS extension files we want to
2661         link statically into the package.  It is used by Makefile.
2662
2663 stdchar (stdchar.U):
2664         This variable conditionally defines STDCHAR to be the type of char
2665         used in stdio.h.  It has the values "unsigned char" or "char".
2666
2667 stdio_base (d_stdstdio.U):
2668         This variable defines how, given a FILE pointer, fp, to access the
2669         _base field (or equivalent) of stdio.h's FILE structure.  This will
2670         be used to define the macro FILE_base(fp).
2671
2672 stdio_bufsiz (d_stdstdio.U):
2673         This variable defines how, given a FILE pointer, fp, to determine
2674         the number of bytes store in the I/O buffer pointer to by the
2675         _base field (or equivalent) of stdio.h's FILE structure.  This will
2676         be used to define the macro FILE_bufsiz(fp).
2677
2678 stdio_cnt (d_stdstdio.U):
2679         This variable defines how, given a FILE pointer, fp, to access the
2680         _cnt field (or equivalent) of stdio.h's FILE structure.  This will
2681         be used to define the macro FILE_cnt(fp).
2682
2683 stdio_filbuf (d_stdstdio.U):
2684         This variable defines how, given a FILE pointer, fp, to tell
2685         stdio to refill it's internal buffers (?).  This will
2686         be used to define the macro FILE_filbuf(fp).
2687
2688 stdio_ptr (d_stdstdio.U):
2689         This variable defines how, given a FILE pointer, fp, to access the
2690         _ptr field (or equivalent) of stdio.h's FILE structure.  This will
2691         be used to define the macro FILE_ptr(fp).
2692
2693 strings (i_string.U):
2694         This variable holds the full path of the string header that will be
2695         used. Typically /usr/include/string.h or /usr/include/strings.h.
2696
2697 submit (Loc.U):
2698         This variable is defined but not used by Configure.
2699         The value is a plain '' and is not useful.
2700
2701 subversion (patchlevel.U):
2702         The subversion level of this package.
2703         The value of subversion comes from the patchlevel.h file.
2704         This is unique to perl.
2705
2706 sysman (sysman.U):
2707         This variable holds the place where the manual is located on this
2708         system. It is not the place where the user wants to put his manual
2709         pages. Rather it is the place where Configure may look to find manual
2710         for unix commands (section 1 of the manual usually). See mansrc.
2711
2712 tail (Loc.U):
2713         This variable is defined but not used by Configure.
2714         The value is a plain '' and is not useful.
2715
2716 tar (Loc.U):
2717         This variable is defined but not used by Configure.
2718         The value is a plain '' and is not useful.
2719
2720 tbl (Loc.U):
2721         This variable is defined but not used by Configure.
2722         The value is a plain '' and is not useful.
2723
2724 tee (Loc.U):
2725         This variable is be used internally by Configure to determine the
2726         full pathname (if any) of the tee program.  After Configure runs,
2727         the value is reset to a plain "tee" and is not useful.
2728
2729 test (Loc.U):
2730         This variable is be used internally by Configure to determine the
2731         full pathname (if any) of the test program.  After Configure runs,
2732         the value is reset to a plain "test" and is not useful.
2733
2734 timeincl (i_time.U):
2735         This variable holds the full path of the included time header(s).
2736
2737 timetype (d_time.U):
2738         This variable holds the type returned by time(). It can be long,
2739         or time_t on BSD sites (in which case <sys/types.h> should be
2740         included). Anyway, the type Time_t should be used.
2741
2742 touch (Loc.U):
2743         This variable is be used internally by Configure to determine the
2744         full pathname (if any) of the touch program.  After Configure runs,
2745         the value is reset to a plain "touch" and is not useful.
2746
2747 tr (Loc.U):
2748         This variable is be used internally by Configure to determine the
2749         full pathname (if any) of the tr program.  After Configure runs,
2750         the value is reset to a plain "tr" and is not useful.
2751
2752 trnl (trnl.U):
2753         This variable contains the value to be passed to the tr(1)
2754         command to transliterate a newline.  Typical values are
2755         '\012' and '\n'.  This is needed for EBCDIC systems where
2756         newline is not necessarily '\012'.
2757
2758 troff (Loc.U):
2759         This variable is defined but not used by Configure.
2760         The value is a plain '' and is not useful.
2761
2762 uidtype (uidtype.U):
2763         This variable defines Uid_t to be something like uid_t, int, 
2764         ushort, or whatever type is used to declare user ids in the kernel.
2765
2766 uname (Loc.U):
2767         This variable is be used internally by Configure to determine the
2768         full pathname (if any) of the uname program.  After Configure runs,
2769         the value is reset to a plain "uname" and is not useful.
2770
2771 uniq (Loc.U):
2772         This variable is be used internally by Configure to determine the
2773         full pathname (if any) of the uniq program.  After Configure runs,
2774         the value is reset to a plain "uniq" and is not useful.
2775
2776 use64bits (use64bits.U):
2777         This variable conditionally defines the USE_64_BITS symbol,
2778         and indicates that explicit 64-bit interfaces should be used
2779         when available.
2780
2781 usedl (dlsrc.U):
2782         This variable indicates if the the system supports dynamic
2783         loading of some sort.  See also dlsrc and dlobj.
2784
2785 usemultiplicity (usemultiplicity.U):
2786         This variable conditionally defines the MULTIPLICITY symbol,
2787         and indicates that Perl should be built to use multiplicity.
2788
2789 usemymalloc (mallocsrc.U):
2790         This variable contains y if the malloc that comes with this package
2791         is desired over the system's version of malloc.  People often include
2792         special versions of malloc for effiency, but such versions are often
2793         less portable.  See also mallocsrc and mallocobj.
2794         If this is 'y', then -lmalloc is removed from $libs.
2795
2796 usenm (usenm.U):
2797         This variable contains 'true' or 'false' depending whether the
2798         nm extraction is wanted or not.
2799
2800 useopcode (Extensions.U):
2801         This variable holds either 'true' or 'false' to indicate
2802         whether the Opcode extension should be used.  The sole
2803         use for this currently is to allow an easy mechanism
2804         for users to skip the Opcode extension from the Configure
2805         command line.
2806
2807 useperlio (useperlio.U):
2808         This variable conditionally defines the USE_PERLIO symbol,
2809         and indicates that the PerlIO abstraction should be
2810         used throughout.
2811
2812 useposix (Extensions.U):
2813         This variable holds either 'true' or 'false' to indicate
2814         whether the POSIX extension should be used.  The sole
2815         use for this currently is to allow an easy mechanism
2816         for hints files to indicate that POSIX will not compile
2817         on a particular system.
2818
2819 usesfio (d_sfio.U):
2820         This variable is set to true when the user agrees to use sfio.
2821         It is set to false when sfio is not available or when the user
2822         explicitely requests not to use sfio.  It is here primarily so
2823         that command-line settings can override the auto-detection of
2824         d_sfio without running into a "WHOA THERE".
2825
2826 useshrplib (libperl.U):
2827         This variable is set to 'yes' if the user wishes
2828         to build a shared libperl, and 'no' otherwise.
2829
2830 usethreads (usethreads.U):
2831         This variable conditionally defines the USE_THREADS symbol,
2832         and indicates that Perl should be built to use threads.
2833
2834 usevfork (d_vfork.U):
2835         This variable is set to true when the user accepts to use vfork.
2836         It is set to false when no vfork is available or when the user
2837         explicitely requests not to use vfork.
2838
2839 usrinc (usrinc.U):
2840         This variable holds the path of the include files, which is
2841         usually /usr/include. It is mainly used by other Configure units.
2842
2843 uuname (Loc.U):
2844         This variable is defined but not used by Configure.
2845         The value is a plain '' and is not useful.
2846
2847 version (patchlevel.U):
2848         The full version number of this package.  This combines
2849         baserev, patchlevel, and subversion to get the full
2850         version number, including any possible subversions.  Care
2851         is taken to use the C locale in order to get something
2852         like 5.004 instead of 5,004.  This is unique to perl.
2853
2854 vi (Loc.U):
2855         This variable is defined but not used by Configure.
2856         The value is a plain '' and is not useful.
2857
2858 voidflags (voidflags.U):
2859         This variable contains the eventual value of the VOIDFLAGS symbol,
2860         which indicates how much support of the void type is given by this
2861         compiler.  See VOIDFLAGS for more info.
2862
2863 zcat (Loc.U):
2864         This variable is defined but not used by Configure.
2865         The value is a plain '' and is not useful.
2866
2867 zip (Loc.U):
2868         This variable is be used internally by Configure to determine the
2869         full pathname (if any) of the zip program.  After Configure runs,
2870         the value is reset to a plain "zip" and is not useful.
2871