typo in change#5408
[p5sagit/p5-mst-13.2.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-- or a long double when applicable. Usual values are
30         2, 4 and 8.  The default is eight, for safety.
31
32 ansi2knr (ansi2knr.U):
33         This variable is set if the user needs to run ansi2knr.  
34         Currently, this is not supported, so we just abort.
35
36 aphostname (d_gethname.U):
37         This variable contains the command which can be used to compute the
38         host name. The command is fully qualified by its absolute path, to make
39         it safe when used by a process with super-user privileges.
40
41 api_revision (patchlevel.U):
42         The three variables, api_revision, api_version, and
43         api_subversion, specify the version of the oldest perl binary
44         compatible with the present perl.  In a full version string
45         such as '5.6.1', api_revision is the '5'.
46         Prior to 5.5.640, the format was a floating point number,
47         like 5.00563.
48                 perl.c:incpush() and lib/lib.pm will automatically search in
49         $sitelib/.. for older directories back to the limit specified
50         by these api_ variables.  This is only useful if you have a
51         perl library directory tree structured like the default one.
52         See INSTALL for how this works.  The versioned site_perl
53         directory was introduced in 5.005, so that is the lowest
54         possible value.  The version list appropriate for the current
55         system is determined in inc_version_list.U.
56                 XXX To do:  Since compatibility can depend on compile time
57         options (such as bincompat, longlong, etc.) it should
58         (perhaps) be set by Configure, but currently it isn't.
59         Currently, we read a hard-wired value from patchlevel.h.
60         Perhaps what we ought to do is take the hard-wired value from
61         patchlevel.h but then modify it if the current Configure
62         options warrant.  patchlevel.h then would use an #ifdef guard.
63
64 api_subversion (patchlevel.U):
65         The three variables, api_revision, api_version, and
66         api_subversion, specify the version of the oldest perl binary
67         compatible with the present perl.  In a full version string
68         such as '5.6.1', api_subversion is the '1'.  See api_revision for
69         full details.
70
71 api_version (patchlevel.U):
72         The three variables, api_revision, api_version, and
73         api_subversion, specify the version of the oldest perl binary
74         compatible with the present perl.  In a full version string
75         such as '5.6.1', api_version is the '6'.  See api_revision for
76         full details.  As a special case, 5.5.0 is rendered in the
77         old-style as 5.005.  (In the 5.005_0x maintenance series,
78         this was the only versioned directory in $sitelib.)
79
80 api_versionstring (patchlevel.U):
81         This variable combines api_revision, api_version, and
82         api_subversion in a format such as 5.6.1 (or 5_6_1) suitable
83         for use as a directory name.  This is filesystem dependent.
84
85 ar (Loc.U):
86         This variable is used internally by Configure to determine the
87         full pathname (if any) of the ar program.  After Configure runs,
88         the value is reset to a plain "ar" and is not useful.
89
90 archlib (archlib.U):
91         This variable holds the name of the directory in which the user wants
92         to put architecture-dependent public library files for $package.
93         It is most often a local directory such as /usr/local/lib.
94         Programs using this variable must be prepared to deal
95         with filename expansion.
96
97 archlibexp (archlib.U):
98         This variable is the same as the archlib variable, but is
99         filename expanded at configuration time, for convenient use.
100
101 archname64 (use64bits.U):
102         This variable is used for the 64-bitness part of $archname.
103
104 archname (archname.U):
105         This variable is a short name to characterize the current
106         architecture.  It is used mainly to construct the default archlib.
107
108 archobjs (Unix.U):
109         This variable defines any additional objects that must be linked
110         in with the program on this architecture.  On unix, it is usually
111         empty.  It is typically used to include emulations of unix calls
112         or other facilities.  For perl on OS/2, for example, this would
113         include os2/os2.obj.
114
115 awk (Loc.U):
116         This variable is used internally by Configure to determine the
117         full pathname (if any) of the awk program.  After Configure runs,
118         the value is reset to a plain "awk" and is not useful.
119
120 baserev (baserev.U):
121         The base revision level of this package, from the .package file.
122
123 bash (Loc.U):
124         This variable is defined but not used by Configure.
125         The value is a plain '' and is not useful.
126
127 bin (bin.U):
128         This variable holds the name of the directory in which the user wants
129         to put publicly executable images for the package in question.  It
130         is most often a local directory such as /usr/local/bin. Programs using
131         this variable must be prepared to deal with ~name substitution.
132
133 bincompat5005 (bincompat5005.U):
134         This variable contains y if Perl 5.006 should be binary-compatible
135         with Perl 5.005.
136
137 binexp (bin.U):
138         This is the same as the bin variable, but is filename expanded at
139         configuration time, for use in your makefiles.
140
141 bison (Loc.U):
142         This variable is defined but not used by Configure.
143         The value is a plain '' and is not useful.
144
145 byacc (Loc.U):
146         This variable is used internally by Configure to determine the
147         full pathname (if any) of the byacc program.  After Configure runs,
148         the value is reset to a plain "byacc" and is not useful.
149
150 byteorder (byteorder.U):
151         This variable holds the byte order. In the following, larger digits
152         indicate more significance.  The variable byteorder is either 4321
153         on a big-endian machine, or 1234 on a little-endian, or 87654321
154         on a Cray ... or 3412 with weird order !
155
156 c (n.U):
157         This variable contains the \c string if that is what causes the echo
158         command to suppress newline.  Otherwise it is null.  Correct usage is
159         $echo $n "prompt for a question: $c".
160
161 castflags (d_castneg.U):
162         This variable contains a flag that precise difficulties the
163         compiler has casting odd floating values to unsigned long:
164         0 = ok
165         1 = couldn't cast < 0
166         2 = couldn't cast >= 0x80000000
167         4 = couldn't cast in argument expression list
168
169 cat (Loc.U):
170         This variable is used internally by Configure to determine the
171         full pathname (if any) of the cat program.  After Configure runs,
172         the value is reset to a plain "cat" and is not useful.
173
174 cc (cc.U):
175         This variable holds the name of a command to execute a C compiler which
176         can resolve multiple global references that happen to have the same
177         name.  Usual values are 'cc', 'Mcc', 'cc -M', and 'gcc'.
178
179 cccdlflags (dlsrc.U):
180         This variable contains any special flags that might need to be
181         passed with 'cc -c' to compile modules to be used to create a shared
182         library that will be used for dynamic loading.  For hpux, this
183         should be +z.  It is up to the makefile to use it.
184
185 ccdlflags (dlsrc.U):
186         This variable contains any special flags that might need to be
187         passed to cc to link with a shared library for dynamic loading.
188         It is up to the makefile to use it.  For sunos 4.1, it should
189         be empty.
190
191 ccflags (ccflags.U):
192         This variable contains any additional C compiler flags desired by
193         the user.  It is up to the Makefile to use this.
194
195 ccsymbols (Cppsym.U):
196         The variable contains the symbols defined by the C compiler alone.
197         The list is a space-separated list of symbol=value tokens.
198
199 cf_by (cf_who.U):
200         Login name of the person who ran the Configure script and answered the
201         questions. This is used to tag both config.sh and config_h.SH.
202
203 cf_email (cf_email.U):
204         Electronic mail address of the person who ran Configure. This can be
205         used by units that require the user's e-mail, like MailList.U.
206
207 cf_time (cf_who.U):
208         Holds the output of the "date" command when the configuration file was
209         produced. This is used to tag both config.sh and config_h.SH.
210
211 charsize (charsize.U):
212         This variable contains the value of the CHARSIZE symbol, which
213         indicates to the C program how many bytes there are in a character.
214
215 chgrp (Loc.U):
216         This variable is defined but not used by Configure.
217         The value is a plain '' and is not useful.
218
219 chmod (Loc.U):
220         This variable is defined but not used by Configure.
221         The value is a plain '' and is not useful.
222
223 chown (Loc.U):
224         This variable is defined but not used by Configure.
225         The value is a plain '' and is not useful.
226
227 clocktype (d_times.U):
228         This variable holds the type returned by times(). It can be long,
229         or clock_t on BSD sites (in which case <sys/types.h> should be
230         included).
231
232 comm (Loc.U):
233         This variable is used internally by Configure to determine the
234         full pathname (if any) of the comm program.  After Configure runs,
235         the value is reset to a plain "comm" and is not useful.
236
237 compress (Loc.U):
238         This variable is defined but not used by Configure.
239         The value is a plain '' and is not useful.
240
241 CONFIGDOTSH (Oldsyms.U):
242         This is set to 'true' in config.sh so that a shell script
243         sourcing config.sh can tell if it has been sourced already.
244
245 contains (contains.U):
246         This variable holds the command to do a grep with a proper return
247         status.  On most sane systems it is simply "grep".  On insane systems
248         it is a grep followed by a cat followed by a test.  This variable
249         is primarily for the use of other Configure units.
250
251 cp (Loc.U):
252         This variable is used internally by Configure to determine the
253         full pathname (if any) of the cp program.  After Configure runs,
254         the value is reset to a plain "cp" and is not useful.
255
256 cpio (Loc.U):
257         This variable is defined but not used by Configure.
258         The value is a plain '' and is not useful.
259
260 cpp (Loc.U):
261         This variable is used internally by Configure to determine the
262         full pathname (if any) of the cpp program.  After Configure runs,
263         the value is reset to a plain "cpp" and is not useful.
264
265 cpp_stuff (cpp_stuff.U):
266         This variable contains an identification of the catenation mechanism
267         used by the C preprocessor.
268
269 cppccsymbols (Cppsym.U):
270         The variable contains the symbols defined by both
271         the bare C compiler and during a compilation that
272         includes stdio.h.
273         The list is a space-separated list of symbol=value tokens.
274
275 cppflags (ccflags.U):
276         This variable holds the flags that will be passed to the C pre-
277         processor. It is up to the Makefile to use it.
278
279 cpplast (cppstdin.U):
280         This variable has the same functionality as cppminus, only it applies
281         to cpprun and not cppstdin.
282
283 cppminus (cppstdin.U):
284         This variable contains the second part of the string which will invoke
285         the C preprocessor on the standard input and produce to standard
286         output.  This variable will have the value "-" if cppstdin needs
287         a minus to specify standard input, otherwise the value is "".
288
289 cpprun (cppstdin.U):
290         This variable contains the command which will invoke a C preprocessor
291         on standard input and put the output to stdout. It is guaranteed not
292         to be a wrapper and may be a null string if no preprocessor can be
293         made directly available. This preprocessor might be different from the
294         one used by the C compiler. Don't forget to append cpplast after the
295         preprocessor options.
296
297 cppstdin (cppstdin.U):
298         This variable contains the command which will invoke the C
299         preprocessor on standard input and put the output to stdout.
300         It is primarily used by other Configure units that ask about
301         preprocessor symbols.
302
303 cppsymbols (Cppsym.U):
304         The variable contains the symbols during a compilation
305         that includes stdio.h.
306         The list is a space-separated list of symbol=value tokens.
307
308 crosscompile (crosscompile.U):
309         This variable conditionally defines the CROSSCOMPILE symbol
310         which signifies that the build process is be a cross-compilation.
311         This is normally set by hints files or from Configure command line.
312
313 cryptlib (d_crypt.U):
314         This variable holds -lcrypt or the path to a libcrypt.a archive if
315         the crypt() function is not defined in the standard C library. It is
316         up to the Makefile to use this.
317
318 csh (Loc.U):
319         This variable is used internally by Configure to determine the
320         full pathname (if any) of the csh program.  After Configure runs,
321         the value is reset to a plain "csh" and is not useful.
322
323 d_access (d_access.U):
324         This variable conditionally defines HAS_ACCESS if the access() system
325         call is available to check for access permissions using real IDs.
326
327 d_accessx (d_accessx.U):
328         This variable conditionally defines the HAS_ACCESSX symbol, which
329         indicates to the C program that the accessx() routine is available.
330
331 d_alarm (d_alarm.U):
332         This variable conditionally defines the HAS_ALARM symbol, which
333         indicates to the C program that the alarm() routine is available.
334
335 d_archlib (archlib.U):
336         This variable conditionally defines ARCHLIB to hold the pathname
337         of architecture-dependent library files for $package.  If
338         $archlib is the same as $privlib, then this is set to undef.
339
340 d_atolf (atolf.U):
341         This variable conditionally defines the HAS_ATOLF symbol, which
342         indicates to the C program that the atolf() routine is available.
343
344 d_atoll (atoll.U):
345         This variable conditionally defines the HAS_ATOLL symbol, which
346         indicates to the C program that the atoll() routine is available.
347
348 d_attribut (d_attribut.U):
349         This variable conditionally defines HASATTRIBUTE, which
350         indicates the C compiler can check for function attributes,
351         such as printf formats.
352
353 d_bcmp (d_bcmp.U):
354         This variable conditionally defines the HAS_BCMP symbol if
355         the bcmp() routine is available to compare strings.
356
357 d_bcopy (d_bcopy.U):
358         This variable conditionally defines the HAS_BCOPY symbol if
359         the bcopy() routine is available to copy strings.
360
361 d_bincompat5005 (bincompat5005.U):
362         This variable conditionally defines BINCOMPAT5005 so that embed.h
363         can take special action if Perl 5.006 should be binary-compatible
364         with Perl 5.005.  This is impossible for builds that use features
365         like threads and multiplicity it is always $undef for those versions.
366
367 d_bsd (Guess.U):
368         This symbol conditionally defines the symbol BSD when running on a
369         BSD system.
370
371 d_bsdgetpgrp (d_getpgrp.U):
372         This variable conditionally defines USE_BSD_GETPGRP if
373         getpgrp needs one arguments whereas USG one needs none.
374
375 d_bsdsetpgrp (d_setpgrp.U):
376         This variable conditionally defines USE_BSD_SETPGRP if
377         setpgrp needs two arguments whereas USG one needs none.
378         See also d_setpgid for a POSIX interface.
379
380 d_bzero (d_bzero.U):
381         This variable conditionally defines the HAS_BZERO symbol if
382         the bzero() routine is available to set memory to 0.
383
384 d_casti32 (d_casti32.U):
385         This variable conditionally defines CASTI32, which indicates
386         whether the C compiler can cast large floats to 32-bit ints.
387
388 d_castneg (d_castneg.U):
389         This variable conditionally defines CASTNEG, which indicates
390         wether the C compiler can cast negative float to unsigned.
391
392 d_charvspr (d_vprintf.U):
393         This variable conditionally defines CHARVSPRINTF if this system
394         has vsprintf returning type (char*).  The trend seems to be to
395         declare it as "int vsprintf()".
396
397 d_chown (d_chown.U):
398         This variable conditionally defines the HAS_CHOWN symbol, which
399         indicates to the C program that the chown() routine is available.
400
401 d_chroot (d_chroot.U):
402         This variable conditionally defines the HAS_CHROOT symbol, which
403         indicates to the C program that the chroot() routine is available.
404
405 d_chsize (d_chsize.U):
406         This variable conditionally defines the CHSIZE symbol, which
407         indicates to the C program that the chsize() routine is available
408         to truncate files.  You might need a -lx to get this routine.
409
410 d_closedir (d_closedir.U):
411         This variable conditionally defines HAS_CLOSEDIR if closedir() is
412         available.
413
414 d_const (d_const.U):
415         This variable conditionally defines the HASCONST symbol, which
416         indicates to the C program that this C compiler knows about the
417         const type.
418
419 d_crypt (d_crypt.U):
420         This variable conditionally defines the CRYPT symbol, which
421         indicates to the C program that the crypt() routine is available
422         to encrypt passwords and the like.
423
424 d_csh (d_csh.U):
425         This variable conditionally defines the CSH symbol, which
426         indicates to the C program that the C-shell exists.
427
428 d_cuserid (d_cuserid.U):
429         This variable conditionally defines the HAS_CUSERID symbol, which
430         indicates to the C program that the cuserid() routine is available
431         to get character login names.
432
433 d_dbl_dig (d_dbl_dig.U):
434         This variable conditionally defines d_dbl_dig if this system's
435         header files provide DBL_DIG, which is the number of significant
436         digits in a double precision number.
437
438 d_difftime (d_difftime.U):
439         This variable conditionally defines the HAS_DIFFTIME symbol, which
440         indicates to the C program that the difftime() routine is available.
441
442 d_dirnamlen (i_dirent.U):
443         This variable conditionally defines DIRNAMLEN, which indicates
444         to the C program that the length of directory entry names is
445         provided by a d_namelen field.
446
447 d_dlerror (d_dlerror.U):
448         This variable conditionally defines the HAS_DLERROR symbol, which
449         indicates to the C program that the dlerror() routine is available.
450
451 d_dlopen (d_dlopen.U):
452         This variable conditionally defines the HAS_DLOPEN symbol, which
453         indicates to the C program that the dlopen() routine is available.
454
455 d_dlsymun (d_dlsymun.U):
456         This variable conditionally defines DLSYM_NEEDS_UNDERSCORE, which
457         indicates that we need to prepend an underscore to the symbol
458         name before calling dlsym().
459
460 d_dosuid (d_dosuid.U):
461         This variable conditionally defines the symbol DOSUID, which
462         tells the C program that it should insert setuid emulation code
463         on hosts which have setuid #! scripts disabled.
464
465 d_drand48proto (d_drand48proto.U):
466         This variable conditionally defines the HAS_DRAND48_PROTO symbol,
467         which indicates to the C program that the system provides
468         a prototype for the drand48() function.  Otherwise, it is
469         up to the program to supply one.
470
471 d_dup2 (d_dup2.U):
472         This variable conditionally defines HAS_DUP2 if dup2() is
473         available to duplicate file descriptors.
474
475 d_eaccess (d_eaccess.U):
476         This variable conditionally defines the HAS_EACCESS symbol, which
477         indicates to the C program that the eaccess() routine is available.
478
479 d_endgrent (d_endgrent.U):
480         This variable conditionally defines the HAS_ENDGRENT symbol, which
481         indicates to the C program that the endgrent() routine is available
482         for sequential access of the group database.
483
484 d_endhent (d_endhent.U):
485         This variable conditionally defines HAS_ENDHOSTENT if endhostent() is
486         available to close whatever was being used for host queries.
487
488 d_endnent (d_endnent.U):
489         This variable conditionally defines HAS_ENDNETENT if endnetent() is
490         available to close whatever was being used for network queries.
491
492 d_endpent (d_endpent.U):
493         This variable conditionally defines HAS_ENDPROTOENT if endprotoent() is
494         available to close whatever was being used for protocol queries.
495
496 d_endpwent (d_endpwent.U):
497         This variable conditionally defines the HAS_ENDPWENT symbol, which
498         indicates to the C program that the endpwent() routine is available
499         for sequential access of the passwd database.
500
501 d_endsent (d_endsent.U):
502         This variable conditionally defines HAS_ENDSERVENT if endservent() is
503         available to close whatever was being used for service queries.
504
505 d_endspent (d_endspent.U):
506         This variable conditionally defines HAS_ENDSPENT if endspent() is
507         available to finalize the scan of SysV shadow password entries.
508
509 d_eofnblk (nblock_io.U):
510         This variable conditionally defines EOF_NONBLOCK if EOF can be seen
511         when reading from a non-blocking I/O source.
512
513 d_eunice (Guess.U):
514         This variable conditionally defines the symbols EUNICE and VAX, which
515         alerts the C program that it must deal with ideosyncracies of VMS.
516
517 d_fchmod (d_fchmod.U):
518         This variable conditionally defines the HAS_FCHMOD symbol, which
519         indicates to the C program that the fchmod() routine is available
520         to change mode of opened files.
521
522 d_fchown (d_fchown.U):
523         This variable conditionally defines the HAS_FCHOWN symbol, which
524         indicates to the C program that the fchown() routine is available
525         to change ownership of opened files.
526
527 d_fcntl (d_fcntl.U):
528         This variable conditionally defines the HAS_FCNTL symbol, and indicates
529         whether the fcntl() function exists
530
531 d_fd_macros (d_fd_set.U):
532         This variable contains the eventual value of the HAS_FD_MACROS symbol,
533         which indicates if your C compiler knows about the macros which
534         manipulate an fd_set.
535
536 d_fd_set (d_fd_set.U):
537         This variable contains the eventual value of the HAS_FD_SET symbol,
538         which indicates if your C compiler knows about the fd_set typedef.
539
540 d_fds_bits (d_fd_set.U):
541         This variable contains the eventual value of the HAS_FDS_BITS symbol,
542         which indicates if your fd_set typedef contains the fds_bits member.
543         If you have an fd_set typedef, but the dweebs who installed it did
544         a half-fast job and neglected to provide the macros to manipulate
545         an fd_set, HAS_FDS_BITS will let us know how to fix the gaffe.
546
547 d_fgetpos (d_fgetpos.U):
548         This variable conditionally defines HAS_FGETPOS if fgetpos() is
549         available to get the file position indicator.
550
551 d_flexfnam (d_flexfnam.U):
552         This variable conditionally defines the FLEXFILENAMES symbol, which
553         indicates that the system supports filenames longer than 14 characters.
554
555 d_flock (d_flock.U):
556         This variable conditionally defines HAS_FLOCK if flock() is
557         available to do file locking.
558
559 d_fork (d_fork.U):
560         This variable conditionally defines the HAS_FORK symbol, which
561         indicates to the C program that the fork() routine is available.
562
563 d_fpathconf (d_pathconf.U):
564         This variable conditionally defines the HAS_FPATHCONF symbol, which
565         indicates to the C program that the pathconf() routine is available
566         to determine file-system related limits and options associated
567         with a given open file descriptor.
568
569 d_fpos64_t (d_fpos64_t.U):
570         This symbol will be defined if the C compiler supports fpos64_t.
571
572 d_fs_data_s (d_fs_data_s.U):
573         This variable conditionally defines the HAS_STRUCT_FS_DATA symbol,
574         which indicates that the struct fs_data is supported.
575
576 d_fseeko (d_fseeko.U):
577         This variable conditionally defines the HAS_FSEEKO symbol, which
578         indicates to the C program that the fseeko() routine is available.
579
580 d_fsetpos (d_fsetpos.U):
581         This variable conditionally defines HAS_FSETPOS if fsetpos() is
582         available to set the file position indicator.
583
584 d_fstatfs (d_fstatfs.U):
585         This variable conditionally defines the HAS_FSTATFS symbol, which
586         indicates to the C program that the fstatfs() routine is available.
587
588 d_fstatvfs (d_statvfs.U):
589         This variable conditionally defines the HAS_FSTATVFS symbol, which
590         indicates to the C program that the fstatvfs() routine is available.
591
592 d_ftello (d_ftello.U):
593         This variable conditionally defines the HAS_FTELLO symbol, which
594         indicates to the C program that the ftello() routine is available.
595
596 d_ftime (d_ftime.U):
597         This variable conditionally defines the HAS_FTIME symbol, which indicates
598         that the ftime() routine exists.  The ftime() routine is basically
599         a sub-second accuracy clock.
600
601 d_Gconvert (d_gconvert.U):
602         This variable holds what Gconvert is defined as to convert
603         floating point numbers into strings. It could be 'gconvert'
604         or a more complex macro emulating gconvert with gcvt() or sprintf.
605         Possible values are:
606         d_Gconvert='gconvert((x),(n),(t),(b))'
607         d_Gconvert='gcvt((x),(n),(b))'
608         d_Gconvert='sprintf((b),"%.*g",(n),(x))'
609
610 d_getcwd (d_getcwd.U):
611         This variable conditionally defines the HAS_GETCWD symbol, which
612         indicates to the C program that the getcwd() routine is available
613         to get the current working directory.
614
615 d_getfsstat (d_getfsstat.U):
616         This variable conditionally defines the HAS_GETFSSTAT symbol, which
617         indicates to the C program that the getfsstat() routine is available.
618
619 d_getgrent (d_getgrent.U):
620         This variable conditionally defines the HAS_GETGRENT symbol, which
621         indicates to the C program that the getgrent() routine is available
622         for sequential access of the group database.
623
624 d_getgrps (d_getgrps.U):
625         This variable conditionally defines the HAS_GETGROUPS symbol, which
626         indicates to the C program that the getgroups() routine is available
627         to get the list of process groups.
628
629 d_gethbyaddr (d_gethbyad.U):
630         This variable conditionally defines the HAS_GETHOSTBYADDR symbol, which
631         indicates to the C program that the gethostbyaddr() routine is available
632         to look up hosts by their IP addresses.
633
634 d_gethbyname (d_gethbynm.U):
635         This variable conditionally defines the HAS_GETHOSTBYNAME symbol, which
636         indicates to the C program that the gethostbyname() routine is available
637         to look up host names in some data base or other.
638
639 d_gethent (d_gethent.U):
640         This variable conditionally defines HAS_GETHOSTENT if gethostent() is
641         available to look up host names in some data base or another.
642
643 d_gethname (d_gethname.U):
644         This variable conditionally defines the HAS_GETHOSTNAME symbol, which
645         indicates to the C program that the gethostname() routine may be
646         used to derive the host name.
647
648 d_gethostprotos (d_gethostprotos.U):
649         This variable conditionally defines the HAS_GETHOST_PROTOS symbol,
650         which indicates to the C program that <netdb.h> supplies
651         prototypes for the various gethost*() functions.  
652         See also netdbtype.U for probing for various netdb types.
653
654 d_getlogin (d_getlogin.U):
655         This variable conditionally defines the HAS_GETLOGIN symbol, which
656         indicates to the C program that the getlogin() routine is available
657         to get the login name.
658
659 d_getmnt (d_getmnt.U):
660         This variable conditionally defines the HAS_GETMNT symbol, which
661         indicates to the C program that the getmnt() routine is available
662         to retrieve one or more mount info blocks by filename.
663
664 d_getmntent (d_getmntent.U):
665         This variable conditionally defines the HAS_GETMNTENT symbol, which
666         indicates to the C program that the getmntent() routine is available
667         to iterate through mounted files to get their mount info.
668
669 d_getnbyaddr (d_getnbyad.U):
670         This variable conditionally defines the HAS_GETNETBYADDR symbol, which
671         indicates to the C program that the getnetbyaddr() routine is available
672         to look up networks by their IP addresses.
673
674 d_getnbyname (d_getnbynm.U):
675         This variable conditionally defines the HAS_GETNETBYNAME symbol, which
676         indicates to the C program that the getnetbyname() routine is available
677         to look up networks by their names.
678
679 d_getnent (d_getnent.U):
680         This variable conditionally defines HAS_GETNETENT if getnetent() is
681         available to look up network names in some data base or another.
682
683 d_getnetprotos (d_getnetprotos.U):
684         This variable conditionally defines the HAS_GETNET_PROTOS symbol,
685         which indicates to the C program that <netdb.h> supplies
686         prototypes for the various getnet*() functions.  
687         See also netdbtype.U for probing for various netdb types.
688
689 d_getpbyname (d_getprotby.U):
690         This variable conditionally defines the HAS_GETPROTOBYNAME 
691         symbol, which indicates to the C program that the 
692         getprotobyname() routine is available to look up protocols
693         by their name.
694
695 d_getpbynumber (d_getprotby.U):
696         This variable conditionally defines the HAS_GETPROTOBYNUMBER 
697         symbol, which indicates to the C program that the 
698         getprotobynumber() routine is available to look up protocols
699         by their number.
700
701 d_getpent (d_getpent.U):
702         This variable conditionally defines HAS_GETPROTOENT if getprotoent() is
703         available to look up protocols in some data base or another.
704
705 d_getpgid (d_getpgid.U):
706         This variable conditionally defines the HAS_GETPGID symbol, which
707         indicates to the C program that the getpgid(pid) function
708         is available to get the process group id.
709
710 d_getpgrp2 (d_getpgrp2.U):
711         This variable conditionally defines the HAS_GETPGRP2 symbol, which
712         indicates to the C program that the getpgrp2() (as in DG/UX) routine
713         is available to get the current process group.
714
715 d_getpgrp (d_getpgrp.U):
716         This variable conditionally defines HAS_GETPGRP if getpgrp() is
717         available to get the current process group.
718
719 d_getppid (d_getppid.U):
720         This variable conditionally defines the HAS_GETPPID symbol, which
721         indicates to the C program that the getppid() routine is available
722         to get the parent process ID.
723
724 d_getprior (d_getprior.U):
725         This variable conditionally defines HAS_GETPRIORITY if getpriority()
726         is available to get a process's priority.
727
728 d_getprotoprotos (d_getprotoprotos.U):
729         This variable conditionally defines the HAS_GETPROTO_PROTOS symbol,
730         which indicates to the C program that <netdb.h> supplies
731         prototypes for the various getproto*() functions.  
732         See also netdbtype.U for probing for various netdb types.
733
734 d_getpwent (d_getpwent.U):
735         This variable conditionally defines the HAS_GETPWENT symbol, which
736         indicates to the C program that the getpwent() routine is available
737         for sequential access of the passwd database.
738
739 d_getsbyname (d_getsrvby.U):
740         This variable conditionally defines the HAS_GETSERVBYNAME 
741         symbol, which indicates to the C program that the 
742         getservbyname() routine is available to look up services
743         by their name.
744
745 d_getsbyport (d_getsrvby.U):
746         This variable conditionally defines the HAS_GETSERVBYPORT 
747         symbol, which indicates to the C program that the 
748         getservbyport() routine is available to look up services
749         by their port.
750
751 d_getsent (d_getsent.U):
752         This variable conditionally defines HAS_GETSERVENT if getservent() is
753         available to look up network services in some data base or another.
754
755 d_getservprotos (d_getservprotos.U):
756         This variable conditionally defines the HAS_GETSERV_PROTOS symbol,
757         which indicates to the C program that <netdb.h> supplies
758         prototypes for the various getserv*() functions.  
759         See also netdbtype.U for probing for various netdb types.
760
761 d_getspent (d_getspent.U):
762         This variable conditionally defines HAS_GETSPENT if getspent() is
763         available to retrieve SysV shadow password entries sequentially.
764
765 d_getspnam (d_getspnam.U):
766         This variable conditionally defines HAS_GETSPNAM if getspnam() is
767         available to retrieve SysV shadow password entries by name.
768
769 d_gettimeod (d_ftime.U):
770         This variable conditionally defines the HAS_GETTIMEOFDAY symbol, which
771         indicates that the gettimeofday() system call exists (to obtain a
772         sub-second accuracy clock). You should probably include <sys/resource.h>.
773
774 d_gnulibc (d_gnulibc.U):
775         Defined if we're dealing with the GNU C Library.
776
777 d_grpasswd (i_grp.U):
778         This variable conditionally defines GRPASSWD, which indicates
779         that struct group in <grp.h> contains gr_passwd.
780
781 d_hasmntopt (d_hasmntopt.U):
782         This variable conditionally defines the HAS_HASMNTOPT symbol, which
783         indicates to the C program that the hasmntopt() routine is available
784         to query the mount options of file systems.
785
786 d_htonl (d_htonl.U):
787         This variable conditionally defines HAS_HTONL if htonl() and its
788         friends are available to do network order byte swapping.
789
790 d_iconv (d_iconv.U):
791         This variable conditionally defines the HAS_ICONV symbol, which
792         indicates to the C program that the iconv() routine is available.
793
794 d_index (d_strchr.U):
795         This variable conditionally defines HAS_INDEX if index() and
796         rindex() are available for string searching.
797
798 d_inetaton (d_inetaton.U):
799         This variable conditionally defines the HAS_INET_ATON symbol, which
800         indicates to the C program that the inet_aton() function is available
801         to parse IP address "dotted-quad" strings.
802
803 d_int64_t (d_int64_t.U):
804         This symbol will be defined if the C compiler supports int64_t.
805
806 d_isascii (d_isascii.U):
807         This variable conditionally defines the HAS_ISASCII constant,
808         which indicates to the C program that isascii() is available.
809
810 d_killpg (d_killpg.U):
811         This variable conditionally defines the HAS_KILLPG symbol, which
812         indicates to the C program that the killpg() routine is available
813         to kill process groups.
814
815 d_lchown (d_lchown.U):
816         This variable conditionally defines the HAS_LCHOWN symbol, which
817         indicates to the C program that the lchown() routine is available
818         to operate on a symbolic link (instead of following the link).
819
820 d_ldbl_dig (d_ldbl_dig.U):
821         This variable conditionally defines d_ldbl_dig if this system's
822         header files provide LDBL_DIG, which is the number of significant
823         digits in a long double precision number.
824
825 d_link (d_link.U):
826         This variable conditionally defines HAS_LINK if link() is
827         available to create hard links.
828
829 d_locconv (d_locconv.U):
830         This variable conditionally defines HAS_LOCALECONV if localeconv() is
831         available for numeric and monetary formatting conventions.
832
833 d_lockf (d_lockf.U):
834         This variable conditionally defines HAS_LOCKF if lockf() is
835         available to do file locking.
836
837 d_longdbl (d_longdbl.U):
838         This variable conditionally defines HAS_LONG_DOUBLE if 
839         the long double type is supported.
840
841 d_longlong (d_longlong.U):
842         This variable conditionally defines HAS_LONG_LONG if 
843         the long long type is supported.
844
845 d_lseekproto (d_lseekproto.U):
846         This variable conditionally defines the HAS_LSEEK_PROTO symbol,
847         which indicates to the C program that the system provides
848         a prototype for the lseek() function.  Otherwise, it is
849         up to the program to supply one.
850
851 d_lstat (d_lstat.U):
852         This variable conditionally defines HAS_LSTAT if lstat() is
853         available to do file stats on symbolic links.
854
855 d_mblen (d_mblen.U):
856         This variable conditionally defines the HAS_MBLEN symbol, which
857         indicates to the C program that the mblen() routine is available
858         to find the number of bytes in a multibye character.
859
860 d_mbstowcs (d_mbstowcs.U):
861         This variable conditionally defines the HAS_MBSTOWCS symbol, which
862         indicates to the C program that the mbstowcs() routine is available
863         to convert a multibyte string into a wide character string.
864
865 d_mbtowc (d_mbtowc.U):
866         This variable conditionally defines the HAS_MBTOWC symbol, which
867         indicates to the C program that the mbtowc() routine is available
868         to convert multibyte to a wide character.
869
870 d_memchr (d_memchr.U):
871         This variable conditionally defines the HAS_MEMCHR symbol, which
872         indicates to the C program that the memchr() routine is available
873         to locate characters within a C string.
874
875 d_memcmp (d_memcmp.U):
876         This variable conditionally defines the HAS_MEMCMP symbol, which
877         indicates to the C program that the memcmp() routine is available
878         to compare blocks of memory.
879
880 d_memcpy (d_memcpy.U):
881         This variable conditionally defines the HAS_MEMCPY symbol, which
882         indicates to the C program that the memcpy() routine is available
883         to copy blocks of memory.
884
885 d_memmove (d_memmove.U):
886         This variable conditionally defines the HAS_MEMMOVE symbol, which
887         indicates to the C program that the memmove() routine is available
888         to copy potentatially overlapping blocks of memory.
889
890 d_memset (d_memset.U):
891         This variable conditionally defines the HAS_MEMSET symbol, which
892         indicates to the C program that the memset() routine is available
893         to set blocks of memory.
894
895 d_mkdir (d_mkdir.U):
896         This variable conditionally defines the HAS_MKDIR symbol, which
897         indicates to the C program that the mkdir() routine is available
898         to create directories..
899
900 d_mkdtemp (d_mkdtemp.U):
901         This variable conditionally defines the HAS_MKDTEMP symbol, which
902         indicates to the C program that the mkdtemp() routine is available
903         to exclusively create a uniquely named temporary directory.
904
905 d_mkfifo (d_mkfifo.U):
906         This variable conditionally defines the HAS_MKFIFO symbol, which
907         indicates to the C program that the mkfifo() routine is available.
908
909 d_mkstemp (d_mkstemp.U):
910         This variable conditionally defines the HAS_MKSTEMP symbol, which
911         indicates to the C program that the mkstemp() routine is available
912         to exclusively create and open a uniquely named temporary file.
913
914 d_mkstemps (d_mkstemps.U):
915         This variable conditionally defines the HAS_MKSTEMPS symbol, which
916         indicates to the C program that the mkstemps() routine is available
917         to exclusively create and open a uniquely named (with a suffix)
918         temporary file.
919
920 d_mktime (d_mktime.U):
921         This variable conditionally defines the HAS_MKTIME symbol, which
922         indicates to the C program that the mktime() routine is available.
923
924 d_mmap (d_mmap.U):
925         This variable conditionally defines HAS_MMAP if mmap() is
926         available to map a file into memory.
927
928 d_mprotect (d_mprotect.U):
929         This variable conditionally defines HAS_MPROTECT if mprotect() is
930         available to modify the access protection of a memory mapped file.
931
932 d_msg (d_msg.U):
933         This variable conditionally defines the HAS_MSG symbol, which
934         indicates that the entire msg*(2) library is present.
935
936 d_msg_ctrunc (d_socket.U):
937         This variable conditionally defines the HAS_MSG_CTRUNC symbol,
938         which indicates that the MSG_CTRUNC is available.  #ifdef is
939         not enough because it may be an enum, glibc has been known to do this.
940
941 d_msg_dontroute (d_socket.U):
942         This variable conditionally defines the HAS_MSG_DONTROUTE symbol,
943         which indicates that the MSG_DONTROUTE is available.  #ifdef is
944         not enough because it may be an enum, glibc has been known to do this.
945
946 d_msg_oob (d_socket.U):
947         This variable conditionally defines the HAS_MSG_OOB symbol,
948         which indicates that the MSG_OOB is available.  #ifdef is
949         not enough because it may be an enum, glibc has been known to do this.
950
951 d_msg_peek (d_socket.U):
952         This variable conditionally defines the HAS_MSG_PEEK symbol,
953         which indicates that the MSG_PEEK is available.  #ifdef is
954         not enough because it may be an enum, glibc has been known to do this.
955
956 d_msg_proxy (d_socket.U):
957         This variable conditionally defines the HAS_MSG_PROXY symbol,
958         which indicates that the MSG_PROXY is available.  #ifdef is
959         not enough because it may be an enum, glibc has been known to do this.
960
961 d_msgctl (d_msgctl.U):
962         This variable conditionally defines the HAS_MSGCTL symbol, which
963         indicates to the C program that the msgctl() routine is available.
964
965 d_msgget (d_msgget.U):
966         This variable conditionally defines the HAS_MSGGET symbol, which
967         indicates to the C program that the msgget() routine is available.
968
969 d_msgrcv (d_msgrcv.U):
970         This variable conditionally defines the HAS_MSGRCV symbol, which
971         indicates to the C program that the msgrcv() routine is available.
972
973 d_msgsnd (d_msgsnd.U):
974         This variable conditionally defines the HAS_MSGSND symbol, which
975         indicates to the C program that the msgsnd() routine is available.
976
977 d_msync (d_msync.U):
978         This variable conditionally defines HAS_MSYNC if msync() is
979         available to synchronize a mapped file.
980
981 d_munmap (d_munmap.U):
982         This variable conditionally defines HAS_MUNMAP if munmap() is
983         available to unmap a region mapped by mmap().
984
985 d_mymalloc (mallocsrc.U):
986         This variable conditionally defines MYMALLOC in case other parts
987         of the source want to take special action if MYMALLOC is used.
988         This may include different sorts of profiling or error detection.
989
990 d_nice (d_nice.U):
991         This variable conditionally defines the HAS_NICE symbol, which
992         indicates to the C program that the nice() routine is available.
993
994 d_nv_preserves_uv (perlxv.U):
995         This variable indicates whether a variable of type nvtype
996         can preserve all the bits a variable of type uvtype.
997
998 d_off64_t (d_off64_t.U):
999         This symbol will be defined if the C compiler supports off64_t.
1000
1001 d_old_pthread_create_joinable (d_pthrattrj.U):
1002         This variable conditionally defines pthread_create_joinable.
1003         undef if pthread.h defines PTHREAD_CREATE_JOINABLE.
1004
1005 d_oldpthreads (usethreads.U):
1006         This variable conditionally defines the OLD_PTHREADS_API symbol,
1007         and indicates that Perl should be built to use the old
1008         draft POSIX threads API.  This is only potentially meaningful if
1009         usethreads is set.
1010
1011 d_oldsock (d_socket.U):
1012         This variable conditionally defines the OLDSOCKET symbol, which
1013         indicates that the BSD socket interface is based on 4.1c and not 4.2.
1014
1015 d_open3 (d_open3.U):
1016         This variable conditionally defines the HAS_OPEN3 manifest constant,
1017         which indicates to the C program that the 3 argument version of
1018         the open(2) function is available.
1019
1020 d_pathconf (d_pathconf.U):
1021         This variable conditionally defines the HAS_PATHCONF symbol, which
1022         indicates to the C program that the pathconf() routine is available
1023         to determine file-system related limits and options associated
1024         with a given filename.
1025
1026 d_pause (d_pause.U):
1027         This variable conditionally defines the HAS_PAUSE symbol, which
1028         indicates to the C program that the pause() routine is available
1029         to suspend a process until a signal is received.
1030
1031 d_phostname (d_gethname.U):
1032         This variable conditionally defines the HAS_PHOSTNAME symbol, which
1033         contains the shell command which, when fed to popen(), may be
1034         used to derive the host name.
1035
1036 d_pipe (d_pipe.U):
1037         This variable conditionally defines the HAS_PIPE symbol, which
1038         indicates to the C program that the pipe() routine is available
1039         to create an inter-process channel.
1040
1041 d_poll (d_poll.U):
1042         This variable conditionally defines the HAS_POLL symbol, which
1043         indicates to the C program that the poll() routine is available
1044         to poll active file descriptors.
1045
1046 d_portable (d_portable.U):
1047         This variable conditionally defines the PORTABLE symbol, which
1048         indicates to the C program that it should not assume that it is
1049         running on the machine it was compiled on.
1050
1051 d_PRId64 (quadfio.U):
1052         This variable conditionally defines the PERL_PRId64 symbol, which
1053         indiciates that stdio has a symbol to print 64-bit decimal numbers.
1054
1055 d_PRIeldbl (longdblfio.U):
1056         This variable conditionally defines the PERL_PRIfldlbl symbol, which
1057         indiciates that stdio has a symbol to print long doubles.
1058
1059 d_PRIEldbl (longdblfio.U):
1060         This variable conditionally defines the PERL_PRIfldlbl symbol, which
1061         indiciates that stdio has a symbol to print long doubles.
1062
1063 d_PRIfldbl (longdblfio.U):
1064         This variable conditionally defines the PERL_PRIfldlbl symbol, which
1065         indiciates that stdio has a symbol to print long doubles.
1066
1067 d_PRIFldbl (longdblfio.U):
1068         This variable conditionally defines the PERL_PRIfldlbl symbol, which
1069         indiciates that stdio has a symbol to print long doubles.
1070
1071 d_PRIgldbl (longdblfio.U):
1072         This variable conditionally defines the PERL_PRIfldlbl symbol, which
1073         indiciates that stdio has a symbol to print long doubles.
1074
1075 d_PRIGldbl (longdblfio.U):
1076         This variable conditionally defines the PERL_PRIfldlbl symbol, which
1077         indiciates that stdio has a symbol to print long doubles.
1078
1079 d_PRIi64 (quadfio.U):
1080         This variable conditionally defines the PERL_PRIi64 symbol, which
1081         indiciates that stdio has a symbol to print 64-bit decimal numbers.
1082
1083 d_PRIo64 (quadfio.U):
1084         This variable conditionally defines the PERL_PRIo64 symbol, which
1085         indiciates that stdio has a symbol to print 64-bit octal numbers.
1086
1087 d_PRIu64 (quadfio.U):
1088         This variable conditionally defines the PERL_PRIu64 symbol, which
1089         indiciates that stdio has a symbol to print 64-bit unsigned decimal
1090         numbers.
1091
1092 d_PRIx64 (quadfio.U):
1093         This variable conditionally defines the PERL_PRIx64 symbol, which
1094         indiciates that stdio has a symbol to print 64-bit hexadecimal numbers.
1095
1096 d_PRIX64 (quadfio.U):
1097         This variable conditionally defines the PERL_PRIX64 symbol, which
1098         indiciates that stdio has a symbol to print 64-bit hExADECimAl numbers.
1099
1100 d_pthread_yield (d_pthread_y.U):
1101         This variable conditionally defines the HAS_PTHREAD_YIELD
1102         symbol if the pthread_yield routine is available to yield
1103         the execution of the current thread.
1104
1105 d_pwage (i_pwd.U):
1106         This variable conditionally defines PWAGE, which indicates
1107         that struct passwd contains pw_age.
1108
1109 d_pwchange (i_pwd.U):
1110         This variable conditionally defines PWCHANGE, which indicates
1111         that struct passwd contains pw_change.
1112
1113 d_pwclass (i_pwd.U):
1114         This variable conditionally defines PWCLASS, which indicates
1115         that struct passwd contains pw_class.
1116
1117 d_pwcomment (i_pwd.U):
1118         This variable conditionally defines PWCOMMENT, which indicates
1119         that struct passwd contains pw_comment.
1120
1121 d_pwexpire (i_pwd.U):
1122         This variable conditionally defines PWEXPIRE, which indicates
1123         that struct passwd contains pw_expire.
1124
1125 d_pwgecos (i_pwd.U):
1126         This variable conditionally defines PWGECOS, which indicates
1127         that struct passwd contains pw_gecos.
1128
1129 d_pwpasswd (i_pwd.U):
1130         This variable conditionally defines PWPASSWD, which indicates
1131         that struct passwd contains pw_passwd.
1132
1133 d_pwquota (i_pwd.U):
1134         This variable conditionally defines PWQUOTA, which indicates
1135         that struct passwd contains pw_quota.
1136
1137 d_quad (quadtype.U):
1138         This variable, if defined, tells that there's a 64-bit integer type,
1139         quadtype.
1140
1141 d_readdir (d_readdir.U):
1142         This variable conditionally defines HAS_READDIR if readdir() is
1143         available to read directory entries.
1144
1145 d_readlink (d_readlink.U):
1146         This variable conditionally defines the HAS_READLINK symbol, which
1147         indicates to the C program that the readlink() routine is available
1148         to read the value of a symbolic link.
1149
1150 d_rename (d_rename.U):
1151         This variable conditionally defines the HAS_RENAME symbol, which
1152         indicates to the C program that the rename() routine is available
1153         to rename files.
1154
1155 d_rewinddir (d_readdir.U):
1156         This variable conditionally defines HAS_REWINDDIR if rewinddir() is
1157         available.
1158
1159 d_rmdir (d_rmdir.U):
1160         This variable conditionally defines HAS_RMDIR if rmdir() is
1161         available to remove directories.
1162
1163 d_safebcpy (d_safebcpy.U):
1164         This variable conditionally defines the HAS_SAFE_BCOPY symbol if
1165         the bcopy() routine can do overlapping copies.
1166
1167 d_safemcpy (d_safemcpy.U):
1168         This variable conditionally defines the HAS_SAFE_MEMCPY symbol if
1169         the memcpy() routine can do overlapping copies.
1170
1171 d_sanemcmp (d_sanemcmp.U):
1172         This variable conditionally defines the HAS_SANE_MEMCMP symbol if
1173         the memcpy() routine is available and can be used to compare relative
1174         magnitudes of chars with their high bits set.
1175
1176 d_sched_yield (d_pthread_y.U):
1177         This variable conditionally defines the HAS_SCHED_YIELD
1178         symbol if the sched_yield routine is available to yield
1179         the execution of the current thread.
1180
1181 d_scm_rights (d_socket.U):
1182         This variable conditionally defines the HAS_SCM_RIGHTS symbol,
1183         which indicates that the SCM_RIGHTS is available.  #ifdef is
1184         not enough because it may be an enum, glibc has been known to do this.
1185
1186 d_seekdir (d_readdir.U):
1187         This variable conditionally defines HAS_SEEKDIR if seekdir() is
1188         available.
1189
1190 d_select (d_select.U):
1191         This variable conditionally defines HAS_SELECT if select() is
1192         available to select active file descriptors. A <sys/time.h>
1193         inclusion may be necessary for the timeout field.
1194
1195 d_sem (d_sem.U):
1196         This variable conditionally defines the HAS_SEM symbol, which
1197         indicates that the entire sem*(2) library is present.
1198
1199 d_semctl (d_semctl.U):
1200         This variable conditionally defines the HAS_SEMCTL symbol, which
1201         indicates to the C program that the semctl() routine is available.
1202
1203 d_semctl_semid_ds (d_union_semun.U):
1204         This variable conditionally defines USE_SEMCTL_SEMID_DS, which
1205         indicates that struct semid_ds * is to be used for semctl IPC_STAT.
1206
1207 d_semctl_semun (d_union_semun.U):
1208         This variable conditionally defines USE_SEMCTL_SEMUN, which
1209         indicates that union semun is to be used for semctl IPC_STAT.
1210
1211 d_semget (d_semget.U):
1212         This variable conditionally defines the HAS_SEMGET symbol, which
1213         indicates to the C program that the semget() routine is available.
1214
1215 d_semop (d_semop.U):
1216         This variable conditionally defines the HAS_SEMOP symbol, which
1217         indicates to the C program that the semop() routine is available.
1218
1219 d_setegid (d_setegid.U):
1220         This variable conditionally defines the HAS_SETEGID symbol, which
1221         indicates to the C program that the setegid() routine is available
1222         to change the effective gid of the current program.
1223
1224 d_seteuid (d_seteuid.U):
1225         This variable conditionally defines the HAS_SETEUID symbol, which
1226         indicates to the C program that the seteuid() routine is available
1227         to change the effective uid of the current program.
1228
1229 d_setgrent (d_setgrent.U):
1230         This variable conditionally defines the HAS_SETGRENT symbol, which
1231         indicates to the C program that the setgrent() routine is available
1232         for initializing sequential access to the group database.
1233
1234 d_setgrps (d_setgrps.U):
1235         This variable conditionally defines the HAS_SETGROUPS symbol, which
1236         indicates to the C program that the setgroups() routine is available
1237         to set the list of process groups.
1238
1239 d_sethent (d_sethent.U):
1240         This variable conditionally defines HAS_SETHOSTENT if sethostent() is
1241         available.
1242
1243 d_setlinebuf (d_setlnbuf.U):
1244         This variable conditionally defines the HAS_SETLINEBUF symbol, which
1245         indicates to the C program that the setlinebuf() routine is available
1246         to change stderr or stdout from block-buffered or unbuffered to a
1247         line-buffered mode.
1248
1249 d_setlocale (d_setlocale.U):
1250         This variable conditionally defines HAS_SETLOCALE if setlocale() is
1251         available to handle locale-specific ctype implementations.
1252
1253 d_setnent (d_setnent.U):
1254         This variable conditionally defines HAS_SETNETENT if setnetent() is
1255         available.
1256
1257 d_setpent (d_setpent.U):
1258         This variable conditionally defines HAS_SETPROTOENT if setprotoent() is
1259         available.
1260
1261 d_setpgid (d_setpgid.U):
1262         This variable conditionally defines the HAS_SETPGID symbol if the
1263         setpgid(pid, gpid) function is available to set process group ID.
1264
1265 d_setpgrp2 (d_setpgrp2.U):
1266         This variable conditionally defines the HAS_SETPGRP2 symbol, which
1267         indicates to the C program that the setpgrp2() (as in DG/UX) routine
1268         is available to set the current process group.
1269
1270 d_setpgrp (d_setpgrp.U):
1271         This variable conditionally defines HAS_SETPGRP if setpgrp() is
1272         available to set the current process group.
1273
1274 d_setprior (d_setprior.U):
1275         This variable conditionally defines HAS_SETPRIORITY if setpriority()
1276         is available to set a process's priority.
1277
1278 d_setpwent (d_setpwent.U):
1279         This variable conditionally defines the HAS_SETPWENT symbol, which
1280         indicates to the C program that the setpwent() routine is available
1281         for initializing sequential access to the passwd database.
1282
1283 d_setregid (d_setregid.U):
1284         This variable conditionally defines HAS_SETREGID if setregid() is
1285         available to change the real and effective gid of the current
1286         process.
1287
1288 d_setresgid (d_setregid.U):
1289         This variable conditionally defines HAS_SETRESGID if setresgid() is
1290         available to change the real, effective and saved gid of the current
1291         process.
1292
1293 d_setresuid (d_setreuid.U):
1294         This variable conditionally defines HAS_SETREUID if setresuid() is
1295         available to change the real, effective and saved uid of the current
1296         process.
1297
1298 d_setreuid (d_setreuid.U):
1299         This variable conditionally defines HAS_SETREUID if setreuid() is
1300         available to change the real and effective uid of the current
1301         process.
1302
1303 d_setrgid (d_setrgid.U):
1304         This variable conditionally defines the HAS_SETRGID symbol, which
1305         indicates to the C program that the setrgid() routine is available
1306         to change the real gid of the current program.
1307
1308 d_setruid (d_setruid.U):
1309         This variable conditionally defines the HAS_SETRUID symbol, which
1310         indicates to the C program that the setruid() routine is available
1311         to change the real uid of the current program.
1312
1313 d_setsent (d_setsent.U):
1314         This variable conditionally defines HAS_SETSERVENT if setservent() is
1315         available.
1316
1317 d_setsid (d_setsid.U):
1318         This variable conditionally defines HAS_SETSID if setsid() is
1319         available to set the process group ID.
1320
1321 d_setspent (d_setspent.U):
1322         This variable conditionally defines HAS_SETSPENT if setspent() is
1323         available to initialize the scan of SysV shadow password entries.
1324
1325 d_setvbuf (d_setvbuf.U):
1326         This variable conditionally defines the HAS_SETVBUF symbol, which
1327         indicates to the C program that the setvbuf() routine is available
1328         to change buffering on an open stdio stream.
1329
1330 d_sfio (d_sfio.U):
1331         This variable conditionally defines the USE_SFIO symbol,
1332         and indicates whether sfio is available (and should be used).
1333
1334 d_shm (d_shm.U):
1335         This variable conditionally defines the HAS_SHM symbol, which
1336         indicates that the entire shm*(2) library is present.
1337
1338 d_shmat (d_shmat.U):
1339         This variable conditionally defines the HAS_SHMAT symbol, which
1340         indicates to the C program that the shmat() routine is available.
1341
1342 d_shmatprototype (d_shmat.U):
1343         This variable conditionally defines the HAS_SHMAT_PROTOTYPE 
1344         symbol, which indicates that sys/shm.h has a prototype for
1345         shmat.
1346
1347 d_shmctl (d_shmctl.U):
1348         This variable conditionally defines the HAS_SHMCTL symbol, which
1349         indicates to the C program that the shmctl() routine is available.
1350
1351 d_shmdt (d_shmdt.U):
1352         This variable conditionally defines the HAS_SHMDT symbol, which
1353         indicates to the C program that the shmdt() routine is available.
1354
1355 d_shmget (d_shmget.U):
1356         This variable conditionally defines the HAS_SHMGET symbol, which
1357         indicates to the C program that the shmget() routine is available.
1358
1359 d_sigaction (d_sigaction.U):
1360         This variable conditionally defines the HAS_SIGACTION symbol, which
1361         indicates that the Vr4 sigaction() routine is available.
1362
1363 d_sigsetjmp (d_sigsetjmp.U):
1364         This variable conditionally defines the HAS_SIGSETJMP symbol,
1365         which indicates that the sigsetjmp() routine is available to
1366         call setjmp() and optionally save the process's signal mask.
1367
1368 d_socket (d_socket.U):
1369         This variable conditionally defines HAS_SOCKET, which indicates
1370         that the BSD socket interface is supported.
1371
1372 d_socklen_t (d_socklen_t.U):
1373         This symbol will be defined if the C compiler supports socklen_t.
1374
1375 d_sockpair (d_socket.U):
1376         This variable conditionally defines the HAS_SOCKETPAIR symbol, which
1377         indicates that the BSD socketpair() is supported.
1378
1379 d_sqrtl (d_sqrtl.U):
1380         This variable conditionally defines the HAS_SQRTL symbol, which
1381         indicates to the C program that the sqrtl() routine is available.
1382
1383 d_statblks (d_statblks.U):
1384         This variable conditionally defines USE_STAT_BLOCKS
1385         if this system has a stat structure declaring
1386         st_blksize and st_blocks.
1387
1388 d_statfs_f_flags (d_statfs_f_flags.U):
1389         This variable conditionally defines the HAS_STRUCT_STATFS_F_FLAGS
1390         symbol, which indicates to struct statfs from has f_flags member.
1391         This kind of struct statfs is coming from sys/mount.h (BSD),
1392         not from sys/statfs.h (SYSV).
1393
1394 d_statfs_s (d_statfs_s.U):
1395         This variable conditionally defines the HAS_STRUCT_STATFS symbol,
1396         which indicates that the struct statfs is supported.
1397
1398 d_statvfs (d_statvfs.U):
1399         This variable conditionally defines the HAS_STATVFS symbol, which
1400         indicates to the C program that the statvfs() routine is available.
1401
1402 d_stdio_cnt_lval (d_stdstdio.U):
1403         This variable conditionally defines STDIO_CNT_LVALUE if the
1404         FILE_cnt macro can be used as an lvalue.
1405
1406 d_stdio_ptr_lval (d_stdstdio.U):
1407         This variable conditionally defines STDIO_PTR_LVALUE if the
1408         FILE_ptr macro can be used as an lvalue.
1409
1410 d_stdio_stream_array (stdio_streams.U):
1411         This variable tells whether there is an array holding
1412         the stdio streams.
1413
1414 d_stdiobase (d_stdstdio.U):
1415         This variable conditionally defines USE_STDIO_BASE if this system
1416         has a FILE structure declaring a usable _base field (or equivalent)
1417         in stdio.h.
1418
1419 d_stdstdio (d_stdstdio.U):
1420         This variable conditionally defines USE_STDIO_PTR if this system
1421         has a FILE structure declaring usable _ptr and _cnt fields (or
1422         equivalent) in stdio.h.
1423
1424 d_strchr (d_strchr.U):
1425         This variable conditionally defines HAS_STRCHR if strchr() and
1426         strrchr() are available for string searching.
1427
1428 d_strcoll (d_strcoll.U):
1429         This variable conditionally defines HAS_STRCOLL if strcoll() is
1430         available to compare strings using collating information.
1431
1432 d_strctcpy (d_strctcpy.U):
1433         This variable conditionally defines the USE_STRUCT_COPY symbol, which
1434         indicates to the C program that this C compiler knows how to copy
1435         structures.
1436
1437 d_strerrm (d_strerror.U):
1438         This variable holds what Strerrr is defined as to translate an error
1439         code condition into an error message string. It could be 'strerror'
1440         or a more complex macro emulating strrror with sys_errlist[], or the
1441         "unknown" string when both strerror and sys_errlist are missing.
1442
1443 d_strerror (d_strerror.U):
1444         This variable conditionally defines HAS_STRERROR if strerror() is
1445         available to translate error numbers to strings.
1446
1447 d_strtod (d_strtod.U):
1448         This variable conditionally defines the HAS_STRTOD symbol, which
1449         indicates to the C program that the strtod() routine is available
1450         to provide better numeric string conversion than atof().
1451
1452 d_strtol (d_strtol.U):
1453         This variable conditionally defines the HAS_STRTOL symbol, which
1454         indicates to the C program that the strtol() routine is available
1455         to provide better numeric string conversion than atoi() and friends.
1456
1457 d_strtold (d_strtold.U):
1458         This variable conditionally defines the HAS_STRTOLD symbol, which
1459         indicates to the C program that the strtold() routine is available.
1460
1461 d_strtoll (d_strtoll.U):
1462         This variable conditionally defines the HAS_STRTOLL symbol, which
1463         indicates to the C program that the strtoll() routine is available.
1464
1465 d_strtoul (d_strtoul.U):
1466         This variable conditionally defines the HAS_STRTOUL symbol, which
1467         indicates to the C program that the strtoul() routine is available
1468         to provide conversion of strings to unsigned long.
1469
1470 d_strtoull (d_strtoull.U):
1471         This variable conditionally defines the HAS_STRTOULL symbol, which
1472         indicates to the C program that the strtoull() routine is available.
1473
1474 d_strtouq (d_strtouq.U):
1475         This variable conditionally defines the HAS_STRTOUQ symbol, which
1476         indicates to the C program that the strtouq() routine is available.
1477
1478 d_strxfrm (d_strxfrm.U):
1479         This variable conditionally defines HAS_STRXFRM if strxfrm() is
1480         available to transform strings.
1481
1482 d_suidsafe (d_dosuid.U):
1483         This variable conditionally defines SETUID_SCRIPTS_ARE_SECURE_NOW
1484         if setuid scripts can be secure.  This test looks in /dev/fd/.
1485
1486 d_symlink (d_symlink.U):
1487         This variable conditionally defines the HAS_SYMLINK symbol, which
1488         indicates to the C program that the symlink() routine is available
1489         to create symbolic links.
1490
1491 d_syscall (d_syscall.U):
1492         This variable conditionally defines HAS_SYSCALL if syscall() is
1493         available call arbitrary system calls.
1494
1495 d_sysconf (d_sysconf.U):
1496         This variable conditionally defines the HAS_SYSCONF symbol, which
1497         indicates to the C program that the sysconf() routine is available
1498         to determine system related limits and options.
1499
1500 d_sysernlst (d_strerror.U):
1501         This variable conditionally defines HAS_SYS_ERRNOLIST if sys_errnolist[]
1502         is available to translate error numbers to the symbolic name.
1503
1504 d_syserrlst (d_strerror.U):
1505         This variable conditionally defines HAS_SYS_ERRLIST if sys_errlist[] is
1506         available to translate error numbers to strings.
1507
1508 d_system (d_system.U):
1509         This variable conditionally defines HAS_SYSTEM if system() is
1510         available to issue a shell command.
1511
1512 d_tcgetpgrp (d_tcgtpgrp.U):
1513         This variable conditionally defines the HAS_TCGETPGRP symbol, which
1514         indicates to the C program that the tcgetpgrp() routine is available.
1515         to get foreground process group ID.
1516
1517 d_tcsetpgrp (d_tcstpgrp.U):
1518         This variable conditionally defines the HAS_TCSETPGRP symbol, which
1519         indicates to the C program that the tcsetpgrp() routine is available
1520         to set foreground process group ID.
1521
1522 d_telldir (d_readdir.U):
1523         This variable conditionally defines HAS_TELLDIR if telldir() is
1524         available.
1525
1526 d_telldirproto (d_telldirproto.U):
1527         This variable conditionally defines the HAS_TELLDIR_PROTO symbol,
1528         which indicates to the C program that the system provides
1529         a prototype for the telldir() function.  Otherwise, it is
1530         up to the program to supply one.
1531
1532 d_time (d_time.U):
1533         This variable conditionally defines the HAS_TIME symbol, which indicates
1534         that the time() routine exists.  The time() routine is normaly
1535         provided on UNIX systems.
1536
1537 d_times (d_times.U):
1538         This variable conditionally defines the HAS_TIMES symbol, which indicates
1539         that the times() routine exists.  The times() routine is normaly
1540         provided on UNIX systems. You may have to include <sys/times.h>.
1541
1542 d_truncate (d_truncate.U):
1543         This variable conditionally defines HAS_TRUNCATE if truncate() is
1544         available to truncate files.
1545
1546 d_tzname (d_tzname.U):
1547         This variable conditionally defines HAS_TZNAME if tzname[] is
1548         available to access timezone names.
1549
1550 d_umask (d_umask.U):
1551         This variable conditionally defines the HAS_UMASK symbol, which
1552         indicates to the C program that the umask() routine is available.
1553         to set and get the value of the file creation mask.
1554
1555 d_uname (d_gethname.U):
1556         This variable conditionally defines the HAS_UNAME symbol, which
1557         indicates to the C program that the uname() routine may be
1558         used to derive the host name.
1559
1560 d_union_semun (d_union_semun.U):
1561         This variable conditionally defines HAS_UNION_SEMUN if the
1562         union semun is defined by including <sys/sem.h>.
1563
1564 d_ustat (d_ustat.U):
1565         This variable conditionally defines HAS_USTAT if ustat() is
1566         available to query file system statistics by dev_t.
1567
1568 d_vendorbin (vendorbin.U):
1569         This variable conditionally defines PERL_VENDORBIN.
1570
1571 d_vendorlib (vendorlib.U):
1572         This variable conditionally defines PERL_VENDORLIB.
1573
1574 d_vfork (d_vfork.U):
1575         This variable conditionally defines the HAS_VFORK symbol, which
1576         indicates the vfork() routine is available.
1577
1578 d_void_closedir (d_closedir.U):
1579         This variable conditionally defines VOID_CLOSEDIR if closedir()
1580         does not return a value.
1581
1582 d_voidsig (d_voidsig.U):
1583         This variable conditionally defines VOIDSIG if this system
1584         declares "void (*signal(...))()" in signal.h.  The old way was to
1585         declare it as "int (*signal(...))()".
1586
1587 d_voidtty (i_sysioctl.U):
1588         This variable conditionally defines USE_IOCNOTTY to indicate that the
1589         ioctl() call with TIOCNOTTY should be used to void tty association.
1590         Otherwise (on USG probably), it is enough to close the standard file
1591         decriptors and do a setpgrp().
1592
1593 d_volatile (d_volatile.U):
1594         This variable conditionally defines the HASVOLATILE symbol, which
1595         indicates to the C program that this C compiler knows about the
1596         volatile declaration.
1597
1598 d_vprintf (d_vprintf.U):
1599         This variable conditionally defines the HAS_VPRINTF symbol, which
1600         indicates to the C program that the vprintf() routine is available
1601         to printf with a pointer to an argument list.
1602
1603 d_wait4 (d_wait4.U):
1604         This variable conditionally defines the HAS_WAIT4 symbol, which
1605         indicates the wait4() routine is available.
1606
1607 d_waitpid (d_waitpid.U):
1608         This variable conditionally defines HAS_WAITPID if waitpid() is
1609         available to wait for child process.
1610
1611 d_wcstombs (d_wcstombs.U):
1612         This variable conditionally defines the HAS_WCSTOMBS symbol, which
1613         indicates to the C program that the wcstombs() routine is available
1614         to convert wide character strings to multibyte strings.
1615
1616 d_wctomb (d_wctomb.U):
1617         This variable conditionally defines the HAS_WCTOMB symbol, which
1618         indicates to the C program that the wctomb() routine is available
1619         to convert a wide character to a multibyte.
1620
1621 d_xenix (Guess.U):
1622         This variable conditionally defines the symbol XENIX, which alerts
1623         the C program that it runs under Xenix.
1624
1625 date (Loc.U):
1626         This variable is used internally by Configure to determine the
1627         full pathname (if any) of the date program.  After Configure runs,
1628         the value is reset to a plain "date" and is not useful.
1629
1630 db_hashtype (i_db.U):
1631         This variable contains the type of the hash structure element
1632         in the <db.h> header file.  In older versions of DB, it was
1633         int, while in newer ones it is u_int32_t.
1634
1635 db_prefixtype (i_db.U):
1636         This variable contains the type of the prefix structure element
1637         in the <db.h> header file.  In older versions of DB, it was
1638         int, while in newer ones it is size_t.
1639
1640 defvoidused (voidflags.U):
1641         This variable contains the default value of the VOIDUSED symbol (15).
1642
1643 direntrytype (i_dirent.U):
1644         This symbol is set to 'struct direct' or 'struct dirent' depending on
1645         whether dirent is available or not. You should use this pseudo type to
1646         portably declare your directory entries.
1647
1648 dlext (dlext.U):
1649         This variable contains the extension that is to be used for the
1650         dynamically loaded modules that perl generaties.
1651
1652 dlsrc (dlsrc.U):
1653         This variable contains the name of the dynamic loading file that
1654         will be used with the package.
1655
1656 doublesize (doublesize.U):
1657         This variable contains the value of the DOUBLESIZE symbol, which
1658         indicates to the C program how many bytes there are in a double.
1659
1660 drand01 (randfunc.U):
1661         Indicates the macro to be used to generate normalized
1662         random numbers.  Uses randfunc, often divided by
1663         (double) (((unsigned long) 1 << randbits)) in order to
1664         normalize the result.
1665         In C programs, the macro 'Drand01' is mapped to drand01.
1666
1667 dynamic_ext (Extensions.U):
1668         This variable holds a list of XS extension files we want to
1669         link dynamically into the package.  It is used by Makefile.
1670
1671 eagain (nblock_io.U):
1672         This variable bears the symbolic errno code set by read() when no
1673         data is present on the file and non-blocking I/O was enabled (otherwise,
1674         read() blocks naturally).
1675
1676 ebcdic (ebcdic.U):
1677         This variable conditionally defines EBCDIC if this
1678         system uses EBCDIC encoding.  Among other things, this
1679         means that the character ranges are not contiguous.
1680         See trnl.U
1681
1682 echo (Loc.U):
1683         This variable is used internally by Configure to determine the
1684         full pathname (if any) of the echo program.  After Configure runs,
1685         the value is reset to a plain "echo" and is not useful.
1686
1687 egrep (Loc.U):
1688         This variable is used internally by Configure to determine the
1689         full pathname (if any) of the egrep program.  After Configure runs,
1690         the value is reset to a plain "egrep" and is not useful.
1691
1692 emacs (Loc.U):
1693         This variable is defined but not used by Configure.
1694         The value is a plain '' and is not useful.
1695
1696 eunicefix (Init.U):
1697         When running under Eunice this variable contains a command which will
1698         convert a shell script to the proper form of text file for it to be
1699         executable by the shell.  On other systems it is a no-op.
1700
1701 exe_ext (Unix.U):
1702         This is an old synonym for _exe.
1703
1704 expr (Loc.U):
1705         This variable is used internally by Configure to determine the
1706         full pathname (if any) of the expr program.  After Configure runs,
1707         the value is reset to a plain "expr" and is not useful.
1708
1709 extensions (Extensions.U):
1710         This variable holds a list of all extension files (both XS and
1711         non-xs linked into the package.  It is propagated to Config.pm
1712         and is typically used to test whether a particular extesion 
1713         is available.
1714
1715 fflushall (fflushall.U):
1716         This symbol, if defined, tells that to flush
1717         all pending stdio output one must loop through all
1718         the stdio file handles stored in an array and fflush them.
1719         Note that if fflushNULL is defined, fflushall will not
1720         even be probed for and will be left undefined.
1721
1722 fflushNULL (fflushall.U):
1723         This symbol, if defined, tells that fflush(NULL) does flush
1724         all pending stdio output.
1725
1726 find (Loc.U):
1727         This variable is defined but not used by Configure.
1728         The value is a plain '' and is not useful.
1729
1730 firstmakefile (Unix.U):
1731         This variable defines the first file searched by make.  On unix,
1732         it is makefile (then Makefile).  On case-insensitive systems,
1733         it might be something else.  This is only used to deal with
1734         convoluted make depend tricks.
1735
1736 flex (Loc.U):
1737         This variable is defined but not used by Configure.
1738         The value is a plain '' and is not useful.
1739
1740 fpossize (fpossize.U):
1741         This variable contains the size of a fpostype in bytes.
1742
1743 fpostype (fpostype.U):
1744         This variable defines Fpos_t to be something like fpos_t, long, 
1745         uint, or whatever type is used to declare file positions in libc.
1746
1747 freetype (mallocsrc.U):
1748         This variable contains the return type of free().  It is usually
1749         void, but occasionally int.
1750
1751 full_ar (Loc_ar.U):
1752         This variable contains the full pathname to 'ar', whether or
1753         not the user has specified 'portability'.  This is only used
1754         in the Makefile.SH.
1755
1756 full_csh (d_csh.U):
1757         This variable contains the full pathname to 'csh', whether or
1758         not the user has specified 'portability'.  This is only used
1759         in the compiled C program, and we assume that all systems which
1760         can share this executable will have the same full pathname to
1761         'csh.'
1762
1763 full_sed (Loc_sed.U):
1764         This variable contains the full pathname to 'sed', whether or
1765         not the user has specified 'portability'.  This is only used
1766         in the compiled C program, and we assume that all systems which
1767         can share this executable will have the same full pathname to
1768         'sed.'
1769
1770 gccversion (cc.U):
1771         If GNU cc (gcc) is used, this variable holds '1' or '2' to 
1772         indicate whether the compiler is version 1 or 2.  This is used in
1773         setting some of the default cflags.  It is set to '' if not gcc.
1774
1775 gidformat (gidf.U):
1776         This variable contains the format string used for printing a Gid_t.
1777
1778 gidsign (gidsign.U):
1779         This variable contains the signedness of a gidtype.
1780         1 for unsigned, -1 for signed.
1781
1782 gidsize (gidsize.U):
1783         This variable contains the size of a gidtype in bytes.
1784
1785 gidtype (gidtype.U):
1786         This variable defines Gid_t to be something like gid_t, int,
1787         ushort, or whatever type is used to declare the return type
1788         of getgid().  Typically, it is the type of group ids in the kernel.
1789
1790 glibpth (libpth.U):
1791         This variable holds the general path (space-separated) used to
1792         find libraries.  It may contain directories that do not exist on
1793         this platform, libpth is the cleaned-up version.
1794
1795 grep (Loc.U):
1796         This variable is used internally by Configure to determine the
1797         full pathname (if any) of the grep program.  After Configure runs,
1798         the value is reset to a plain "grep" and is not useful.
1799
1800 groupcat (nis.U):
1801         This variable contains a command that produces the text of the
1802         /etc/group file.  This is normally "cat /etc/group", but can be
1803         "ypcat group" when NIS is used.
1804         On some systems, such as os390, there may be no equivalent
1805         command, in which case this variable is unset.
1806
1807 groupstype (groupstype.U):
1808         This variable defines Groups_t to be something like gid_t, int, 
1809         ushort, or whatever type is used for the second argument to
1810         getgroups() and setgroups().  Usually, this is the same as
1811         gidtype (gid_t), but sometimes it isn't.
1812
1813 gzip (Loc.U):
1814         This variable is used internally by Configure to determine the
1815         full pathname (if any) of the gzip program.  After Configure runs,
1816         the value is reset to a plain "gzip" and is not useful.
1817
1818 h_fcntl (h_fcntl.U):
1819         This is variable gets set in various places to tell i_fcntl that
1820         <fcntl.h> should be included.
1821
1822 h_sysfile (h_sysfile.U):
1823         This is variable gets set in various places to tell i_sys_file that
1824         <sys/file.h> should be included.
1825
1826 hint (Oldconfig.U):
1827         Gives the type of hints used for previous answers. May be one of
1828         "default", "recommended" or "previous".
1829
1830 hostcat (nis.U):
1831         This variable contains a command that produces the text of the
1832         /etc/hosts file.  This is normally "cat /etc/hosts", but can be
1833         "ypcat hosts" when NIS is used.
1834         On some systems, such as os390, there may be no equivalent
1835         command, in which case this variable is unset.
1836
1837 huge (models.U):
1838         This variable contains a flag which will tell the C compiler and loader
1839         to produce a program running with a huge memory model.  If the
1840         huge model is not supported, contains the flag to produce large
1841         model programs.  It is up to the Makefile to use this.
1842
1843 i16size (perlxv.U):
1844         This variable is the size of an I16 in bytes.
1845
1846 i16type (perlxv.U):
1847         This variable contains the C type used for Perl's I16.
1848
1849 i32size (perlxv.U):
1850         This variable is the size of an I32 in bytes.
1851
1852 i32type (perlxv.U):
1853         This variable contains the C type used for Perl's I32.
1854
1855 i64size (perlxv.U):
1856         This variable is the size of an I64 in bytes.
1857
1858 i64type (perlxv.U):
1859         This variable contains the C type used for Perl's I64.
1860
1861 i8size (perlxv.U):
1862         This variable is the size of an I8 in bytes.
1863
1864 i8type (perlxv.U):
1865         This variable contains the C type used for Perl's I8.
1866
1867 i_arpainet (i_arpainet.U):
1868         This variable conditionally defines the I_ARPA_INET symbol,
1869         and indicates whether a C program should include <arpa/inet.h>.
1870
1871 i_bsdioctl (i_sysioctl.U):
1872         This variable conditionally defines the I_SYS_BSDIOCTL symbol, which
1873         indicates to the C program that <sys/bsdioctl.h> exists and should
1874         be included.
1875
1876 i_db (i_db.U):
1877         This variable conditionally defines the I_DB symbol, and indicates
1878         whether a C program may include Berkeley's DB include file <db.h>.
1879
1880 i_dbm (i_dbm.U):
1881         This variable conditionally defines the I_DBM symbol, which
1882         indicates to the C program that <dbm.h> exists and should
1883         be included.
1884
1885 i_dirent (i_dirent.U):
1886         This variable conditionally defines I_DIRENT, which indicates
1887         to the C program that it should include <dirent.h>.
1888
1889 i_dld (i_dld.U):
1890         This variable conditionally defines the I_DLD symbol, which
1891         indicates to the C program that <dld.h> (GNU dynamic loading)
1892         exists and should be included.
1893
1894 i_dlfcn (i_dlfcn.U):
1895         This variable conditionally defines the I_DLFCN symbol, which
1896         indicates to the C program that <dlfcn.h> exists and should
1897         be included.
1898
1899 i_fcntl (i_fcntl.U):
1900         This variable controls the value of I_FCNTL (which tells
1901         the C program to include <fcntl.h>).
1902
1903 i_float (i_float.U):
1904         This variable conditionally defines the I_FLOAT symbol, and indicates
1905         whether a C program may include <float.h> to get symbols like DBL_MAX
1906         or DBL_MIN, i.e. machine dependent floating point values.
1907
1908 i_gdbm (i_gdbm.U):
1909         This variable conditionally defines the I_GDBM symbol, which
1910         indicates to the C program that <gdbm.h> exists and should
1911         be included.
1912
1913 i_grp (i_grp.U):
1914         This variable conditionally defines the I_GRP symbol, and indicates
1915         whether a C program should include <grp.h>.
1916
1917 i_iconv (i_iconv.U):
1918         This variable conditionally defines the I_ICONV symbol, and indicates
1919         whether a C program should include <iconv.h>.
1920
1921 i_inttypes (i_inttypes.U):
1922         This variable conditionally defines the I_INTTYPES symbol,
1923         and indicates whether a C program should include <inttypes.h>.
1924
1925 i_limits (i_limits.U):
1926         This variable conditionally defines the I_LIMITS symbol, and indicates
1927         whether a C program may include <limits.h> to get symbols like WORD_BIT
1928         and friends.
1929
1930 i_locale (i_locale.U):
1931         This variable conditionally defines the I_LOCALE symbol,
1932         and indicates whether a C program should include <locale.h>.
1933
1934 i_machcthr (i_machcthr.U):
1935         This variable conditionally defines the I_MACH_CTHREADS symbol,
1936         and indicates whether a C program should include <mach/cthreads.h>.
1937
1938 i_malloc (i_malloc.U):
1939         This variable conditionally defines the I_MALLOC symbol, and indicates
1940         whether a C program should include <malloc.h>.
1941
1942 i_math (i_math.U):
1943         This variable conditionally defines the I_MATH symbol, and indicates
1944         whether a C program may include <math.h>.
1945
1946 i_memory (i_memory.U):
1947         This variable conditionally defines the I_MEMORY symbol, and indicates
1948         whether a C program should include <memory.h>.
1949
1950 i_mntent (i_mntent.U):
1951         This variable conditionally defines the I_MNTENT symbol, and indicates
1952         whether a C program should include <mntent.h>.
1953
1954 i_ndbm (i_ndbm.U):
1955         This variable conditionally defines the I_NDBM symbol, which
1956         indicates to the C program that <ndbm.h> exists and should
1957         be included.
1958
1959 i_netdb (i_netdb.U):
1960         This variable conditionally defines the I_NETDB symbol, and indicates
1961         whether a C program should include <netdb.h>.
1962
1963 i_neterrno (i_neterrno.U):
1964         This variable conditionally defines the I_NET_ERRNO symbol, which
1965         indicates to the C program that <net/errno.h> exists and should
1966         be included.
1967
1968 i_netinettcp (i_netinettcp.U):
1969         This variable conditionally defines the I_NETINET_TCP symbol,
1970         and indicates whether a C program should include <netinet/tcp.h>.
1971
1972 i_niin (i_niin.U):
1973         This variable conditionally defines I_NETINET_IN, which indicates
1974         to the C program that it should include <netinet/in.h>. Otherwise,
1975         you may try <sys/in.h>.
1976
1977 i_poll (i_poll.U):
1978         This variable conditionally defines the I_POLL symbol, and indicates
1979         whether a C program should include <poll.h>.
1980
1981 i_pthread (i_pthread.U):
1982         This variable conditionally defines the I_PTHREAD symbol,
1983         and indicates whether a C program should include <pthread.h>.
1984
1985 i_pwd (i_pwd.U):
1986         This variable conditionally defines I_PWD, which indicates
1987         to the C program that it should include <pwd.h>.
1988
1989 i_rpcsvcdbm (i_dbm.U):
1990         This variable conditionally defines the I_RPCSVC_DBM symbol, which
1991         indicates to the C program that <rpcsvc/dbm.h> exists and should
1992         be included.  Some System V systems might need this instead of <dbm.h>.
1993
1994 i_sfio (i_sfio.U):
1995         This variable conditionally defines the I_SFIO symbol,
1996         and indicates whether a C program should include <sfio.h>.
1997
1998 i_sgtty (i_termio.U):
1999         This variable conditionally defines the I_SGTTY symbol, which
2000         indicates to the C program that it should include <sgtty.h> rather
2001         than <termio.h>.
2002
2003 i_shadow (i_shadow.U):
2004         This variable conditionally defines the I_SHADOW symbol, and indicates
2005         whether a C program should include <shadow.h>.
2006
2007 i_socks (i_socks.U):
2008         This variable conditionally defines the I_SOCKS symbol, and indicates
2009         whether a C program should include <socks.h>.
2010
2011 i_stdarg (i_varhdr.U):
2012         This variable conditionally defines the I_STDARG symbol, which
2013         indicates to the C program that <stdarg.h> exists and should
2014         be included.
2015
2016 i_stddef (i_stddef.U):
2017         This variable conditionally defines the I_STDDEF symbol, which
2018         indicates to the C program that <stddef.h> exists and should
2019         be included.
2020
2021 i_stdlib (i_stdlib.U):
2022         This variable conditionally defines the I_STDLIB symbol, which
2023         indicates to the C program that <stdlib.h> exists and should
2024         be included.
2025
2026 i_string (i_string.U):
2027         This variable conditionally defines the I_STRING symbol, which
2028         indicates that <string.h> should be included rather than <strings.h>.
2029
2030 i_sysaccess (i_sysaccess.U):
2031         This variable conditionally defines the I_SYS_ACCESS symbol,
2032         and indicates whether a C program should include <sys/access.h>.
2033
2034 i_sysdir (i_sysdir.U):
2035         This variable conditionally defines the I_SYS_DIR symbol, and indicates
2036         whether a C program should include <sys/dir.h>.
2037
2038 i_sysfile (i_sysfile.U):
2039         This variable conditionally defines the I_SYS_FILE symbol, and indicates
2040         whether a C program should include <sys/file.h> to get R_OK and friends.
2041
2042 i_sysfilio (i_sysioctl.U):
2043         This variable conditionally defines the I_SYS_FILIO symbol, which
2044         indicates to the C program that <sys/filio.h> exists and should
2045         be included in preference to <sys/ioctl.h>.
2046
2047 i_sysin (i_niin.U):
2048         This variable conditionally defines I_SYS_IN, which indicates
2049         to the C program that it should include <sys/in.h> instead of
2050         <netinet/in.h>.
2051
2052 i_sysioctl (i_sysioctl.U):
2053         This variable conditionally defines the I_SYS_IOCTL symbol, which
2054         indicates to the C program that <sys/ioctl.h> exists and should
2055         be included.
2056
2057 i_syslog (i_syslog.U):
2058         This variable conditionally defines the I_SYSLOG symbol,
2059         and indicates whether a C program should include <syslog.h>.
2060
2061 i_sysmman (i_sysmman.U):
2062         This variable conditionally defines the I_SYS_MMAN symbol, and
2063         indicates whether a C program should include <sys/mman.h>.
2064
2065 i_sysmode (i_sysmode.U):
2066         This variable conditionally defines the I_SYSMODE symbol,
2067         and indicates whether a C program should include <sys/mode.h>.
2068
2069 i_sysmount (i_sysmount.U):
2070         This variable conditionally defines the I_SYSMOUNT symbol,
2071         and indicates whether a C program should include <sys/mount.h>.
2072
2073 i_sysndir (i_sysndir.U):
2074         This variable conditionally defines the I_SYS_NDIR symbol, and indicates
2075         whether a C program should include <sys/ndir.h>.
2076
2077 i_sysparam (i_sysparam.U):
2078         This variable conditionally defines the I_SYS_PARAM symbol, and indicates
2079         whether a C program should include <sys/param.h>.
2080
2081 i_sysresrc (i_sysresrc.U):
2082         This variable conditionally defines the I_SYS_RESOURCE symbol,
2083         and indicates whether a C program should include <sys/resource.h>.
2084
2085 i_syssecrt (i_syssecrt.U):
2086         This variable conditionally defines the I_SYS_SECURITY symbol,
2087         and indicates whether a C program should include <sys/security.h>.
2088
2089 i_sysselct (i_sysselct.U):
2090         This variable conditionally defines I_SYS_SELECT, which indicates
2091         to the C program that it should include <sys/select.h> in order to
2092         get the definition of struct timeval.
2093
2094 i_syssockio (i_sysioctl.U):
2095         This variable conditionally defines I_SYS_SOCKIO to indicate to the
2096         C program that socket ioctl codes may be found in <sys/sockio.h>
2097         instead of <sys/ioctl.h>.
2098
2099 i_sysstat (i_sysstat.U):
2100         This variable conditionally defines the I_SYS_STAT symbol,
2101         and indicates whether a C program should include <sys/stat.h>.
2102
2103 i_sysstatfs (i_sysstatfs.U):
2104         This variable conditionally defines the I_SYSSTATFS symbol,
2105         and indicates whether a C program should include <sys/statfs.h>.
2106
2107 i_sysstatvfs (i_sysstatvfs.U):
2108         This variable conditionally defines the I_SYSSTATVFS symbol,
2109         and indicates whether a C program should include <sys/statvfs.h>.
2110
2111 i_systime (i_time.U):
2112         This variable conditionally defines I_SYS_TIME, which indicates
2113         to the C program that it should include <sys/time.h>.
2114
2115 i_systimek (i_time.U):
2116         This variable conditionally defines I_SYS_TIME_KERNEL, which
2117         indicates to the C program that it should include <sys/time.h>
2118         with KERNEL defined.
2119
2120 i_systimes (i_systimes.U):
2121         This variable conditionally defines the I_SYS_TIMES symbol, and indicates
2122         whether a C program should include <sys/times.h>.
2123
2124 i_systypes (i_systypes.U):
2125         This variable conditionally defines the I_SYS_TYPES symbol,
2126         and indicates whether a C program should include <sys/types.h>.
2127
2128 i_sysuio (i_sysuio.U):
2129         This variable conditionally defines the I_SYSUIO symbol, and indicates
2130         whether a C program should include <sys/uio.h>.
2131
2132 i_sysun (i_sysun.U):
2133         This variable conditionally defines I_SYS_UN, which indicates
2134         to the C program that it should include <sys/un.h> to get UNIX
2135         domain socket definitions.
2136
2137 i_sysutsname (i_sysutsname.U):
2138         This variable conditionally defines the I_SYSUTSNAME symbol,
2139         and indicates whether a C program should include <sys/utsname.h>.
2140
2141 i_sysvfs (i_sysvfs.U):
2142         This variable conditionally defines the I_SYSVFS symbol,
2143         and indicates whether a C program should include <sys/vfs.h>.
2144
2145 i_syswait (i_syswait.U):
2146         This variable conditionally defines I_SYS_WAIT, which indicates
2147         to the C program that it should include <sys/wait.h>.
2148
2149 i_termio (i_termio.U):
2150         This variable conditionally defines the I_TERMIO symbol, which
2151         indicates to the C program that it should include <termio.h> rather
2152         than <sgtty.h>.
2153
2154 i_termios (i_termio.U):
2155         This variable conditionally defines the I_TERMIOS symbol, which
2156         indicates to the C program that the POSIX <termios.h> file is
2157         to be included.
2158
2159 i_time (i_time.U):
2160         This variable conditionally defines I_TIME, which indicates
2161         to the C program that it should include <time.h>.
2162
2163 i_unistd (i_unistd.U):
2164         This variable conditionally defines the I_UNISTD symbol, and indicates
2165         whether a C program should include <unistd.h>.
2166
2167 i_ustat (i_ustat.U):
2168         This variable conditionally defines the I_USTAT symbol, and indicates
2169         whether a C program should include <ustat.h>.
2170
2171 i_utime (i_utime.U):
2172         This variable conditionally defines the I_UTIME symbol, and indicates
2173         whether a C program should include <utime.h>.
2174
2175 i_values (i_values.U):
2176         This variable conditionally defines the I_VALUES symbol, and indicates
2177         whether a C program may include <values.h> to get symbols like MAXLONG
2178         and friends.
2179
2180 i_varargs (i_varhdr.U):
2181         This variable conditionally defines I_VARARGS, which indicates
2182         to the C program that it should include <varargs.h>.
2183
2184 i_varhdr (i_varhdr.U):
2185         Contains the name of the header to be included to get va_dcl definition.
2186         Typically one of varargs.h or stdarg.h.
2187
2188 i_vfork (i_vfork.U):
2189         This variable conditionally defines the I_VFORK symbol, and indicates
2190         whether a C program should include vfork.h.
2191
2192 ignore_versioned_solibs (libs.U):
2193         This variable should be non-empty if non-versioned shared
2194         libraries (libfoo.so.x.y) are to be ignored (because they
2195         cannot be linked against).
2196
2197 inc_version_list (inc_version_list.U):
2198         This variable specifies the list of subdirectories in over
2199         which perl.c:incpush() and lib/lib.pm will automatically
2200         search when adding directories to @INC.  The elements in
2201         the list are separated by spaces.  This is only useful
2202         if you have a perl library directory tree structured like the
2203         default one.  See INSTALL for how this works.  The versioned
2204         site_perl directory was introduced in 5.005, so that is the
2205         lowest possible value.
2206
2207 inc_version_list_init (inc_version_list.U):
2208         This variable holds the same list as inc_version_list, but
2209         each item is enclosed in double quotes and separated by commas, 
2210         suitable for use in the PERL_INC_VERSION_LIST initialization.
2211
2212 incpath (usrinc.U):
2213         This variable must preceed the normal include path to get hte
2214         right one, as in "$incpath/usr/include" or "$incpath/usr/lib".
2215         Value can be "" or "/bsd43" on mips.
2216
2217 inews (Loc.U):
2218         This variable is defined but not used by Configure.
2219         The value is a plain '' and is not useful.
2220
2221 installarchlib (archlib.U):
2222         This variable is really the same as archlibexp but may differ on
2223         those systems using AFS. For extra portability, only this variable
2224         should be used in makefiles.
2225
2226 installbin (bin.U):
2227         This variable is the same as binexp unless AFS is running in which case
2228         the user is explicitely prompted for it. This variable should always
2229         be used in your makefiles for maximum portability.
2230
2231 installman1dir (man1dir.U):
2232         This variable is really the same as man1direxp, unless you are using
2233         AFS in which case it points to the read/write location whereas
2234         man1direxp only points to the read-only access location. For extra
2235         portability, you should only use this variable within your makefiles.
2236
2237 installman3dir (man3dir.U):
2238         This variable is really the same as man3direxp, unless you are using
2239         AFS in which case it points to the read/write location whereas
2240         man3direxp only points to the read-only access location. For extra
2241         portability, you should only use this variable within your makefiles.
2242
2243 installprefix (installprefix.U):
2244         This variable holds the name of the directory below which 
2245         "make install" will install the package.  For most users, this
2246         is the same as prefix.  However, it is useful for
2247         installing the software into a different (usually temporary)
2248         location after which it can be bundled up and moved somehow
2249         to the final location specified by prefix.
2250
2251 installprefixexp (installprefix.U):
2252         This variable holds the full absolute path of installprefix
2253         with all ~-expansion done.
2254
2255 installprivlib (privlib.U):
2256         This variable is really the same as privlibexp but may differ on
2257         those systems using AFS. For extra portability, only this variable
2258         should be used in makefiles.
2259
2260 installscript (scriptdir.U):
2261         This variable is usually the same as scriptdirexp, unless you are on
2262         a system running AFS, in which case they may differ slightly. You
2263         should always use this variable within your makefiles for portability.
2264
2265 installsitearch (sitearch.U):
2266         This variable is really the same as sitearchexp but may differ on
2267         those systems using AFS. For extra portability, only this variable
2268         should be used in makefiles.
2269
2270 installsitebin (sitebin.U):
2271         This variable is usually the same as sitebinexp, unless you are on
2272         a system running AFS, in which case they may differ slightly. You
2273         should always use this variable within your makefiles for portability.
2274
2275 installsitelib (sitelib.U):
2276         This variable is really the same as sitelibexp but may differ on
2277         those systems using AFS. For extra portability, only this variable
2278         should be used in makefiles.
2279
2280 installstyle (installstyle.U):
2281         This variable describes the "style" of the perl installation.
2282         This is intended to be useful for tools that need to
2283         manipulate entire perl distributions.  Perl itself doesn't use
2284         this to find its libraries -- the library directories are
2285         stored directly in Config.pm.  Currently, there are only two
2286         styles:  "lib" and "lib/perl5".  The default library locations
2287         (e.g. privlib, sitelib) are either $prefix/lib or
2288         $prefix/lib/perl5.  The former is useful if $prefix is a
2289         directory dedicated to perl (e.g. /opt/perl), while the latter
2290         is useful if $prefix is shared by many packages, e.g. if
2291         $prefix=/usr/local.
2292                 This may later be extended to include other information, so
2293         be careful with pattern-matching on the results.
2294                 For compatibility with perl5.005 and earlier, the default
2295         setting is based on whether or not $prefix contains the string
2296         "perl".
2297
2298 installusrbinperl (instubperl.U):
2299         This variable tells whether Perl should be installed also as
2300         /usr/bin/perl in addition to
2301         $installbin/perl
2302
2303 installvendorbin (vendorbin.U):
2304         This variable is really the same as vendorbinexp but may differ on
2305         those systems using AFS. For extra portability, only this variable
2306         should be used in makefiles.
2307
2308 installvendorlib (vendorlib.U):
2309         This variable is really the same as vendorlibexp but may differ on
2310         those systems using AFS. For extra portability, only this variable
2311         should be used in makefiles.
2312
2313 intsize (intsize.U):
2314         This variable contains the value of the INTSIZE symbol, which
2315         indicates to the C program how many bytes there are in an int.
2316
2317 ivdformat (perlxvf.U):
2318         This variable contains the format string used for printing
2319         a Perl IV as a signed decimal integer. 
2320
2321 ivsize (perlxv.U):
2322         This variable is the size of an IV in bytes.
2323
2324 ivtype (perlxv.U):
2325         This variable contains the C type used for Perl's IV.
2326
2327 known_extensions (Extensions.U):
2328         This variable holds a list of all XS extensions included in 
2329         the package.
2330
2331 ksh (Loc.U):
2332         This variable is defined but not used by Configure.
2333         The value is a plain '' and is not useful.
2334
2335 large (models.U):
2336         This variable contains a flag which will tell the C compiler and loader
2337         to produce a program running with a large memory model.  It is up to
2338         the Makefile to use this.
2339
2340 ld (dlsrc.U):
2341         This variable indicates the program to be used to link
2342         libraries for dynamic loading.  On some systems, it is 'ld'.
2343         On ELF systems, it should be $cc.  Mostly, we'll try to respect
2344         the hint file setting.
2345
2346 lddlflags (dlsrc.U):
2347         This variable contains any special flags that might need to be
2348         passed to $ld to create a shared library suitable for dynamic
2349         loading.  It is up to the makefile to use it.  For hpux, it
2350         should be '-b'.  For sunos 4.1, it is empty.
2351
2352 ldflags (ccflags.U):
2353         This variable contains any additional C loader flags desired by
2354         the user.  It is up to the Makefile to use this.
2355
2356 ldlibpthname (libperl.U):
2357         This variable holds the name of the shared library
2358         search path, often LD_LIBRARY_PATH.  To get an empty
2359         string, the hints file must set this to 'none'.
2360
2361 less (Loc.U):
2362         This variable is used internally by Configure to determine the
2363         full pathname (if any) of the less program.  After Configure runs,
2364         the value is reset to a plain "less" and is not useful.
2365
2366 lib_ext (Unix.U):
2367         This is an old synonym for _a.
2368
2369 libc (libc.U):
2370         This variable contains the location of the C library.
2371
2372 libperl (libperl.U):
2373         The perl executable is obtained by linking perlmain.c with
2374         libperl, any static extensions (usually just DynaLoader),
2375         and any other libraries needed on this system.  libperl
2376         is usually libperl.a, but can also be libperl.so.xxx if
2377         the user wishes to build a perl executable with a shared
2378         library.
2379
2380 libpth (libpth.U):
2381         This variable holds the general path (space-separated) used to find
2382         libraries. It is intended to be used by other units.
2383
2384 libs (libs.U):
2385         This variable holds the additional libraries we want to use.
2386         It is up to the Makefile to deal with it.
2387
2388 libsdirs (libs.U):
2389         This variable holds the directory names aka dirnames of the libraries
2390         we found and accepted, duplicates are removed.
2391
2392 libsfiles (libs.U):
2393         This variable holds the filenames aka basenames of the libraries
2394         we found and accepted.
2395
2396 libsfound (libs.U):
2397         This variable holds the full pathnames of the libraries
2398         we found and accepted.
2399
2400 libspath (libs.U):
2401         This variable holds the directory names probed for libraries.
2402
2403 libswanted (Myinit.U):
2404         This variable holds a list of all the libraries we want to
2405         search.  The order is chosen to pick up the c library
2406         ahead of ucb or bsd libraries for SVR4.
2407
2408 line (Loc.U):
2409         This variable is defined but not used by Configure.
2410         The value is a plain '' and is not useful.
2411
2412 lint (Loc.U):
2413         This variable is defined but not used by Configure.
2414         The value is a plain '' and is not useful.
2415
2416 lkflags (ccflags.U):
2417         This variable contains any additional C partial linker flags desired by
2418         the user.  It is up to the Makefile to use this.
2419
2420 ln (Loc.U):
2421         This variable is used internally by Configure to determine the
2422         full pathname (if any) of the ln program.  After Configure runs,
2423         the value is reset to a plain "ln" and is not useful.
2424
2425 lns (lns.U):
2426         This variable holds the name of the command to make 
2427         symbolic links (if they are supported).  It can be used
2428         in the Makefile. It is either 'ln -s' or 'ln'
2429
2430 locincpth (ccflags.U):
2431         This variable contains a list of additional directories to be
2432         searched by the compiler.  The appropriate '-I' directives will
2433         be added to ccflags.  This is intended to simplify setting
2434         local directories from the Configure command line.
2435         It's not much, but it parallels the loclibpth stuff in libpth.U.
2436
2437 loclibpth (libpth.U):
2438         This variable holds the paths (space-separated) used to find local
2439         libraries.  It is prepended to libpth, and is intended to be easily
2440         set from the command line.
2441
2442 longdblsize (d_longdbl.U):
2443         This variable contains the value of the LONG_DOUBLESIZE symbol, which
2444         indicates to the C program how many bytes there are in a long double,
2445         if this system supports long doubles.
2446
2447 longlongsize (d_longlong.U):
2448         This variable contains the value of the LONGLONGSIZE symbol, which
2449         indicates to the C program how many bytes there are in a long long,
2450         if this system supports long long.
2451
2452 longsize (intsize.U):
2453         This variable contains the value of the LONGSIZE symbol, which
2454         indicates to the C program how many bytes there are in a long.
2455
2456 lp (Loc.U):
2457         This variable is defined but not used by Configure.
2458         The value is a plain '' and is not useful.
2459
2460 lpr (Loc.U):
2461         This variable is defined but not used by Configure.
2462         The value is a plain '' and is not useful.
2463
2464 ls (Loc.U):
2465         This variable is used internally by Configure to determine the
2466         full pathname (if any) of the ls program.  After Configure runs,
2467         the value is reset to a plain "ls" and is not useful.
2468
2469 lseeksize (lseektype.U):
2470         This variable defines lseektype to be something like off_t, long, 
2471         or whatever type is used to declare lseek offset's type in the
2472         kernel (which also appears to be lseek's return type).
2473
2474 lseektype (lseektype.U):
2475         This variable defines lseektype to be something like off_t, long, 
2476         or whatever type is used to declare lseek offset's type in the
2477         kernel (which also appears to be lseek's return type).
2478
2479 mail (Loc.U):
2480         This variable is defined but not used by Configure.
2481         The value is a plain '' and is not useful.
2482
2483 mailx (Loc.U):
2484         This variable is defined but not used by Configure.
2485         The value is a plain '' and is not useful.
2486
2487 make (Loc.U):
2488         This variable is used internally by Configure to determine the
2489         full pathname (if any) of the make program.  After Configure runs,
2490         the value is reset to a plain "make" and is not useful.
2491
2492 make_set_make (make.U):
2493         Some versions of 'make' set the variable MAKE.  Others do not.
2494         This variable contains the string to be included in Makefile.SH
2495         so that MAKE is set if needed, and not if not needed.
2496         Possible values are:
2497         make_set_make='#'               # If your make program handles this for you,
2498         make_set_make="MAKE=$make"      # if it doesn't.
2499         I used a comment character so that we can distinguish a
2500         'set' value (from a previous config.sh or Configure '-D' option)
2501         from an uncomputed value.
2502
2503 mallocobj (mallocsrc.U):
2504         This variable contains the name of the malloc.o that this package
2505         generates, if that malloc.o is preferred over the system malloc.
2506         Otherwise the value is null.  This variable is intended for generating
2507         Makefiles.  See mallocsrc.
2508
2509 mallocsrc (mallocsrc.U):
2510         This variable contains the name of the malloc.c that comes with
2511         the package, if that malloc.c is preferred over the system malloc.
2512         Otherwise the value is null.  This variable is intended for generating
2513         Makefiles.
2514
2515 malloctype (mallocsrc.U):
2516         This variable contains the kind of ptr returned by malloc and realloc.
2517
2518 man1dir (man1dir.U):
2519         This variable contains the name of the directory in which manual
2520         source pages are to be put.  It is the responsibility of the
2521         Makefile.SH to get the value of this into the proper command.
2522         You must be prepared to do the ~name expansion yourself.
2523
2524 man1direxp (man1dir.U):
2525         This variable is the same as the man1dir variable, but is filename
2526         expanded at configuration time, for convenient use in makefiles.
2527
2528 man1ext (man1dir.U):
2529         This variable contains the extension that the manual page should
2530         have: one of 'n', 'l', or '1'.  The Makefile must supply the '.'.
2531         See man1dir.
2532
2533 man3dir (man3dir.U):
2534         This variable contains the name of the directory in which manual
2535         source pages are to be put.  It is the responsibility of the
2536         Makefile.SH to get the value of this into the proper command.
2537         You must be prepared to do the ~name expansion yourself.
2538
2539 man3direxp (man3dir.U):
2540         This variable is the same as the man3dir variable, but is filename
2541         expanded at configuration time, for convenient use in makefiles.
2542
2543 man3ext (man3dir.U):
2544         This variable contains the extension that the manual page should
2545         have: one of 'n', 'l', or '3'.  The Makefile must supply the '.'.
2546         See man3dir.
2547
2548 Mcc (Loc.U):
2549         This variable is used internally by Configure to determine the
2550         full pathname (if any) of the Mcc program.  After Configure runs,
2551         the value is reset to a plain "Mcc" and is not useful.
2552
2553 medium (models.U):
2554         This variable contains a flag which will tell the C compiler and loader
2555         to produce a program running with a medium memory model.  If the
2556         medium model is not supported, contains the flag to produce large
2557         model programs.  It is up to the Makefile to use this.
2558
2559 mips_type (usrinc.U):
2560         This variable holds the environment type for the mips system.
2561         Possible values are "BSD 4.3" and "System V".
2562
2563 mkdir (Loc.U):
2564         This variable is used internally by Configure to determine the
2565         full pathname (if any) of the mkdir program.  After Configure runs,
2566         the value is reset to a plain "mkdir" and is not useful.
2567
2568 mmaptype (d_mmap.U):
2569         This symbol contains the type of pointer returned by mmap()
2570         (and simultaneously the type of the first argument).
2571         It can be 'void *' or 'caddr_t'.
2572
2573 models (models.U):
2574         This variable contains the list of memory models supported by this
2575         system.  Possible component values are none, split, unsplit, small,
2576         medium, large, and huge.  The component values are space separated.
2577
2578 modetype (modetype.U):
2579         This variable defines modetype to be something like mode_t, 
2580         int, unsigned short, or whatever type is used to declare file 
2581         modes for system calls.
2582
2583 more (Loc.U):
2584         This variable is used internally by Configure to determine the
2585         full pathname (if any) of the more program.  After Configure runs,
2586         the value is reset to a plain "more" and is not useful.
2587
2588 multiarch (multiarch.U):
2589         This variable conditionally defines the MULTIARCH symbol
2590         which signifies the presence of multiplatform files.
2591         This is normally set by hints files.
2592
2593 mv (Loc.U):
2594         This variable is defined but not used by Configure.
2595         The value is a plain '' and is not useful.
2596
2597 myarchname (archname.U):
2598         This variable holds the architecture name computed by Configure in
2599         a previous run. It is not intended to be perused by any user and
2600         should never be set in a hint file.
2601
2602 mydomain (myhostname.U):
2603         This variable contains the eventual value of the MYDOMAIN symbol,
2604         which is the domain of the host the program is going to run on.
2605         The domain must be appended to myhostname to form a complete host name.
2606         The dot comes with mydomain, and need not be supplied by the program.
2607
2608 myhostname (myhostname.U):
2609         This variable contains the eventual value of the MYHOSTNAME symbol,
2610         which is the name of the host the program is going to run on.
2611         The domain is not kept with hostname, but must be gotten from mydomain.
2612         The dot comes with mydomain, and need not be supplied by the program.
2613
2614 myuname (Oldconfig.U):
2615         The output of 'uname -a' if available, otherwise the hostname. On Xenix,
2616         pseudo variables assignments in the output are stripped, thank you. The
2617         whole thing is then lower-cased.
2618
2619 n (n.U):
2620         This variable contains the '-n' flag if that is what causes the echo
2621         command to suppress newline.  Otherwise it is null.  Correct usage is
2622         $echo $n "prompt for a question: $c".
2623
2624 netdb_hlen_type (netdbtype.U):
2625         This variable holds the type used for the 2nd argument to
2626         gethostbyaddr().  Usually, this is int or size_t or unsigned.
2627         This is only useful if you have gethostbyaddr(), naturally.
2628
2629 netdb_host_type (netdbtype.U):
2630         This variable holds the type used for the 1st argument to
2631         gethostbyaddr().  Usually, this is char * or void *,  possibly
2632         with or without a const prefix.
2633         This is only useful if you have gethostbyaddr(), naturally.
2634
2635 netdb_name_type (netdbtype.U):
2636         This variable holds the type used for the argument to
2637         gethostbyname().  Usually, this is char * or const char *.
2638         This is only useful if you have gethostbyname(), naturally.
2639
2640 netdb_net_type (netdbtype.U):
2641         This variable holds the type used for the 1st argument to
2642         getnetbyaddr().  Usually, this is int or long.
2643         This is only useful if you have getnetbyaddr(), naturally.
2644
2645 nm (Loc.U):
2646         This variable is used internally by Configure to determine the
2647         full pathname (if any) of the nm program.  After Configure runs,
2648         the value is reset to a plain "nm" and is not useful.
2649
2650 nm_opt (usenm.U):
2651         This variable holds the options that may be necessary for nm.
2652
2653 nm_so_opt (usenm.U):
2654         This variable holds the options that may be necessary for nm
2655         to work on a shared library but that can not be used on an
2656         archive library.  Currently, this is only used by Linux, where
2657         nm --dynamic is *required* to get symbols from an ELF library which
2658         has been stripped, but nm --dynamic is *fatal* on an archive library.
2659         Maybe Linux should just always set usenm=false.
2660
2661 nonxs_ext (Extensions.U):
2662         This variable holds a list of all non-xs extensions included
2663         in the package.  All of them will be built.
2664
2665 nroff (Loc.U):
2666         This variable is used internally by Configure to determine the
2667         full pathname (if any) of the nroff program.  After Configure runs,
2668         the value is reset to a plain "nroff" and is not useful.
2669
2670 nvsize (perlxv.U):
2671         This variable is the size of an NV in bytes.
2672
2673 nvtype (perlxv.U):
2674         This variable contains the C type used for Perl's NV.
2675
2676 o_nonblock (nblock_io.U):
2677         This variable bears the symbol value to be used during open() or fcntl()
2678         to turn on non-blocking I/O for a file descriptor. If you wish to switch
2679         between blocking and non-blocking, you may try ioctl(FIOSNBIO) instead,
2680         but that is only supported by some devices.
2681
2682 obj_ext (Unix.U):
2683         This is an old synonym for _o.
2684
2685 old_pthread_create_joinable (d_pthrattrj.U):
2686         This variable defines the constant to use for creating joinable
2687         (aka undetached) pthreads.  Unused if pthread.h defines
2688         PTHREAD_CREATE_JOINABLE.  If used, possible values are
2689         PTHREAD_CREATE_UNDETACHED and __UNDETACHED.
2690
2691 optimize (ccflags.U):
2692         This variable contains any optimizer/debugger flag that should be used.
2693         It is up to the Makefile to use it.
2694
2695 orderlib (orderlib.U):
2696         This variable is "true" if the components of libraries must be ordered
2697         (with `lorder $* | tsort`) before placing them in an archive.  Set to
2698         "false" if ranlib or ar can generate random libraries.
2699
2700 osname (Oldconfig.U):
2701         This variable contains the operating system name (e.g. sunos,
2702         solaris, hpux, etc.).  It can be useful later on for setting
2703         defaults.  Any spaces are replaced with underscores.  It is set
2704         to a null string if we can't figure it out.
2705
2706 osvers (Oldconfig.U):
2707         This variable contains the operating system version (e.g.
2708         4.1.3, 5.2, etc.).  It is primarily used for helping select
2709         an appropriate hints file, but might be useful elsewhere for
2710         setting defaults.  It is set to '' if we can't figure it out.
2711         We try to be flexible about how much of the version number
2712         to keep, e.g. if 4.1.1, 4.1.2, and 4.1.3 are essentially the
2713         same for this package, hints files might just be os_4.0 or
2714         os_4.1, etc., not keeping separate files for each little release.
2715
2716 package (package.U):
2717         This variable contains the name of the package being constructed.
2718         It is primarily intended for the use of later Configure units.
2719
2720 pager (pager.U):
2721         This variable contains the name of the preferred pager on the system.
2722         Usual values are (the full pathnames of) more, less, pg, or cat.
2723
2724 passcat (nis.U):
2725         This variable contains a command that produces the text of the
2726         /etc/passwd file.  This is normally "cat /etc/passwd", but can be
2727         "ypcat passwd" when NIS is used.
2728         On some systems, such as os390, there may be no equivalent
2729         command, in which case this variable is unset.
2730
2731 patchlevel (patchlevel.U):
2732         The patchlevel level of this package.
2733         The value of patchlevel comes from the patchlevel.h file.
2734         In a version number such as 5.6.1, this is the "6".
2735         In patchlevel.h, this is referred to as "PERL_VERSION".
2736
2737 path_sep (Unix.U):
2738         This is an old synonym for p_ in Head.U, the character
2739         used to separate elements in the command shell search PATH.
2740
2741 perl5 (perl5.U):
2742         This variable contains the full path (if any) to a previously
2743         installed perl5.005 or later suitable for running the script
2744         to determine inc_version_list.
2745
2746 perl (Loc.U):
2747         This variable is defined but not used by Configure.
2748         The value is a plain '' and is not useful.
2749
2750 PERL_REVISION (Oldsyms.U):
2751         In a Perl version number such as 5.6.2, this is the 5.
2752         This value is manually set in patchlevel.h
2753
2754 PERL_SUBVERSION (Oldsyms.U):
2755         In a Perl version number such as 5.6.2, this is the 2.
2756         Values greater than 50 represent potentially unstable
2757         development subversions.
2758         This value is manually set in patchlevel.h
2759
2760 PERL_VERSION (Oldsyms.U):
2761         In a Perl version number such as 5.6.2, this is the 6.
2762         This value is manually set in patchlevel.h
2763
2764 perladmin (perladmin.U):
2765         Electronic mail address of the perl5 administrator.
2766
2767 perlpath (perlpath.U):
2768         This variable contains the eventual value of the PERLPATH symbol,
2769         which contains the name of the perl interpreter to be used in
2770         shell scripts and in the "eval 'exec'" idiom.
2771
2772 pg (Loc.U):
2773         This variable is used internally by Configure to determine the
2774         full pathname (if any) of the pg program.  After Configure runs,
2775         the value is reset to a plain "pg" and is not useful.
2776
2777 phostname (myhostname.U):
2778         This variable contains the eventual value of the PHOSTNAME symbol,
2779         which is a command that can be fed to popen() to get the host name.
2780         The program should probably not presume that the domain is or isn't
2781         there already.
2782
2783 pidtype (pidtype.U):
2784         This variable defines PIDTYPE to be something like pid_t, int, 
2785         ushort, or whatever type is used to declare process ids in the kernel.
2786
2787 plibpth (libpth.U):
2788         Holds the private path used by Configure to find out the libraries.
2789         Its value is prepend to libpth. This variable takes care of special
2790         machines, like the mips.  Usually, it should be empty.
2791
2792 pm_apiversion (xs_apiversion.U):
2793         This variable contains the version of the oldest perl
2794         compatible with the present perl.  (That is, pure perl modules
2795         written for $pm_apiversion will still work for the current
2796         version).  perl.c:incpush() and lib/lib.pm will automatically
2797         search in $sitelib for older directories across major versions
2798         back to pm_apiversion.  This is only useful if you have a perl
2799         library directory tree structured like the default one.  The
2800         versioned site_perl library was introduced in 5.005, so that's
2801         the default setting for this variable.  It's hard to imagine
2802         it changing before Perl6.  It is included here for symmetry
2803         with xs_apiveprsion -- the searching algorithms will
2804         (presumably) be similar.
2805         See the INSTALL file for how this works.
2806
2807 pmake (Loc.U):
2808         This variable is defined but not used by Configure.
2809         The value is a plain '' and is not useful.
2810
2811 pr (Loc.U):
2812         This variable is defined but not used by Configure.
2813         The value is a plain '' and is not useful.
2814
2815 prefix (prefix.U):
2816         This variable holds the name of the directory below which the
2817         user will install the package.  Usually, this is /usr/local, and
2818         executables go in /usr/local/bin, library stuff in /usr/local/lib,
2819         man pages in /usr/local/man, etc.  It is only used to set defaults
2820         for things in bin.U, mansrc.U, privlib.U, or scriptdir.U.
2821
2822 prefixexp (prefix.U):
2823         This variable holds the full absolute path of the directory below
2824         which the user will install the package.  Derived from prefix.
2825
2826 privlib (privlib.U):
2827         This variable contains the eventual value of the PRIVLIB symbol,
2828         which is the name of the private library for this package.  It may
2829         have a ~ on the front. It is up to the makefile to eventually create
2830         this directory while performing installation (with ~ substitution).
2831
2832 privlibexp (privlib.U):
2833         This variable is the ~name expanded version of privlib, so that you
2834         may use it directly in Makefiles or shell scripts.
2835
2836 prototype (prototype.U):
2837         This variable holds the eventual value of CAN_PROTOTYPE, which
2838         indicates the C compiler can handle funciton prototypes.
2839
2840 ptrsize (ptrsize.U):
2841         This variable contains the value of the PTRSIZE symbol, which
2842         indicates to the C program how many bytes there are in a pointer.
2843
2844 quadkind (quadtype.U):
2845         This variable, if defined, encodes the type of a quad:
2846         1 = int, 2 = long, 3 = long long, 4 = int64_t.
2847
2848 quadtype (quadtype.U):
2849         This variable defines Quad_t to be something like long, int, 
2850         long long, int64_t, or whatever type is used for 64-bit integers.
2851
2852 randbits (randfunc.U):
2853         Indicates how many bits are produced by the function used to
2854         generate normalized random numbers.
2855
2856 randfunc (randfunc.U):
2857         Indicates the name of the random number function to use.
2858         Values include drand48, random, and rand. In C programs,
2859         the 'Drand01' macro is defined to generate uniformly distributed
2860         random numbers over the range [0., 1.[ (see drand01 and nrand).
2861
2862 randseedtype (randfunc.U):
2863         Indicates the type of the argument of the seedfunc.
2864
2865 ranlib (orderlib.U):
2866         This variable is set to the pathname of the ranlib program, if it is
2867         needed to generate random libraries.  Set to ":" if ar can generate
2868         random libraries or if random libraries are not supported
2869
2870 rd_nodata (nblock_io.U):
2871         This variable holds the return code from read() when no data is
2872         present. It should be -1, but some systems return 0 when O_NDELAY is
2873         used, which is a shame because you cannot make the difference between
2874         no data and an EOF.. Sigh!
2875
2876 revision (patchlevel.U):
2877         The value of revision comes from the patchlevel.h file.
2878         In a version number such as 5.6.1, this is the "5".
2879         In patchlevel.h, this is referred to as "PERL_REVISION".
2880
2881 rm (Loc.U):
2882         This variable is used internally by Configure to determine the
2883         full pathname (if any) of the rm program.  After Configure runs,
2884         the value is reset to a plain "rm" and is not useful.
2885
2886 rmail (Loc.U):
2887         This variable is defined but not used by Configure.
2888         The value is a plain '' and is not useful.
2889
2890 runnm (usenm.U):
2891         This variable contains 'true' or 'false' depending whether the
2892         nm extraction should be performed or not, according to the value
2893         of usenm and the flags on the Configure command line.
2894
2895 sched_yield (d_pthread_y.U):
2896         This variable defines the way to yield the execution
2897         of the current thread.
2898
2899 scriptdir (scriptdir.U):
2900         This variable holds the name of the directory in which the user wants
2901         to put publicly scripts for the package in question.  It is either
2902         the same directory as for binaries, or a special one that can be
2903         mounted across different architectures, like /usr/share. Programs
2904         must be prepared to deal with ~name expansion.
2905
2906 scriptdirexp (scriptdir.U):
2907         This variable is the same as scriptdir, but is filename expanded
2908         at configuration time, for programs not wanting to bother with it.
2909
2910 sed (Loc.U):
2911         This variable is used internally by Configure to determine the
2912         full pathname (if any) of the sed program.  After Configure runs,
2913         the value is reset to a plain "sed" and is not useful.
2914
2915 seedfunc (randfunc.U):
2916         Indicates the random number generating seed function.
2917         Values include srand48, srandom, and srand.
2918
2919 selectminbits (selectminbits.U):
2920         This variable holds the minimum number of bits operated by select.
2921         That is, if you do select(n, ...), how many bits at least will be
2922         cleared in the masks if some activity is detected.  Usually this
2923         is either n or 32*ceil(n/32), especially many little-endians do
2924         the latter.  This is only useful if you have select(), naturally.
2925
2926 selecttype (selecttype.U):
2927         This variable holds the type used for the 2nd, 3rd, and 4th
2928         arguments to select.  Usually, this is 'fd_set *', if HAS_FD_SET
2929         is defined, and 'int *' otherwise.  This is only useful if you 
2930         have select(), naturally.
2931
2932 sendmail (Loc.U):
2933         This variable is defined but not used by Configure.
2934         The value is a plain '' and is not useful.
2935
2936 sh (sh.U):
2937         This variable contains the full pathname of the shell used
2938         on this system to execute Bourne shell scripts.  Usually, this will be
2939         /bin/sh, though it's possible that some systems will have /bin/ksh,
2940         /bin/pdksh, /bin/ash, /bin/bash, or even something such as
2941         D:/bin/sh.exe.
2942         This unit comes before Options.U, so you can't set sh with a '-D'
2943         option, though you can override this (and startsh)
2944         with '-O -Dsh=/bin/whatever -Dstartsh=whatever'
2945
2946 shar (Loc.U):
2947         This variable is defined but not used by Configure.
2948         The value is a plain '' and is not useful.
2949
2950 sharpbang (spitshell.U):
2951         This variable contains the string #! if this system supports that
2952         construct.
2953
2954 shmattype (d_shmat.U):
2955         This symbol contains the type of pointer returned by shmat().
2956         It can be 'void *' or 'char *'.
2957
2958 shortsize (intsize.U):
2959         This variable contains the value of the SHORTSIZE symbol which
2960         indicates to the C program how many bytes there are in a short.
2961
2962 shrpenv (libperl.U):
2963         If the user builds a shared libperl.so, then we need to tell the
2964         'perl' executable where it will be able to find the installed libperl.so. 
2965         One way to do this on some systems is to set the environment variable
2966         LD_RUN_PATH to the directory that will be the final location of the
2967         shared libperl.so.  The makefile can use this with something like
2968         $shrpenv $(CC) -o perl perlmain.o $libperl $libs
2969         Typical values are
2970         shrpenv="env LD_RUN_PATH=$archlibexp/CORE"
2971         or
2972         shrpenv=''
2973         See the main perl Makefile.SH for actual working usage.
2974         Alternatively, we might be able to use a command line option such
2975         as -R $archlibexp/CORE (Solaris, NetBSD) or -Wl,-rpath
2976         $archlibexp/CORE (Linux).
2977
2978 shsharp (spitshell.U):
2979         This variable tells further Configure units whether your sh can
2980         handle # comments.
2981
2982 sig_count (sig_name.U):
2983         This variable holds a number larger than the largest valid
2984         signal number.  This is usually the same as the NSIG macro.
2985
2986 sig_name (sig_name.U):
2987         This variable holds the signal names, space separated. The leading
2988         SIG in signal name is removed.  A ZERO is prepended to the
2989         list.  This is currently not used.
2990
2991 sig_name_init (sig_name.U):
2992         This variable holds the signal names, enclosed in double quotes and
2993         separated by commas, suitable for use in the SIG_NAME definition 
2994         below.  A "ZERO" is prepended to the list, and the list is 
2995         terminated with a plain 0.  The leading SIG in signal names
2996         is removed. See sig_num.
2997
2998 sig_num (sig_name.U):
2999         This variable holds the signal numbers, space separated. A ZERO is
3000         prepended to the list (corresponding to the fake SIGZERO), and 
3001         the list is terminated with a 0.  Those numbers correspond to 
3002         the value of the signal listed in the same place within the
3003         sig_name list.
3004
3005 sig_num_init (sig_name.U):
3006         This variable holds the signal numbers, enclosed in double quotes and
3007         separated by commas, suitable for use in the SIG_NUM definition 
3008         below.  A "ZERO" is prepended to the list, and the list is 
3009         terminated with a plain 0.
3010
3011 signal_t (d_voidsig.U):
3012         This variable holds the type of the signal handler (void or int).
3013
3014 sitearch (sitearch.U):
3015         This variable contains the eventual value of the SITEARCH symbol,
3016         which is the name of the private library for this package.  It may
3017         have a ~ on the front. It is up to the makefile to eventually create
3018         this directory while performing installation (with ~ substitution).
3019         The standard distribution will put nothing in this directory.
3020         After perl has been installed, users may install their own local
3021         architecture-dependent modules in this directory with
3022         MakeMaker Makefile.PL
3023         or equivalent.  See INSTALL for details.
3024
3025 sitearchexp (sitearch.U):
3026         This variable is the ~name expanded version of sitearch, so that you
3027         may use it directly in Makefiles or shell scripts.
3028
3029 sitebin (sitebin.U):
3030         This variable holds the name of the directory in which the user wants
3031         to put add-on publicly executable files for the package in question.  It
3032         is most often a local directory such as /usr/local/bin. Programs using
3033         this variable must be prepared to deal with ~name substitution.
3034         The standard distribution will put nothing in this directory.
3035         After perl has been installed, users may install their own local
3036         executables in this directory with
3037         MakeMaker Makefile.PL
3038         or equivalent.  See INSTALL for details.
3039
3040 sitebinexp (sitebin.U):
3041         This is the same as the sitebin variable, but is filename expanded at
3042         configuration time, for use in your makefiles.
3043
3044 sitelib (sitelib.U):
3045         This variable contains the eventual value of the SITELIB symbol,
3046         which is the name of the private library for this package.  It may
3047         have a ~ on the front. It is up to the makefile to eventually create
3048         this directory while performing installation (with ~ substitution).
3049         The standard distribution will put nothing in this directory.
3050         After perl has been installed, users may install their own local
3051         architecture-independent modules in this directory with
3052         MakeMaker Makefile.PL
3053         or equivalent.  See INSTALL for details.
3054
3055 sitelibexp (sitelib.U):
3056         This variable is the ~name expanded version of sitelib, so that you
3057         may use it directly in Makefiles or shell scripts.
3058
3059 siteprefix (siteprefix.U):
3060         This variable holds the full absolute path of the directory below
3061         which the user will install add-on packages.
3062         See INSTALL for usage and examples.
3063
3064 siteprefixexp (siteprefix.U):
3065         This variable holds the full absolute path of the directory below
3066         which the user will install add-on packages.  Derived from siteprefix.
3067
3068 sizetype (sizetype.U):
3069         This variable defines sizetype to be something like size_t, 
3070         unsigned long, or whatever type is used to declare length 
3071         parameters for string functions.
3072
3073 sleep (Loc.U):
3074         This variable is defined but not used by Configure.
3075         The value is a plain '' and is not useful.
3076
3077 smail (Loc.U):
3078         This variable is defined but not used by Configure.
3079         The value is a plain '' and is not useful.
3080
3081 small (models.U):
3082         This variable contains a flag which will tell the C compiler and loader
3083         to produce a program running with a small memory model.  It is up to
3084         the Makefile to use this.
3085
3086 so (so.U):
3087         This variable holds the extension used to identify shared libraries
3088         (also known as shared objects) on the system. Usually set to 'so'.
3089
3090 sockethdr (d_socket.U):
3091         This variable has any cpp '-I' flags needed for socket support.
3092
3093 socketlib (d_socket.U):
3094         This variable has the names of any libraries needed for socket support.
3095
3096 socksizetype (socksizetype.U):
3097         This variable holds the type used for the size argument
3098         for various socket calls like accept.  Usual values include
3099         socklen_t, size_t, and int.
3100
3101 sort (Loc.U):
3102         This variable is used internally by Configure to determine the
3103         full pathname (if any) of the sort program.  After Configure runs,
3104         the value is reset to a plain "sort" and is not useful.
3105
3106 spackage (package.U):
3107         This variable contains the name of the package being constructed,
3108         with the first letter uppercased, i.e. suitable for starting
3109         sentences.
3110
3111 spitshell (spitshell.U):
3112         This variable contains the command necessary to spit out a runnable
3113         shell on this system.  It is either cat or a grep '-v' for # comments.
3114
3115 split (models.U):
3116         This variable contains a flag which will tell the C compiler and loader
3117         to produce a program that will run in separate I and D space, for those
3118         machines that support separation of instruction and data space.  It is
3119         up to the Makefile to use this.
3120
3121 sPRId64 (quadfio.U):
3122         This variable, if defined, contains the string used by stdio to
3123         format 64-bit decimal numbers (format 'd') for output.
3124
3125 sPRIeldbl (longdblfio.U):
3126         This variable, if defined, contains the string used by stdio to
3127         format long doubles (format 'e') for output.
3128
3129 sPRIEldbl (longdblfio.U):
3130         This variable, if defined, contains the string used by stdio to
3131         format long doubles (format 'E') for output.
3132
3133 sPRIfldbl (longdblfio.U):
3134         This variable, if defined, contains the string used by stdio to
3135         format long doubles (format 'f') for output.
3136
3137 sPRIFldbl (longdblfio.U):
3138         This variable, if defined, contains the string used by stdio to
3139         format long doubles (format 'F') for output.
3140
3141 sPRIgldbl (longdblfio.U):
3142         This variable, if defined, contains the string used by stdio to
3143         format long doubles (format 'g') for output.
3144
3145 sPRIGldbl (longdblfio.U):
3146         This variable, if defined, contains the string used by stdio to
3147         format long doubles (format 'G') for output.
3148
3149 sPRIi64 (quadfio.U):
3150         This variable, if defined, contains the string used by stdio to
3151         format 64-bit decimal numbers (format 'i') for output.
3152
3153 sPRIo64 (quadfio.U):
3154         This variable, if defined, contains the string used by stdio to
3155         format 64-bit octal numbers (format 'o') for output.
3156
3157 sPRIu64 (quadfio.U):
3158         This variable, if defined, contains the string used by stdio to
3159         format 64-bit unsigned decimal numbers (format 'u') for output.
3160
3161 sPRIx64 (quadfio.U):
3162         This variable, if defined, contains the string used by stdio to
3163         format 64-bit hexadecimal numbers (format 'x') for output.
3164
3165 sPRIX64 (quadfio.U):
3166         This variable, if defined, contains the string used by stdio to
3167         format 64-bit hExADECimAl numbers (format 'X') for output.
3168
3169 src (src.U):
3170         This variable holds the path to the package source. It is up to
3171         the Makefile to use this variable and set VPATH accordingly to
3172         find the sources remotely.
3173
3174 ssizetype (ssizetype.U):
3175         This variable defines ssizetype to be something like ssize_t, 
3176         long or int.  It is used by functions that return a count 
3177         of bytes or an error condition.  It must be a signed type.
3178         We will pick a type such that sizeof(SSize_t) == sizeof(Size_t).
3179
3180 startperl (startperl.U):
3181         This variable contains the string to put on the front of a perl
3182         script to make sure (hopefully) that it runs with perl and not some
3183         shell. Of course, that leading line must be followed by the classical
3184         perl idiom:
3185         eval 'exec perl -S $0 ${1+"$@"}'
3186         if $running_under_some_shell;
3187         to guarantee perl startup should the shell execute the script. Note
3188         that this magic incatation is not understood by csh.
3189
3190 startsh (startsh.U):
3191         This variable contains the string to put on the front of a shell
3192         script to make sure (hopefully) that it runs with sh and not some
3193         other shell.
3194
3195 static_ext (Extensions.U):
3196         This variable holds a list of XS extension files we want to
3197         link statically into the package.  It is used by Makefile.
3198
3199 stdchar (stdchar.U):
3200         This variable conditionally defines STDCHAR to be the type of char
3201         used in stdio.h.  It has the values "unsigned char" or "char".
3202
3203 stdio_base (d_stdstdio.U):
3204         This variable defines how, given a FILE pointer, fp, to access the
3205         _base field (or equivalent) of stdio.h's FILE structure.  This will
3206         be used to define the macro FILE_base(fp).
3207
3208 stdio_bufsiz (d_stdstdio.U):
3209         This variable defines how, given a FILE pointer, fp, to determine
3210         the number of bytes store in the I/O buffer pointer to by the
3211         _base field (or equivalent) of stdio.h's FILE structure.  This will
3212         be used to define the macro FILE_bufsiz(fp).
3213
3214 stdio_cnt (d_stdstdio.U):
3215         This variable defines how, given a FILE pointer, fp, to access the
3216         _cnt field (or equivalent) of stdio.h's FILE structure.  This will
3217         be used to define the macro FILE_cnt(fp).
3218
3219 stdio_filbuf (d_stdstdio.U):
3220         This variable defines how, given a FILE pointer, fp, to tell
3221         stdio to refill it's internal buffers (?).  This will
3222         be used to define the macro FILE_filbuf(fp).
3223
3224 stdio_ptr (d_stdstdio.U):
3225         This variable defines how, given a FILE pointer, fp, to access the
3226         _ptr field (or equivalent) of stdio.h's FILE structure.  This will
3227         be used to define the macro FILE_ptr(fp).
3228
3229 stdio_stream_array (stdio_streams.U):
3230         This variable tells the name of the array holding the stdio streams.
3231         Usual values include _iob, __iob, and __sF.
3232
3233 strings (i_string.U):
3234         This variable holds the full path of the string header that will be
3235         used. Typically /usr/include/string.h or /usr/include/strings.h.
3236
3237 submit (Loc.U):
3238         This variable is defined but not used by Configure.
3239         The value is a plain '' and is not useful.
3240
3241 subversion (patchlevel.U):
3242         The subversion level of this package.
3243         The value of subversion comes from the patchlevel.h file.
3244         In a version number such as 5.6.1, this is the "1".
3245         In patchlevel.h, this is referred to as "PERL_SUBVERSION".
3246         This is unique to perl.
3247
3248 sysman (sysman.U):
3249         This variable holds the place where the manual is located on this
3250         system. It is not the place where the user wants to put his manual
3251         pages. Rather it is the place where Configure may look to find manual
3252         for unix commands (section 1 of the manual usually). See mansrc.
3253
3254 tail (Loc.U):
3255         This variable is defined but not used by Configure.
3256         The value is a plain '' and is not useful.
3257
3258 tar (Loc.U):
3259         This variable is defined but not used by Configure.
3260         The value is a plain '' and is not useful.
3261
3262 tbl (Loc.U):
3263         This variable is defined but not used by Configure.
3264         The value is a plain '' and is not useful.
3265
3266 tee (Loc.U):
3267         This variable is defined but not used by Configure.
3268         The value is a plain '' and is not useful.
3269
3270 test (Loc.U):
3271         This variable is used internally by Configure to determine the
3272         full pathname (if any) of the test program.  After Configure runs,
3273         the value is reset to a plain "test" and is not useful.
3274
3275 timeincl (i_time.U):
3276         This variable holds the full path of the included time header(s).
3277
3278 timetype (d_time.U):
3279         This variable holds the type returned by time(). It can be long,
3280         or time_t on BSD sites (in which case <sys/types.h> should be
3281         included). Anyway, the type Time_t should be used.
3282
3283 touch (Loc.U):
3284         This variable is used internally by Configure to determine the
3285         full pathname (if any) of the touch program.  After Configure runs,
3286         the value is reset to a plain "touch" and is not useful.
3287
3288 tr (Loc.U):
3289         This variable is used internally by Configure to determine the
3290         full pathname (if any) of the tr program.  After Configure runs,
3291         the value is reset to a plain "tr" and is not useful.
3292
3293 trnl (trnl.U):
3294         This variable contains the value to be passed to the tr(1)
3295         command to transliterate a newline.  Typical values are
3296         '\012' and '\n'.  This is needed for EBCDIC systems where
3297         newline is not necessarily '\012'.
3298
3299 troff (Loc.U):
3300         This variable is defined but not used by Configure.
3301         The value is a plain '' and is not useful.
3302
3303 u16size (perlxv.U):
3304         This variable is the size of an U16 in bytes.
3305
3306 u16type (perlxv.U):
3307         This variable contains the C type used for Perl's U16.
3308
3309 u32size (perlxv.U):
3310         This variable is the size of an U32 in bytes.
3311
3312 u32type (perlxv.U):
3313         This variable contains the C type used for Perl's U32.
3314
3315 u64size (perlxv.U):
3316         This variable is the size of an U64 in bytes.
3317
3318 u64type (perlxv.U):
3319         This variable contains the C type used for Perl's U64.
3320
3321 u8size (perlxv.U):
3322         This variable is the size of an U8 in bytes.
3323
3324 u8type (perlxv.U):
3325         This variable contains the C type used for Perl's U8.
3326
3327 uidformat (uidf.U):
3328         This variable contains the format string used for printing a Uid_t.
3329
3330 uidsign (uidsign.U):
3331         This variable contains the signedness of a uidtype.
3332         1 for unsigned, -1 for signed.
3333
3334 uidsize (uidsize.U):
3335         This variable contains the size of a uidtype in bytes.
3336
3337 uidtype (uidtype.U):
3338         This variable defines Uid_t to be something like uid_t, int, 
3339         ushort, or whatever type is used to declare user ids in the kernel.
3340
3341 uname (Loc.U):
3342         This variable is used internally by Configure to determine the
3343         full pathname (if any) of the uname program.  After Configure runs,
3344         the value is reset to a plain "uname" and is not useful.
3345
3346 uniq (Loc.U):
3347         This variable is used internally by Configure to determine the
3348         full pathname (if any) of the uniq program.  After Configure runs,
3349         the value is reset to a plain "uniq" and is not useful.
3350
3351 uquadtype (quadtype.U):
3352         This variable defines Uquad_t to be something like unsigned long,
3353         unsigned int, unsigned long long, uint64_t, or whatever type is
3354         used for 64-bit integers.
3355
3356 use5005threads (usethreads.U):
3357         This variable conditionally defines the USE_5005THREADS symbol,
3358         and indicates that Perl should be built to use the 5.005-based
3359         threading implementation.
3360
3361 use64bitall (use64bits.U):
3362         This variable conditionally defines the USE_64_BIT_ALL symbol,
3363         and indicates that 64-bit integer types should be used
3364         when available.  The maximal possible
3365         64-bitness is employed: LP64 or ILP64, meaning that you will
3366         be able to use more than 2 gigabytes of memory.  This mode is
3367         even more binary incompatible than USE_64_BIT_INT. You may not
3368         be able to run the resulting executable in a 32-bit CPU at all or
3369         you may need at least to reboot your OS to 64-bit mode.
3370
3371 use64bitint (use64bits.U):
3372         This variable conditionally defines the USE_64_BIT_INT symbol,
3373         and indicates that 64-bit integer types should be used
3374         when available.  The minimal possible 64-bitness
3375         is employed, just enough to get 64-bit integers into Perl.
3376         This may mean using for example "long longs", while your memory
3377         may still be limited to 2 gigabytes.
3378
3379 usedl (dlsrc.U):
3380         This variable indicates if the system supports dynamic
3381         loading of some sort.  See also dlsrc and dlobj.
3382
3383 useithreads (usethreads.U):
3384         This variable conditionally defines the USE_ITHREADS symbol,
3385         and indicates that Perl should be built to use the interpreter-based
3386         threading implementation.
3387
3388 uselargefiles (uselfs.U):
3389         This variable conditionally defines the USE_LARGE_FILES symbol,
3390         and indicates that large file interfaces should be used when
3391         available.
3392
3393 uselongdouble (uselongdbl.U):
3394         This variable conditionally defines the USE_LONG_DOUBLE symbol,
3395         and indicates that long doubles should be used when available.
3396
3397 usemorebits (usemorebits.U):
3398         This variable conditionally defines the USE_MORE_BITS symbol,
3399         and indicates that explicit 64-bit interfaces and long doubles
3400         should be used when available.
3401
3402 usemultiplicity (usemultiplicity.U):
3403         This variable conditionally defines the MULTIPLICITY symbol,
3404         and indicates that Perl should be built to use multiplicity.
3405
3406 usemymalloc (mallocsrc.U):
3407         This variable contains y if the malloc that comes with this package
3408         is desired over the system's version of malloc.  People often include
3409         special versions of malloc for effiency, but such versions are often
3410         less portable.  See also mallocsrc and mallocobj.
3411         If this is 'y', then -lmalloc is removed from $libs.
3412
3413 usenm (usenm.U):
3414         This variable contains 'true' or 'false' depending whether the
3415         nm extraction is wanted or not.
3416
3417 useopcode (Extensions.U):
3418         This variable holds either 'true' or 'false' to indicate
3419         whether the Opcode extension should be used.  The sole
3420         use for this currently is to allow an easy mechanism
3421         for users to skip the Opcode extension from the Configure
3422         command line.
3423
3424 useperlio (useperlio.U):
3425         This variable conditionally defines the USE_PERLIO symbol,
3426         and indicates that the PerlIO abstraction should be
3427         used throughout.
3428
3429 useposix (Extensions.U):
3430         This variable holds either 'true' or 'false' to indicate
3431         whether the POSIX extension should be used.  The sole
3432         use for this currently is to allow an easy mechanism
3433         for hints files to indicate that POSIX will not compile
3434         on a particular system.
3435
3436 usesfio (d_sfio.U):
3437         This variable is set to true when the user agrees to use sfio.
3438         It is set to false when sfio is not available or when the user
3439         explicitely requests not to use sfio.  It is here primarily so
3440         that command-line settings can override the auto-detection of
3441         d_sfio without running into a "WHOA THERE".
3442
3443 useshrplib (libperl.U):
3444         This variable is set to 'yes' if the user wishes
3445         to build a shared libperl, and 'no' otherwise.
3446
3447 usesocks (usesocks.U):
3448         This variable conditionally defines the USE_SOCKS symbol,
3449         and indicates that Perl should be built to use SOCKS.
3450
3451 usethreads (usethreads.U):
3452         This variable conditionally defines the USE_THREADS symbol,
3453         and indicates that Perl should be built to use threads.
3454
3455 usevendorprefix (vendorprefix.U):
3456         This variable tells whether the vendorprefix
3457         and consequently other vendor* paths are in use.
3458
3459 usevfork (d_vfork.U):
3460         This variable is set to true when the user accepts to use vfork.
3461         It is set to false when no vfork is available or when the user
3462         explicitely requests not to use vfork.
3463
3464 usrinc (usrinc.U):
3465         This variable holds the path of the include files, which is
3466         usually /usr/include. It is mainly used by other Configure units.
3467
3468 uuname (Loc.U):
3469         This variable is defined but not used by Configure.
3470         The value is a plain '' and is not useful.
3471
3472 uvoformat (perlxvf.U):
3473         This variable contains the format string used for printing
3474         a Perl UV as an unsigned octal integer. 
3475
3476 uvsize (perlxv.U):
3477         This variable is the size of a UV in bytes.
3478
3479 uvtype (perlxv.U):
3480         This variable contains the C type used for Perl's UV.
3481
3482 uvuformat (perlxvf.U):
3483         This variable contains the format string used for printing
3484         a Perl UV as an unsigned decimal integer. 
3485
3486 uvxformat (perlxvf.U):
3487         This variable contains the format string used for printing
3488         a Perl UV as an unsigned hexadecimal integer. 
3489
3490 vendorbin (vendorbin.U):
3491         This variable contains the eventual value of the VENDORBIN symbol.
3492         It may have a ~ on the front.
3493         The standard distribution will put nothing in this directory.
3494         Vendors who distribute perl may wish to place additional
3495         binaries in this directory with
3496         MakeMaker Makefile.PL INSTALLDIRS=vendor 
3497         or equivalent.  See INSTALL for details.
3498
3499 vendorbinexp (vendorbin.U):
3500         This variable is the ~name expanded version of vendorbin, so that you
3501         may use it directly in Makefiles or shell scripts.
3502
3503 vendorlib (vendorlib.U):
3504         This variable contains the eventual value of the VENDORLIB symbol,
3505         which is the name of the private library for this package.
3506         The standard distribution will put nothing in this directory.
3507         Vendors who distribute perl may wish to place their own
3508         modules in this directory with
3509         MakeMaker Makefile.PL INSTALLDIRS=vendor 
3510         or equivalent.  See INSTALL for details.
3511
3512 vendorlibexp (vendorlib.U):
3513         This variable is the ~name expanded version of vendorlib, so that you
3514         may use it directly in Makefiles or shell scripts.
3515
3516 vendorprefix (vendorprefix.U):
3517         This variable holds the full absolute path of the directory below
3518         which the vendor will install add-on packages.
3519         See INSTALL for usage and examples.
3520
3521 vendorprefixexp (vendorprefix.U):
3522         This variable holds the full absolute path of the directory below
3523         which the vendor will install add-on packages.  Derived from vendorprefix.
3524
3525 version (patchlevel.U):
3526         The full version number of this package, such as 5.6.1 (or 5_6_1).
3527         This combines revision, patchlevel, and subversion to get the
3528         full version number, including any possible subversions.
3529         This is suitable for use as a directory name, and hence is
3530         filesystem dependent.
3531
3532 vi (Loc.U):
3533         This variable is defined but not used by Configure.
3534         The value is a plain '' and is not useful.
3535
3536 voidflags (voidflags.U):
3537         This variable contains the eventual value of the VOIDFLAGS symbol,
3538         which indicates how much support of the void type is given by this
3539         compiler.  See VOIDFLAGS for more info.
3540
3541 xlibpth (libpth.U):
3542         This variable holds extra path (space-separated) used to find
3543         libraries on this platform, for example CPU-specific libraries
3544         (on multi-CPU platforms) may be listed here.
3545
3546 xs_apiversion (xs_apiversion.U):
3547         This variable contains the version of the oldest perl binary
3548         compatible with the present perl.  perl.c:incpush() and
3549         lib/lib.pm will automatically search in $sitearch for older
3550         directories across major versions back to xs_apiversion.
3551         This is only useful if you have a perl library directory tree
3552         structured like the default one.
3553         See INSTALL for how this works.
3554         The versioned site_perl directory was introduced in 5.005,
3555         so that is the lowest possible value.
3556         Since this can depend on compile time options (such as
3557         bincompat) it is set by Configure.  Other non-default sources
3558         of potential incompatibility, such as multiplicity, threads,
3559         debugging, 64bits, sfio, etc., are not checked for currently,
3560         though in principle we could go snooping around in old
3561         Config.pm files.
3562
3563 zcat (Loc.U):
3564         This variable is defined but not used by Configure.
3565         The value is a plain '' and is not useful.
3566
3567 zip (Loc.U):
3568         This variable is used internally by Configure to determine the
3569         full pathname (if any) of the zip program.  After Configure runs,
3570         the value is reset to a plain "zip" and is not useful.
3571