This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
lexer API
[perl5.git] / Porting / Glossary
1
2 !!!!!!!   DO NOT EDIT THIS FILE   !!!!!!!
3 This file is built by metaconfig.
4
5 This file contains a description of all the shell variables whose value is
6 determined by the Configure script.  Variables intended for use in C
7 programs (e.g. I_UNISTD) are already described in config_h.SH.  [`configpm'
8 generates pod documentation for Config.pm from this file--please try to keep
9 the formatting regular.]
10
11 _a (Unix.U):
12         This variable defines the extension used for ordinary library files.
13         For unix, it is '.a'.  The '.' is included.  Other possible
14         values include '.lib'.
15
16 _exe (Unix.U):
17         This variable defines the extension used for executable files.
18         DJGPP, Cygwin and OS/2 use '.exe'.  Stratus VOS uses '.pm'.
19         On operating systems which do not require a specific extension
20         for executable files, this variable is empty.
21
22 _o (Unix.U):
23         This variable defines the extension used for object files.
24         For unix, it is '.o'.  The '.' is included.  Other possible
25         values include '.obj'.
26
27 afs (afs.U):
28         This variable is set to 'true' if AFS (Andrew File System) is used
29         on the system, 'false' otherwise.  It is possible to override this
30         with a hint value or command line option, but you'd better know
31         what you are doing.
32
33 afsroot (afs.U):
34         This variable is by default set to '/afs'. In the unlikely case
35         this is not the correct root, it is possible to override this with
36         a hint value or command line option.  This will be used in subsequent
37         tests for AFSness in the configure and test process.
38
39 alignbytes (alignbytes.U):
40         This variable holds the number of bytes required to align a
41         double-- or a long double when applicable. Usual values are
42         2, 4 and 8.  The default is eight, for safety.
43
44 ansi2knr (ansi2knr.U):
45         This variable is set if the user needs to run ansi2knr.
46         Currently, this is not supported, so we just abort.
47
48 aphostname (d_gethname.U):
49         This variable contains the command which can be used to compute the
50         host name. The command is fully qualified by its absolute path, to make
51         it safe when used by a process with super-user privileges.
52
53 api_revision (patchlevel.U):
54         The three variables, api_revision, api_version, and
55         api_subversion, specify the version of the oldest perl binary
56         compatible with the present perl.  In a full version string
57         such as '5.6.1', api_revision is the '5'.
58         Prior to 5.5.640, the format was a floating point number,
59         like 5.00563.
60
61         perl.c:incpush() and lib/lib.pm will automatically search in
62         $sitelib/.. for older directories back to the limit specified
63         by these api_ variables.  This is only useful if you have a
64         perl library directory tree structured like the default one.
65         See INSTALL for how this works.  The versioned site_perl
66         directory was introduced in 5.005, so that is the lowest
67         possible value.  The version list appropriate for the current
68         system is determined in inc_version_list.U.
69
70         XXX To do:  Since compatibility can depend on compile time
71         options (such as bincompat, longlong, etc.) it should
72         (perhaps) be set by Configure, but currently it isn't.
73         Currently, we read a hard-wired value from patchlevel.h.
74         Perhaps what we ought to do is take the hard-wired value from
75         patchlevel.h but then modify it if the current Configure
76         options warrant.  patchlevel.h then would use an #ifdef guard.
77
78 api_subversion (patchlevel.U):
79         The three variables, api_revision, api_version, and
80         api_subversion, specify the version of the oldest perl binary
81         compatible with the present perl.  In a full version string
82         such as '5.6.1', api_subversion is the '1'.  See api_revision for
83         full details.
84
85 api_version (patchlevel.U):
86         The three variables, api_revision, api_version, and
87         api_subversion, specify the version of the oldest perl binary
88         compatible with the present perl.  In a full version string
89         such as '5.6.1', api_version is the '6'.  See api_revision for
90         full details.  As a special case, 5.5.0 is rendered in the
91         old-style as 5.005.  (In the 5.005_0x maintenance series,
92         this was the only versioned directory in $sitelib.)
93
94 api_versionstring (patchlevel.U):
95         This variable combines api_revision, api_version, and
96         api_subversion in a format such as 5.6.1 (or 5_6_1) suitable
97         for use as a directory name.  This is filesystem dependent.
98
99 ar (Loc.U):
100         This variable is used internally by Configure to determine the
101         full pathname (if any) of the ar program.  After Configure runs,
102         the value is reset to a plain "ar" and is not useful.
103
104 archlib (archlib.U):
105         This variable holds the name of the directory in which the user wants
106         to put architecture-dependent public library files for $package.
107         It is most often a local directory such as /usr/local/lib.
108         Programs using this variable must be prepared to deal
109         with filename expansion.
110
111 archlibexp (archlib.U):
112         This variable is the same as the archlib variable, but is
113         filename expanded at configuration time, for convenient use.
114
115 archname (archname.U):
116         This variable is a short name to characterize the current
117         architecture.  It is used mainly to construct the default archlib.
118
119 archname64 (use64bits.U):
120         This variable is used for the 64-bitness part of $archname.
121
122 archobjs (Unix.U):
123         This variable defines any additional objects that must be linked
124         in with the program on this architecture.  On unix, it is usually
125         empty.  It is typically used to include emulations of unix calls
126         or other facilities.  For perl on OS/2, for example, this would
127         include os2/os2.obj.
128
129 asctime_r_proto (d_asctime_r.U):
130         This variable encodes the prototype of asctime_r.
131         It is zero if d_asctime_r is undef, and one of the
132         REENTRANT_PROTO_T_ABC macros of reentr.h if d_asctime_r
133         is defined.
134
135 awk (Loc.U):
136         This variable is used internally by Configure to determine the
137         full pathname (if any) of the awk program.  After Configure runs,
138         the value is reset to a plain "awk" and is not useful.
139
140 baserev (baserev.U):
141         The base revision level of this package, from the .package file.
142
143 bash (Loc.U):
144         This variable is defined but not used by Configure.
145         The value is the empty string and is not useful.
146
147 bin (bin.U):
148         This variable holds the name of the directory in which the user wants
149         to put publicly executable images for the package in question.  It
150         is most often a local directory such as /usr/local/bin. Programs using
151         this variable must be prepared to deal with ~name substitution.
152
153 bin_ELF (dlsrc.U):
154         This variable saves the result from configure if generated binaries
155         are in ELF format. Only set to defined when the test has actually
156         been performed, and the result was positive.
157
158 binexp (bin.U):
159         This is the same as the bin variable, but is filename expanded at
160         configuration time, for use in your makefiles.
161
162 bison (Loc.U):
163         This variable is used internally by Configure to determine the
164         full pathname (if any) of the bison program.  After Configure runs,
165         the value is reset to a plain "bison" and is not useful.
166
167 byacc (Loc.U):
168         This variable is used internally by Configure to determine the
169         full pathname (if any) of the byacc program.  After Configure runs,
170         the value is reset to a plain "byacc" and is not useful.
171
172 byteorder (byteorder.U):
173         This variable holds the byte order in a UV. In the following,
174         larger digits indicate more significance.  The variable byteorder
175         is either 4321 on a big-endian machine, or 1234 on a little-endian,
176         or 87654321 on a Cray ... or 3412 with weird order !
177
178 c (n.U):
179         This variable contains the \c string if that is what causes the echo
180         command to suppress newline.  Otherwise it is null.  Correct usage is
181         $echo $n "prompt for a question: $c".
182
183 castflags (d_castneg.U):
184         This variable contains a flag that precise difficulties the
185         compiler has casting odd floating values to unsigned long:
186         0 = ok
187         1 = couldn't cast < 0
188         2 = couldn't cast >= 0x80000000
189         4 = couldn't cast in argument expression list
190
191 cat (Loc.U):
192         This variable is used internally by Configure to determine the
193         full pathname (if any) of the cat program.  After Configure runs,
194         the value is reset to a plain "cat" and is not useful.
195
196 cc (cc.U):
197         This variable holds the name of a command to execute a C compiler which
198         can resolve multiple global references that happen to have the same
199         name.  Usual values are 'cc' and 'gcc'.
200         Fervent ANSI compilers may be called 'c89'.  AIX has xlc.
201
202 cccdlflags (dlsrc.U):
203         This variable contains any special flags that might need to be
204         passed with 'cc -c' to compile modules to be used to create a shared
205         library that will be used for dynamic loading.  For hpux, this
206         should be +z.  It is up to the makefile to use it.
207
208 ccdlflags (dlsrc.U):
209         This variable contains any special flags that might need to be
210         passed to cc to link with a shared library for dynamic loading.
211         It is up to the makefile to use it.  For sunos 4.1, it should
212         be empty.
213
214 ccflags (ccflags.U):
215         This variable contains any additional C compiler flags desired by
216         the user.  It is up to the Makefile to use this.
217
218 ccflags_uselargefiles (uselfs.U):
219         This variable contains the compiler flags needed by large file builds
220         and added to ccflags by hints files.
221
222 ccname (Checkcc.U):
223         This can set either by hints files or by Configure.  If using
224         gcc, this is gcc, and if not, usually equal to cc, unimpressive, no?
225         Some platforms, however, make good use of this by storing the
226         flavor of the C compiler being used here.  For example if using
227         the Sun WorkShop suite, ccname will be 'workshop'.
228
229 ccsymbols (Cppsym.U):
230         The variable contains the symbols defined by the C compiler alone.
231         The symbols defined by cpp or by cc when it calls cpp are not in
232         this list, see cppsymbols and cppccsymbols.
233         The list is a space-separated list of symbol=value tokens.
234
235 ccversion (Checkcc.U):
236         This can set either by hints files or by Configure.  If using
237         a (non-gcc) vendor cc, this variable may contain a version for
238         the compiler.
239
240 cf_by (cf_who.U):
241         Login name of the person who ran the Configure script and answered the
242         questions. This is used to tag both config.sh and config_h.SH.
243
244 cf_email (cf_email.U):
245         Electronic mail address of the person who ran Configure. This can be
246         used by units that require the user's e-mail, like MailList.U.
247
248 cf_time (cf_who.U):
249         Holds the output of the "date" command when the configuration file was
250         produced. This is used to tag both config.sh and config_h.SH.
251
252 charbits (charsize.U):
253         This variable contains the value of the CHARBITS symbol, which
254         indicates to the C program how many bits there are in a character.
255
256 charsize (charsize.U):
257         This variable contains the value of the CHARSIZE symbol, which
258         indicates to the C program how many bytes there are in a character.
259
260 chgrp (Loc.U):
261         This variable is defined but not used by Configure.
262         The value is the empty string and is not useful.
263
264 chmod (Loc.U):
265         This variable is used internally by Configure to determine the
266         full pathname (if any) of the chmod program.  After Configure runs,
267         the value is reset to a plain "chmod" and is not useful.
268
269 chown (Loc.U):
270         This variable is defined but not used by Configure.
271         The value is the empty string and is not useful.
272
273 clocktype (d_times.U):
274         This variable holds the type returned by times(). It can be long,
275         or clock_t on BSD sites (in which case <sys/types.h> should be
276         included).
277
278 comm (Loc.U):
279         This variable is used internally by Configure to determine the
280         full pathname (if any) of the comm program.  After Configure runs,
281         the value is reset to a plain "comm" and is not useful.
282
283 compress (Loc.U):
284         This variable is defined but not used by Configure.
285         The value is the empty string and is not useful.
286
287 contains (contains.U):
288         This variable holds the command to do a grep with a proper return
289         status.  On most sane systems it is simply "grep".  On insane systems
290         it is a grep followed by a cat followed by a test.  This variable
291         is primarily for the use of other Configure units.
292
293 cp (Loc.U):
294         This variable is used internally by Configure to determine the
295         full pathname (if any) of the cp program.  After Configure runs,
296         the value is reset to a plain "cp" and is not useful.
297
298 cpio (Loc.U):
299         This variable is defined but not used by Configure.
300         The value is the empty string and is not useful.
301
302 cpp (Loc.U):
303         This variable is used internally by Configure to determine the
304         full pathname (if any) of the cpp program.  After Configure runs,
305         the value is reset to a plain "cpp" and is not useful.
306
307 cpp_stuff (cpp_stuff.U):
308         This variable contains an identification of the concatenation mechanism
309         used by the C preprocessor.
310
311 cppccsymbols (Cppsym.U):
312         The variable contains the symbols defined by the C compiler
313         when it calls cpp.  The symbols defined by the cc alone or cpp
314         alone are not in this list, see ccsymbols and cppsymbols.
315         The list is a space-separated list of symbol=value tokens.
316
317 cppflags (ccflags.U):
318         This variable holds the flags that will be passed to the C pre-
319         processor. It is up to the Makefile to use it.
320
321 cpplast (cppstdin.U):
322         This variable has the same functionality as cppminus, only it applies
323         to cpprun and not cppstdin.
324
325 cppminus (cppstdin.U):
326         This variable contains the second part of the string which will invoke
327         the C preprocessor on the standard input and produce to standard
328         output.  This variable will have the value "-" if cppstdin needs
329         a minus to specify standard input, otherwise the value is "".
330
331 cpprun (cppstdin.U):
332         This variable contains the command which will invoke a C preprocessor
333         on standard input and put the output to stdout. It is guaranteed not
334         to be a wrapper and may be a null string if no preprocessor can be
335         made directly available. This preprocessor might be different from the
336         one used by the C compiler. Don't forget to append cpplast after the
337         preprocessor options.
338
339 cppstdin (cppstdin.U):
340         This variable contains the command which will invoke the C
341         preprocessor on standard input and put the output to stdout.
342         It is primarily used by other Configure units that ask about
343         preprocessor symbols.
344
345 cppsymbols (Cppsym.U):
346         The variable contains the symbols defined by the C preprocessor
347         alone.  The symbols defined by cc or by cc when it calls cpp are
348         not in this list, see ccsymbols and cppccsymbols.
349         The list is a space-separated list of symbol=value tokens.
350
351 crypt_r_proto (d_crypt_r.U):
352         This variable encodes the prototype of crypt_r.
353         It is zero if d_crypt_r is undef, and one of the
354         REENTRANT_PROTO_T_ABC macros of reentr.h if d_crypt_r
355         is defined.
356
357 cryptlib (d_crypt.U):
358         This variable holds -lcrypt or the path to a libcrypt.a archive if
359         the crypt() function is not defined in the standard C library. It is
360         up to the Makefile to use this.
361
362 csh (Loc.U):
363         This variable is used internally by Configure to determine the
364         full pathname (if any) of the csh program.  After Configure runs,
365         the value is reset to a plain "csh" and is not useful.
366
367 ctermid_r_proto (d_ctermid_r.U):
368         This variable encodes the prototype of ctermid_r.
369         It is zero if d_ctermid_r is undef, and one of the
370         REENTRANT_PROTO_T_ABC macros of reentr.h if d_ctermid_r
371         is defined.
372
373 ctime_r_proto (d_ctime_r.U):
374         This variable encodes the prototype of ctime_r.
375         It is zero if d_ctime_r is undef, and one of the
376         REENTRANT_PROTO_T_ABC macros of reentr.h if d_ctime_r
377         is defined.
378
379 d__fwalk (d__fwalk.U):
380         This variable conditionally defines HAS__FWALK if _fwalk() is
381         available to apply a function to all the file handles.
382
383 d_access (d_access.U):
384         This variable conditionally defines HAS_ACCESS if the access() system
385         call is available to check for access permissions using real IDs.
386
387 d_accessx (d_accessx.U):
388         This variable conditionally defines the HAS_ACCESSX symbol, which
389         indicates to the C program that the accessx() routine is available.
390
391 d_aintl (d_aintl.U):
392         This variable conditionally defines the HAS_AINTL symbol, which
393         indicates to the C program that the aintl() routine is available.
394         If copysignl is also present we can emulate modfl.
395
396 d_alarm (d_alarm.U):
397         This variable conditionally defines the HAS_ALARM symbol, which
398         indicates to the C program that the alarm() routine is available.
399
400 d_archlib (archlib.U):
401         This variable conditionally defines ARCHLIB to hold the pathname
402         of architecture-dependent library files for $package.  If
403         $archlib is the same as $privlib, then this is set to undef.
404
405 d_asctime64 (d_timefuncs64.U):
406         This variable conditionally defines the HAS_ASCTIME64 symbol, which
407         indicates to the C program that the asctime64 () routine is available.
408
409 d_asctime_r (d_asctime_r.U):
410         This variable conditionally defines the HAS_ASCTIME_R symbol,
411         which indicates to the C program that the asctime_r()
412         routine is available.
413
414 d_atolf (atolf.U):
415         This variable conditionally defines the HAS_ATOLF symbol, which
416         indicates to the C program that the atolf() routine is available.
417
418 d_atoll (atoll.U):
419         This variable conditionally defines the HAS_ATOLL symbol, which
420         indicates to the C program that the atoll() routine is available.
421
422 d_attribute_deprecated (d_attribut.U):
423         This variable conditionally defines HASATTRIBUTE_DEPRECATED, which
424         indicates that GCC can handle the attribute for marking deprecated
425         APIs
426
427 d_attribute_format (d_attribut.U):
428         This variable conditionally defines HASATTRIBUTE_FORMAT, which
429         indicates the C compiler can check for printf-like formats.
430
431 d_attribute_malloc (d_attribut.U):
432         This variable conditionally defines HASATTRIBUTE_MALLOC, which
433         indicates the C compiler can understand functions as having
434         malloc-like semantics.
435
436 d_attribute_nonnull (d_attribut.U):
437         This variable conditionally defines HASATTRIBUTE_NONNULL, which
438         indicates that the C compiler can know that certain arguments
439         must not be NULL, and will check accordingly at compile time.
440
441 d_attribute_noreturn (d_attribut.U):
442         This variable conditionally defines HASATTRIBUTE_NORETURN, which
443         indicates that the C compiler can know that certain functions
444         are guaranteed never to return.
445
446 d_attribute_pure (d_attribut.U):
447         This variable conditionally defines HASATTRIBUTE_PURE, which
448         indicates that the C compiler can know that certain functions
449         are "pure" functions, meaning that they have no side effects, and
450         only rely on function input and/or global data for their results.
451
452 d_attribute_unused (d_attribut.U):
453         This variable conditionally defines HASATTRIBUTE_UNUSED, which
454         indicates that the C compiler can know that certain variables
455         and arguments may not always be used, and to not throw warnings
456         if they don't get used.
457
458 d_attribute_warn_unused_result (d_attribut.U):
459         This variable conditionally defines
460         HASATTRIBUTE_WARN_UNUSED_RESULT, which indicates that the C
461         compiler can know that certain functions have a return values
462         that must not be ignored, such as malloc() or open().
463
464 d_bcmp (d_bcmp.U):
465         This variable conditionally defines the HAS_BCMP symbol if
466         the bcmp() routine is available to compare strings.
467
468 d_bcopy (d_bcopy.U):
469         This variable conditionally defines the HAS_BCOPY symbol if
470         the bcopy() routine is available to copy strings.
471
472 d_bsd (Guess.U):
473         This symbol conditionally defines the symbol BSD when running on a
474         BSD system.
475
476 d_bsdgetpgrp (d_getpgrp.U):
477         This variable conditionally defines USE_BSD_GETPGRP if
478         getpgrp needs one arguments whereas USG one needs none.
479
480 d_bsdsetpgrp (d_setpgrp.U):
481         This variable conditionally defines USE_BSD_SETPGRP if
482         setpgrp needs two arguments whereas USG one needs none.
483         See also d_setpgid for a POSIX interface.
484
485 d_builtin_choose_expr (d_builtin.U):
486         This conditionally defines HAS_BUILTIN_CHOOSE_EXPR, which
487         indicates that the compiler supports __builtin_choose_expr(x,y,z).
488         This built-in function is analogous to the "x?y:z" operator in C,
489         except that the expression returned has its type unaltered by
490         promotion rules. Also, the built-in function does not evaluate
491         the expression that was not chosen.
492
493 d_builtin_expect (d_builtin.U):
494         This conditionally defines HAS_BUILTIN_EXPECT, which indicates
495         that the compiler supports __builtin_expect(exp,c).  You may use
496         __builtin_expect to provide the compiler with branch prediction
497         information.
498
499 d_bzero (d_bzero.U):
500         This variable conditionally defines the HAS_BZERO symbol if
501         the bzero() routine is available to set memory to 0.
502
503 d_c99_variadic_macros (d_c99_variadic.U):
504         This variable conditionally defines the HAS_C99_VARIADIC_MACROS
505         symbol, which indicates to the C program that C99 variadic macros
506         are available.
507
508 d_casti32 (d_casti32.U):
509         This variable conditionally defines CASTI32, which indicates
510         whether the C compiler can cast large floats to 32-bit ints.
511
512 d_castneg (d_castneg.U):
513         This variable conditionally defines CASTNEG, which indicates
514         wether the C compiler can cast negative float to unsigned.
515
516 d_charvspr (d_vprintf.U):
517         This variable conditionally defines CHARVSPRINTF if this system
518         has vsprintf returning type (char*).  The trend seems to be to
519         declare it as "int vsprintf()".
520
521 d_chown (d_chown.U):
522         This variable conditionally defines the HAS_CHOWN symbol, which
523         indicates to the C program that the chown() routine is available.
524
525 d_chroot (d_chroot.U):
526         This variable conditionally defines the HAS_CHROOT symbol, which
527         indicates to the C program that the chroot() routine is available.
528
529 d_chsize (d_chsize.U):
530         This variable conditionally defines the CHSIZE symbol, which
531         indicates to the C program that the chsize() routine is available
532         to truncate files.  You might need a -lx to get this routine.
533
534 d_class (d_class.U):
535         This variable conditionally defines the HAS_CLASS symbol, which
536         indicates to the C program that the class() routine is available.
537
538 d_clearenv (d_clearenv.U):
539         This variable conditionally defines the HAS_CLEARENV symbol, which
540         indicates to the C program that the clearenv () routine is available.
541
542 d_closedir (d_closedir.U):
543         This variable conditionally defines HAS_CLOSEDIR if closedir() is
544         available.
545
546 d_cmsghdr_s (d_cmsghdr_s.U):
547         This variable conditionally defines the HAS_STRUCT_CMSGHDR symbol,
548         which indicates that the struct cmsghdr is supported.
549
550 d_const (d_const.U):
551         This variable conditionally defines the HASCONST symbol, which
552         indicates to the C program that this C compiler knows about the
553         const type.
554
555 d_copysignl (d_copysignl.U):
556         This variable conditionally defines the HAS_COPYSIGNL symbol, which
557         indicates to the C program that the copysignl() routine is available.
558         If aintl is also present we can emulate modfl.
559
560 d_cplusplus (d_cplusplus.U):
561         This variable conditionally defines the USE_CPLUSPLUS symbol, which
562         indicates that a C++ compiler was used to compiled Perl and will be
563         used to compile extensions.
564
565 d_crypt (d_crypt.U):
566         This variable conditionally defines the CRYPT symbol, which
567         indicates to the C program that the crypt() routine is available
568         to encrypt passwords and the like.
569
570 d_crypt_r (d_crypt_r.U):
571         This variable conditionally defines the HAS_CRYPT_R symbol,
572         which indicates to the C program that the crypt_r()
573         routine is available.
574
575 d_csh (d_csh.U):
576         This variable conditionally defines the CSH symbol, which
577         indicates to the C program that the C-shell exists.
578
579 d_ctermid (d_ctermid.U):
580         This variable conditionally defines CTERMID if ctermid() is
581         available to generate filename for terminal.
582
583 d_ctermid_r (d_ctermid_r.U):
584         This variable conditionally defines the HAS_CTERMID_R symbol,
585         which indicates to the C program that the ctermid_r()
586         routine is available.
587
588 d_ctime64 (d_timefuncs64.U):
589         This variable conditionally defines the HAS_CTIME64 symbol, which
590         indicates to the C program that the ctime64 () routine is available.
591
592 d_ctime_r (d_ctime_r.U):
593         This variable conditionally defines the HAS_CTIME_R symbol,
594         which indicates to the C program that the ctime_r()
595         routine is available.
596
597 d_cuserid (d_cuserid.U):
598         This variable conditionally defines the HAS_CUSERID symbol, which
599         indicates to the C program that the cuserid() routine is available
600         to get character login names.
601
602 d_dbl_dig (d_dbl_dig.U):
603         This variable conditionally defines d_dbl_dig if this system's
604         header files provide DBL_DIG, which is the number of significant
605         digits in a double precision number.
606
607 d_dbminitproto (d_dbminitproto.U):
608         This variable conditionally defines the HAS_DBMINIT_PROTO symbol,
609         which indicates to the C program that the system provides
610         a prototype for the dbminit() function.  Otherwise, it is
611         up to the program to supply one.
612
613 d_difftime (d_difftime.U):
614         This variable conditionally defines the HAS_DIFFTIME symbol, which
615         indicates to the C program that the difftime() routine is available.
616
617 d_difftime64 (d_timefuncs64.U):
618         This variable conditionally defines the HAS_DIFFTIME64 symbol, which
619         indicates to the C program that the difftime64 () routine is available.
620
621 d_dir_dd_fd (d_dir_dd_fd.U):
622         This variable conditionally defines the HAS_DIR_DD_FD symbol, which
623         indicates that the DIR directory stream type contains a member
624         variable called dd_fd.
625
626 d_dirfd (d_dirfd.U):
627         This variable conditionally defines the HAS_DIRFD constant,
628         which indicates to the C program that dirfd() is available
629         to return the file descriptor of a directory stream.
630
631 d_dirnamlen (i_dirent.U):
632         This variable conditionally defines DIRNAMLEN, which indicates
633         to the C program that the length of directory entry names is
634         provided by a d_namelen field.
635
636 d_dlerror (d_dlerror.U):
637         This variable conditionally defines the HAS_DLERROR symbol, which
638         indicates to the C program that the dlerror() routine is available.
639
640 d_dlopen (d_dlopen.U):
641         This variable conditionally defines the HAS_DLOPEN symbol, which
642         indicates to the C program that the dlopen() routine is available.
643
644 d_dlsymun (d_dlsymun.U):
645         This variable conditionally defines DLSYM_NEEDS_UNDERSCORE, which
646         indicates that we need to prepend an underscore to the symbol
647         name before calling dlsym().
648
649 d_dosuid (d_dosuid.U):
650         This variable conditionally defines the symbol DOSUID, which
651         tells the C program that it should insert setuid emulation code
652         on hosts which have setuid #! scripts disabled.
653
654 d_drand48_r (d_drand48_r.U):
655         This variable conditionally defines the HAS_DRAND48_R symbol,
656         which indicates to the C program that the drand48_r()
657         routine is available.
658
659 d_drand48proto (d_drand48proto.U):
660         This variable conditionally defines the HAS_DRAND48_PROTO symbol,
661         which indicates to the C program that the system provides
662         a prototype for the drand48() function.  Otherwise, it is
663         up to the program to supply one.
664
665 d_dup2 (d_dup2.U):
666         This variable conditionally defines HAS_DUP2 if dup2() is
667         available to duplicate file descriptors.
668
669 d_eaccess (d_eaccess.U):
670         This variable conditionally defines the HAS_EACCESS symbol, which
671         indicates to the C program that the eaccess() routine is available.
672
673 d_endgrent (d_endgrent.U):
674         This variable conditionally defines the HAS_ENDGRENT symbol, which
675         indicates to the C program that the endgrent() routine is available
676         for sequential access of the group database.
677
678 d_endgrent_r (d_endgrent_r.U):
679         This variable conditionally defines the HAS_ENDGRENT_R symbol,
680         which indicates to the C program that the endgrent_r()
681         routine is available.
682
683 d_endhent (d_endhent.U):
684         This variable conditionally defines HAS_ENDHOSTENT if endhostent() is
685         available to close whatever was being used for host queries.
686
687 d_endhostent_r (d_endhostent_r.U):
688         This variable conditionally defines the HAS_ENDHOSTENT_R symbol,
689         which indicates to the C program that the endhostent_r()
690         routine is available.
691
692 d_endnent (d_endnent.U):
693         This variable conditionally defines HAS_ENDNETENT if endnetent() is
694         available to close whatever was being used for network queries.
695
696 d_endnetent_r (d_endnetent_r.U):
697         This variable conditionally defines the HAS_ENDNETENT_R symbol,
698         which indicates to the C program that the endnetent_r()
699         routine is available.
700
701 d_endpent (d_endpent.U):
702         This variable conditionally defines HAS_ENDPROTOENT if endprotoent() is
703         available to close whatever was being used for protocol queries.
704
705 d_endprotoent_r (d_endprotoent_r.U):
706         This variable conditionally defines the HAS_ENDPROTOENT_R symbol,
707         which indicates to the C program that the endprotoent_r()
708         routine is available.
709
710 d_endpwent (d_endpwent.U):
711         This variable conditionally defines the HAS_ENDPWENT symbol, which
712         indicates to the C program that the endpwent() routine is available
713         for sequential access of the passwd database.
714
715 d_endpwent_r (d_endpwent_r.U):
716         This variable conditionally defines the HAS_ENDPWENT_R symbol,
717         which indicates to the C program that the endpwent_r()
718         routine is available.
719
720 d_endsent (d_endsent.U):
721         This variable conditionally defines HAS_ENDSERVENT if endservent() is
722         available to close whatever was being used for service queries.
723
724 d_endservent_r (d_endservent_r.U):
725         This variable conditionally defines the HAS_ENDSERVENT_R symbol,
726         which indicates to the C program that the endservent_r()
727         routine is available.
728
729 d_eofnblk (nblock_io.U):
730         This variable conditionally defines EOF_NONBLOCK if EOF can be seen
731         when reading from a non-blocking I/O source.
732
733 d_eunice (Guess.U):
734         This variable conditionally defines the symbols EUNICE and VAX, which
735         alerts the C program that it must deal with ideosyncracies of VMS.
736
737 d_faststdio (d_faststdio.U):
738         This variable conditionally defines the HAS_FAST_STDIO symbol,
739         which indicates to the C program that the "fast stdio" is available
740         to manipulate the stdio buffers directly.
741
742 d_fchdir (d_fchdir.U):
743         This variable conditionally defines the HAS_FCHDIR symbol, which
744         indicates to the C program that the fchdir() routine is available.
745
746 d_fchmod (d_fchmod.U):
747         This variable conditionally defines the HAS_FCHMOD symbol, which
748         indicates to the C program that the fchmod() routine is available
749         to change mode of opened files.
750
751 d_fchown (d_fchown.U):
752         This variable conditionally defines the HAS_FCHOWN symbol, which
753         indicates to the C program that the fchown() routine is available
754         to change ownership of opened files.
755
756 d_fcntl (d_fcntl.U):
757         This variable conditionally defines the HAS_FCNTL symbol, and indicates
758         whether the fcntl() function exists
759
760 d_fcntl_can_lock (d_fcntl_can_lock.U):
761         This variable conditionally defines the FCNTL_CAN_LOCK symbol
762         and indicates whether file locking with fcntl() works.
763
764 d_fd_macros (d_fd_set.U):
765         This variable contains the eventual value of the HAS_FD_MACROS symbol,
766         which indicates if your C compiler knows about the macros which
767         manipulate an fd_set.
768
769 d_fd_set (d_fd_set.U):
770         This variable contains the eventual value of the HAS_FD_SET symbol,
771         which indicates if your C compiler knows about the fd_set typedef.
772
773 d_fds_bits (d_fd_set.U):
774         This variable contains the eventual value of the HAS_FDS_BITS symbol,
775         which indicates if your fd_set typedef contains the fds_bits member.
776         If you have an fd_set typedef, but the dweebs who installed it did
777         a half-fast job and neglected to provide the macros to manipulate
778         an fd_set, HAS_FDS_BITS will let us know how to fix the gaffe.
779
780 d_fgetpos (d_fgetpos.U):
781         This variable conditionally defines HAS_FGETPOS if fgetpos() is
782         available to get the file position indicator.
783
784 d_finite (d_finite.U):
785         This variable conditionally defines the HAS_FINITE symbol, which
786         indicates to the C program that the finite() routine is available.
787
788 d_finitel (d_finitel.U):
789         This variable conditionally defines the HAS_FINITEL symbol, which
790         indicates to the C program that the finitel() routine is available.
791
792 d_flexfnam (d_flexfnam.U):
793         This variable conditionally defines the FLEXFILENAMES symbol, which
794         indicates that the system supports filenames longer than 14 characters.
795
796 d_flock (d_flock.U):
797         This variable conditionally defines HAS_FLOCK if flock() is
798         available to do file locking.
799
800 d_flockproto (d_flockproto.U):
801         This variable conditionally defines the HAS_FLOCK_PROTO symbol,
802         which indicates to the C program that the system provides
803         a prototype for the flock() function.  Otherwise, it is
804         up to the program to supply one.
805
806 d_fork (d_fork.U):
807         This variable conditionally defines the HAS_FORK symbol, which
808         indicates to the C program that the fork() routine is available.
809
810 d_fp_class (d_fp_class.U):
811         This variable conditionally defines the HAS_FP_CLASS symbol, which
812         indicates to the C program that the fp_class() routine is available.
813
814 d_fpathconf (d_pathconf.U):
815         This variable conditionally defines the HAS_FPATHCONF symbol, which
816         indicates to the C program that the pathconf() routine is available
817         to determine file-system related limits and options associated
818         with a given open file descriptor.
819
820 d_fpclass (d_fpclass.U):
821         This variable conditionally defines the HAS_FPCLASS symbol, which
822         indicates to the C program that the fpclass() routine is available.
823
824 d_fpclassify (d_fpclassify.U):
825         This variable conditionally defines the HAS_FPCLASSIFY symbol, which
826         indicates to the C program that the fpclassify() routine is available.
827
828 d_fpclassl (d_fpclassl.U):
829         This variable conditionally defines the HAS_FPCLASSL symbol, which
830         indicates to the C program that the fpclassl() routine is available.
831
832 d_fpos64_t (d_fpos64_t.U):
833         This symbol will be defined if the C compiler supports fpos64_t.
834
835 d_frexpl (d_frexpl.U):
836         This variable conditionally defines the HAS_FREXPL symbol, which
837         indicates to the C program that the frexpl() routine is available.
838
839 d_fs_data_s (d_fs_data_s.U):
840         This variable conditionally defines the HAS_STRUCT_FS_DATA symbol,
841         which indicates that the struct fs_data is supported.
842
843 d_fseeko (d_fseeko.U):
844         This variable conditionally defines the HAS_FSEEKO symbol, which
845         indicates to the C program that the fseeko() routine is available.
846
847 d_fsetpos (d_fsetpos.U):
848         This variable conditionally defines HAS_FSETPOS if fsetpos() is
849         available to set the file position indicator.
850
851 d_fstatfs (d_fstatfs.U):
852         This variable conditionally defines the HAS_FSTATFS symbol, which
853         indicates to the C program that the fstatfs() routine is available.
854
855 d_fstatvfs (d_statvfs.U):
856         This variable conditionally defines the HAS_FSTATVFS symbol, which
857         indicates to the C program that the fstatvfs() routine is available.
858
859 d_fsync (d_fsync.U):
860         This variable conditionally defines the HAS_FSYNC symbol, which
861         indicates to the C program that the fsync() routine is available.
862
863 d_ftello (d_ftello.U):
864         This variable conditionally defines the HAS_FTELLO symbol, which
865         indicates to the C program that the ftello() routine is available.
866
867 d_ftime (d_ftime.U):
868         This variable conditionally defines the HAS_FTIME symbol, which indicates
869         that the ftime() routine exists.  The ftime() routine is basically
870         a sub-second accuracy clock.
871
872 d_futimes (d_futimes.U):
873         This variable conditionally defines the HAS_FUTIMES symbol, which
874         indicates to the C program that the futimes() routine is available.
875
876 d_Gconvert (d_gconvert.U):
877         This variable holds what Gconvert is defined as to convert
878         floating point numbers into strings.  By default, Configure
879         sets this macro to use the first of gconvert, gcvt, or sprintf
880         that pass sprintf-%g-like behaviour tests.  If perl is using
881         long doubles, the macro uses the first of the following
882         functions that pass Configure's tests: qgcvt, sprintf (if
883         Configure knows how to make sprintf format long doubles--see
884         sPRIgldbl), gconvert, gcvt, and sprintf (casting to double).
885         The gconvert_preference and gconvert_ld_preference variables
886         can be used to alter Configure's preferences, for doubles and
887         long doubles, respectively.  If present, they contain a
888         space-separated list of one or more of the above function
889         names in the order they should be tried.
890
891         d_Gconvert may be set to override Configure with a platform-
892         specific function.  If this function expects a double, a
893         different value may need to be set by the uselongdouble.cbu
894         call-back unit so that long doubles can be formatted without
895         loss of precision.
896
897 d_gdbm_ndbm_h_uses_prototypes (i_ndbm.U):
898         This variable conditionally defines the NDBM_H_USES_PROTOTYPES symbol,
899         which indicates that the gdbm-ndbm.h include file uses real ANSI C
900         prototypes instead of K&R style function declarations. K&R style
901         declarations are unsupported in C++, so the include file requires
902         special handling when using a C++ compiler and this variable is
903         undefined. Consult the different d_*ndbm_h_uses_prototypes variables
904         to get the same information for alternative ndbm.h include files.
905
906 d_gdbmndbm_h_uses_prototypes (i_ndbm.U):
907         This variable conditionally defines the NDBM_H_USES_PROTOTYPES symbol,
908         which indicates that the gdbm/ndbm.h include file uses real ANSI C
909         prototypes instead of K&R style function declarations. K&R style
910         declarations are unsupported in C++, so the include file requires
911         special handling when using a C++ compiler and this variable is
912         undefined. Consult the different d_*ndbm_h_uses_prototypes variables
913         to get the same information for alternative ndbm.h include files.
914
915 d_getaddrinfo (d_getaddrinfo.U):
916         This variable conditionally defines the HAS_GETADDRINFO symbol,
917         which indicates to the C program that the getaddrinfo() function
918         is available.
919
920 d_getcwd (d_getcwd.U):
921         This variable conditionally defines the HAS_GETCWD symbol, which
922         indicates to the C program that the getcwd() routine is available
923         to get the current working directory.
924
925 d_getespwnam (d_getespwnam.U):
926         This variable conditionally defines HAS_GETESPWNAM if getespwnam() is
927         available to retrieve enchanced (shadow) password entries by name.
928
929 d_getfsstat (d_getfsstat.U):
930         This variable conditionally defines the HAS_GETFSSTAT symbol, which
931         indicates to the C program that the getfsstat() routine is available.
932
933 d_getgrent (d_getgrent.U):
934         This variable conditionally defines the HAS_GETGRENT symbol, which
935         indicates to the C program that the getgrent() routine is available
936         for sequential access of the group database.
937
938 d_getgrent_r (d_getgrent_r.U):
939         This variable conditionally defines the HAS_GETGRENT_R symbol,
940         which indicates to the C program that the getgrent_r()
941         routine is available.
942
943 d_getgrgid_r (d_getgrgid_r.U):
944         This variable conditionally defines the HAS_GETGRGID_R symbol,
945         which indicates to the C program that the getgrgid_r()
946         routine is available.
947
948 d_getgrnam_r (d_getgrnam_r.U):
949         This variable conditionally defines the HAS_GETGRNAM_R symbol,
950         which indicates to the C program that the getgrnam_r()
951         routine is available.
952
953 d_getgrps (d_getgrps.U):
954         This variable conditionally defines the HAS_GETGROUPS symbol, which
955         indicates to the C program that the getgroups() routine is available
956         to get the list of process groups.
957
958 d_gethbyaddr (d_gethbyad.U):
959         This variable conditionally defines the HAS_GETHOSTBYADDR symbol, which
960         indicates to the C program that the gethostbyaddr() routine is available
961         to look up hosts by their IP addresses.
962
963 d_gethbyname (d_gethbynm.U):
964         This variable conditionally defines the HAS_GETHOSTBYNAME symbol, which
965         indicates to the C program that the gethostbyname() routine is available
966         to look up host names in some data base or other.
967
968 d_gethent (d_gethent.U):
969         This variable conditionally defines HAS_GETHOSTENT if gethostent() is
970         available to look up host names in some data base or another.
971
972 d_gethname (d_gethname.U):
973         This variable conditionally defines the HAS_GETHOSTNAME symbol, which
974         indicates to the C program that the gethostname() routine may be
975         used to derive the host name.
976
977 d_gethostbyaddr_r (d_gethostbyaddr_r.U):
978         This variable conditionally defines the HAS_GETHOSTBYADDR_R symbol,
979         which indicates to the C program that the gethostbyaddr_r()
980         routine is available.
981
982 d_gethostbyname_r (d_gethostbyname_r.U):
983         This variable conditionally defines the HAS_GETHOSTBYNAME_R symbol,
984         which indicates to the C program that the gethostbyname_r()
985         routine is available.
986
987 d_gethostent_r (d_gethostent_r.U):
988         This variable conditionally defines the HAS_GETHOSTENT_R symbol,
989         which indicates to the C program that the gethostent_r()
990         routine is available.
991
992 d_gethostprotos (d_gethostprotos.U):
993         This variable conditionally defines the HAS_GETHOST_PROTOS symbol,
994         which indicates to the C program that <netdb.h> supplies
995         prototypes for the various gethost*() functions.
996         See also netdbtype.U for probing for various netdb types.
997
998 d_getitimer (d_getitimer.U):
999         This variable conditionally defines the HAS_GETITIMER symbol, which
1000         indicates to the C program that the getitimer() routine is available.
1001
1002 d_getlogin (d_getlogin.U):
1003         This variable conditionally defines the HAS_GETLOGIN symbol, which
1004         indicates to the C program that the getlogin() routine is available
1005         to get the login name.
1006
1007 d_getlogin_r (d_getlogin_r.U):
1008         This variable conditionally defines the HAS_GETLOGIN_R symbol,
1009         which indicates to the C program that the getlogin_r()
1010         routine is available.
1011
1012 d_getmnt (d_getmnt.U):
1013         This variable conditionally defines the HAS_GETMNT symbol, which
1014         indicates to the C program that the getmnt() routine is available
1015         to retrieve one or more mount info blocks by filename.
1016
1017 d_getmntent (d_getmntent.U):
1018         This variable conditionally defines the HAS_GETMNTENT symbol, which
1019         indicates to the C program that the getmntent() routine is available
1020         to iterate through mounted files to get their mount info.
1021
1022 d_getnameinfo (d_getnameinfo.U):
1023         This variable conditionally defines the HAS_GETNAMEINFO symbol,
1024         which indicates to the C program that the getnameinfo() function
1025         is available.
1026
1027 d_getnbyaddr (d_getnbyad.U):
1028         This variable conditionally defines the HAS_GETNETBYADDR symbol, which
1029         indicates to the C program that the getnetbyaddr() routine is available
1030         to look up networks by their IP addresses.
1031
1032 d_getnbyname (d_getnbynm.U):
1033         This variable conditionally defines the HAS_GETNETBYNAME symbol, which
1034         indicates to the C program that the getnetbyname() routine is available
1035         to look up networks by their names.
1036
1037 d_getnent (d_getnent.U):
1038         This variable conditionally defines HAS_GETNETENT if getnetent() is
1039         available to look up network names in some data base or another.
1040
1041 d_getnetbyaddr_r (d_getnetbyaddr_r.U):
1042         This variable conditionally defines the HAS_GETNETBYADDR_R symbol,
1043         which indicates to the C program that the getnetbyaddr_r()
1044         routine is available.
1045
1046 d_getnetbyname_r (d_getnetbyname_r.U):
1047         This variable conditionally defines the HAS_GETNETBYNAME_R symbol,
1048         which indicates to the C program that the getnetbyname_r()
1049         routine is available.
1050
1051 d_getnetent_r (d_getnetent_r.U):
1052         This variable conditionally defines the HAS_GETNETENT_R symbol,
1053         which indicates to the C program that the getnetent_r()
1054         routine is available.
1055
1056 d_getnetprotos (d_getnetprotos.U):
1057         This variable conditionally defines the HAS_GETNET_PROTOS symbol,
1058         which indicates to the C program that <netdb.h> supplies
1059         prototypes for the various getnet*() functions.
1060         See also netdbtype.U for probing for various netdb types.
1061
1062 d_getpagsz (d_getpagsz.U):
1063         This variable conditionally defines HAS_GETPAGESIZE if getpagesize()
1064         is available to get the system page size.
1065
1066 d_getpbyname (d_getprotby.U):
1067         This variable conditionally defines the HAS_GETPROTOBYNAME
1068         symbol, which indicates to the C program that the
1069         getprotobyname() routine is available to look up protocols
1070         by their name.
1071
1072 d_getpbynumber (d_getprotby.U):
1073         This variable conditionally defines the HAS_GETPROTOBYNUMBER
1074         symbol, which indicates to the C program that the
1075         getprotobynumber() routine is available to look up protocols
1076         by their number.
1077
1078 d_getpent (d_getpent.U):
1079         This variable conditionally defines HAS_GETPROTOENT if getprotoent() is
1080         available to look up protocols in some data base or another.
1081
1082 d_getpgid (d_getpgid.U):
1083         This variable conditionally defines the HAS_GETPGID symbol, which
1084         indicates to the C program that the getpgid(pid) function
1085         is available to get the process group id.
1086
1087 d_getpgrp (d_getpgrp.U):
1088         This variable conditionally defines HAS_GETPGRP if getpgrp() is
1089         available to get the current process group.
1090
1091 d_getpgrp2 (d_getpgrp2.U):
1092         This variable conditionally defines the HAS_GETPGRP2 symbol, which
1093         indicates to the C program that the getpgrp2() (as in DG/UX) routine
1094         is available to get the current process group.
1095
1096 d_getppid (d_getppid.U):
1097         This variable conditionally defines the HAS_GETPPID symbol, which
1098         indicates to the C program that the getppid() routine is available
1099         to get the parent process ID.
1100
1101 d_getprior (d_getprior.U):
1102         This variable conditionally defines HAS_GETPRIORITY if getpriority()
1103         is available to get a process's priority.
1104
1105 d_getprotobyname_r (d_getprotobyname_r.U):
1106         This variable conditionally defines the HAS_GETPROTOBYNAME_R symbol,
1107         which indicates to the C program that the getprotobyname_r()
1108         routine is available.
1109
1110 d_getprotobynumber_r (d_getprotobynumber_r.U):
1111         This variable conditionally defines the HAS_GETPROTOBYNUMBER_R symbol,
1112         which indicates to the C program that the getprotobynumber_r()
1113         routine is available.
1114
1115 d_getprotoent_r (d_getprotoent_r.U):
1116         This variable conditionally defines the HAS_GETPROTOENT_R symbol,
1117         which indicates to the C program that the getprotoent_r()
1118         routine is available.
1119
1120 d_getprotoprotos (d_getprotoprotos.U):
1121         This variable conditionally defines the HAS_GETPROTO_PROTOS symbol,
1122         which indicates to the C program that <netdb.h> supplies
1123         prototypes for the various getproto*() functions.
1124         See also netdbtype.U for probing for various netdb types.
1125
1126 d_getprpwnam (d_getprpwnam.U):
1127         This variable conditionally defines HAS_GETPRPWNAM if getprpwnam() is
1128         available to retrieve protected (shadow) password entries by name.
1129
1130 d_getpwent (d_getpwent.U):
1131         This variable conditionally defines the HAS_GETPWENT symbol, which
1132         indicates to the C program that the getpwent() routine is available
1133         for sequential access of the passwd database.
1134
1135 d_getpwent_r (d_getpwent_r.U):
1136         This variable conditionally defines the HAS_GETPWENT_R symbol,
1137         which indicates to the C program that the getpwent_r()
1138         routine is available.
1139
1140 d_getpwnam_r (d_getpwnam_r.U):
1141         This variable conditionally defines the HAS_GETPWNAM_R symbol,
1142         which indicates to the C program that the getpwnam_r()
1143         routine is available.
1144
1145 d_getpwuid_r (d_getpwuid_r.U):
1146         This variable conditionally defines the HAS_GETPWUID_R symbol,
1147         which indicates to the C program that the getpwuid_r()
1148         routine is available.
1149
1150 d_getsbyname (d_getsrvby.U):
1151         This variable conditionally defines the HAS_GETSERVBYNAME
1152         symbol, which indicates to the C program that the
1153         getservbyname() routine is available to look up services
1154         by their name.
1155
1156 d_getsbyport (d_getsrvby.U):
1157         This variable conditionally defines the HAS_GETSERVBYPORT
1158         symbol, which indicates to the C program that the
1159         getservbyport() routine is available to look up services
1160         by their port.
1161
1162 d_getsent (d_getsent.U):
1163         This variable conditionally defines HAS_GETSERVENT if getservent() is
1164         available to look up network services in some data base or another.
1165
1166 d_getservbyname_r (d_getservbyname_r.U):
1167         This variable conditionally defines the HAS_GETSERVBYNAME_R symbol,
1168         which indicates to the C program that the getservbyname_r()
1169         routine is available.
1170
1171 d_getservbyport_r (d_getservbyport_r.U):
1172         This variable conditionally defines the HAS_GETSERVBYPORT_R symbol,
1173         which indicates to the C program that the getservbyport_r()
1174         routine is available.
1175
1176 d_getservent_r (d_getservent_r.U):
1177         This variable conditionally defines the HAS_GETSERVENT_R symbol,
1178         which indicates to the C program that the getservent_r()
1179         routine is available.
1180
1181 d_getservprotos (d_getservprotos.U):
1182         This variable conditionally defines the HAS_GETSERV_PROTOS symbol,
1183         which indicates to the C program that <netdb.h> supplies
1184         prototypes for the various getserv*() functions.
1185         See also netdbtype.U for probing for various netdb types.
1186
1187 d_getspnam (d_getspnam.U):
1188         This variable conditionally defines HAS_GETSPNAM if getspnam() is
1189         available to retrieve SysV shadow password entries by name.
1190
1191 d_getspnam_r (d_getspnam_r.U):
1192         This variable conditionally defines the HAS_GETSPNAM_R symbol,
1193         which indicates to the C program that the getspnam_r()
1194         routine is available.
1195
1196 d_gettimeod (d_ftime.U):
1197         This variable conditionally defines the HAS_GETTIMEOFDAY symbol, which
1198         indicates that the gettimeofday() system call exists (to obtain a
1199         sub-second accuracy clock). You should probably include <sys/resource.h>.
1200
1201 d_gmtime64 (d_timefuncs64.U):
1202         This variable conditionally defines the HAS_GMTIME64 symbol, which
1203         indicates to the C program that the gmtime64 () routine is available.
1204
1205 d_gmtime_r (d_gmtime_r.U):
1206         This variable conditionally defines the HAS_GMTIME_R symbol,
1207         which indicates to the C program that the gmtime_r()
1208         routine is available.
1209
1210 d_gnulibc (d_gnulibc.U):
1211         Defined if we're dealing with the GNU C Library.
1212
1213 d_grpasswd (i_grp.U):
1214         This variable conditionally defines GRPASSWD, which indicates
1215         that struct group in <grp.h> contains gr_passwd.
1216
1217 d_hasmntopt (d_hasmntopt.U):
1218         This variable conditionally defines the HAS_HASMNTOPT symbol, which
1219         indicates to the C program that the hasmntopt() routine is available
1220         to query the mount options of file systems.
1221
1222 d_htonl (d_htonl.U):
1223         This variable conditionally defines HAS_HTONL if htonl() and its
1224         friends are available to do network order byte swapping.
1225
1226 d_ilogbl (d_ilogbl.U):
1227         This variable conditionally defines the HAS_ILOGBL symbol, which
1228         indicates to the C program that the ilogbl() routine is available.
1229         If scalbnl is also present we can emulate frexpl.
1230
1231 d_inc_version_list (inc_version_list.U):
1232         This variable conditionally defines PERL_INC_VERSION_LIST.
1233         It is set to undef when PERL_INC_VERSION_LIST is empty.
1234
1235 d_index (d_strchr.U):
1236         This variable conditionally defines HAS_INDEX if index() and
1237         rindex() are available for string searching.
1238
1239 d_inetaton (d_inetaton.U):
1240         This variable conditionally defines the HAS_INET_ATON symbol, which
1241         indicates to the C program that the inet_aton() function is available
1242         to parse IP address "dotted-quad" strings.
1243
1244 d_inetntop (d_inetntop.U):
1245         This variable conditionally defines the HAS_INETNTOP symbol,
1246         which indicates to the C program that the inet_ntop() function
1247         is available.
1248
1249 d_inetpton (d_inetpton.U):
1250         This variable conditionally defines the HAS_INETPTON symbol,
1251         which indicates to the C program that the inet_pton() function
1252         is available.
1253
1254 d_int64_t (d_int64_t.U):
1255         This symbol will be defined if the C compiler supports int64_t.
1256
1257 d_isascii (d_isascii.U):
1258         This variable conditionally defines the HAS_ISASCII constant,
1259         which indicates to the C program that isascii() is available.
1260
1261 d_isfinite (d_isfinite.U):
1262         This variable conditionally defines the HAS_ISFINITE symbol, which
1263         indicates to the C program that the isfinite() routine is available.
1264
1265 d_isinf (d_isinf.U):
1266         This variable conditionally defines the HAS_ISINF symbol, which
1267         indicates to the C program that the isinf() routine is available.
1268
1269 d_isnan (d_isnan.U):
1270         This variable conditionally defines the HAS_ISNAN symbol, which
1271         indicates to the C program that the isnan() routine is available.
1272
1273 d_isnanl (d_isnanl.U):
1274         This variable conditionally defines the HAS_ISNANL symbol, which
1275         indicates to the C program that the isnanl() routine is available.
1276
1277 d_killpg (d_killpg.U):
1278         This variable conditionally defines the HAS_KILLPG symbol, which
1279         indicates to the C program that the killpg() routine is available
1280         to kill process groups.
1281
1282 d_lchown (d_lchown.U):
1283         This variable conditionally defines the HAS_LCHOWN symbol, which
1284         indicates to the C program that the lchown() routine is available
1285         to operate on a symbolic link (instead of following the link).
1286
1287 d_ldbl_dig (d_ldbl_dig.U):
1288         This variable conditionally defines d_ldbl_dig if this system's
1289         header files provide LDBL_DIG, which is the number of significant
1290         digits in a long double precision number.
1291
1292 d_libm_lib_version (d_libm_lib_version.U):
1293         This variable conditionally defines the LIBM_LIB_VERSION symbol,
1294         which indicates to the C program that math.h defines _LIB_VERSION
1295         being available in libm
1296
1297 d_link (d_link.U):
1298         This variable conditionally defines HAS_LINK if link() is
1299         available to create hard links.
1300
1301 d_localtime64 (d_timefuncs64.U):
1302         This variable conditionally defines the HAS_LOCALTIME64 symbol, which
1303         indicates to the C program that the localtime64 () routine is available.
1304
1305 d_localtime_r (d_localtime_r.U):
1306         This variable conditionally defines the HAS_LOCALTIME_R symbol,
1307         which indicates to the C program that the localtime_r()
1308         routine is available.
1309
1310 d_localtime_r_needs_tzset (d_localtime_r.U):
1311         This variable conditionally defines the LOCALTIME_R_NEEDS_TZSET
1312         symbol, which makes us call tzset before localtime_r()
1313
1314 d_locconv (d_locconv.U):
1315         This variable conditionally defines HAS_LOCALECONV if localeconv() is
1316         available for numeric and monetary formatting conventions.
1317
1318 d_lockf (d_lockf.U):
1319         This variable conditionally defines HAS_LOCKF if lockf() is
1320         available to do file locking.
1321
1322 d_longdbl (d_longdbl.U):
1323         This variable conditionally defines HAS_LONG_DOUBLE if
1324         the long double type is supported.
1325
1326 d_longlong (d_longlong.U):
1327         This variable conditionally defines HAS_LONG_LONG if
1328         the long long type is supported.
1329
1330 d_lseekproto (d_lseekproto.U):
1331         This variable conditionally defines the HAS_LSEEK_PROTO symbol,
1332         which indicates to the C program that the system provides
1333         a prototype for the lseek() function.  Otherwise, it is
1334         up to the program to supply one.
1335
1336 d_lstat (d_lstat.U):
1337         This variable conditionally defines HAS_LSTAT if lstat() is
1338         available to do file stats on symbolic links.
1339
1340 d_madvise (d_madvise.U):
1341         This variable conditionally defines HAS_MADVISE if madvise() is
1342         available to map a file into memory.
1343
1344 d_malloc_good_size (d_malloc_size.U):
1345         This symbol, if defined, indicates that the malloc_good_size
1346         routine is available for use.
1347
1348 d_malloc_size (d_malloc_size.U):
1349         This symbol, if defined, indicates that the malloc_size
1350         routine is available for use.
1351
1352 d_mblen (d_mblen.U):
1353         This variable conditionally defines the HAS_MBLEN symbol, which
1354         indicates to the C program that the mblen() routine is available
1355         to find the number of bytes in a multibye character.
1356
1357 d_mbstowcs (d_mbstowcs.U):
1358         This variable conditionally defines the HAS_MBSTOWCS symbol, which
1359         indicates to the C program that the mbstowcs() routine is available
1360         to convert a multibyte string into a wide character string.
1361
1362 d_mbtowc (d_mbtowc.U):
1363         This variable conditionally defines the HAS_MBTOWC symbol, which
1364         indicates to the C program that the mbtowc() routine is available
1365         to convert multibyte to a wide character.
1366
1367 d_memchr (d_memchr.U):
1368         This variable conditionally defines the HAS_MEMCHR symbol, which
1369         indicates to the C program that the memchr() routine is available
1370         to locate characters within a C string.
1371
1372 d_memcmp (d_memcmp.U):
1373         This variable conditionally defines the HAS_MEMCMP symbol, which
1374         indicates to the C program that the memcmp() routine is available
1375         to compare blocks of memory.
1376
1377 d_memcpy (d_memcpy.U):
1378         This variable conditionally defines the HAS_MEMCPY symbol, which
1379         indicates to the C program that the memcpy() routine is available
1380         to copy blocks of memory.
1381
1382 d_memmove (d_memmove.U):
1383         This variable conditionally defines the HAS_MEMMOVE symbol, which
1384         indicates to the C program that the memmove() routine is available
1385         to copy potentatially overlapping blocks of memory.
1386
1387 d_memset (d_memset.U):
1388         This variable conditionally defines the HAS_MEMSET symbol, which
1389         indicates to the C program that the memset() routine is available
1390         to set blocks of memory.
1391
1392 d_mkdir (d_mkdir.U):
1393         This variable conditionally defines the HAS_MKDIR symbol, which
1394         indicates to the C program that the mkdir() routine is available
1395         to create directories..
1396
1397 d_mkdtemp (d_mkdtemp.U):
1398         This variable conditionally defines the HAS_MKDTEMP symbol, which
1399         indicates to the C program that the mkdtemp() routine is available
1400         to exclusively create a uniquely named temporary directory.
1401
1402 d_mkfifo (d_mkfifo.U):
1403         This variable conditionally defines the HAS_MKFIFO symbol, which
1404         indicates to the C program that the mkfifo() routine is available.
1405
1406 d_mkstemp (d_mkstemp.U):
1407         This variable conditionally defines the HAS_MKSTEMP symbol, which
1408         indicates to the C program that the mkstemp() routine is available
1409         to exclusively create and open a uniquely named temporary file.
1410
1411 d_mkstemps (d_mkstemps.U):
1412         This variable conditionally defines the HAS_MKSTEMPS symbol, which
1413         indicates to the C program that the mkstemps() routine is available
1414         to exclusively create and open a uniquely named (with a suffix)
1415         temporary file.
1416
1417 d_mktime (d_mktime.U):
1418         This variable conditionally defines the HAS_MKTIME symbol, which
1419         indicates to the C program that the mktime() routine is available.
1420
1421 d_mktime64 (d_timefuncs64.U):
1422         This variable conditionally defines the HAS_MKTIME64 symbol, which
1423         indicates to the C program that the mktime64 () routine is available.
1424
1425 d_mmap (d_mmap.U):
1426         This variable conditionally defines HAS_MMAP if mmap() is
1427         available to map a file into memory.
1428
1429 d_modfl (d_modfl.U):
1430         This variable conditionally defines the HAS_MODFL symbol, which
1431         indicates to the C program that the modfl() routine is available.
1432
1433 d_modfl_pow32_bug (d_modfl.U):
1434         This variable conditionally defines the HAS_MODFL_POW32_BUG symbol,
1435         which indicates that modfl() is broken for long doubles >= pow(2, 32).
1436         For example from 4294967303.150000 one would get 4294967302.000000
1437         and 1.150000.  The bug has been seen in certain versions of glibc,
1438         release 2.2.2 is known to be okay.
1439
1440 d_modflproto (d_modfl.U):
1441         This symbol, if defined, indicates that the system provides
1442         a prototype for the modfl() function.  Otherwise, it is up
1443         to the program to supply one.  C99 says it should be
1444         long double modfl(long double, long double *);
1445
1446 d_mprotect (d_mprotect.U):
1447         This variable conditionally defines HAS_MPROTECT if mprotect() is
1448         available to modify the access protection of a memory mapped file.
1449
1450 d_msg (d_msg.U):
1451         This variable conditionally defines the HAS_MSG symbol, which
1452         indicates that the entire msg*(2) library is present.
1453
1454 d_msg_ctrunc (d_socket.U):
1455         This variable conditionally defines the HAS_MSG_CTRUNC symbol,
1456         which indicates that the MSG_CTRUNC is available.  #ifdef is
1457         not enough because it may be an enum, glibc has been known to do this.
1458
1459 d_msg_dontroute (d_socket.U):
1460         This variable conditionally defines the HAS_MSG_DONTROUTE symbol,
1461         which indicates that the MSG_DONTROUTE is available.  #ifdef is
1462         not enough because it may be an enum, glibc has been known to do this.
1463
1464 d_msg_oob (d_socket.U):
1465         This variable conditionally defines the HAS_MSG_OOB symbol,
1466         which indicates that the MSG_OOB is available.  #ifdef is
1467         not enough because it may be an enum, glibc has been known to do this.
1468
1469 d_msg_peek (d_socket.U):
1470         This variable conditionally defines the HAS_MSG_PEEK symbol,
1471         which indicates that the MSG_PEEK is available.  #ifdef is
1472         not enough because it may be an enum, glibc has been known to do this.
1473
1474 d_msg_proxy (d_socket.U):
1475         This variable conditionally defines the HAS_MSG_PROXY symbol,
1476         which indicates that the MSG_PROXY is available.  #ifdef is
1477         not enough because it may be an enum, glibc has been known to do this.
1478
1479 d_msgctl (d_msgctl.U):
1480         This variable conditionally defines the HAS_MSGCTL symbol, which
1481         indicates to the C program that the msgctl() routine is available.
1482
1483 d_msgget (d_msgget.U):
1484         This variable conditionally defines the HAS_MSGGET symbol, which
1485         indicates to the C program that the msgget() routine is available.
1486
1487 d_msghdr_s (d_msghdr_s.U):
1488         This variable conditionally defines the HAS_STRUCT_MSGHDR symbol,
1489         which indicates that the struct msghdr is supported.
1490
1491 d_msgrcv (d_msgrcv.U):
1492         This variable conditionally defines the HAS_MSGRCV symbol, which
1493         indicates to the C program that the msgrcv() routine is available.
1494
1495 d_msgsnd (d_msgsnd.U):
1496         This variable conditionally defines the HAS_MSGSND symbol, which
1497         indicates to the C program that the msgsnd() routine is available.
1498
1499 d_msync (d_msync.U):
1500         This variable conditionally defines HAS_MSYNC if msync() is
1501         available to synchronize a mapped file.
1502
1503 d_munmap (d_munmap.U):
1504         This variable conditionally defines HAS_MUNMAP if munmap() is
1505         available to unmap a region mapped by mmap().
1506
1507 d_mymalloc (mallocsrc.U):
1508         This variable conditionally defines MYMALLOC in case other parts
1509         of the source want to take special action if MYMALLOC is used.
1510         This may include different sorts of profiling or error detection.
1511
1512 d_ndbm (i_ndbm.U):
1513         This variable conditionally defines the HAS_NDBM symbol, which
1514         indicates that both the ndbm.h include file and an appropriate ndbm
1515         library exist.  Consult the different i_*ndbm variables
1516         to find out the actual include location.  Sometimes, a system has the
1517         header file but not the library.  This variable will only be set if
1518         the system has both.
1519
1520 d_ndbm_h_uses_prototypes (i_ndbm.U):
1521         This variable conditionally defines the NDBM_H_USES_PROTOTYPES symbol,
1522         which indicates that the ndbm.h include file uses real ANSI C
1523         prototypes instead of K&R style function declarations. K&R style
1524         declarations are unsupported in C++, so the include file requires
1525         special handling when using a C++ compiler and this variable is
1526         undefined. Consult the different d_*ndbm_h_uses_prototypes variables
1527         to get the same information for alternative ndbm.h include files.
1528
1529 d_nice (d_nice.U):
1530         This variable conditionally defines the HAS_NICE symbol, which
1531         indicates to the C program that the nice() routine is available.
1532
1533 d_nl_langinfo (d_nl_langinfo.U):
1534         This variable conditionally defines the HAS_NL_LANGINFO symbol, which
1535         indicates to the C program that the nl_langinfo() routine is available.
1536
1537 d_nv_preserves_uv (perlxv.U):
1538         This variable indicates whether a variable of type nvtype
1539         can preserve all the bits a variable of type uvtype.
1540
1541 d_nv_zero_is_allbits_zero (perlxv.U):
1542         This variable indicates whether a variable of type nvtype
1543         stores 0.0 in memory as all bits zero.
1544
1545 d_off64_t (d_off64_t.U):
1546         This symbol will be defined if the C compiler supports off64_t.
1547
1548 d_old_pthread_create_joinable (d_pthrattrj.U):
1549         This variable conditionally defines pthread_create_joinable.
1550         undef if pthread.h defines PTHREAD_CREATE_JOINABLE.
1551
1552 d_oldpthreads (usethreads.U):
1553         This variable conditionally defines the OLD_PTHREADS_API symbol,
1554         and indicates that Perl should be built to use the old
1555         draft POSIX threads API.  This is only potentially meaningful if
1556         usethreads is set.
1557
1558 d_oldsock (d_socket.U):
1559         This variable conditionally defines the OLDSOCKET symbol, which
1560         indicates that the BSD socket interface is based on 4.1c and not 4.2.
1561
1562 d_open3 (d_open3.U):
1563         This variable conditionally defines the HAS_OPEN3 manifest constant,
1564         which indicates to the C program that the 3 argument version of
1565         the open(2) function is available.
1566
1567 d_pathconf (d_pathconf.U):
1568         This variable conditionally defines the HAS_PATHCONF symbol, which
1569         indicates to the C program that the pathconf() routine is available
1570         to determine file-system related limits and options associated
1571         with a given filename.
1572
1573 d_pause (d_pause.U):
1574         This variable conditionally defines the HAS_PAUSE symbol, which
1575         indicates to the C program that the pause() routine is available
1576         to suspend a process until a signal is received.
1577
1578 d_perl_otherlibdirs (otherlibdirs.U):
1579         This variable conditionally defines PERL_OTHERLIBDIRS, which
1580         contains a colon-separated set of paths for the perl binary to
1581         include in @INC.  See also otherlibdirs.
1582
1583 d_phostname (d_gethname.U):
1584         This variable conditionally defines the HAS_PHOSTNAME symbol, which
1585         contains the shell command which, when fed to popen(), may be
1586         used to derive the host name.
1587
1588 d_pipe (d_pipe.U):
1589         This variable conditionally defines the HAS_PIPE symbol, which
1590         indicates to the C program that the pipe() routine is available
1591         to create an inter-process channel.
1592
1593 d_poll (d_poll.U):
1594         This variable conditionally defines the HAS_POLL symbol, which
1595         indicates to the C program that the poll() routine is available
1596         to poll active file descriptors.
1597
1598 d_portable (d_portable.U):
1599         This variable conditionally defines the PORTABLE symbol, which
1600         indicates to the C program that it should not assume that it is
1601         running on the machine it was compiled on.
1602
1603 d_PRId64 (quadfio.U):
1604         This variable conditionally defines the PERL_PRId64 symbol, which
1605         indiciates that stdio has a symbol to print 64-bit decimal numbers.
1606
1607 d_PRIeldbl (longdblfio.U):
1608         This variable conditionally defines the PERL_PRIfldbl symbol, which
1609         indiciates that stdio has a symbol to print long doubles.
1610
1611 d_PRIEUldbl (longdblfio.U):
1612         This variable conditionally defines the PERL_PRIfldbl symbol, which
1613         indiciates that stdio has a symbol to print long doubles.
1614         The 'U' in the name is to separate this from d_PRIeldbl so that even
1615         case-blind systems can see the difference.
1616
1617 d_PRIfldbl (longdblfio.U):
1618         This variable conditionally defines the PERL_PRIfldbl symbol, which
1619         indiciates that stdio has a symbol to print long doubles.
1620
1621 d_PRIFUldbl (longdblfio.U):
1622         This variable conditionally defines the PERL_PRIfldbl symbol, which
1623         indiciates that stdio has a symbol to print long doubles.
1624         The 'U' in the name is to separate this from d_PRIfldbl so that even
1625         case-blind systems can see the difference.
1626
1627 d_PRIgldbl (longdblfio.U):
1628         This variable conditionally defines the PERL_PRIfldbl symbol, which
1629         indiciates that stdio has a symbol to print long doubles.
1630
1631 d_PRIGUldbl (longdblfio.U):
1632         This variable conditionally defines the PERL_PRIfldbl symbol, which
1633         indiciates that stdio has a symbol to print long doubles.
1634         The 'U' in the name is to separate this from d_PRIgldbl so that even
1635         case-blind systems can see the difference.
1636
1637 d_PRIi64 (quadfio.U):
1638         This variable conditionally defines the PERL_PRIi64 symbol, which
1639         indiciates that stdio has a symbol to print 64-bit decimal numbers.
1640
1641 d_printf_format_null (d_attribut.U):
1642         This variable conditionally defines PRINTF_FORMAT_NULL_OK, which
1643         indicates the C compiler allows printf-like formats to be null.
1644
1645 d_PRIo64 (quadfio.U):
1646         This variable conditionally defines the PERL_PRIo64 symbol, which
1647         indiciates that stdio has a symbol to print 64-bit octal numbers.
1648
1649 d_PRIu64 (quadfio.U):
1650         This variable conditionally defines the PERL_PRIu64 symbol, which
1651         indiciates that stdio has a symbol to print 64-bit unsigned decimal
1652         numbers.
1653
1654 d_PRIx64 (quadfio.U):
1655         This variable conditionally defines the PERL_PRIx64 symbol, which
1656         indiciates that stdio has a symbol to print 64-bit hexadecimal numbers.
1657
1658 d_PRIXU64 (quadfio.U):
1659         This variable conditionally defines the PERL_PRIXU64 symbol, which
1660         indiciates that stdio has a symbol to print 64-bit hExADECimAl numbers.
1661         The 'U' in the name is to separate this from d_PRIx64 so that even
1662         case-blind systems can see the difference.
1663
1664 d_procselfexe (d_procselfexe.U):
1665         Defined if $procselfexe is symlink to the absolute
1666         pathname of the executing program.
1667
1668 d_pseudofork (d_vfork.U):
1669         This variable conditionally defines the HAS_PSEUDOFORK symbol,
1670         which indicates that an emulation of the fork routine is available.
1671
1672 d_pthread_atfork (d_pthread_atfork.U):
1673         This variable conditionally defines the HAS_PTHREAD_ATFORK symbol,
1674         which indicates to the C program that the pthread_atfork()
1675         routine is available.
1676
1677 d_pthread_attr_setscope (d_pthread_attr_ss.U):
1678         This variable conditionally defines HAS_PTHREAD_ATTR_SETSCOPE if
1679         pthread_attr_setscope() is available to set the contention scope
1680         attribute of a thread attribute object.
1681
1682 d_pthread_yield (d_pthread_y.U):
1683         This variable conditionally defines the HAS_PTHREAD_YIELD
1684         symbol if the pthread_yield routine is available to yield
1685         the execution of the current thread.
1686
1687 d_pwage (i_pwd.U):
1688         This variable conditionally defines PWAGE, which indicates
1689         that struct passwd contains pw_age.
1690
1691 d_pwchange (i_pwd.U):
1692         This variable conditionally defines PWCHANGE, which indicates
1693         that struct passwd contains pw_change.
1694
1695 d_pwclass (i_pwd.U):
1696         This variable conditionally defines PWCLASS, which indicates
1697         that struct passwd contains pw_class.
1698
1699 d_pwcomment (i_pwd.U):
1700         This variable conditionally defines PWCOMMENT, which indicates
1701         that struct passwd contains pw_comment.
1702
1703 d_pwexpire (i_pwd.U):
1704         This variable conditionally defines PWEXPIRE, which indicates
1705         that struct passwd contains pw_expire.
1706
1707 d_pwgecos (i_pwd.U):
1708         This variable conditionally defines PWGECOS, which indicates
1709         that struct passwd contains pw_gecos.
1710
1711 d_pwpasswd (i_pwd.U):
1712         This variable conditionally defines PWPASSWD, which indicates
1713         that struct passwd contains pw_passwd.
1714
1715 d_pwquota (i_pwd.U):
1716         This variable conditionally defines PWQUOTA, which indicates
1717         that struct passwd contains pw_quota.
1718
1719 d_qgcvt (d_qgcvt.U):
1720         This variable conditionally defines the HAS_QGCVT symbol, which
1721         indicates to the C program that the qgcvt() routine is available.
1722
1723 d_quad (quadtype.U):
1724         This variable, if defined, tells that there's a 64-bit integer type,
1725         quadtype.
1726
1727 d_random_r (d_random_r.U):
1728         This variable conditionally defines the HAS_RANDOM_R symbol,
1729         which indicates to the C program that the random_r()
1730         routine is available.
1731
1732 d_readdir (d_readdir.U):
1733         This variable conditionally defines HAS_READDIR if readdir() is
1734         available to read directory entries.
1735
1736 d_readdir64_r (d_readdir64_r.U):
1737         This variable conditionally defines the HAS_READDIR64_R symbol,
1738         which indicates to the C program that the readdir64_r()
1739         routine is available.
1740
1741 d_readdir_r (d_readdir_r.U):
1742         This variable conditionally defines the HAS_READDIR_R symbol,
1743         which indicates to the C program that the readdir_r()
1744         routine is available.
1745
1746 d_readlink (d_readlink.U):
1747         This variable conditionally defines the HAS_READLINK symbol, which
1748         indicates to the C program that the readlink() routine is available
1749         to read the value of a symbolic link.
1750
1751 d_readv (d_readv.U):
1752         This variable conditionally defines the HAS_READV symbol, which
1753         indicates to the C program that the readv() routine is available.
1754
1755 d_recvmsg (d_recvmsg.U):
1756         This variable conditionally defines the HAS_RECVMSG symbol, which
1757         indicates to the C program that the recvmsg() routine is available.
1758
1759 d_rename (d_rename.U):
1760         This variable conditionally defines the HAS_RENAME symbol, which
1761         indicates to the C program that the rename() routine is available
1762         to rename files.
1763
1764 d_rewinddir (d_readdir.U):
1765         This variable conditionally defines HAS_REWINDDIR if rewinddir() is
1766         available.
1767
1768 d_rmdir (d_rmdir.U):
1769         This variable conditionally defines HAS_RMDIR if rmdir() is
1770         available to remove directories.
1771
1772 d_safebcpy (d_safebcpy.U):
1773         This variable conditionally defines the HAS_SAFE_BCOPY symbol if
1774         the bcopy() routine can do overlapping copies.  Normally, you
1775         should probably use memmove().
1776
1777 d_safemcpy (d_safemcpy.U):
1778         This variable conditionally defines the HAS_SAFE_MEMCPY symbol if
1779         the memcpy() routine can do overlapping copies.
1780         For overlapping copies, memmove() should be used, if available.
1781
1782 d_sanemcmp (d_sanemcmp.U):
1783         This variable conditionally defines the HAS_SANE_MEMCMP symbol if
1784         the memcpy() routine is available and can be used to compare relative
1785         magnitudes of chars with their high bits set.
1786
1787 d_sbrkproto (d_sbrkproto.U):
1788         This variable conditionally defines the HAS_SBRK_PROTO symbol,
1789         which indicates to the C program that the system provides
1790         a prototype for the sbrk() function.  Otherwise, it is
1791         up to the program to supply one.
1792
1793 d_scalbnl (d_scalbnl.U):
1794         This variable conditionally defines the HAS_SCALBNL symbol, which
1795         indicates to the C program that the scalbnl() routine is available.
1796         If ilogbl is also present we can emulate frexpl.
1797
1798 d_sched_yield (d_pthread_y.U):
1799         This variable conditionally defines the HAS_SCHED_YIELD
1800         symbol if the sched_yield routine is available to yield
1801         the execution of the current thread.
1802
1803 d_scm_rights (d_socket.U):
1804         This variable conditionally defines the HAS_SCM_RIGHTS symbol,
1805         which indicates that the SCM_RIGHTS is available.  #ifdef is
1806         not enough because it may be an enum, glibc has been known to do this.
1807
1808 d_SCNfldbl (longdblfio.U):
1809         This variable conditionally defines the PERL_PRIfldbl symbol, which
1810         indiciates that stdio has a symbol to scan long doubles.
1811
1812 d_seekdir (d_readdir.U):
1813         This variable conditionally defines HAS_SEEKDIR if seekdir() is
1814         available.
1815
1816 d_select (d_select.U):
1817         This variable conditionally defines HAS_SELECT if select() is
1818         available to select active file descriptors. A <sys/time.h>
1819         inclusion may be necessary for the timeout field.
1820
1821 d_sem (d_sem.U):
1822         This variable conditionally defines the HAS_SEM symbol, which
1823         indicates that the entire sem*(2) library is present.
1824
1825 d_semctl (d_semctl.U):
1826         This variable conditionally defines the HAS_SEMCTL symbol, which
1827         indicates to the C program that the semctl() routine is available.
1828
1829 d_semctl_semid_ds (d_union_semun.U):
1830         This variable conditionally defines USE_SEMCTL_SEMID_DS, which
1831         indicates that struct semid_ds * is to be used for semctl IPC_STAT.
1832
1833 d_semctl_semun (d_union_semun.U):
1834         This variable conditionally defines USE_SEMCTL_SEMUN, which
1835         indicates that union semun is to be used for semctl IPC_STAT.
1836
1837 d_semget (d_semget.U):
1838         This variable conditionally defines the HAS_SEMGET symbol, which
1839         indicates to the C program that the semget() routine is available.
1840
1841 d_semop (d_semop.U):
1842         This variable conditionally defines the HAS_SEMOP symbol, which
1843         indicates to the C program that the semop() routine is available.
1844
1845 d_sendmsg (d_sendmsg.U):
1846         This variable conditionally defines the HAS_SENDMSG symbol, which
1847         indicates to the C program that the sendmsg() routine is available.
1848
1849 d_setegid (d_setegid.U):
1850         This variable conditionally defines the HAS_SETEGID symbol, which
1851         indicates to the C program that the setegid() routine is available
1852         to change the effective gid of the current program.
1853
1854 d_seteuid (d_seteuid.U):
1855         This variable conditionally defines the HAS_SETEUID symbol, which
1856         indicates to the C program that the seteuid() routine is available
1857         to change the effective uid of the current program.
1858
1859 d_setgrent (d_setgrent.U):
1860         This variable conditionally defines the HAS_SETGRENT symbol, which
1861         indicates to the C program that the setgrent() routine is available
1862         for initializing sequential access to the group database.
1863
1864 d_setgrent_r (d_setgrent_r.U):
1865         This variable conditionally defines the HAS_SETGRENT_R symbol,
1866         which indicates to the C program that the setgrent_r()
1867         routine is available.
1868
1869 d_setgrps (d_setgrps.U):
1870         This variable conditionally defines the HAS_SETGROUPS symbol, which
1871         indicates to the C program that the setgroups() routine is available
1872         to set the list of process groups.
1873
1874 d_sethent (d_sethent.U):
1875         This variable conditionally defines HAS_SETHOSTENT if sethostent() is
1876         available.
1877
1878 d_sethostent_r (d_sethostent_r.U):
1879         This variable conditionally defines the HAS_SETHOSTENT_R symbol,
1880         which indicates to the C program that the sethostent_r()
1881         routine is available.
1882
1883 d_setitimer (d_setitimer.U):
1884         This variable conditionally defines the HAS_SETITIMER symbol, which
1885         indicates to the C program that the setitimer() routine is available.
1886
1887 d_setlinebuf (d_setlnbuf.U):
1888         This variable conditionally defines the HAS_SETLINEBUF symbol, which
1889         indicates to the C program that the setlinebuf() routine is available
1890         to change stderr or stdout from block-buffered or unbuffered to a
1891         line-buffered mode.
1892
1893 d_setlocale (d_setlocale.U):
1894         This variable conditionally defines HAS_SETLOCALE if setlocale() is
1895         available to handle locale-specific ctype implementations.
1896
1897 d_setlocale_r (d_setlocale_r.U):
1898         This variable conditionally defines the HAS_SETLOCALE_R symbol,
1899         which indicates to the C program that the setlocale_r()
1900         routine is available.
1901
1902 d_setnent (d_setnent.U):
1903         This variable conditionally defines HAS_SETNETENT if setnetent() is
1904         available.
1905
1906 d_setnetent_r (d_setnetent_r.U):
1907         This variable conditionally defines the HAS_SETNETENT_R symbol,
1908         which indicates to the C program that the setnetent_r()
1909         routine is available.
1910
1911 d_setpent (d_setpent.U):
1912         This variable conditionally defines HAS_SETPROTOENT if setprotoent() is
1913         available.
1914
1915 d_setpgid (d_setpgid.U):
1916         This variable conditionally defines the HAS_SETPGID symbol if the
1917         setpgid(pid, gpid) function is available to set process group ID.
1918
1919 d_setpgrp (d_setpgrp.U):
1920         This variable conditionally defines HAS_SETPGRP if setpgrp() is
1921         available to set the current process group.
1922
1923 d_setpgrp2 (d_setpgrp2.U):
1924         This variable conditionally defines the HAS_SETPGRP2 symbol, which
1925         indicates to the C program that the setpgrp2() (as in DG/UX) routine
1926         is available to set the current process group.
1927
1928 d_setprior (d_setprior.U):
1929         This variable conditionally defines HAS_SETPRIORITY if setpriority()
1930         is available to set a process's priority.
1931
1932 d_setproctitle (d_setproctitle.U):
1933         This variable conditionally defines the HAS_SETPROCTITLE symbol,
1934         which indicates to the C program that the setproctitle() routine
1935         is available.
1936
1937 d_setprotoent_r (d_setprotoent_r.U):
1938         This variable conditionally defines the HAS_SETPROTOENT_R symbol,
1939         which indicates to the C program that the setprotoent_r()
1940         routine is available.
1941
1942 d_setpwent (d_setpwent.U):
1943         This variable conditionally defines the HAS_SETPWENT symbol, which
1944         indicates to the C program that the setpwent() routine is available
1945         for initializing sequential access to the passwd database.
1946
1947 d_setpwent_r (d_setpwent_r.U):
1948         This variable conditionally defines the HAS_SETPWENT_R symbol,
1949         which indicates to the C program that the setpwent_r()
1950         routine is available.
1951
1952 d_setregid (d_setregid.U):
1953         This variable conditionally defines HAS_SETREGID if setregid() is
1954         available to change the real and effective gid of the current
1955         process.
1956
1957 d_setresgid (d_setregid.U):
1958         This variable conditionally defines HAS_SETRESGID if setresgid() is
1959         available to change the real, effective and saved gid of the current
1960         process.
1961
1962 d_setresuid (d_setreuid.U):
1963         This variable conditionally defines HAS_SETREUID if setresuid() is
1964         available to change the real, effective and saved uid of the current
1965         process.
1966
1967 d_setreuid (d_setreuid.U):
1968         This variable conditionally defines HAS_SETREUID if setreuid() is
1969         available to change the real and effective uid of the current
1970         process.
1971
1972 d_setrgid (d_setrgid.U):
1973         This variable conditionally defines the HAS_SETRGID symbol, which
1974         indicates to the C program that the setrgid() routine is available
1975         to change the real gid of the current program.
1976
1977 d_setruid (d_setruid.U):
1978         This variable conditionally defines the HAS_SETRUID symbol, which
1979         indicates to the C program that the setruid() routine is available
1980         to change the real uid of the current program.
1981
1982 d_setsent (d_setsent.U):
1983         This variable conditionally defines HAS_SETSERVENT if setservent() is
1984         available.
1985
1986 d_setservent_r (d_setservent_r.U):
1987         This variable conditionally defines the HAS_SETSERVENT_R symbol,
1988         which indicates to the C program that the setservent_r()
1989         routine is available.
1990
1991 d_setsid (d_setsid.U):
1992         This variable conditionally defines HAS_SETSID if setsid() is
1993         available to set the process group ID.
1994
1995 d_setvbuf (d_setvbuf.U):
1996         This variable conditionally defines the HAS_SETVBUF symbol, which
1997         indicates to the C program that the setvbuf() routine is available
1998         to change buffering on an open stdio stream.
1999
2000 d_sfio (d_sfio.U):
2001         This variable conditionally defines the USE_SFIO symbol,
2002         and indicates whether sfio is available (and should be used).
2003
2004 d_shm (d_shm.U):
2005         This variable conditionally defines the HAS_SHM symbol, which
2006         indicates that the entire shm*(2) library is present.
2007
2008 d_shmat (d_shmat.U):
2009         This variable conditionally defines the HAS_SHMAT symbol, which
2010         indicates to the C program that the shmat() routine is available.
2011
2012 d_shmatprototype (d_shmat.U):
2013         This variable conditionally defines the HAS_SHMAT_PROTOTYPE
2014         symbol, which indicates that sys/shm.h has a prototype for
2015         shmat.
2016
2017 d_shmctl (d_shmctl.U):
2018         This variable conditionally defines the HAS_SHMCTL symbol, which
2019         indicates to the C program that the shmctl() routine is available.
2020
2021 d_shmdt (d_shmdt.U):
2022         This variable conditionally defines the HAS_SHMDT symbol, which
2023         indicates to the C program that the shmdt() routine is available.
2024
2025 d_shmget (d_shmget.U):
2026         This variable conditionally defines the HAS_SHMGET symbol, which
2027         indicates to the C program that the shmget() routine is available.
2028
2029 d_sigaction (d_sigaction.U):
2030         This variable conditionally defines the HAS_SIGACTION symbol, which
2031         indicates that the Vr4 sigaction() routine is available.
2032
2033 d_signbit (d_signbit.U):
2034         This variable conditionally defines the HAS_SIGNBIT symbol, which
2035         indicates to the C program that the signbit() routine is available
2036         and safe to use with perl's intern NV type.
2037
2038 d_sigprocmask (d_sigprocmask.U):
2039         This variable conditionally defines HAS_SIGPROCMASK
2040         if sigprocmask() is available to examine or change the signal mask
2041         of the calling process.
2042
2043 d_sigsetjmp (d_sigsetjmp.U):
2044         This variable conditionally defines the HAS_SIGSETJMP symbol,
2045         which indicates that the sigsetjmp() routine is available to
2046         call setjmp() and optionally save the process's signal mask.
2047
2048 d_sitearch (sitearch.U):
2049         This variable conditionally defines SITEARCH to hold the pathname
2050         of architecture-dependent library files for $package.  If
2051         $sitearch is the same as $archlib, then this is set to undef.
2052
2053 d_snprintf (d_snprintf.U):
2054         This variable conditionally defines the HAS_SNPRINTF symbol, which
2055         indicates to the C program that the snprintf () library function
2056         is available.
2057
2058 d_sockatmark (d_sockatmark.U):
2059         This variable conditionally defines the HAS_SOCKATMARK symbol, which
2060         indicates to the C program that the sockatmark() routine is available.
2061
2062 d_sockatmarkproto (d_sockatmarkproto.U):
2063         This variable conditionally defines the HAS_SOCKATMARK_PROTO symbol,
2064         which indicates to the C program that the system provides
2065         a prototype for the sockatmark() function.  Otherwise, it is
2066         up to the program to supply one.
2067
2068 d_socket (d_socket.U):
2069         This variable conditionally defines HAS_SOCKET, which indicates
2070         that the BSD socket interface is supported.
2071
2072 d_socklen_t (d_socklen_t.U):
2073         This symbol will be defined if the C compiler supports socklen_t.
2074
2075 d_sockpair (d_socket.U):
2076         This variable conditionally defines the HAS_SOCKETPAIR symbol, which
2077         indicates that the BSD socketpair() is supported.
2078
2079 d_socks5_init (d_socks5_init.U):
2080         This variable conditionally defines the HAS_SOCKS5_INIT symbol, which
2081         indicates to the C program that the socks5_init() routine is available.
2082
2083 d_sprintf_returns_strlen (d_sprintf_len.U):
2084         This variable defines whether sprintf returns the length of the string
2085         (as per the ANSI spec). Some C libraries retain compatibility with
2086         pre-ANSI C and return a pointer to the passed in buffer; for these
2087         this variable will be undef.
2088
2089 d_sqrtl (d_sqrtl.U):
2090         This variable conditionally defines the HAS_SQRTL symbol, which
2091         indicates to the C program that the sqrtl() routine is available.
2092
2093 d_srand48_r (d_srand48_r.U):
2094         This variable conditionally defines the HAS_SRAND48_R symbol,
2095         which indicates to the C program that the srand48_r()
2096         routine is available.
2097
2098 d_srandom_r (d_srandom_r.U):
2099         This variable conditionally defines the HAS_SRANDOM_R symbol,
2100         which indicates to the C program that the srandom_r()
2101         routine is available.
2102
2103 d_sresgproto (d_sresgproto.U):
2104         This variable conditionally defines the HAS_SETRESGID_PROTO symbol,
2105         which indicates to the C program that the system provides
2106         a prototype for the setresgid() function.  Otherwise, it is
2107         up to the program to supply one.
2108
2109 d_sresuproto (d_sresuproto.U):
2110         This variable conditionally defines the HAS_SETRESUID_PROTO symbol,
2111         which indicates to the C program that the system provides
2112         a prototype for the setresuid() function.  Otherwise, it is
2113         up to the program to supply one.
2114
2115 d_statblks (d_statblks.U):
2116         This variable conditionally defines USE_STAT_BLOCKS
2117         if this system has a stat structure declaring
2118         st_blksize and st_blocks.
2119
2120 d_statfs_f_flags (d_statfs_f_flags.U):
2121         This variable conditionally defines the HAS_STRUCT_STATFS_F_FLAGS
2122         symbol, which indicates to struct statfs from has f_flags member.
2123         This kind of struct statfs is coming from sys/mount.h (BSD),
2124         not from sys/statfs.h (SYSV).
2125
2126 d_statfs_s (d_statfs_s.U):
2127         This variable conditionally defines the HAS_STRUCT_STATFS symbol,
2128         which indicates that the struct statfs is supported.
2129
2130 d_statvfs (d_statvfs.U):
2131         This variable conditionally defines the HAS_STATVFS symbol, which
2132         indicates to the C program that the statvfs() routine is available.
2133
2134 d_stdio_cnt_lval (d_stdstdio.U):
2135         This variable conditionally defines STDIO_CNT_LVALUE if the
2136         FILE_cnt macro can be used as an lvalue.
2137
2138 d_stdio_ptr_lval (d_stdstdio.U):
2139         This variable conditionally defines STDIO_PTR_LVALUE if the
2140         FILE_ptr macro can be used as an lvalue.
2141
2142 d_stdio_ptr_lval_nochange_cnt (d_stdstdio.U):
2143         This symbol is defined if using the FILE_ptr macro as an lvalue
2144         to increase the pointer by n leaves File_cnt(fp) unchanged.
2145
2146 d_stdio_ptr_lval_sets_cnt (d_stdstdio.U):
2147         This symbol is defined if using the FILE_ptr macro as an lvalue
2148         to increase the pointer by n has the side effect of decreasing the
2149         value of File_cnt(fp) by n.
2150
2151 d_stdio_stream_array (stdio_streams.U):
2152         This variable tells whether there is an array holding
2153         the stdio streams.
2154
2155 d_stdiobase (d_stdstdio.U):
2156         This variable conditionally defines USE_STDIO_BASE if this system
2157         has a FILE structure declaring a usable _base field (or equivalent)
2158         in stdio.h.
2159
2160 d_stdstdio (d_stdstdio.U):
2161         This variable conditionally defines USE_STDIO_PTR if this system
2162         has a FILE structure declaring usable _ptr and _cnt fields (or
2163         equivalent) in stdio.h.
2164
2165 d_strchr (d_strchr.U):
2166         This variable conditionally defines HAS_STRCHR if strchr() and
2167         strrchr() are available for string searching.
2168
2169 d_strcoll (d_strcoll.U):
2170         This variable conditionally defines HAS_STRCOLL if strcoll() is
2171         available to compare strings using collating information.
2172
2173 d_strctcpy (d_strctcpy.U):
2174         This variable conditionally defines the USE_STRUCT_COPY symbol, which
2175         indicates to the C program that this C compiler knows how to copy
2176         structures.
2177
2178 d_strerrm (d_strerror.U):
2179         This variable holds what Strerrr is defined as to translate an error
2180         code condition into an error message string. It could be 'strerror'
2181         or a more complex macro emulating strrror with sys_errlist[], or the
2182         "unknown" string when both strerror and sys_errlist are missing.
2183
2184 d_strerror (d_strerror.U):
2185         This variable conditionally defines HAS_STRERROR if strerror() is
2186         available to translate error numbers to strings.
2187
2188 d_strerror_r (d_strerror_r.U):
2189         This variable conditionally defines the HAS_STRERROR_R symbol,
2190         which indicates to the C program that the strerror_r()
2191         routine is available.
2192
2193 d_strftime (d_strftime.U):
2194         This variable conditionally defines the HAS_STRFTIME symbol, which
2195         indicates to the C program that the strftime() routine is available.
2196
2197 d_strlcat (d_strlcat.U):
2198         This variable conditionally defines the HAS_STRLCAT symbol, which
2199         indicates to the C program that the strlcat () routine is available.
2200
2201 d_strlcpy (d_strlcpy.U):
2202         This variable conditionally defines the HAS_STRLCPY symbol, which
2203         indicates to the C program that the strlcpy () routine is available.
2204
2205 d_strtod (d_strtod.U):
2206         This variable conditionally defines the HAS_STRTOD symbol, which
2207         indicates to the C program that the strtod() routine is available
2208         to provide better numeric string conversion than atof().
2209
2210 d_strtol (d_strtol.U):
2211         This variable conditionally defines the HAS_STRTOL symbol, which
2212         indicates to the C program that the strtol() routine is available
2213         to provide better numeric string conversion than atoi() and friends.
2214
2215 d_strtold (d_strtold.U):
2216         This variable conditionally defines the HAS_STRTOLD symbol, which
2217         indicates to the C program that the strtold() routine is available.
2218
2219 d_strtoll (d_strtoll.U):
2220         This variable conditionally defines the HAS_STRTOLL symbol, which
2221         indicates to the C program that the strtoll() routine is available.
2222
2223 d_strtoq (d_strtoq.U):
2224         This variable conditionally defines the HAS_STRTOQ symbol, which
2225         indicates to the C program that the strtoq() routine is available.
2226
2227 d_strtoul (d_strtoul.U):
2228         This variable conditionally defines the HAS_STRTOUL symbol, which
2229         indicates to the C program that the strtoul() routine is available
2230         to provide conversion of strings to unsigned long.
2231
2232 d_strtoull (d_strtoull.U):
2233         This variable conditionally defines the HAS_STRTOULL symbol, which
2234         indicates to the C program that the strtoull() routine is available.
2235
2236 d_strtouq (d_strtouq.U):
2237         This variable conditionally defines the HAS_STRTOUQ symbol, which
2238         indicates to the C program that the strtouq() routine is available.
2239
2240 d_strxfrm (d_strxfrm.U):
2241         This variable conditionally defines HAS_STRXFRM if strxfrm() is
2242         available to transform strings.
2243
2244 d_suidsafe (d_dosuid.U):
2245         This variable conditionally defines SETUID_SCRIPTS_ARE_SECURE_NOW
2246         if setuid scripts can be secure.  This test looks in /dev/fd/.
2247
2248 d_symlink (d_symlink.U):
2249         This variable conditionally defines the HAS_SYMLINK symbol, which
2250         indicates to the C program that the symlink() routine is available
2251         to create symbolic links.
2252
2253 d_syscall (d_syscall.U):
2254         This variable conditionally defines HAS_SYSCALL if syscall() is
2255         available call arbitrary system calls.
2256
2257 d_syscallproto (d_syscallproto.U):
2258         This variable conditionally defines the HAS_SYSCALL_PROTO symbol,
2259         which indicates to the C program that the system provides
2260         a prototype for the syscall() function.  Otherwise, it is
2261         up to the program to supply one.
2262
2263 d_sysconf (d_sysconf.U):
2264         This variable conditionally defines the HAS_SYSCONF symbol, which
2265         indicates to the C program that the sysconf() routine is available
2266         to determine system related limits and options.
2267
2268 d_sysernlst (d_strerror.U):
2269         This variable conditionally defines HAS_SYS_ERRNOLIST if sys_errnolist[]
2270         is available to translate error numbers to the symbolic name.
2271
2272 d_syserrlst (d_strerror.U):
2273         This variable conditionally defines HAS_SYS_ERRLIST if sys_errlist[] is
2274         available to translate error numbers to strings.
2275
2276 d_system (d_system.U):
2277         This variable conditionally defines HAS_SYSTEM if system() is
2278         available to issue a shell command.
2279
2280 d_tcgetpgrp (d_tcgtpgrp.U):
2281         This variable conditionally defines the HAS_TCGETPGRP symbol, which
2282         indicates to the C program that the tcgetpgrp() routine is available.
2283         to get foreground process group ID.
2284
2285 d_tcsetpgrp (d_tcstpgrp.U):
2286         This variable conditionally defines the HAS_TCSETPGRP symbol, which
2287         indicates to the C program that the tcsetpgrp() routine is available
2288         to set foreground process group ID.
2289
2290 d_telldir (d_readdir.U):
2291         This variable conditionally defines HAS_TELLDIR if telldir() is
2292         available.
2293
2294 d_telldirproto (d_telldirproto.U):
2295         This variable conditionally defines the HAS_TELLDIR_PROTO symbol,
2296         which indicates to the C program that the system provides
2297         a prototype for the telldir() function.  Otherwise, it is
2298         up to the program to supply one.
2299
2300 d_time (d_time.U):
2301         This variable conditionally defines the HAS_TIME symbol, which indicates
2302         that the time() routine exists.  The time() routine is normaly
2303         provided on UNIX systems.
2304
2305 d_timegm (d_timegm.U):
2306         This variable conditionally defines the HAS_TIMEGM symbol, which
2307         indicates to the C program that the timegm () routine is available.
2308
2309 d_times (d_times.U):
2310         This variable conditionally defines the HAS_TIMES symbol, which indicates
2311         that the times() routine exists.  The times() routine is normaly
2312         provided on UNIX systems. You may have to include <sys/times.h>.
2313
2314 d_tm_tm_gmtoff (i_time.U):
2315         This variable conditionally defines HAS_TM_TM_GMTOFF, which indicates
2316         indicates to the C program that the struct tm has the tm_gmtoff field.
2317
2318 d_tm_tm_zone (i_time.U):
2319         This variable conditionally defines HAS_TM_TM_ZONE, which indicates
2320         indicates to the C program that the struct tm has the tm_zone field.
2321
2322 d_tmpnam_r (d_tmpnam_r.U):
2323         This variable conditionally defines the HAS_TMPNAM_R symbol,
2324         which indicates to the C program that the tmpnam_r()
2325         routine is available.
2326
2327 d_truncate (d_truncate.U):
2328         This variable conditionally defines HAS_TRUNCATE if truncate() is
2329         available to truncate files.
2330
2331 d_ttyname_r (d_ttyname_r.U):
2332         This variable conditionally defines the HAS_TTYNAME_R symbol,
2333         which indicates to the C program that the ttyname_r()
2334         routine is available.
2335
2336 d_tzname (d_tzname.U):
2337         This variable conditionally defines HAS_TZNAME if tzname[] is
2338         available to access timezone names.
2339
2340 d_u32align (d_u32align.U):
2341         This variable tells whether you must access character data
2342         through U32-aligned pointers.
2343
2344 d_ualarm (d_ualarm.U):
2345         This variable conditionally defines the HAS_UALARM symbol, which
2346         indicates to the C program that the ualarm() routine is available.
2347
2348 d_umask (d_umask.U):
2349         This variable conditionally defines the HAS_UMASK symbol, which
2350         indicates to the C program that the umask() routine is available.
2351         to set and get the value of the file creation mask.
2352
2353 d_uname (d_gethname.U):
2354         This variable conditionally defines the HAS_UNAME symbol, which
2355         indicates to the C program that the uname() routine may be
2356         used to derive the host name.
2357
2358 d_union_semun (d_union_semun.U):
2359         This variable conditionally defines HAS_UNION_SEMUN if the
2360         union semun is defined by including <sys/sem.h>.
2361
2362 d_unordered (d_unordered.U):
2363         This variable conditionally defines the HAS_UNORDERED symbol, which
2364         indicates to the C program that the unordered() routine is available.
2365
2366 d_unsetenv (d_unsetenv.U):
2367         This variable conditionally defines the HAS_UNSETENV symbol, which
2368         indicates to the C program that the unsetenv () routine is available.
2369
2370 d_usleep (d_usleep.U):
2371         This variable conditionally defines HAS_USLEEP if usleep() is
2372         available to do high granularity sleeps.
2373
2374 d_usleepproto (d_usleepproto.U):
2375         This variable conditionally defines the HAS_USLEEP_PROTO symbol,
2376         which indicates to the C program that the system provides
2377         a prototype for the usleep() function.  Otherwise, it is
2378         up to the program to supply one.
2379
2380 d_ustat (d_ustat.U):
2381         This variable conditionally defines HAS_USTAT if ustat() is
2382         available to query file system statistics by dev_t.
2383
2384 d_vendorarch (vendorarch.U):
2385         This variable conditionally defined PERL_VENDORARCH.
2386
2387 d_vendorbin (vendorbin.U):
2388         This variable conditionally defines PERL_VENDORBIN.
2389
2390 d_vendorlib (vendorlib.U):
2391         This variable conditionally defines PERL_VENDORLIB.
2392
2393 d_vendorscript (vendorscript.U):
2394         This variable conditionally defines PERL_VENDORSCRIPT.
2395
2396 d_vfork (d_vfork.U):
2397         This variable conditionally defines the HAS_VFORK symbol, which
2398         indicates the vfork() routine is available.
2399
2400 d_void_closedir (d_closedir.U):
2401         This variable conditionally defines VOID_CLOSEDIR if closedir()
2402         does not return a value.
2403
2404 d_voidsig (d_voidsig.U):
2405         This variable conditionally defines VOIDSIG if this system
2406         declares "void (*signal(...))()" in signal.h.  The old way was to
2407         declare it as "int (*signal(...))()".
2408
2409 d_voidtty (i_sysioctl.U):
2410         This variable conditionally defines USE_IOCNOTTY to indicate that the
2411         ioctl() call with TIOCNOTTY should be used to void tty association.
2412         Otherwise (on USG probably), it is enough to close the standard file
2413         decriptors and do a setpgrp().
2414
2415 d_volatile (d_volatile.U):
2416         This variable conditionally defines the HASVOLATILE symbol, which
2417         indicates to the C program that this C compiler knows about the
2418         volatile declaration.
2419
2420 d_vprintf (d_vprintf.U):
2421         This variable conditionally defines the HAS_VPRINTF symbol, which
2422         indicates to the C program that the vprintf() routine is available
2423         to printf with a pointer to an argument list.
2424
2425 d_vsnprintf (d_snprintf.U):
2426         This variable conditionally defines the HAS_VSNPRINTF symbol, which
2427         indicates to the C program that the vsnprintf () library function
2428         is available.
2429
2430 d_wait4 (d_wait4.U):
2431         This variable conditionally defines the HAS_WAIT4 symbol, which
2432         indicates the wait4() routine is available.
2433
2434 d_waitpid (d_waitpid.U):
2435         This variable conditionally defines HAS_WAITPID if waitpid() is
2436         available to wait for child process.
2437
2438 d_wcstombs (d_wcstombs.U):
2439         This variable conditionally defines the HAS_WCSTOMBS symbol, which
2440         indicates to the C program that the wcstombs() routine is available
2441         to convert wide character strings to multibyte strings.
2442
2443 d_wctomb (d_wctomb.U):
2444         This variable conditionally defines the HAS_WCTOMB symbol, which
2445         indicates to the C program that the wctomb() routine is available
2446         to convert a wide character to a multibyte.
2447
2448 d_writev (d_writev.U):
2449         This variable conditionally defines the HAS_WRITEV symbol, which
2450         indicates to the C program that the writev() routine is available.
2451
2452 d_xenix (Guess.U):
2453         This variable conditionally defines the symbol XENIX, which alerts
2454         the C program that it runs under Xenix.
2455
2456 date (Loc.U):
2457         This variable is used internally by Configure to determine the
2458         full pathname (if any) of the date program.  After Configure runs,
2459         the value is reset to a plain "date" and is not useful.
2460
2461 db_hashtype (i_db.U):
2462         This variable contains the type of the hash structure element
2463         in the <db.h> header file.  In older versions of DB, it was
2464         int, while in newer ones it is u_int32_t.
2465
2466 db_prefixtype (i_db.U):
2467         This variable contains the type of the prefix structure element
2468         in the <db.h> header file.  In older versions of DB, it was
2469         int, while in newer ones it is size_t.
2470
2471 db_version_major (i_db.U):
2472         This variable contains the major version number of
2473         Berkeley DB found in the <db.h> header file.
2474
2475 db_version_minor (i_db.U):
2476         This variable contains the minor version number of
2477         Berkeley DB found in the <db.h> header file.
2478         For DB version 1 this is always 0.
2479
2480 db_version_patch (i_db.U):
2481         This variable contains the patch version number of
2482         Berkeley DB found in the <db.h> header file.
2483         For DB version 1 this is always 0.
2484
2485 defvoidused (voidflags.U):
2486         This variable contains the default value of the VOIDUSED symbol (15).
2487
2488 direntrytype (i_dirent.U):
2489         This symbol is set to 'struct direct' or 'struct dirent' depending on
2490         whether dirent is available or not. You should use this pseudo type to
2491         portably declare your directory entries.
2492
2493 dlext (dlext.U):
2494         This variable contains the extension that is to be used for the
2495         dynamically loaded modules that perl generaties.
2496
2497 dlsrc (dlsrc.U):
2498         This variable contains the name of the dynamic loading file that
2499         will be used with the package.
2500
2501 doublesize (doublesize.U):
2502         This variable contains the value of the DOUBLESIZE symbol, which
2503         indicates to the C program how many bytes there are in a double.
2504
2505 drand01 (randfunc.U):
2506         Indicates the macro to be used to generate normalized
2507         random numbers.  Uses randfunc, often divided by
2508         (double) (((unsigned long) 1 << randbits)) in order to
2509         normalize the result.
2510         In C programs, the macro 'Drand01' is mapped to drand01.
2511
2512 drand48_r_proto (d_drand48_r.U):
2513         This variable encodes the prototype of drand48_r.
2514         It is zero if d_drand48_r is undef, and one of the
2515         REENTRANT_PROTO_T_ABC macros of reentr.h if d_drand48_r
2516         is defined.
2517
2518 dtrace (usedtrace.U):
2519         This variable holds the location of the dtrace executable.
2520
2521 dynamic_ext (Extensions.U):
2522         This variable holds a list of XS extension files we want to
2523         link dynamically into the package.  It is used by Makefile.
2524
2525 eagain (nblock_io.U):
2526         This variable bears the symbolic errno code set by read() when no
2527         data is present on the file and non-blocking I/O was enabled (otherwise,
2528         read() blocks naturally).
2529
2530 ebcdic (ebcdic.U):
2531         This variable conditionally defines EBCDIC if this
2532         system uses EBCDIC encoding.  Among other things, this
2533         means that the character ranges are not contiguous.
2534         See trnl.U
2535
2536 echo (Loc.U):
2537         This variable is used internally by Configure to determine the
2538         full pathname (if any) of the echo program.  After Configure runs,
2539         the value is reset to a plain "echo" and is not useful.
2540
2541 egrep (Loc.U):
2542         This variable is used internally by Configure to determine the
2543         full pathname (if any) of the egrep program.  After Configure runs,
2544         the value is reset to a plain "egrep" and is not useful.
2545
2546 emacs (Loc.U):
2547         This variable is defined but not used by Configure.
2548         The value is the empty string and is not useful.
2549
2550 endgrent_r_proto (d_endgrent_r.U):
2551         This variable encodes the prototype of endgrent_r.
2552         It is zero if d_endgrent_r is undef, and one of the
2553         REENTRANT_PROTO_T_ABC macros of reentr.h if d_endgrent_r
2554         is defined.
2555
2556 endhostent_r_proto (d_endhostent_r.U):
2557         This variable encodes the prototype of endhostent_r.
2558         It is zero if d_endhostent_r is undef, and one of the
2559         REENTRANT_PROTO_T_ABC macros of reentr.h if d_endhostent_r
2560         is defined.
2561
2562 endnetent_r_proto (d_endnetent_r.U):
2563         This variable encodes the prototype of endnetent_r.
2564         It is zero if d_endnetent_r is undef, and one of the
2565         REENTRANT_PROTO_T_ABC macros of reentr.h if d_endnetent_r
2566         is defined.
2567
2568 endprotoent_r_proto (d_endprotoent_r.U):
2569         This variable encodes the prototype of endprotoent_r.
2570         It is zero if d_endprotoent_r is undef, and one of the
2571         REENTRANT_PROTO_T_ABC macros of reentr.h if d_endprotoent_r
2572         is defined.
2573
2574 endpwent_r_proto (d_endpwent_r.U):
2575         This variable encodes the prototype of endpwent_r.
2576         It is zero if d_endpwent_r is undef, and one of the
2577         REENTRANT_PROTO_T_ABC macros of reentr.h if d_endpwent_r
2578         is defined.
2579
2580 endservent_r_proto (d_endservent_r.U):
2581         This variable encodes the prototype of endservent_r.
2582         It is zero if d_endservent_r is undef, and one of the
2583         REENTRANT_PROTO_T_ABC macros of reentr.h if d_endservent_r
2584         is defined.
2585
2586 eunicefix (Init.U):
2587         When running under Eunice this variable contains a command which will
2588         convert a shell script to the proper form of text file for it to be
2589         executable by the shell.  On other systems it is a no-op.
2590
2591 exe_ext (Unix.U):
2592         This is an old synonym for _exe.
2593
2594 expr (Loc.U):
2595         This variable is used internally by Configure to determine the
2596         full pathname (if any) of the expr program.  After Configure runs,
2597         the value is reset to a plain "expr" and is not useful.
2598
2599 extensions (Extensions.U):
2600         This variable holds a list of all extension files (both XS and
2601         non-xs linked into the package.  It is propagated to Config.pm
2602         and is typically used to test whether a particular extesion
2603         is available.
2604
2605 extern_C (Csym.U):
2606         ANSI C requires 'extern' where C++ requires 'extern "C"'. This
2607         variable can be used in Configure to do the right thing.
2608
2609 extras (Extras.U):
2610         This variable holds a list of extra modules to install.
2611
2612 fflushall (fflushall.U):
2613         This symbol, if defined, tells that to flush
2614         all pending stdio output one must loop through all
2615         the stdio file handles stored in an array and fflush them.
2616         Note that if fflushNULL is defined, fflushall will not
2617         even be probed for and will be left undefined.
2618
2619 fflushNULL (fflushall.U):
2620         This symbol, if defined, tells that fflush(NULL) does flush
2621         all pending stdio output.
2622
2623 find (Loc.U):
2624         This variable is defined but not used by Configure.
2625         The value is the empty string and is not useful.
2626
2627 firstmakefile (Unix.U):
2628         This variable defines the first file searched by make.  On unix,
2629         it is makefile (then Makefile).  On case-insensitive systems,
2630         it might be something else.  This is only used to deal with
2631         convoluted make depend tricks.
2632
2633 flex (Loc.U):
2634         This variable is defined but not used by Configure.
2635         The value is the empty string and is not useful.
2636
2637 fpossize (fpossize.U):
2638         This variable contains the size of a fpostype in bytes.
2639
2640 fpostype (fpostype.U):
2641         This variable defines Fpos_t to be something like fpos_t, long,
2642         uint, or whatever type is used to declare file positions in libc.
2643
2644 freetype (mallocsrc.U):
2645         This variable contains the return type of free().  It is usually
2646         void, but occasionally int.
2647
2648 from (Cross.U):
2649         This variable contains the command used by Configure
2650         to copy files from the target host.  Useful and available
2651         only during Perl build.
2652         The string ':' if not cross-compiling.
2653
2654 full_ar (Loc_ar.U):
2655         This variable contains the full pathname to 'ar', whether or
2656         not the user has specified 'portability'.  This is only used
2657         in the Makefile.SH.
2658
2659 full_csh (d_csh.U):
2660         This variable contains the full pathname to 'csh', whether or
2661         not the user has specified 'portability'.  This is only used
2662         in the compiled C program, and we assume that all systems which
2663         can share this executable will have the same full pathname to
2664         'csh.'
2665
2666 full_sed (Loc_sed.U):
2667         This variable contains the full pathname to 'sed', whether or
2668         not the user has specified 'portability'.  This is only used
2669         in the compiled C program, and we assume that all systems which
2670         can share this executable will have the same full pathname to
2671         'sed.'
2672
2673 gccansipedantic (gccvers.U):
2674         If GNU cc (gcc) is used, this variable will enable (if set) the
2675         -ansi and -pedantic ccflags for building core files (through
2676         cflags script). (See Porting/pumpkin.pod for full description).
2677
2678 gccosandvers (gccvers.U):
2679         If GNU cc (gcc) is used, this variable holds the operating system
2680         and version used to compile gcc.  It is set to '' if not gcc,
2681         or if nothing useful can be parsed as the os version.
2682
2683 gccversion (gccvers.U):
2684         If GNU cc (gcc) is used, this variable holds '1' or '2' to
2685         indicate whether the compiler is version 1 or 2.  This is used in
2686         setting some of the default cflags.  It is set to '' if not gcc.
2687
2688 getgrent_r_proto (d_getgrent_r.U):
2689         This variable encodes the prototype of getgrent_r.
2690         It is zero if d_getgrent_r is undef, and one of the
2691         REENTRANT_PROTO_T_ABC macros of reentr.h if d_getgrent_r
2692         is defined.
2693
2694 getgrgid_r_proto (d_getgrgid_r.U):
2695         This variable encodes the prototype of getgrgid_r.
2696         It is zero if d_getgrgid_r is undef, and one of the
2697         REENTRANT_PROTO_T_ABC macros of reentr.h if d_getgrgid_r
2698         is defined.
2699
2700 getgrnam_r_proto (d_getgrnam_r.U):
2701         This variable encodes the prototype of getgrnam_r.
2702         It is zero if d_getgrnam_r is undef, and one of the
2703         REENTRANT_PROTO_T_ABC macros of reentr.h if d_getgrnam_r
2704         is defined.
2705
2706 gethostbyaddr_r_proto (d_gethostbyaddr_r.U):
2707         This variable encodes the prototype of gethostbyaddr_r.
2708         It is zero if d_gethostbyaddr_r is undef, and one of the
2709         REENTRANT_PROTO_T_ABC macros of reentr.h if d_gethostbyaddr_r
2710         is defined.
2711
2712 gethostbyname_r_proto (d_gethostbyname_r.U):
2713         This variable encodes the prototype of gethostbyname_r.
2714         It is zero if d_gethostbyname_r is undef, and one of the
2715         REENTRANT_PROTO_T_ABC macros of reentr.h if d_gethostbyname_r
2716         is defined.
2717
2718 gethostent_r_proto (d_gethostent_r.U):
2719         This variable encodes the prototype of gethostent_r.
2720         It is zero if d_gethostent_r is undef, and one of the
2721         REENTRANT_PROTO_T_ABC macros of reentr.h if d_gethostent_r
2722         is defined.
2723
2724 getlogin_r_proto (d_getlogin_r.U):
2725         This variable encodes the prototype of getlogin_r.
2726         It is zero if d_getlogin_r is undef, and one of the
2727         REENTRANT_PROTO_T_ABC macros of reentr.h if d_getlogin_r
2728         is defined.
2729
2730 getnetbyaddr_r_proto (d_getnetbyaddr_r.U):
2731         This variable encodes the prototype of getnetbyaddr_r.
2732         It is zero if d_getnetbyaddr_r is undef, and one of the
2733         REENTRANT_PROTO_T_ABC macros of reentr.h if d_getnetbyaddr_r
2734         is defined.
2735
2736 getnetbyname_r_proto (d_getnetbyname_r.U):
2737         This variable encodes the prototype of getnetbyname_r.
2738         It is zero if d_getnetbyname_r is undef, and one of the
2739         REENTRANT_PROTO_T_ABC macros of reentr.h if d_getnetbyname_r
2740         is defined.
2741
2742 getnetent_r_proto (d_getnetent_r.U):
2743         This variable encodes the prototype of getnetent_r.
2744         It is zero if d_getnetent_r is undef, and one of the
2745         REENTRANT_PROTO_T_ABC macros of reentr.h if d_getnetent_r
2746         is defined.
2747
2748 getprotobyname_r_proto (d_getprotobyname_r.U):
2749         This variable encodes the prototype of getprotobyname_r.
2750         It is zero if d_getprotobyname_r is undef, and one of the
2751         REENTRANT_PROTO_T_ABC macros of reentr.h if d_getprotobyname_r
2752         is defined.
2753
2754 getprotobynumber_r_proto (d_getprotobynumber_r.U):
2755         This variable encodes the prototype of getprotobynumber_r.
2756         It is zero if d_getprotobynumber_r is undef, and one of the
2757         REENTRANT_PROTO_T_ABC macros of reentr.h if d_getprotobynumber_r
2758         is defined.
2759
2760 getprotoent_r_proto (d_getprotoent_r.U):
2761         This variable encodes the prototype of getprotoent_r.
2762         It is zero if d_getprotoent_r is undef, and one of the
2763         REENTRANT_PROTO_T_ABC macros of reentr.h if d_getprotoent_r
2764         is defined.
2765
2766 getpwent_r_proto (d_getpwent_r.U):
2767         This variable encodes the prototype of getpwent_r.
2768         It is zero if d_getpwent_r is undef, and one of the
2769         REENTRANT_PROTO_T_ABC macros of reentr.h if d_getpwent_r
2770         is defined.
2771
2772 getpwnam_r_proto (d_getpwnam_r.U):
2773         This variable encodes the prototype of getpwnam_r.
2774         It is zero if d_getpwnam_r is undef, and one of the
2775         REENTRANT_PROTO_T_ABC macros of reentr.h if d_getpwnam_r
2776         is defined.
2777
2778 getpwuid_r_proto (d_getpwuid_r.U):
2779         This variable encodes the prototype of getpwuid_r.
2780         It is zero if d_getpwuid_r is undef, and one of the
2781         REENTRANT_PROTO_T_ABC macros of reentr.h if d_getpwuid_r
2782         is defined.
2783
2784 getservbyname_r_proto (d_getservbyname_r.U):
2785         This variable encodes the prototype of getservbyname_r.
2786         It is zero if d_getservbyname_r is undef, and one of the
2787         REENTRANT_PROTO_T_ABC macros of reentr.h if d_getservbyname_r
2788         is defined.
2789
2790 getservbyport_r_proto (d_getservbyport_r.U):
2791         This variable encodes the prototype of getservbyport_r.
2792         It is zero if d_getservbyport_r is undef, and one of the
2793         REENTRANT_PROTO_T_ABC macros of reentr.h if d_getservbyport_r
2794         is defined.
2795
2796 getservent_r_proto (d_getservent_r.U):
2797         This variable encodes the prototype of getservent_r.
2798         It is zero if d_getservent_r is undef, and one of the
2799         REENTRANT_PROTO_T_ABC macros of reentr.h if d_getservent_r
2800         is defined.
2801
2802 getspnam_r_proto (d_getspnam_r.U):
2803         This variable encodes the prototype of getspnam_r.
2804         It is zero if d_getspnam_r is undef, and one of the
2805         REENTRANT_PROTO_T_ABC macros of reentr.h if d_getspnam_r
2806         is defined.
2807
2808 gidformat (gidf.U):
2809         This variable contains the format string used for printing a Gid_t.
2810
2811 gidsign (gidsign.U):
2812         This variable contains the signedness of a gidtype.
2813         1 for unsigned, -1 for signed.
2814
2815 gidsize (gidsize.U):
2816         This variable contains the size of a gidtype in bytes.
2817
2818 gidtype (gidtype.U):
2819         This variable defines Gid_t to be something like gid_t, int,
2820         ushort, or whatever type is used to declare the return type
2821         of getgid().  Typically, it is the type of group ids in the kernel.
2822
2823 glibpth (libpth.U):
2824         This variable holds the general path (space-separated) used to
2825         find libraries.  It may contain directories that do not exist on
2826         this platform, libpth is the cleaned-up version.
2827
2828 gmake (Loc.U):
2829         This variable is used internally by Configure to determine the
2830         full pathname (if any) of the gmake program.  After Configure runs,
2831         the value is reset to a plain "gmake" and is not useful.
2832
2833 gmtime_r_proto (d_gmtime_r.U):
2834         This variable encodes the prototype of gmtime_r.
2835         It is zero if d_gmtime_r is undef, and one of the
2836         REENTRANT_PROTO_T_ABC macros of reentr.h if d_gmtime_r
2837         is defined.
2838
2839 gnulibc_version (d_gnulibc.U):
2840         This variable contains the version number of the GNU C library.
2841         It is usually something like '2.2.5'.  It is a plain '' if this
2842         is not the GNU C library, or if the version is unknown.
2843
2844 grep (Loc.U):
2845         This variable is used internally by Configure to determine the
2846         full pathname (if any) of the grep program.  After Configure runs,
2847         the value is reset to a plain "grep" and is not useful.
2848
2849 groupcat (nis.U):
2850         This variable contains a command that produces the text of the
2851         /etc/group file.  This is normally "cat /etc/group", but can be
2852         "ypcat group" when NIS is used.
2853         On some systems, such as os390, there may be no equivalent
2854         command, in which case this variable is unset.
2855
2856 groupstype (groupstype.U):
2857         This variable defines Groups_t to be something like gid_t, int,
2858         ushort, or whatever type is used for the second argument to
2859         getgroups() and setgroups().  Usually, this is the same as
2860         gidtype (gid_t), but sometimes it isn't.
2861
2862 gzip (Loc.U):
2863         This variable is used internally by Configure to determine the
2864         full pathname (if any) of the gzip program.  After Configure runs,
2865         the value is reset to a plain "gzip" and is not useful.
2866
2867 h_fcntl (h_fcntl.U):
2868         This is variable gets set in various places to tell i_fcntl that
2869         <fcntl.h> should be included.
2870
2871 h_sysfile (h_sysfile.U):
2872         This is variable gets set in various places to tell i_sys_file that
2873         <sys/file.h> should be included.
2874
2875 hint (Oldconfig.U):
2876         Gives the type of hints used for previous answers. May be one of
2877         "default", "recommended" or "previous".
2878
2879 hostcat (nis.U):
2880         This variable contains a command that produces the text of the
2881         /etc/hosts file.  This is normally "cat /etc/hosts", but can be
2882         "ypcat hosts" when NIS is used.
2883         On some systems, such as os390, there may be no equivalent
2884         command, in which case this variable is unset.
2885
2886 html1dir (html1dir.U):
2887         This variable contains the name of the directory in which html
2888         source pages are to be put.  This directory is for pages
2889         that describe whole programs, not libraries or modules.  It
2890         is intended to correspond roughly to section 1 of the Unix
2891         manuals.
2892
2893 html1direxp (html1dir.U):
2894         This variable is the same as the html1dir variable, but is filename
2895         expanded at configuration time, for convenient use in makefiles.
2896
2897 html3dir (html3dir.U):
2898         This variable contains the name of the directory in which html
2899         source pages are to be put.  This directory is for pages
2900         that describe libraries or modules.  It is intended to
2901         correspond roughly to section 3 of the Unix manuals.
2902
2903 html3direxp (html3dir.U):
2904         This variable is the same as the html3dir variable, but is filename
2905         expanded at configuration time, for convenient use in makefiles.
2906
2907 i16size (perlxv.U):
2908         This variable is the size of an I16 in bytes.
2909
2910 i16type (perlxv.U):
2911         This variable contains the C type used for Perl's I16.
2912
2913 i32size (perlxv.U):
2914         This variable is the size of an I32 in bytes.
2915
2916 i32type (perlxv.U):
2917         This variable contains the C type used for Perl's I32.
2918
2919 i64size (perlxv.U):
2920         This variable is the size of an I64 in bytes.
2921
2922 i64type (perlxv.U):
2923         This variable contains the C type used for Perl's I64.
2924
2925 i8size (perlxv.U):
2926         This variable is the size of an I8 in bytes.
2927
2928 i8type (perlxv.U):
2929         This variable contains the C type used for Perl's I8.
2930
2931 i_arpainet (i_arpainet.U):
2932         This variable conditionally defines the I_ARPA_INET symbol,
2933         and indicates whether a C program should include <arpa/inet.h>.
2934
2935 i_assert (i_assert.U):
2936         This variable conditionally defines the I_ASSERT symbol, which
2937         indicates to the C program that <assert.h> exists and could be
2938         included.
2939
2940 i_bsdioctl (i_sysioctl.U):
2941         This variable conditionally defines the I_SYS_BSDIOCTL symbol, which
2942         indicates to the C program that <sys/bsdioctl.h> exists and should
2943         be included.
2944
2945 i_crypt (i_crypt.U):
2946         This variable conditionally defines the I_CRYPT symbol, and indicates
2947         whether a C program should include <crypt.h>.
2948
2949 i_db (i_db.U):
2950         This variable conditionally defines the I_DB symbol, and indicates
2951         whether a C program may include Berkeley's DB include file <db.h>.
2952
2953 i_dbm (i_dbm.U):
2954         This variable conditionally defines the I_DBM symbol, which
2955         indicates to the C program that <dbm.h> exists and should
2956         be included.
2957
2958 i_dirent (i_dirent.U):
2959         This variable conditionally defines I_DIRENT, which indicates
2960         to the C program that it should include <dirent.h>.
2961
2962 i_dld (i_dld.U):
2963         This variable conditionally defines the I_DLD symbol, which
2964         indicates to the C program that <dld.h> (GNU dynamic loading)
2965         exists and should be included.
2966
2967 i_dlfcn (i_dlfcn.U):
2968         This variable conditionally defines the I_DLFCN symbol, which
2969         indicates to the C program that <dlfcn.h> exists and should
2970         be included.
2971
2972 i_fcntl (i_fcntl.U):
2973         This variable controls the value of I_FCNTL (which tells
2974         the C program to include <fcntl.h>).
2975
2976 i_float (i_float.U):
2977         This variable conditionally defines the I_FLOAT symbol, and indicates
2978         whether a C program may include <float.h> to get symbols like DBL_MAX
2979         or DBL_MIN, i.e. machine dependent floating point values.
2980
2981 i_fp (i_fp.U):
2982         This variable conditionally defines the I_FP symbol, and indicates
2983         whether a C program should include <fp.h>.
2984
2985 i_fp_class (i_fp_class.U):
2986         This variable conditionally defines the I_FP_CLASS symbol, and indicates
2987         whether a C program should include <fp_class.h>.
2988
2989 i_gdbm (i_gdbm.U):
2990         This variable conditionally defines the I_GDBM symbol, which
2991         indicates to the C program that <gdbm.h> exists and should
2992         be included.
2993
2994 i_gdbm_ndbm (i_ndbm.U):
2995         This variable conditionally defines the I_GDBM_NDBM symbol, which
2996         indicates to the C program that <gdbm-ndbm.h> exists and should
2997         be included.  This is the location of the ndbm.h compatibility file
2998         in Debian 4.0.
2999
3000 i_gdbmndbm (i_ndbm.U):
3001         This variable conditionally defines the I_GDBMNDBM symbol, which
3002         indicates to the C program that <gdbm/ndbm.h> exists and should
3003         be included.  This was the location of the ndbm.h compatibility file
3004         in RedHat 7.1.
3005
3006 i_grp (i_grp.U):
3007         This variable conditionally defines the I_GRP symbol, and indicates
3008         whether a C program should include <grp.h>.
3009
3010 i_ieeefp (i_ieeefp.U):
3011         This variable conditionally defines the I_IEEEFP symbol, and indicates
3012         whether a C program should include <ieeefp.h>.
3013
3014 i_inttypes (i_inttypes.U):
3015         This variable conditionally defines the I_INTTYPES symbol,
3016         and indicates whether a C program should include <inttypes.h>.
3017
3018 i_langinfo (i_langinfo.U):
3019         This variable conditionally defines the I_LANGINFO symbol,
3020         and indicates whether a C program should include <langinfo.h>.
3021
3022 i_libutil (i_libutil.U):
3023         This variable conditionally defines the I_LIBUTIL symbol, and indicates
3024         whether a C program should include <libutil.h>.
3025
3026 i_limits (i_limits.U):
3027         This variable conditionally defines the I_LIMITS symbol, and indicates
3028         whether a C program may include <limits.h> to get symbols like WORD_BIT
3029         and friends.
3030
3031 i_locale (i_locale.U):
3032         This variable conditionally defines the I_LOCALE symbol,
3033         and indicates whether a C program should include <locale.h>.
3034
3035 i_machcthr (i_machcthr.U):
3036         This variable conditionally defines the I_MACH_CTHREADS symbol,
3037         and indicates whether a C program should include <mach/cthreads.h>.
3038
3039 i_malloc (i_malloc.U):
3040         This variable conditionally defines the I_MALLOC symbol, and indicates
3041         whether a C program should include <malloc.h>.
3042
3043 i_mallocmalloc (i_mallocmalloc.U):
3044         This variable conditionally defines the I_MALLOCMALLOC symbol,
3045         and indicates whether a C program should include <malloc/malloc.h>.
3046
3047 i_math (i_math.U):
3048         This variable conditionally defines the I_MATH symbol, and indicates
3049         whether a C program may include <math.h>.
3050
3051 i_memory (i_memory.U):
3052         This variable conditionally defines the I_MEMORY symbol, and indicates
3053         whether a C program should include <memory.h>.
3054
3055 i_mntent (i_mntent.U):
3056         This variable conditionally defines the I_MNTENT symbol, and indicates
3057         whether a C program should include <mntent.h>.
3058
3059 i_ndbm (i_ndbm.U):
3060         This variable conditionally defines the I_NDBM symbol, which
3061         indicates to the C program that <ndbm.h> exists and should
3062         be included.
3063
3064 i_netdb (i_netdb.U):
3065         This variable conditionally defines the I_NETDB symbol, and indicates
3066         whether a C program should include <netdb.h>.
3067
3068 i_neterrno (i_neterrno.U):
3069         This variable conditionally defines the I_NET_ERRNO symbol, which
3070         indicates to the C program that <net/errno.h> exists and should
3071         be included.
3072
3073 i_netinettcp (i_netinettcp.U):
3074         This variable conditionally defines the I_NETINET_TCP symbol,
3075         and indicates whether a C program should include <netinet/tcp.h>.
3076
3077 i_niin (i_niin.U):
3078         This variable conditionally defines I_NETINET_IN, which indicates
3079         to the C program that it should include <netinet/in.h>. Otherwise,
3080         you may try <sys/in.h>.
3081
3082 i_poll (i_poll.U):
3083         This variable conditionally defines the I_POLL symbol, and indicates
3084         whether a C program should include <poll.h>.
3085
3086 i_prot (i_prot.U):
3087         This variable conditionally defines the I_PROT symbol, and indicates
3088         whether a C program should include <prot.h>.
3089
3090 i_pthread (i_pthread.U):
3091         This variable conditionally defines the I_PTHREAD symbol,
3092         and indicates whether a C program should include <pthread.h>.
3093
3094 i_pwd (i_pwd.U):
3095         This variable conditionally defines I_PWD, which indicates
3096         to the C program that it should include <pwd.h>.
3097
3098 i_rpcsvcdbm (i_dbm.U):
3099         This variable conditionally defines the I_RPCSVC_DBM symbol, which
3100         indicates to the C program that <rpcsvc/dbm.h> exists and should
3101         be included.  Some System V systems might need this instead of <dbm.h>.
3102
3103 i_sfio (i_sfio.U):
3104         This variable conditionally defines the I_SFIO symbol,
3105         and indicates whether a C program should include <sfio.h>.
3106
3107 i_sgtty (i_termio.U):
3108         This variable conditionally defines the I_SGTTY symbol, which
3109         indicates to the C program that it should include <sgtty.h> rather
3110         than <termio.h>.
3111
3112 i_shadow (i_shadow.U):
3113         This variable conditionally defines the I_SHADOW symbol, and indicates
3114         whether a C program should include <shadow.h>.
3115
3116 i_socks (i_socks.U):
3117         This variable conditionally defines the I_SOCKS symbol, and indicates
3118         whether a C program should include <socks.h>.
3119
3120 i_stdarg (i_varhdr.U):
3121         This variable conditionally defines the I_STDARG symbol, which
3122         indicates to the C program that <stdarg.h> exists and should
3123         be included.
3124
3125 i_stddef (i_stddef.U):
3126         This variable conditionally defines the I_STDDEF symbol, which
3127         indicates to the C program that <stddef.h> exists and should
3128         be included.
3129
3130 i_stdlib (i_stdlib.U):
3131         This variable conditionally defines the I_STDLIB symbol, which
3132         indicates to the C program that <stdlib.h> exists and should
3133         be included.
3134
3135 i_string (i_string.U):
3136         This variable conditionally defines the I_STRING symbol, which
3137         indicates that <string.h> should be included rather than <strings.h>.
3138
3139 i_sunmath (i_sunmath.U):
3140         This variable conditionally defines the I_SUNMATH symbol, and indicates
3141         whether a C program should include <sunmath.h>.
3142
3143 i_sysaccess (i_sysaccess.U):
3144         This variable conditionally defines the I_SYS_ACCESS symbol,
3145         and indicates whether a C program should include <sys/access.h>.
3146
3147 i_sysdir (i_sysdir.U):
3148         This variable conditionally defines the I_SYS_DIR symbol, and indicates
3149         whether a C program should include <sys/dir.h>.
3150
3151 i_sysfile (i_sysfile.U):
3152         This variable conditionally defines the I_SYS_FILE symbol, and indicates
3153         whether a C program should include <sys/file.h> to get R_OK and friends.
3154
3155 i_sysfilio (i_sysioctl.U):
3156         This variable conditionally defines the I_SYS_FILIO symbol, which
3157         indicates to the C program that <sys/filio.h> exists and should
3158         be included in preference to <sys/ioctl.h>.
3159
3160 i_sysin (i_niin.U):
3161         This variable conditionally defines I_SYS_IN, which indicates
3162         to the C program that it should include <sys/in.h> instead of
3163         <netinet/in.h>.
3164
3165 i_sysioctl (i_sysioctl.U):
3166         This variable conditionally defines the I_SYS_IOCTL symbol, which
3167         indicates to the C program that <sys/ioctl.h> exists and should
3168         be included.
3169
3170 i_syslog (i_syslog.U):
3171         This variable conditionally defines the I_SYSLOG symbol,
3172         and indicates whether a C program should include <syslog.h>.
3173
3174 i_sysmman (i_sysmman.U):
3175         This variable conditionally defines the I_SYS_MMAN symbol, and
3176         indicates whether a C program should include <sys/mman.h>.
3177
3178 i_sysmode (i_sysmode.U):
3179         This variable conditionally defines the I_SYSMODE symbol,
3180         and indicates whether a C program should include <sys/mode.h>.
3181
3182 i_sysmount (i_sysmount.U):
3183         This variable conditionally defines the I_SYSMOUNT symbol,
3184         and indicates whether a C program should include <sys/mount.h>.
3185
3186 i_sysndir (i_sysndir.U):
3187         This variable conditionally defines the I_SYS_NDIR symbol, and indicates
3188         whether a C program should include <sys/ndir.h>.
3189
3190 i_sysparam (i_sysparam.U):
3191         This variable conditionally defines the I_SYS_PARAM symbol, and indicates
3192         whether a C program should include <sys/param.h>.
3193
3194 i_syspoll (i_syspoll.U):
3195         This variable conditionally defines the I_SYS_POLL symbol, which
3196         indicates to the C program that it should include <sys/poll.h>.
3197
3198 i_sysresrc (i_sysresrc.U):
3199         This variable conditionally defines the I_SYS_RESOURCE symbol,
3200         and indicates whether a C program should include <sys/resource.h>.
3201
3202 i_syssecrt (i_syssecrt.U):
3203         This variable conditionally defines the I_SYS_SECURITY symbol,
3204         and indicates whether a C program should include <sys/security.h>.
3205
3206 i_sysselct (i_sysselct.U):
3207         This variable conditionally defines I_SYS_SELECT, which indicates
3208         to the C program that it should include <sys/select.h> in order to
3209         get the definition of struct timeval.
3210
3211 i_syssockio (i_sysioctl.U):
3212         This variable conditionally defines I_SYS_SOCKIO to indicate to the
3213         C program that socket ioctl codes may be found in <sys/sockio.h>
3214         instead of <sys/ioctl.h>.
3215
3216 i_sysstat (i_sysstat.U):
3217         This variable conditionally defines the I_SYS_STAT symbol,
3218         and indicates whether a C program should include <sys/stat.h>.
3219
3220 i_sysstatfs (i_sysstatfs.U):
3221         This variable conditionally defines the I_SYSSTATFS symbol,
3222         and indicates whether a C program should include <sys/statfs.h>.
3223
3224 i_sysstatvfs (i_sysstatvfs.U):
3225         This variable conditionally defines the I_SYSSTATVFS symbol,
3226         and indicates whether a C program should include <sys/statvfs.h>.
3227
3228 i_systime (i_time.U):
3229         This variable conditionally defines I_SYS_TIME, which indicates
3230         to the C program that it should include <sys/time.h>.
3231
3232 i_systimek (i_time.U):
3233         This variable conditionally defines I_SYS_TIME_KERNEL, which
3234         indicates to the C program that it should include <sys/time.h>
3235         with KERNEL defined.
3236
3237 i_systimes (i_systimes.U):
3238         This variable conditionally defines the I_SYS_TIMES symbol, and indicates
3239         whether a C program should include <sys/times.h>.
3240
3241 i_systypes (i_systypes.U):
3242         This variable conditionally defines the I_SYS_TYPES symbol,
3243         and indicates whether a C program should include <sys/types.h>.
3244
3245 i_sysuio (i_sysuio.U):
3246         This variable conditionally defines the I_SYSUIO symbol, and indicates
3247         whether a C program should include <sys/uio.h>.
3248
3249 i_sysun (i_sysun.U):
3250         This variable conditionally defines I_SYS_UN, which indicates
3251         to the C program that it should include <sys/un.h> to get UNIX
3252         domain socket definitions.
3253
3254 i_sysutsname (i_sysutsname.U):
3255         This variable conditionally defines the I_SYSUTSNAME symbol,
3256         and indicates whether a C program should include <sys/utsname.h>.
3257
3258 i_sysvfs (i_sysvfs.U):
3259         This variable conditionally defines the I_SYSVFS symbol,
3260         and indicates whether a C program should include <sys/vfs.h>.
3261
3262 i_syswait (i_syswait.U):
3263         This variable conditionally defines I_SYS_WAIT, which indicates
3264         to the C program that it should include <sys/wait.h>.
3265
3266 i_termio (i_termio.U):
3267         This variable conditionally defines the I_TERMIO symbol, which
3268         indicates to the C program that it should include <termio.h> rather
3269         than <sgtty.h>.
3270
3271 i_termios (i_termio.U):
3272         This variable conditionally defines the I_TERMIOS symbol, which
3273         indicates to the C program that the POSIX <termios.h> file is
3274         to be included.
3275
3276 i_time (i_time.U):
3277         This variable conditionally defines I_TIME, which indicates
3278         to the C program that it should include <time.h>.
3279
3280 i_unistd (i_unistd.U):
3281         This variable conditionally defines the I_UNISTD symbol, and indicates
3282         whether a C program should include <unistd.h>.
3283
3284 i_ustat (i_ustat.U):
3285         This variable conditionally defines the I_USTAT symbol, and indicates
3286         whether a C program should include <ustat.h>.
3287
3288 i_utime (i_utime.U):
3289         This variable conditionally defines the I_UTIME symbol, and indicates
3290         whether a C program should include <utime.h>.
3291
3292 i_values (i_values.U):
3293         This variable conditionally defines the I_VALUES symbol, and indicates
3294         whether a C program may include <values.h> to get symbols like MAXLONG
3295         and friends.
3296
3297 i_varargs (i_varhdr.U):
3298         This variable conditionally defines I_VARARGS, which indicates
3299         to the C program that it should include <varargs.h>.
3300
3301 i_varhdr (i_varhdr.U):
3302         Contains the name of the header to be included to get va_dcl definition.
3303         Typically one of varargs.h or stdarg.h.
3304
3305 i_vfork (i_vfork.U):
3306         This variable conditionally defines the I_VFORK symbol, and indicates
3307         whether a C program should include vfork.h.
3308
3309 ignore_versioned_solibs (libs.U):
3310         This variable should be non-empty if non-versioned shared
3311         libraries (libfoo.so.x.y) are to be ignored (because they
3312         cannot be linked against).
3313
3314 inc_version_list (inc_version_list.U):
3315         This variable specifies the list of subdirectories in over
3316         which perl.c:incpush() and lib/lib.pm will automatically
3317         search when adding directories to @INC.  The elements in
3318         the list are separated by spaces.  This is only useful
3319         if you have a perl library directory tree structured like the
3320         default one.  See INSTALL for how this works.  The versioned
3321         site_perl directory was introduced in 5.005, so that is the
3322         lowest possible value.
3323
3324         This list includes architecture-dependent directories back to
3325         version $api_versionstring (e.g. 5.5.640) and
3326         architecture-independent directories all the way back to
3327         5.005.
3328
3329 inc_version_list_init (inc_version_list.U):
3330         This variable holds the same list as inc_version_list, but
3331         each item is enclosed in double quotes and separated by commas,
3332         suitable for use in the PERL_INC_VERSION_LIST initialization.
3333
3334 incpath (usrinc.U):
3335         This variable must preceed the normal include path to get hte
3336         right one, as in "$incpath/usr/include" or "$incpath/usr/lib".
3337         Value can be "" or "/bsd43" on mips.
3338
3339 inews (Loc.U):
3340         This variable is defined but not used by Configure.
3341         The value is the empty string and is not useful.
3342
3343 initialinstalllocation (bin.U):
3344         When userelocatableinc is true, this variable holds the location
3345         that make install should copy the perl binary to, with all the
3346         run-time relocatable paths calculated from this at install time.
3347         When used, it is initialised to the original value of binexp, and
3348         then binexp is set to '.../', as the other binaries are found
3349         relative to the perl binary.
3350
3351 installarchlib (archlib.U):
3352         This variable is really the same as archlibexp but may differ on
3353         those systems using AFS. For extra portability, only this variable
3354         should be used in makefiles.
3355
3356 installbin (bin.U):
3357         This variable is the same as binexp unless AFS is running in which case
3358         the user is explicitely prompted for it. This variable should always
3359         be used in your makefiles for maximum portability.
3360
3361 installhtml1dir (html1dir.U):
3362         This variable is really the same as html1direxp, unless you are
3363         using a different installprefix.  For extra portability, you
3364         should only use this variable within your makefiles.
3365
3366 installhtml3dir (html3dir.U):
3367         This variable is really the same as html3direxp, unless you are
3368         using a different installprefix.  For extra portability, you
3369         should only use this variable within your makefiles.
3370
3371 installman1dir (man1dir.U):
3372         This variable is really the same as man1direxp, unless you are using
3373         AFS in which case it points to the read/write location whereas
3374         man1direxp only points to the read-only access location. For extra
3375         portability, you should only use this variable within your makefiles.
3376
3377 installman3dir (man3dir.U):
3378         This variable is really the same as man3direxp, unless you are using
3379         AFS in which case it points to the read/write location whereas
3380         man3direxp only points to the read-only access location. For extra
3381         portability, you should only use this variable within your makefiles.
3382
3383 installprefix (installprefix.U):
3384         This variable holds the name of the directory below which
3385         "make install" will install the package.  For most users, this
3386         is the same as prefix.  However, it is useful for
3387         installing the software into a different (usually temporary)
3388         location after which it can be bundled up and moved somehow
3389         to the final location specified by prefix.
3390
3391 installprefixexp (installprefix.U):
3392         This variable holds the full absolute path of installprefix
3393         with all ~-expansion done.
3394
3395 installprivlib (privlib.U):
3396         This variable is really the same as privlibexp but may differ on
3397         those systems using AFS. For extra portability, only this variable
3398         should be used in makefiles.
3399
3400 installscript (scriptdir.U):
3401         This variable is usually the same as scriptdirexp, unless you are on
3402         a system running AFS, in which case they may differ slightly. You
3403         should always use this variable within your makefiles for portability.
3404
3405 installsitearch (sitearch.U):
3406         This variable is really the same as sitearchexp but may differ on
3407         those systems using AFS. For extra portability, only this variable
3408         should be used in makefiles.
3409
3410 installsitebin (sitebin.U):
3411         This variable is usually the same as sitebinexp, unless you are on
3412         a system running AFS, in which case they may differ slightly. You
3413         should always use this variable within your makefiles for portability.
3414
3415 installsitehtml1dir (sitehtml1dir.U):
3416         This variable is really the same as sitehtml1direxp, unless you are using
3417         AFS in which case it points to the read/write location whereas
3418         html1direxp only points to the read-only access location. For extra
3419         portability, you should only use this variable within your makefiles.
3420
3421 installsitehtml3dir (sitehtml3dir.U):
3422         This variable is really the same as sitehtml3direxp, unless you are using
3423         AFS in which case it points to the read/write location whereas
3424         html3direxp only points to the read-only access location. For extra
3425         portability, you should only use this variable within your makefiles.
3426
3427 installsitelib (sitelib.U):
3428         This variable is really the same as sitelibexp but may differ on
3429         those systems using AFS. For extra portability, only this variable
3430         should be used in makefiles.
3431
3432 installsiteman1dir (siteman1dir.U):
3433         This variable is really the same as siteman1direxp, unless you are using
3434         AFS in which case it points to the read/write location whereas
3435         man1direxp only points to the read-only access location. For extra
3436         portability, you should only use this variable within your makefiles.
3437
3438 installsiteman3dir (siteman3dir.U):
3439         This variable is really the same as siteman3direxp, unless you are using
3440         AFS in which case it points to the read/write location whereas
3441         man3direxp only points to the read-only access location. For extra
3442         portability, you should only use this variable within your makefiles.
3443
3444 installsitescript (sitescript.U):
3445         This variable is usually the same as sitescriptexp, unless you are on
3446         a system running AFS, in which case they may differ slightly. You
3447         should always use this variable within your makefiles for portability.
3448
3449 installstyle (installstyle.U):
3450         This variable describes the "style" of the perl installation.
3451         This is intended to be useful for tools that need to
3452         manipulate entire perl distributions.  Perl itself doesn't use
3453         this to find its libraries -- the library directories are
3454         stored directly in Config.pm.  Currently, there are only two
3455         styles:  "lib" and "lib/perl5".  The default library locations
3456         (e.g. privlib, sitelib) are either $prefix/lib or
3457         $prefix/lib/perl5.  The former is useful if $prefix is a
3458         directory dedicated to perl (e.g. /opt/perl), while the latter
3459         is useful if $prefix is shared by many packages, e.g. if
3460         $prefix=/usr/local.
3461
3462         Unfortunately, while this "style" variable is used to set
3463         defaults for all three directory hierarchies (core, vendor, and
3464         site), there is no guarantee that the same style is actually
3465         appropriate for all those directories.  For example, $prefix
3466         might be /opt/perl, but $siteprefix might be /usr/local.
3467         (Perhaps, in retrospect, the "lib" style should never have been
3468         supported, but it did seem like a nice idea at the time.)
3469
3470         The situation is even less clear for tools such as MakeMaker
3471         that can be used to install additional modules into
3472         non-standard places.  For example, if a user intends to install
3473         a module into a private directory (perhaps by setting PREFIX on
3474         the Makefile.PL command line), then there is no reason to
3475         assume that the Configure-time $installstyle setting will be
3476         relevant for that PREFIX.
3477
3478         This may later be extended to include other information, so
3479         be careful with pattern-matching on the results.
3480
3481         For compatibility with perl5.005 and earlier, the default
3482         setting is based on whether or not $prefix contains the string
3483         "perl".
3484
3485 installusrbinperl (instubperl.U):
3486         This variable tells whether Perl should be installed also as
3487         /usr/bin/perl in addition to
3488         $installbin/perl
3489
3490 installvendorarch (vendorarch.U):
3491         This variable is really the same as vendorarchexp but may differ on
3492         those systems using AFS. For extra portability, only this variable
3493         should be used in makefiles.
3494
3495 installvendorbin (vendorbin.U):
3496         This variable is really the same as vendorbinexp but may differ on
3497         those systems using AFS. For extra portability, only this variable
3498         should be used in makefiles.
3499
3500 installvendorhtml1dir (vendorhtml1dir.U):
3501         This variable is really the same as vendorhtml1direxp but may differ on
3502         those systems using AFS. For extra portability, only this variable
3503         should be used in makefiles.
3504
3505 installvendorhtml3dir (vendorhtml3dir.U):
3506         This variable is really the same as vendorhtml3direxp but may differ on
3507         those systems using AFS. For extra portability, only this variable
3508         should be used in makefiles.
3509
3510 installvendorlib (vendorlib.U):
3511         This variable is really the same as vendorlibexp but may differ on
3512         those systems using AFS. For extra portability, only this variable
3513         should be used in makefiles.
3514
3515 installvendorman1dir (vendorman1dir.U):
3516         This variable is really the same as vendorman1direxp but may differ on
3517         those systems using AFS. For extra portability, only this variable
3518         should be used in makefiles.
3519
3520 installvendorman3dir (vendorman3dir.U):
3521         This variable is really the same as vendorman3direxp but may differ on
3522         those systems using AFS. For extra portability, only this variable
3523         should be used in makefiles.
3524
3525 installvendorscript (vendorscript.U):
3526         This variable is really the same as vendorscriptexp but may differ on
3527         those systems using AFS. For extra portability, only this variable
3528         should be used in makefiles.
3529
3530 intsize (intsize.U):
3531         This variable contains the value of the INTSIZE symbol, which
3532         indicates to the C program how many bytes there are in an int.
3533
3534 issymlink (issymlink.U):
3535         This variable holds the test command to test for a symbolic link
3536         (if they are supported).  Typical values include 'test -h' and
3537         'test -L'.
3538
3539 ivdformat (perlxvf.U):
3540         This variable contains the format string used for printing
3541         a Perl IV as a signed decimal integer.
3542
3543 ivsize (perlxv.U):
3544         This variable is the size of an IV in bytes.
3545
3546 ivtype (perlxv.U):
3547         This variable contains the C type used for Perl's IV.
3548
3549 known_extensions (Extensions.U):
3550         This variable holds a list of all XS extensions included in
3551         the package.
3552
3553 ksh (Loc.U):
3554         This variable is defined but not used by Configure.
3555         The value is the empty string and is not useful.
3556
3557 ld (dlsrc.U):
3558         This variable indicates the program to be used to link
3559         libraries for dynamic loading.  On some systems, it is 'ld'.
3560         On ELF systems, it should be $cc.  Mostly, we'll try to respect
3561         the hint file setting.
3562
3563 lddlflags (dlsrc.U):
3564         This variable contains any special flags that might need to be
3565         passed to $ld to create a shared library suitable for dynamic
3566         loading.  It is up to the makefile to use it.  For hpux, it
3567         should be '-b'.  For sunos 4.1, it is empty.
3568
3569 ldflags (ccflags.U):
3570         This variable contains any additional C loader flags desired by
3571         the user.  It is up to the Makefile to use this.
3572
3573 ldflags_uselargefiles (uselfs.U):
3574         This variable contains the loader flags needed by large file builds
3575         and added to ldflags by hints files.
3576
3577 ldlibpthname (libperl.U):
3578         This variable holds the name of the shared library
3579         search path, often LD_LIBRARY_PATH.  To get an empty
3580         string, the hints file must set this to 'none'.
3581
3582 less (Loc.U):
3583         This variable is used internally by Configure to determine the
3584         full pathname (if any) of the less program.  After Configure runs,
3585         the value is reset to a plain "less" and is not useful.
3586
3587 lib_ext (Unix.U):
3588         This is an old synonym for _a.
3589
3590 libc (libc.U):
3591         This variable contains the location of the C library.
3592
3593 libperl (libperl.U):
3594         The perl executable is obtained by linking perlmain.c with
3595         libperl, any static extensions (usually just DynaLoader),
3596         and any other libraries needed on this system.  libperl
3597         is usually libperl.a, but can also be libperl.so.xxx if
3598         the user wishes to build a perl executable with a shared
3599         library.
3600
3601 libpth (libpth.U):
3602         This variable holds the general path (space-separated) used to find
3603         libraries. It is intended to be used by other units.
3604
3605 libs (libs.U):
3606         This variable holds the additional libraries we want to use.
3607         It is up to the Makefile to deal with it.  The list can be empty.
3608
3609 libsdirs (libs.U):
3610         This variable holds the directory names aka dirnames of the libraries
3611         we found and accepted, duplicates are removed.
3612
3613 libsfiles (libs.U):
3614         This variable holds the filenames aka basenames of the libraries
3615         we found and accepted.
3616
3617 libsfound (libs.U):
3618         This variable holds the full pathnames of the libraries
3619         we found and accepted.
3620
3621 libspath (libs.U):
3622         This variable holds the directory names probed for libraries.
3623
3624 libswanted (Myinit.U):
3625         This variable holds a list of all the libraries we want to
3626         search.  The order is chosen to pick up the c library
3627         ahead of ucb or bsd libraries for SVR4.
3628
3629 libswanted_uselargefiles (uselfs.U):
3630         This variable contains the libraries needed by large file builds
3631         and added to ldflags by hints files.  It is a space separated list
3632         of the library names without the "lib" prefix or any suffix, just
3633         like libswanted..
3634
3635 line (Loc.U):
3636         This variable is defined but not used by Configure.
3637         The value is the empty string and is not useful.
3638
3639 lint (Loc.U):
3640         This variable is defined but not used by Configure.
3641         The value is the empty string and is not useful.
3642
3643 lkflags (ccflags.U):
3644         This variable contains any additional C partial linker flags desired by
3645         the user.  It is up to the Makefile to use this.
3646
3647 ln (Loc.U):
3648         This variable is used internally by Configure to determine the
3649         full pathname (if any) of the ln program.  After Configure runs,
3650         the value is reset to a plain "ln" and is not useful.
3651
3652 lns (lns.U):
3653         This variable holds the name of the command to make
3654         symbolic links (if they are supported).  It can be used
3655         in the Makefile. It is either 'ln -s' or 'ln'
3656
3657 localtime_r_proto (d_localtime_r.U):
3658         This variable encodes the prototype of localtime_r.
3659         It is zero if d_localtime_r is undef, and one of the
3660         REENTRANT_PROTO_T_ABC macros of reentr.h if d_localtime_r
3661         is defined.
3662
3663 locincpth (ccflags.U):
3664         This variable contains a list of additional directories to be
3665         searched by the compiler.  The appropriate '-I' directives will
3666         be added to ccflags.  This is intended to simplify setting
3667         local directories from the Configure command line.
3668         It's not much, but it parallels the loclibpth stuff in libpth.U.
3669
3670 loclibpth (libpth.U):
3671         This variable holds the paths (space-separated) used to find local
3672         libraries.  It is prepended to libpth, and is intended to be easily
3673         set from the command line.
3674
3675 longdblsize (d_longdbl.U):
3676         This variable contains the value of the LONG_DOUBLESIZE symbol, which
3677         indicates to the C program how many bytes there are in a long double,
3678         if this system supports long doubles.
3679
3680 longlongsize (d_longlong.U):
3681         This variable contains the value of the LONGLONGSIZE symbol, which
3682         indicates to the C program how many bytes there are in a long long,
3683         if this system supports long long.
3684
3685 longsize (intsize.U):
3686         This variable contains the value of the LONGSIZE symbol, which
3687         indicates to the C program how many bytes there are in a long.
3688
3689 lp (Loc.U):
3690         This variable is defined but not used by Configure.
3691         The value is the empty string and is not useful.
3692
3693 lpr (Loc.U):
3694         This variable is defined but not used by Configure.
3695         The value is the empty string and is not useful.
3696
3697 ls (Loc.U):
3698         This variable is used internally by Configure to determine the
3699         full pathname (if any) of the ls program.  After Configure runs,
3700         the value is reset to a plain "ls" and is not useful.
3701
3702 lseeksize (lseektype.U):
3703         This variable defines lseektype to be something like off_t, long,
3704         or whatever type is used to declare lseek offset's type in the
3705         kernel (which also appears to be lseek's return type).
3706
3707 lseektype (lseektype.U):
3708         This variable defines lseektype to be something like off_t, long,
3709         or whatever type is used to declare lseek offset's type in the
3710         kernel (which also appears to be lseek's return type).
3711
3712 mad (mad.U):
3713         This variable indicates that the Misc Attribute Definition code is to
3714         be compiled.
3715
3716 madlyh (mad.U):
3717         If the Misc Attribute Decoration is to be compiled, this variable is
3718         set to the name of the extra header files to be used, else it is ''
3719
3720 madlyobj (mad.U):
3721         If the Misc Attribute Decoration is to be compiled, this variable is
3722         set to the name of the extra object files to be used, else it is ''
3723
3724 madlysrc (mad.U):
3725         If the Misc Attribute Decoration is to be compiled, this variable is
3726         set to the name of the extra C source files to be used, else it is ''
3727
3728 mail (Loc.U):
3729         This variable is defined but not used by Configure.
3730         The value is the empty string and is not useful.
3731
3732 mailx (Loc.U):
3733         This variable is defined but not used by Configure.
3734         The value is the empty string and is not useful.
3735
3736 make (Loc.U):
3737         This variable is used internally by Configure to determine the
3738         full pathname (if any) of the make program.  After Configure runs,
3739         the value is reset to a plain "make" and is not useful.
3740
3741 make_set_make (make.U):
3742         Some versions of 'make' set the variable MAKE.  Others do not.
3743         This variable contains the string to be included in Makefile.SH
3744         so that MAKE is set if needed, and not if not needed.
3745         Possible values are:
3746
3747         make_set_make='#'               # If your make program handles this for you,
3748
3749         make_set_make="MAKE=$make"      # if it doesn't.
3750
3751         This uses a comment character so that we can distinguish a
3752         'set' value (from a previous config.sh or Configure '-D' option)
3753         from an uncomputed value.
3754
3755 mallocobj (mallocsrc.U):
3756         This variable contains the name of the malloc.o that this package
3757         generates, if that malloc.o is preferred over the system malloc.
3758         Otherwise the value is null.  This variable is intended for generating
3759         Makefiles.  See mallocsrc.
3760
3761 mallocsrc (mallocsrc.U):
3762         This variable contains the name of the malloc.c that comes with
3763         the package, if that malloc.c is preferred over the system malloc.
3764         Otherwise the value is null.  This variable is intended for generating
3765         Makefiles.
3766
3767 malloctype (mallocsrc.U):
3768         This variable contains the kind of ptr returned by malloc and realloc.
3769
3770 man1dir (man1dir.U):
3771         This variable contains the name of the directory in which manual
3772         source pages are to be put.  It is the responsibility of the
3773         Makefile.SH to get the value of this into the proper command.
3774         You must be prepared to do the ~name expansion yourself.
3775
3776 man1direxp (man1dir.U):
3777         This variable is the same as the man1dir variable, but is filename
3778         expanded at configuration time, for convenient use in makefiles.
3779
3780 man1ext (man1dir.U):
3781         This variable contains the extension that the manual page should
3782         have: one of 'n', 'l', or '1'.  The Makefile must supply the '.'.
3783         See man1dir.
3784
3785 man3dir (man3dir.U):
3786         This variable contains the name of the directory in which manual
3787         source pages are to be put.  It is the responsibility of the
3788         Makefile.SH to get the value of this into the proper command.
3789         You must be prepared to do the ~name expansion yourself.
3790
3791 man3direxp (man3dir.U):
3792         This variable is the same as the man3dir variable, but is filename
3793         expanded at configuration time, for convenient use in makefiles.
3794
3795 man3ext (man3dir.U):
3796         This variable contains the extension that the manual page should
3797         have: one of 'n', 'l', or '3'.  The Makefile must supply the '.'.
3798         See man3dir.
3799
3800 mips_type (usrinc.U):
3801         This variable holds the environment type for the mips system.
3802         Possible values are "BSD 4.3" and "System V".
3803
3804 mistrustnm (Csym.U):
3805         This variable can be used to establish a fallthrough for the cases
3806         where nm fails to find a symbol.  If usenm is false or usenm is true
3807         and mistrustnm is false, this variable has no effect.  If usenm is true
3808         and mistrustnm is "compile", a test program will be compiled to try to
3809         find any symbol that can't be located via nm lookup.  If mistrustnm is
3810         "run", the test program will be run as well as being compiled.
3811
3812 mkdir (Loc.U):
3813         This variable is used internally by Configure to determine the
3814         full pathname (if any) of the mkdir program.  After Configure runs,
3815         the value is reset to a plain "mkdir" and is not useful.
3816
3817 mmaptype (d_mmap.U):
3818         This symbol contains the type of pointer returned by mmap()
3819         (and simultaneously the type of the first argument).
3820         It can be 'void *' or 'caddr_t'.
3821
3822 modetype (modetype.U):
3823         This variable defines modetype to be something like mode_t,
3824         int, unsigned short, or whatever type is used to declare file
3825         modes for system calls.
3826
3827 more (Loc.U):
3828         This variable is used internally by Configure to determine the
3829         full pathname (if any) of the more program.  After Configure runs,
3830         the value is reset to a plain "more" and is not useful.
3831
3832 multiarch (multiarch.U):
3833         This variable conditionally defines the MULTIARCH symbol
3834         which signifies the presence of multiplatform files.
3835         This is normally set by hints files.
3836
3837 mv (Loc.U):
3838         This variable is defined but not used by Configure.
3839         The value is the empty string and is not useful.
3840
3841 myarchname (archname.U):
3842         This variable holds the architecture name computed by Configure in
3843         a previous run. It is not intended to be perused by any user and
3844         should never be set in a hint file.
3845
3846 mydomain (myhostname.U):
3847         This variable contains the eventual value of the MYDOMAIN symbol,
3848         which is the domain of the host the program is going to run on.
3849         The domain must be appended to myhostname to form a complete host name.
3850         The dot comes with mydomain, and need not be supplied by the program.
3851
3852 myhostname (myhostname.U):
3853         This variable contains the eventual value of the MYHOSTNAME symbol,
3854         which is the name of the host the program is going to run on.
3855         The domain is not kept with hostname, but must be gotten from mydomain.
3856         The dot comes with mydomain, and need not be supplied by the program.
3857
3858 myuname (Oldconfig.U):
3859         The output of 'uname -a' if available, otherwise the hostname. On Xenix,
3860         pseudo variables assignments in the output are stripped, thank you. The
3861         whole thing is then lower-cased.
3862
3863 n (n.U):
3864         This variable contains the '-n' flag if that is what causes the echo
3865         command to suppress newline.  Otherwise it is null.  Correct usage is
3866         $echo $n "prompt for a question: $c".
3867
3868 need_va_copy (need_va_copy.U):
3869         This symbol, if defined, indicates that the system stores
3870         the variable argument list datatype, va_list, in a format
3871         that cannot be copied by simple assignment, so that some
3872         other means must be used when copying is required.
3873         As such systems vary in their provision (or non-provision)
3874         of copying mechanisms, handy.h defines a platform-
3875         independent macro, Perl_va_copy(src, dst), to do the job.
3876
3877 netdb_hlen_type (netdbtype.U):
3878         This variable holds the type used for the 2nd argument to
3879         gethostbyaddr().  Usually, this is int or size_t or unsigned.
3880         This is only useful if you have gethostbyaddr(), naturally.
3881
3882 netdb_host_type (netdbtype.U):
3883         This variable holds the type used for the 1st argument to
3884         gethostbyaddr().  Usually, this is char * or void *,  possibly
3885         with or without a const prefix.
3886         This is only useful if you have gethostbyaddr(), naturally.
3887
3888 netdb_name_type (netdbtype.U):
3889         This variable holds the type used for the argument to
3890         gethostbyname().  Usually, this is char * or const char *.
3891         This is only useful if you have gethostbyname(), naturally.
3892
3893 netdb_net_type (netdbtype.U):
3894         This variable holds the type used for the 1st argument to
3895         getnetbyaddr().  Usually, this is int or long.
3896         This is only useful if you have getnetbyaddr(), naturally.
3897
3898 nm (Loc.U):
3899         This variable is used internally by Configure to determine the
3900         full pathname (if any) of the nm program.  After Configure runs,
3901         the value is reset to a plain "nm" and is not useful.
3902
3903 nm_opt (usenm.U):
3904         This variable holds the options that may be necessary for nm.
3905
3906 nm_so_opt (usenm.U):
3907         This variable holds the options that may be necessary for nm
3908         to work on a shared library but that can not be used on an
3909         archive library.  Currently, this is only used by Linux, where
3910         nm --dynamic is *required* to get symbols from an ELF library which
3911         has been stripped, but nm --dynamic is *fatal* on an archive library.
3912         Maybe Linux should just always set usenm=false.
3913
3914 nonxs_ext (Extensions.U):
3915         This variable holds a list of all non-xs extensions included
3916         in the package.  All of them will be built.
3917
3918 nroff (Loc.U):
3919         This variable is used internally by Configure to determine the
3920         full pathname (if any) of the nroff program.  After Configure runs,
3921         the value is reset to a plain "nroff" and is not useful.
3922
3923 nv_overflows_integers_at (perlxv.U):
3924         This variable gives the largest integer value that NVs can hold
3925         as a constant floating point expression.
3926         If it could not be determined, it holds the value 0.
3927
3928 nv_preserves_uv_bits (perlxv.U):
3929         This variable indicates how many of bits type uvtype
3930         a variable nvtype can preserve.
3931
3932 nveformat (perlxvf.U):
3933         This variable contains the format string used for printing
3934         a Perl NV using %e-ish floating point format.
3935
3936 nvEUformat (perlxvf.U):
3937         This variable contains the format string used for printing
3938         a Perl NV using %E-ish floating point format.
3939
3940 nvfformat (perlxvf.U):
3941         This variable confains the format string used for printing
3942         a Perl NV using %f-ish floating point format.
3943
3944 nvFUformat (perlxvf.U):
3945         This variable confains the format string used for printing
3946         a Perl NV using %F-ish floating point format.
3947
3948 nvgformat (perlxvf.U):
3949         This variable contains the format string used for printing
3950         a Perl NV using %g-ish floating point format.
3951
3952 nvGUformat (perlxvf.U):
3953         This variable contains the format string used for printing
3954         a Perl NV using %G-ish floating point format.
3955
3956 nvsize (perlxv.U):
3957         This variable is the size of an NV in bytes.
3958
3959 nvtype (perlxv.U):
3960         This variable contains the C type used for Perl's NV.
3961
3962 o_nonblock (nblock_io.U):
3963         This variable bears the symbol value to be used during open() or fcntl()
3964         to turn on non-blocking I/O for a file descriptor. If you wish to switch
3965         between blocking and non-blocking, you may try ioctl(FIOSNBIO) instead,
3966         but that is only supported by some devices.
3967
3968 obj_ext (Unix.U):
3969         This is an old synonym for _o.
3970
3971 old_pthread_create_joinable (d_pthrattrj.U):
3972         This variable defines the constant to use for creating joinable
3973         (aka undetached) pthreads.  Unused if pthread.h defines
3974         PTHREAD_CREATE_JOINABLE.  If used, possible values are
3975         PTHREAD_CREATE_UNDETACHED and __UNDETACHED.
3976
3977 optimize (ccflags.U):
3978         This variable contains any optimizer/debugger flag that should be used.
3979         It is up to the Makefile to use it.
3980
3981 orderlib (orderlib.U):
3982         This variable is "true" if the components of libraries must be ordered
3983         (with `lorder $* | tsort`) before placing them in an archive.  Set to
3984         "false" if ranlib or ar can generate random libraries.
3985
3986 osname (Oldconfig.U):
3987         This variable contains the operating system name (e.g. sunos,
3988         solaris, hpux, etc.).  It can be useful later on for setting
3989         defaults.  Any spaces are replaced with underscores.  It is set
3990         to a null string if we can't figure it out.
3991
3992 osvers (Oldconfig.U):
3993         This variable contains the operating system version (e.g.
3994         4.1.3, 5.2, etc.).  It is primarily used for helping select
3995         an appropriate hints file, but might be useful elsewhere for
3996         setting defaults.  It is set to '' if we can't figure it out.
3997         We try to be flexible about how much of the version number
3998         to keep, e.g. if 4.1.1, 4.1.2, and 4.1.3 are essentially the
3999         same for this package, hints files might just be os_4.0 or
4000         os_4.1, etc., not keeping separate files for each little release.
4001
4002 otherlibdirs (otherlibdirs.U):
4003         This variable contains a colon-separated set of paths for the perl
4004         binary to search for additional library files or modules.
4005         These directories will be tacked to the end of @INC.
4006         Perl will automatically search below each path for version-
4007         and architecture-specific directories.  See inc_version_list
4008         for more details.
4009         A value of ' ' means 'none' and is used to preserve this value
4010         for the next run through Configure.
4011
4012 package (package.U):
4013         This variable contains the name of the package being constructed.
4014         It is primarily intended for the use of later Configure units.
4015
4016 pager (pager.U):
4017         This variable contains the name of the preferred pager on the system.
4018         Usual values are (the full pathnames of) more, less, pg, or cat.
4019
4020 passcat (nis.U):
4021         This variable contains a command that produces the text of the
4022         /etc/passwd file.  This is normally "cat /etc/passwd", but can be
4023         "ypcat passwd" when NIS is used.
4024         On some systems, such as os390, there may be no equivalent
4025         command, in which case this variable is unset.
4026
4027 patchlevel (patchlevel.U):
4028         The patchlevel level of this package.
4029         The value of patchlevel comes from the patchlevel.h file.
4030         In a version number such as 5.6.1, this is the "6".
4031         In patchlevel.h, this is referred to as "PERL_VERSION".
4032
4033 path_sep (Unix.U):
4034         This is an old synonym for p_ in Head.U, the character
4035         used to separate elements in the command shell search PATH.
4036
4037 perl (Loc.U):
4038         This variable is defined but not used by Configure.
4039         The value is the empty string and is not useful.
4040
4041 perl5 (perl5.U):
4042         This variable contains the full path (if any) to a previously
4043         installed perl5.005 or later suitable for running the script
4044         to determine inc_version_list.
4045
4046 PERL_API_REVISION (patchlevel.h):
4047         This number describes the earliest compatible PERL_REVISION of
4048         Perl ("compatibility" here being defined as sufficient binary/API
4049         compatibility to run XS code built with the older version).
4050         Normally this does not change across maintenance releases.
4051         Please read the comment in patchlevel.h.
4052
4053 PERL_API_SUBVERSION (patchlevel.h):
4054         This number describes the earliest compatible PERL_SUBVERSION of
4055         Perl ("compatibility" here being defined as sufficient binary/API
4056         compatibility to run XS code built with the older version).
4057         Normally this does not change across maintenance releases.
4058         Please read the comment in patchlevel.h.
4059
4060 PERL_API_VERSION (patchlevel.h):
4061         This number describes the earliest compatible PERL_VERSION of
4062         Perl ("compatibility" here being defined as sufficient binary/API
4063         compatibility to run XS code built with the older version).
4064         Normally this does not change across maintenance releases.
4065         Please read the comment in patchlevel.h.
4066
4067 PERL_CONFIG_SH (Oldsyms.U):
4068         This is set to 'true' in config.sh so that a shell script
4069         sourcing config.sh can tell if it has been sourced already.
4070
4071 PERL_PATCHLEVEL (Oldsyms.U):
4072         This symbol reflects the patchlevel, if available. Will usually
4073         come from the .patch file, which is available when the perl
4074         source tree was fetched with rsync.
4075
4076 perl_patchlevel (patchlevel.U):
4077         This is the Perl patch level, a numeric change identifier,
4078         as defined by whichever source code maintenance system
4079         is used to maintain the patches; currently Perforce.
4080         It does not correlate with the Perl version numbers or
4081         the maintenance versus development dichotomy except
4082         by also being increasing.
4083
4084 PERL_REVISION (Oldsyms.U):
4085         In a Perl version number such as 5.6.2, this is the 5.
4086         This value is manually set in patchlevel.h
4087
4088 PERL_SUBVERSION (Oldsyms.U):
4089         In a Perl version number such as 5.6.2, this is the 2.
4090         Values greater than 50 represent potentially unstable
4091         development subversions.
4092         This value is manually set in patchlevel.h
4093
4094 PERL_VERSION (Oldsyms.U):
4095         In a Perl version number such as 5.6.2, this is the 6.
4096         This value is manually set in patchlevel.h
4097
4098 perladmin (perladmin.U):
4099         Electronic mail address of the perl5 administrator.
4100
4101 perllibs (End.U):
4102         The list of libraries needed by Perl only (any libraries needed
4103         by extensions only will by dropped, if using dynamic loading).
4104
4105 perlpath (perlpath.U):
4106         This variable contains the eventual value of the PERLPATH symbol,
4107         which contains the name of the perl interpreter to be used in
4108         shell scripts and in the "eval 'exec'" idiom.  This variable is
4109         not necessarily the pathname of the file containing the perl
4110         interpreter; you must append the executable extension (_exe) if
4111         it is not already present.  Note that Perl code that runs during
4112         the Perl build process cannot reference this variable, as Perl
4113         may not have been installed, or even if installed, may be a
4114         different version of Perl.
4115
4116 pg (Loc.U):
4117         This variable is used internally by Configure to determine the
4118         full pathname (if any) of the pg program.  After Configure runs,
4119         the value is reset to a plain "pg" and is not useful.
4120
4121 phostname (myhostname.U):
4122         This variable contains the eventual value of the PHOSTNAME symbol,
4123         which is a command that can be fed to popen() to get the host name.
4124         The program should probably not presume that the domain is or isn't
4125         there already.
4126
4127 pidtype (pidtype.U):
4128         This variable defines PIDTYPE to be something like pid_t, int,
4129         ushort, or whatever type is used to declare process ids in the kernel.
4130
4131 plibpth (libpth.U):
4132         Holds the private path used by Configure to find out the libraries.
4133         Its value is prepend to libpth. This variable takes care of special
4134         machines, like the mips.  Usually, it should be empty.
4135
4136 pmake (Loc.U):
4137         This variable is defined but not used by Configure.
4138         The value is the empty string and is not useful.
4139
4140 pr (Loc.U):
4141         This variable is defined but not used by Configure.
4142         The value is the empty string and is not useful.
4143
4144 prefix (prefix.U):
4145         This variable holds the name of the directory below which the
4146         user will install the package.  Usually, this is /usr/local, and
4147         executables go in /usr/local/bin, library stuff in /usr/local/lib,
4148         man pages in /usr/local/man, etc.  It is only used to set defaults
4149         for things in bin.U, mansrc.U, privlib.U, or scriptdir.U.
4150
4151 prefixexp (prefix.U):
4152         This variable holds the full absolute path of the directory below
4153         which the user will install the package.  Derived from prefix.
4154
4155 privlib (privlib.U):
4156         This variable contains the eventual value of the PRIVLIB symbol,
4157         which is the name of the private library for this package.  It may
4158         have a ~ on the front. It is up to the makefile to eventually create
4159         this directory while performing installation (with ~ substitution).
4160
4161 privlibexp (privlib.U):
4162         This variable is the ~name expanded version of privlib, so that you
4163         may use it directly in Makefiles or shell scripts.
4164
4165 procselfexe (d_procselfexe.U):
4166         If d_procselfexe is defined, $procselfexe is the filename
4167         of the symbolic link pointing to the absolute pathname of
4168         the executing program.
4169
4170 prototype (prototype.U):
4171         This variable holds the eventual value of CAN_PROTOTYPE, which
4172         indicates the C compiler can handle funciton prototypes.
4173
4174 ptrsize (ptrsize.U):
4175         This variable contains the value of the PTRSIZE symbol, which
4176         indicates to the C program how many bytes there are in a pointer.
4177
4178 quadkind (quadtype.U):
4179         This variable, if defined, encodes the type of a quad:
4180         1 = int, 2 = long, 3 = long long, 4 = int64_t.
4181
4182 quadtype (quadtype.U):
4183         This variable defines Quad_t to be something like long, int,
4184         long long, int64_t, or whatever type is used for 64-bit integers.
4185
4186 randbits (randfunc.U):
4187         Indicates how many bits are produced by the function used to
4188         generate normalized random numbers.
4189
4190 randfunc (randfunc.U):
4191         Indicates the name of the random number function to use.
4192         Values include drand48, random, and rand. In C programs,
4193         the 'Drand01' macro is defined to generate uniformly distributed
4194         random numbers over the range [0., 1.[ (see drand01 and nrand).
4195
4196 random_r_proto (d_random_r.U):
4197         This variable encodes the prototype of random_r.
4198         It is zero if d_random_r is undef, and one of the
4199         REENTRANT_PROTO_T_ABC macros of reentr.h if d_random_r
4200         is defined.
4201
4202 randseedtype (randfunc.U):
4203         Indicates the type of the argument of the seedfunc.
4204
4205 ranlib (orderlib.U):
4206         This variable is set to the pathname of the ranlib program, if it is
4207         needed to generate random libraries.  Set to ":" if ar can generate
4208         random libraries or if random libraries are not supported
4209
4210 rd_nodata (nblock_io.U):
4211         This variable holds the return code from read() when no data is
4212         present. It should be -1, but some systems return 0 when O_NDELAY is
4213         used, which is a shame because you cannot make the difference between
4214         no data and an EOF.. Sigh!
4215
4216 readdir64_r_proto (d_readdir64_r.U):
4217         This variable encodes the prototype of readdir64_r.
4218         It is zero if d_readdir64_r is undef, and one of the
4219         REENTRANT_PROTO_T_ABC macros of reentr.h if d_readdir64_r
4220         is defined.
4221
4222 readdir_r_proto (d_readdir_r.U):
4223         This variable encodes the prototype of readdir_r.
4224         It is zero if d_readdir_r is undef, and one of the
4225         REENTRANT_PROTO_T_ABC macros of reentr.h if d_readdir_r
4226         is defined.
4227
4228 revision (patchlevel.U):
4229         The value of revision comes from the patchlevel.h file.
4230         In a version number such as 5.6.1, this is the "5".
4231         In patchlevel.h, this is referred to as "PERL_REVISION".
4232
4233 rm (Loc.U):
4234         This variable is used internally by Configure to determine the
4235         full pathname (if any) of the rm program.  After Configure runs,
4236         the value is reset to a plain "rm" and is not useful.
4237
4238 rm_try (Unix.U):
4239         This is a cleanup variable for try test programs.
4240         Internal Configure use only.
4241
4242 rmail (Loc.U):
4243         This variable is defined but not used by Configure.
4244         The value is the empty string and is not useful.
4245
4246 run (Cross.U):
4247         This variable contains the command used by Configure
4248         to copy and execute a cross-compiled executable in the
4249         target host.  Useful and available only during Perl build.
4250         Empty string '' if not cross-compiling.
4251
4252 runnm (usenm.U):
4253         This variable contains 'true' or 'false' depending whether the
4254         nm extraction should be performed or not, according to the value
4255         of usenm and the flags on the Configure command line.
4256
4257 sched_yield (d_pthread_y.U):
4258         This variable defines the way to yield the execution
4259         of the current thread.
4260
4261 scriptdir (scriptdir.U):
4262         This variable holds the name of the directory in which the user wants
4263         to put publicly scripts for the package in question.  It is either
4264         the same directory as for binaries, or a special one that can be
4265         mounted across different architectures, like /usr/share. Programs
4266         must be prepared to deal with ~name expansion.
4267
4268 scriptdirexp (scriptdir.U):
4269         This variable is the same as scriptdir, but is filename expanded
4270         at configuration time, for programs not wanting to bother with it.
4271
4272 sed (Loc.U):
4273         This variable is used internally by Configure to determine the
4274         full pathname (if any) of the sed program.  After Configure runs,
4275         the value is reset to a plain "sed" and is not useful.
4276
4277 seedfunc (randfunc.U):
4278         Indicates the random number generating seed function.
4279         Values include srand48, srandom, and srand.
4280
4281 selectminbits (selectminbits.U):
4282         This variable holds the minimum number of bits operated by select.
4283         That is, if you do select(n, ...), how many bits at least will be
4284         cleared in the masks if some activity is detected.  Usually this
4285         is either n or 32*ceil(n/32), especially many little-endians do
4286         the latter.  This is only useful if you have select(), naturally.
4287
4288 selecttype (selecttype.U):
4289         This variable holds the type used for the 2nd, 3rd, and 4th
4290         arguments to select.  Usually, this is 'fd_set *', if HAS_FD_SET
4291         is defined, and 'int *' otherwise.  This is only useful if you
4292         have select(), naturally.
4293
4294 sendmail (Loc.U):
4295         This variable is defined but not used by Configure.
4296         The value is the empty string and is not useful.
4297
4298 setgrent_r_proto (d_setgrent_r.U):
4299         This variable encodes the prototype of setgrent_r.
4300         It is zero if d_setgrent_r is undef, and one of the
4301         REENTRANT_PROTO_T_ABC macros of reentr.h if d_setgrent_r
4302         is defined.
4303
4304 sethostent_r_proto (d_sethostent_r.U):
4305         This variable encodes the prototype of sethostent_r.
4306         It is zero if d_sethostent_r is undef, and one of the
4307         REENTRANT_PROTO_T_ABC macros of reentr.h if d_sethostent_r
4308         is defined.
4309
4310 setlocale_r_proto (d_setlocale_r.U):
4311         This variable encodes the prototype of setlocale_r.
4312         It is zero if d_setlocale_r is undef, and one of the
4313         REENTRANT_PROTO_T_ABC macros of reentr.h if d_setlocale_r
4314         is defined.
4315
4316 setnetent_r_proto (d_setnetent_r.U):
4317         This variable encodes the prototype of setnetent_r.
4318         It is zero if d_setnetent_r is undef, and one of the
4319         REENTRANT_PROTO_T_ABC macros of reentr.h if d_setnetent_r
4320         is defined.
4321
4322 setprotoent_r_proto (d_setprotoent_r.U):
4323         This variable encodes the prototype of setprotoent_r.
4324         It is zero if d_setprotoent_r is undef, and one of the
4325         REENTRANT_PROTO_T_ABC macros of reentr.h if d_setprotoent_r
4326         is defined.
4327
4328 setpwent_r_proto (d_setpwent_r.U):
4329         This variable encodes the prototype of setpwent_r.
4330         It is zero if d_setpwent_r is undef, and one of the
4331         REENTRANT_PROTO_T_ABC macros of reentr.h if d_setpwent_r
4332         is defined.
4333
4334 setservent_r_proto (d_setservent_r.U):
4335         This variable encodes the prototype of setservent_r.
4336         It is zero if d_setservent_r is undef, and one of the
4337         REENTRANT_PROTO_T_ABC macros of reentr.h if d_setservent_r
4338         is defined.
4339
4340 sGMTIME_max (time_size.U):
4341         This variable defines the maximum value of the time_t offset that
4342         the system function gmtime () accepts
4343
4344 sGMTIME_min (time_size.U):
4345         This variable defines the minimum value of the time_t offset that
4346         the system function gmtime () accepts
4347
4348 sh (sh.U):
4349         This variable contains the full pathname of the shell used
4350         on this system to execute Bourne shell scripts.  Usually, this will be
4351         /bin/sh, though it's possible that some systems will have /bin/ksh,
4352         /bin/pdksh, /bin/ash, /bin/bash, or even something such as
4353         D:/bin/sh.exe.
4354         This unit comes before Options.U, so you can't set sh with a '-D'
4355         option, though you can override this (and startsh)
4356         with '-O -Dsh=/bin/whatever -Dstartsh=whatever'
4357
4358 shar (Loc.U):
4359         This variable is defined but not used by Configure.
4360         The value is the empty string and is not useful.
4361
4362 sharpbang (spitshell.U):
4363         This variable contains the string #! if this system supports that
4364         construct.
4365
4366 shmattype (d_shmat.U):
4367         This symbol contains the type of pointer returned by shmat().
4368         It can be 'void *' or 'char *'.
4369
4370 shortsize (intsize.U):
4371         This variable contains the value of the SHORTSIZE symbol which
4372         indicates to the C program how many bytes there are in a short.
4373
4374 shrpenv (libperl.U):
4375         If the user builds a shared libperl.so, then we need to tell the
4376         'perl' executable where it will be able to find the installed libperl.so.
4377         One way to do this on some systems is to set the environment variable
4378         LD_RUN_PATH to the directory that will be the final location of the
4379         shared libperl.so.  The makefile can use this with something like
4380         $shrpenv $(CC) -o perl perlmain.o $libperl $libs
4381         Typical values are
4382         shrpenv="env LD_RUN_PATH=$archlibexp/CORE"
4383         or
4384         shrpenv=''
4385         See the main perl Makefile.SH for actual working usage.
4386         Alternatively, we might be able to use a command line option such
4387         as -R $archlibexp/CORE (Solaris) or -Wl,-rpath
4388         $archlibexp/CORE (Linux).
4389
4390 shsharp (spitshell.U):
4391         This variable tells further Configure units whether your sh can
4392         handle # comments.
4393
4394 sig_count (sig_name.U):
4395         This variable holds a number larger than the largest valid
4396         signal number.  This is usually the same as the NSIG macro.
4397
4398 sig_name (sig_name.U):
4399         This variable holds the signal names, space separated. The leading
4400         SIG in signal name is removed.  A ZERO is prepended to the list.
4401         This is currently not used, sig_name_init is used instead.
4402
4403 sig_name_init (sig_name.U):
4404         This variable holds the signal names, enclosed in double quotes and
4405         separated by commas, suitable for use in the SIG_NAME definition
4406         below.  A "ZERO" is prepended to the list, and the list is
4407         terminated with a plain 0.  The leading SIG in signal names
4408         is removed. See sig_num.
4409
4410 sig_num (sig_name.U):
4411         This variable holds the signal numbers, space separated. A ZERO is
4412         prepended to the list (corresponding to the fake SIGZERO).
4413         Those numbers correspond to  the value of the signal listed
4414         in the same place within the sig_name list.
4415         This is currently not used, sig_num_init is used instead.
4416
4417 sig_num_init (sig_name.U):
4418         This variable holds the signal numbers, enclosed in double quotes and
4419         separated by commas, suitable for use in the SIG_NUM definition
4420         below.  A "ZERO" is prepended to the list, and the list is
4421         terminated with a plain 0.
4422
4423 sig_size (sig_name.U):
4424         This variable contains the number of elements of the sig_name
4425         and sig_num arrays.
4426
4427 signal_t (d_voidsig.U):
4428         This variable holds the type of the signal handler (void or int).
4429
4430 sitearch (sitearch.U):
4431         This variable contains the eventual value of the SITEARCH symbol,
4432         which is the name of the private library for this package.  It may
4433         have a ~ on the front. It is up to the makefile to eventually create
4434         this directory while performing installation (with ~ substitution).
4435         The standard distribution will put nothing in this directory.
4436         After perl has been installed, users may install their own local
4437         architecture-dependent modules in this directory with
4438         MakeMaker Makefile.PL
4439         or equivalent.  See INSTALL for details.
4440
4441 sitearchexp (sitearch.U):
4442         This variable is the ~name expanded version of sitearch, so that you
4443         may use it directly in Makefiles or shell scripts.
4444
4445 sitebin (sitebin.U):
4446         This variable holds the name of the directory in which the user wants
4447         to put add-on publicly executable files for the package in question.  It
4448         is most often a local directory such as /usr/local/bin. Programs using
4449         this variable must be prepared to deal with ~name substitution.
4450         The standard distribution will put nothing in this directory.
4451         After perl has been installed, users may install their own local
4452         executables in this directory with
4453         MakeMaker Makefile.PL
4454         or equivalent.  See INSTALL for details.
4455
4456 sitebinexp (sitebin.U):
4457         This is the same as the sitebin variable, but is filename expanded at
4458         configuration time, for use in your makefiles.
4459
4460 sitehtml1dir (sitehtml1dir.U):
4461         This variable contains the name of the directory in which site-specific
4462         html source pages are to be put.  It is the responsibility of the
4463         Makefile.SH to get the value of this into the proper command.
4464         You must be prepared to do the ~name expansion yourself.
4465         The standard distribution will put nothing in this directory.
4466         After perl has been installed, users may install their own local
4467         html pages in this directory with
4468         MakeMaker Makefile.PL
4469         or equivalent.  See INSTALL for details.
4470
4471 sitehtml1direxp (sitehtml1dir.U):
4472         This variable is the same as the sitehtml1dir variable, but is filename
4473         expanded at configuration time, for convenient use in makefiles.
4474
4475 sitehtml3dir (sitehtml3dir.U):
4476         This variable contains the name of the directory in which site-specific
4477         library html source pages are to be put.  It is the responsibility of the
4478         Makefile.SH to get the value of this into the proper command.
4479         You must be prepared to do the ~name expansion yourself.
4480         The standard distribution will put nothing in this directory.
4481         After perl has been installed, users may install their own local
4482         library html pages in this directory with
4483         MakeMaker Makefile.PL
4484         or equivalent.  See INSTALL for details.
4485
4486 sitehtml3direxp (sitehtml3dir.U):
4487         This variable is the same as the sitehtml3dir variable, but is filename
4488         expanded at configuration time, for convenient use in makefiles.
4489
4490 sitelib (sitelib.U):
4491         This variable contains the eventual value of the SITELIB symbol,
4492         which is the name of the private library for this package.  It may
4493         have a ~ on the front. It is up to the makefile to eventually create
4494         this directory while performing installation (with ~ substitution).
4495         The standard distribution will put nothing in this directory.
4496         After perl has been installed, users may install their own local
4497         architecture-independent modules in this directory with
4498         MakeMaker Makefile.PL
4499         or equivalent.  See INSTALL for details.
4500
4501 sitelib_stem (sitelib.U):
4502         This variable is $sitelibexp with any trailing version-specific component
4503         removed.  The elements in inc_version_list (inc_version_list.U) can
4504         be tacked onto this variable to generate a list of directories to search.
4505
4506 sitelibexp (sitelib.U):
4507         This variable is the ~name expanded version of sitelib, so that you
4508         may use it directly in Makefiles or shell scripts.
4509
4510 siteman1dir (siteman1dir.U):
4511         This variable contains the name of the directory in which site-specific
4512         manual source pages are to be put.  It is the responsibility of the
4513         Makefile.SH to get the value of this into the proper command.
4514         You must be prepared to do the ~name expansion yourself.
4515         The standard distribution will put nothing in this directory.
4516         After perl has been installed, users may install their own local
4517         man1 pages in this directory with
4518         MakeMaker Makefile.PL
4519         or equivalent.  See INSTALL for details.
4520
4521 siteman1direxp (siteman1dir.U):
4522         This variable is the same as the siteman1dir variable, but is filename
4523         expanded at configuration time, for convenient use in makefiles.
4524
4525 siteman3dir (siteman3dir.U):
4526         This variable contains the name of the directory in which site-specific
4527         library man source pages are to be put.  It is the responsibility of the
4528         Makefile.SH to get the value of this into the proper command.
4529         You must be prepared to do the ~name expansion yourself.
4530         The standard distribution will put nothing in this directory.
4531         After perl has been installed, users may install their own local
4532         man3 pages in this directory with
4533         MakeMaker Makefile.PL
4534         or equivalent.  See INSTALL for details.
4535
4536 siteman3direxp (siteman3dir.U):
4537         This variable is the same as the siteman3dir variable, but is filename
4538         expanded at configuration time, for convenient use in makefiles.
4539
4540 siteprefix (siteprefix.U):
4541         This variable holds the full absolute path of the directory below
4542         which the user will install add-on packages.
4543         See INSTALL for usage and examples.
4544
4545 siteprefixexp (siteprefix.U):
4546         This variable holds the full absolute path of the directory below
4547         which the user will install add-on packages.  Derived from siteprefix.
4548
4549 sitescript (sitescript.U):
4550         This variable holds the name of the directory in which the user wants
4551         to put add-on publicly executable files for the package in question.  It
4552         is most often a local directory such as /usr/local/bin. Programs using
4553         this variable must be prepared to deal with ~name substitution.
4554         The standard distribution will put nothing in this directory.
4555         After perl has been installed, users may install their own local
4556         scripts in this directory with
4557         MakeMaker Makefile.PL
4558         or equivalent.  See INSTALL for details.
4559
4560 sitescriptexp (sitescript.U):
4561         This is the same as the sitescript variable, but is filename expanded at
4562         configuration time, for use in your makefiles.
4563
4564 sizesize (sizesize.U):
4565         This variable contains the size of a sizetype in bytes.
4566
4567 sizetype (sizetype.U):
4568         This variable defines sizetype to be something like size_t,
4569         unsigned long, or whatever type is used to declare length
4570         parameters for string functions.
4571
4572 sleep (Loc.U):
4573         This variable is defined but not used by Configure.
4574         The value is the empty string and is not useful.
4575
4576 sLOCALTIME_max (time_size.U):
4577         This variable defines the maximum value of the time_t offset that
4578         the system function localtime () accepts
4579
4580 sLOCALTIME_min (time_size.U):
4581         This variable defines the minimum value of the time_t offset that
4582         the system function localtime () accepts
4583
4584 smail (Loc.U):
4585         This variable is defined but not used by Configure.
4586         The value is the empty string and is not useful.
4587
4588 so (so.U):
4589         This variable holds the extension used to identify shared libraries
4590         (also known as shared objects) on the system. Usually set to 'so'.
4591
4592 sockethdr (d_socket.U):
4593         This variable has any cpp '-I' flags needed for socket support.
4594
4595 socketlib (d_socket.U):
4596         This variable has the names of any libraries needed for socket support.
4597
4598 socksizetype (socksizetype.U):
4599         This variable holds the type used for the size argument
4600         for various socket calls like accept.  Usual values include
4601         socklen_t, size_t, and int.
4602
4603 sort (Loc.U):
4604         This variable is used internally by Configure to determine the
4605         full pathname (if any) of the sort program.  After Configure runs,
4606         the value is reset to a plain "sort" and is not useful.
4607
4608 spackage (package.U):
4609         This variable contains the name of the package being constructed,
4610         with the first letter uppercased, i.e. suitable for starting
4611         sentences.
4612
4613 spitshell (spitshell.U):
4614         This variable contains the command necessary to spit out a runnable
4615         shell on this system.  It is either cat or a grep '-v' for # comments.
4616
4617 sPRId64 (quadfio.U):
4618         This variable, if defined, contains the string used by stdio to
4619         format 64-bit decimal numbers (format 'd') for output.
4620
4621 sPRIeldbl (longdblfio.U):
4622         This variable, if defined, contains the string used by stdio to
4623         format long doubles (format 'e') for output.
4624
4625 sPRIEUldbl (longdblfio.U):
4626         This variable, if defined, contains the string used by stdio to
4627         format long doubles (format 'E') for output.
4628         The 'U' in the name is to separate this from sPRIeldbl so that even
4629         case-blind systems can see the difference.
4630
4631 sPRIfldbl (longdblfio.U):
4632         This variable, if defined, contains the string used by stdio to
4633         format long doubles (format 'f') for output.
4634
4635 sPRIFUldbl (longdblfio.U):
4636         This variable, if defined, contains the string used by stdio to
4637         format long doubles (format 'F') for output.
4638         The 'U' in the name is to separate this from sPRIfldbl so that even
4639         case-blind systems can see the difference.
4640
4641 sPRIgldbl (longdblfio.U):
4642         This variable, if defined, contains the string used by stdio to
4643         format long doubles (format 'g') for output.
4644
4645 sPRIGUldbl (longdblfio.U):
4646         This variable, if defined, contains the string used by stdio to
4647         format long doubles (format 'G') for output.
4648         The 'U' in the name is to separate this from sPRIgldbl so that even
4649         case-blind systems can see the difference.
4650
4651 sPRIi64 (quadfio.U):
4652         This variable, if defined, contains the string used by stdio to
4653         format 64-bit decimal numbers (format 'i') for output.
4654
4655 sPRIo64 (quadfio.U):
4656         This variable, if defined, contains the string used by stdio to
4657         format 64-bit octal numbers (format 'o') for output.
4658
4659 sPRIu64 (quadfio.U):
4660         This variable, if defined, contains the string used by stdio to
4661         format 64-bit unsigned decimal numbers (format 'u') for output.
4662
4663 sPRIx64 (quadfio.U):
4664         This variable, if defined, contains the string used by stdio to
4665         format 64-bit hexadecimal numbers (format 'x') for output.
4666
4667 sPRIXU64 (quadfio.U):
4668         This variable, if defined, contains the string used by stdio to
4669         format 64-bit hExADECimAl numbers (format 'X') for output.
4670         The 'U' in the name is to separate this from sPRIx64 so that even
4671         case-blind systems can see the difference.
4672
4673 srand48_r_proto (d_srand48_r.U):
4674         This variable encodes the prototype of srand48_r.
4675         It is zero if d_srand48_r is undef, and one of the
4676         REENTRANT_PROTO_T_ABC macros of reentr.h if d_srand48_r
4677         is defined.
4678
4679 srandom_r_proto (d_srandom_r.U):
4680         This variable encodes the prototype of srandom_r.
4681         It is zero if d_srandom_r is undef, and one of the
4682         REENTRANT_PROTO_T_ABC macros of reentr.h if d_srandom_r
4683         is defined.
4684
4685 src (src.U):
4686         This variable holds the (possibly relative) path of the package source.
4687         It is up to the Makefile to use this variable and set VPATH accordingly
4688         to find the sources remotely.  Use $pkgsrc to have an absolute path.
4689
4690 sSCNfldbl (longdblfio.U):
4691         This variable, if defined, contains the string used by stdio to
4692         format long doubles (format 'f') for input.
4693
4694 ssizetype (ssizetype.U):
4695         This variable defines ssizetype to be something like ssize_t,
4696         long or int.  It is used by functions that return a count
4697         of bytes or an error condition.  It must be a signed type.
4698         We will pick a type such that sizeof(SSize_t) == sizeof(Size_t).
4699
4700 startperl (startperl.U):
4701         This variable contains the string to put on the front of a perl
4702         script to make sure (hopefully) that it runs with perl and not some
4703         shell. Of course, that leading line must be followed by the classical
4704         perl idiom:
4705         eval 'exec perl -S $0 ${1+"$@"}'
4706         if $running_under_some_shell;
4707         to guarantee perl startup should the shell execute the script. Note
4708         that this magic incatation is not understood by csh.
4709
4710 startsh (startsh.U):
4711         This variable contains the string to put on the front of a shell
4712         script to make sure (hopefully) that it runs with sh and not some
4713         other shell.
4714
4715 static_ext (Extensions.U):
4716         This variable holds a list of XS extension files we want to
4717         link statically into the package.  It is used by Makefile.
4718
4719 stdchar (stdchar.U):
4720         This variable conditionally defines STDCHAR to be the type of char
4721         used in stdio.h.  It has the values "unsigned char" or "char".
4722
4723 stdio_base (d_stdstdio.U):
4724         This variable defines how, given a FILE pointer, fp, to access the
4725         _base field (or equivalent) of stdio.h's FILE structure.  This will
4726         be used to define the macro FILE_base(fp).
4727
4728 stdio_bufsiz (d_stdstdio.U):
4729         This variable defines how, given a FILE pointer, fp, to determine
4730         the number of bytes store in the I/O buffer pointer to by the
4731         _base field (or equivalent) of stdio.h's FILE structure.  This will
4732         be used to define the macro FILE_bufsiz(fp).
4733
4734 stdio_cnt (d_stdstdio.U):
4735         This variable defines how, given a FILE pointer, fp, to access the
4736         _cnt field (or equivalent) of stdio.h's FILE structure.  This will
4737         be used to define the macro FILE_cnt(fp).
4738
4739 stdio_filbuf (d_stdstdio.U):
4740         This variable defines how, given a FILE pointer, fp, to tell
4741         stdio to refill its internal buffers (?).  This will
4742         be used to define the macro FILE_filbuf(fp).
4743
4744 stdio_ptr (d_stdstdio.U):
4745         This variable defines how, given a FILE pointer, fp, to access the
4746         _ptr field (or equivalent) of stdio.h's FILE structure.  This will
4747         be used to define the macro FILE_ptr(fp).
4748
4749 stdio_stream_array (stdio_streams.U):
4750         This variable tells the name of the array holding the stdio streams.
4751         Usual values include _iob, __iob, and __sF.
4752
4753 strerror_r_proto (d_strerror_r.U):
4754         This variable encodes the prototype of strerror_r.
4755         It is zero if d_strerror_r is undef, and one of the
4756         REENTRANT_PROTO_T_ABC macros of reentr.h if d_strerror_r
4757         is defined.
4758
4759 strings (i_string.U):
4760         This variable holds the full path of the string header that will be
4761         used. Typically /usr/include/string.h or /usr/include/strings.h.
4762
4763 submit (Loc.U):
4764         This variable is defined but not used by Configure.
4765         The value is the empty string and is not useful.
4766
4767 subversion (patchlevel.U):
4768         The subversion level of this package.
4769         The value of subversion comes from the patchlevel.h file.
4770         In a version number such as 5.6.1, this is the "1".
4771         In patchlevel.h, this is referred to as "PERL_SUBVERSION".
4772         This is unique to perl.
4773
4774 sysman (sysman.U):
4775         This variable holds the place where the manual is located on this
4776         system. It is not the place where the user wants to put his manual
4777         pages. Rather it is the place where Configure may look to find manual
4778         for unix commands (section 1 of the manual usually). See mansrc.
4779
4780 tail (Loc.U):
4781         This variable is defined but not used by Configure.
4782         The value is the empty string and is not useful.
4783
4784 tar (Loc.U):
4785         This variable is defined but not used by Configure.
4786         The value is the empty string and is not useful.
4787
4788 targetarch (Cross.U):
4789         If cross-compiling, this variable contains the target architecture.
4790         If not, this will be empty.
4791
4792 tbl (Loc.U):
4793         This variable is defined but not used by Configure.
4794         The value is the empty string and is not useful.
4795
4796 tee (Loc.U):
4797         This variable is defined but not used by Configure.
4798         The value is the empty string and is not useful.
4799
4800 test (Loc.U):
4801         This variable is used internally by Configure to determine the
4802         full pathname (if any) of the test program.  After Configure runs,
4803         the value is reset to a plain "test" and is not useful.
4804
4805 timeincl (i_time.U):
4806         This variable holds the full path of the included time header(s).
4807
4808 timetype (d_time.U):
4809         This variable holds the type returned by time(). It can be long,
4810         or time_t on BSD sites (in which case <sys/types.h> should be
4811         included). Anyway, the type Time_t should be used.
4812
4813 tmpnam_r_proto (d_tmpnam_r.U):
4814         This variable encodes the prototype of tmpnam_r.
4815         It is zero if d_tmpnam_r is undef, and one of the
4816         REENTRANT_PROTO_T_ABC macros of reentr.h if d_tmpnam_r
4817         is defined.
4818
4819 to (Cross.U):
4820         This variable contains the command used by Configure
4821         to copy to from the target host.  Useful and available
4822         only during Perl build.
4823         The string ':' if not cross-compiling.
4824
4825 touch (Loc.U):
4826         This variable is used internally by Configure to determine the
4827         full pathname (if any) of the touch program.  After Configure runs,
4828         the value is reset to a plain "touch" and is not useful.
4829
4830 tr (Loc.U):
4831         This variable is used internally by Configure to determine the
4832         full pathname (if any) of the tr program.  After Configure runs,
4833         the value is reset to a plain "tr" and is not useful.
4834
4835 trnl (trnl.U):
4836         This variable contains the value to be passed to the tr(1)
4837         command to transliterate a newline.  Typical values are
4838         '\012' and '\n'.  This is needed for EBCDIC systems where
4839         newline is not necessarily '\012'.
4840
4841 troff (Loc.U):
4842         This variable is defined but not used by Configure.
4843         The value is the empty string and is not useful.
4844
4845 ttyname_r_proto (d_ttyname_r.U):
4846         This variable encodes the prototype of ttyname_r.
4847         It is zero if d_ttyname_r is undef, and one of the
4848         REENTRANT_PROTO_T_ABC macros of reentr.h if d_ttyname_r
4849         is defined.
4850
4851 u16size (perlxv.U):
4852         This variable is the size of an U16 in bytes.
4853
4854 u16type (perlxv.U):
4855         This variable contains the C type used for Perl's U16.
4856
4857 u32size (perlxv.U):
4858         This variable is the size of an U32 in bytes.
4859
4860 u32type (perlxv.U):
4861         This variable contains the C type used for Perl's U32.
4862
4863 u64size (perlxv.U):
4864         This variable is the size of an U64 in bytes.
4865
4866 u64type (perlxv.U):
4867         This variable contains the C type used for Perl's U64.
4868
4869 u8size (perlxv.U):
4870         This variable is the size of an U8 in bytes.
4871
4872 u8type (perlxv.U):
4873         This variable contains the C type used for Perl's U8.
4874
4875 uidformat (uidf.U):
4876         This variable contains the format string used for printing a Uid_t.
4877
4878 uidsign (uidsign.U):
4879         This variable contains the signedness of a uidtype.
4880         1 for unsigned, -1 for signed.
4881
4882 uidsize (uidsize.U):
4883         This variable contains the size of a uidtype in bytes.
4884
4885 uidtype (uidtype.U):
4886         This variable defines Uid_t to be something like uid_t, int,
4887         ushort, or whatever type is used to declare user ids in the kernel.
4888
4889 uname (Loc.U):
4890         This variable is used internally by Configure to determine the
4891         full pathname (if any) of the uname program.  After Configure runs,
4892         the value is reset to a plain "uname" and is not useful.
4893
4894 uniq (Loc.U):
4895         This variable is used internally by Configure to determine the
4896         full pathname (if any) of the uniq program.  After Configure runs,
4897         the value is reset to a plain "uniq" and is not useful.
4898
4899 uquadtype (quadtype.U):
4900         This variable defines Uquad_t to be something like unsigned long,
4901         unsigned int, unsigned long long, uint64_t, or whatever type is
4902         used for 64-bit integers.
4903
4904 use5005threads (usethreads.U):
4905         This variable conditionally defines the USE_5005THREADS symbol,
4906         and indicates that Perl should be built to use the 5.005-based
4907         threading implementation. Only valid up to 5.8.x.
4908
4909 use64bitall (use64bits.U):
4910         This variable conditionally defines the USE_64_BIT_ALL symbol,
4911         and indicates that 64-bit integer types should be used
4912         when available.  The maximal possible
4913         64-bitness is employed: LP64 or ILP64, meaning that you will
4914         be able to use more than 2 gigabytes of memory.  This mode is
4915         even more binary incompatible than USE_64_BIT_INT. You may not
4916         be able to run the resulting executable in a 32-bit CPU at all or
4917         you may need at least to reboot your OS to 64-bit mode.
4918
4919 use64bitint (use64bits.U):
4920         This variable conditionally defines the USE_64_BIT_INT symbol,
4921         and indicates that 64-bit integer types should be used
4922         when available.  The minimal possible 64-bitness
4923         is employed, just enough to get 64-bit integers into Perl.
4924         This may mean using for example "long longs", while your memory
4925         may still be limited to 2 gigabytes.
4926
4927 usecrosscompile (Cross.U):
4928         This variable conditionally defines the USE_CROSS_COMPILE symbol,
4929         and indicates that Perl has been cross-compiled.
4930
4931 usedevel (Devel.U):
4932         This variable indicates that Perl was configured with development
4933         features enabled.  This should not be done for production builds.
4934
4935 usedl (dlsrc.U):
4936         This variable indicates if the system supports dynamic
4937         loading of some sort.  See also dlsrc and dlobj.
4938
4939 usedtrace (usedtrace.U):
4940         This variable indicates whether we are compiling with dtrace
4941         support. See also dtrace.
4942
4943 usefaststdio (usefaststdio.U):
4944         This variable conditionally defines the USE_FAST_STDIO symbol,
4945         and indicates that Perl should be built to use 'fast stdio'.
4946         Defaults to define in Perls 5.8 and earlier, to undef later.
4947
4948 useithreads (usethreads.U):
4949         This variable conditionally defines the USE_ITHREADS symbol,
4950         and indicates that Perl should be built to use the interpreter-based
4951         threading implementation.
4952
4953 uselargefiles (uselfs.U):
4954         This variable conditionally defines the USE_LARGE_FILES symbol,
4955         and indicates that large file interfaces should be used when
4956         available.
4957
4958 uselongdouble (uselongdbl.U):
4959         This variable conditionally defines the USE_LONG_DOUBLE symbol,
4960         and indicates that long doubles should be used when available.
4961
4962 usemallocwrap (mallocsrc.U):
4963         This variable contains y if we are wrapping malloc to prevent
4964         integer overflow during size calculations.
4965
4966 usemorebits (usemorebits.U):
4967         This variable conditionally defines the USE_MORE_BITS symbol,
4968         and indicates that explicit 64-bit interfaces and long doubles
4969         should be used when available.
4970
4971 usemultiplicity (usemultiplicity.U):
4972         This variable conditionally defines the MULTIPLICITY symbol,
4973         and indicates that Perl should be built to use multiplicity.
4974
4975 usemymalloc (mallocsrc.U):
4976         This variable contains y if the malloc that comes with this package
4977         is desired over the system's version of malloc.  People often include
4978         special versions of malloc for effiency, but such versions are often
4979         less portable.  See also mallocsrc and mallocobj.
4980         If this is 'y', then -lmalloc is removed from $libs.
4981
4982 usenm (usenm.U):
4983         This variable contains 'true' or 'false' depending whether the
4984         nm extraction is wanted or not.
4985
4986 useopcode (Extensions.U):
4987         This variable holds either 'true' or 'false' to indicate
4988         whether the Opcode extension should be used.  The sole
4989         use for this currently is to allow an easy mechanism
4990         for users to skip the Opcode extension from the Configure
4991         command line.
4992
4993 useperlio (useperlio.U):
4994         This variable conditionally defines the USE_PERLIO symbol,
4995         and indicates that the PerlIO abstraction should be
4996         used throughout.
4997
4998 useposix (Extensions.U):
4999         This variable holds either 'true' or 'false' to indicate
5000         whether the POSIX extension should be used.  The sole
5001         use for this currently is to allow an easy mechanism
5002         for hints files to indicate that POSIX will not compile
5003         on a particular system.
5004
5005 usereentrant (usethreads.U):
5006         This variable conditionally defines the USE_REENTRANT_API symbol,
5007         which indicates that the thread code may try to use the various
5008         _r versions of library functions.  This is only potentially
5009         meaningful if usethreads is set and is very experimental, it is
5010         not even prompted for.
5011
5012 userelocatableinc (bin.U):
5013         This variable is set to true to indicate that perl should relocate
5014         @INC entries at runtime based on the path to the perl binary.
5015         Any @INC paths starting ".../" are relocated relative to the directory
5016         containing the perl binary, and a logical cleanup of the path is then
5017         made around the join point (removing "dir/../" pairs)
5018
5019 usesfio (d_sfio.U):
5020         This variable is set to true when the user agrees to use sfio.
5021         It is set to false when sfio is not available or when the user
5022         explicitely requests not to use sfio.  It is here primarily so
5023         that command-line settings can override the auto-detection of
5024         d_sfio without running into a "WHOA THERE".
5025
5026 useshrplib (libperl.U):
5027         This variable is set to 'true' if the user wishes
5028         to build a shared libperl, and 'false' otherwise.
5029
5030 usesitecustomize (d_sitecustomize.U):
5031         This variable is set to true when the user requires a mechanism that
5032         allows the sysadmin to add entries to @INC at runtime.  This variable
5033         being set, makes perl run '$sitelib/sitecustomize.pl' at startup.
5034
5035 usesocks (usesocks.U):
5036         This variable conditionally defines the USE_SOCKS symbol,
5037         and indicates that Perl should be built to use SOCKS.
5038
5039 usethreads (usethreads.U):
5040         This variable conditionally defines the USE_THREADS symbol,
5041         and indicates that Perl should be built to use threads.
5042
5043 usevendorprefix (vendorprefix.U):
5044         This variable tells whether the vendorprefix
5045         and consequently other vendor* paths are in use.
5046
5047 usevfork (d_vfork.U):
5048         This variable is set to true when the user accepts to use vfork.
5049         It is set to false when no vfork is available or when the user
5050         explicitely requests not to use vfork.
5051
5052 usrinc (usrinc.U):
5053         This variable holds the path of the include files, which is
5054         usually /usr/include. It is mainly used by other Configure units.
5055
5056 uuname (Loc.U):
5057         This variable is defined but not used by Configure.
5058         The value is the empty string and is not useful.
5059
5060 uvoformat (perlxvf.U):
5061         This variable contains the format string used for printing
5062         a Perl UV as an unsigned octal integer.
5063
5064 uvsize (perlxv.U):
5065         This variable is the size of a UV in bytes.
5066
5067 uvtype (perlxv.U):
5068         This variable contains the C type used for Perl's UV.
5069
5070 uvuformat (perlxvf.U):
5071         This variable contains the format string used for printing
5072         a Perl UV as an unsigned decimal integer.
5073
5074 uvxformat (perlxvf.U):
5075         This variable contains the format string used for printing
5076         a Perl UV as an unsigned hexadecimal integer in lowercase abcdef.
5077
5078 uvXUformat (perlxvf.U):
5079         This variable contains the format string used for printing
5080         a Perl UV as an unsigned hexadecimal integer in uppercase ABCDEF.
5081
5082 vendorarch (vendorarch.U):
5083         This variable contains the value of the PERL_VENDORARCH symbol.
5084         It may have a ~ on the front.
5085         The standard distribution will put nothing in this directory.
5086         Vendors who distribute perl may wish to place their own
5087         architecture-dependent modules and extensions in this directory with
5088         MakeMaker Makefile.PL INSTALLDIRS=vendor
5089         or equivalent.  See INSTALL for details.
5090
5091 vendorarchexp (vendorarch.U):
5092         This variable is the ~name expanded version of vendorarch, so that you
5093         may use it directly in Makefiles or shell scripts.
5094
5095 vendorbin (vendorbin.U):
5096         This variable contains the eventual value of the VENDORBIN symbol.
5097         It may have a ~ on the front.
5098         The standard distribution will put nothing in this directory.
5099         Vendors who distribute perl may wish to place additional
5100         binaries in this directory with
5101         MakeMaker Makefile.PL INSTALLDIRS=vendor
5102         or equivalent.  See INSTALL for details.
5103
5104 vendorbinexp (vendorbin.U):
5105         This variable is the ~name expanded version of vendorbin, so that you
5106         may use it directly in Makefiles or shell scripts.
5107
5108 vendorhtml1dir (vendorhtml1dir.U):
5109         This variable contains the name of the directory for html
5110         pages.  It may have a ~ on the front.
5111         The standard distribution will put nothing in this directory.
5112         Vendors who distribute perl may wish to place their own
5113         html pages in this directory with
5114         MakeMaker Makefile.PL INSTALLDIRS=vendor
5115         or equivalent.  See INSTALL for details.
5116
5117 vendorhtml1direxp (vendorhtml1dir.U):
5118         This variable is the ~name expanded version of vendorhtml1dir, so that you
5119         may use it directly in Makefiles or shell scripts.
5120
5121 vendorhtml3dir (vendorhtml3dir.U):
5122         This variable contains the name of the directory for html
5123         library pages.  It may have a ~ on the front.
5124         The standard distribution will put nothing in this directory.
5125         Vendors who distribute perl may wish to place their own
5126         html pages for modules and extensions in this directory with
5127         MakeMaker Makefile.PL INSTALLDIRS=vendor
5128         or equivalent.  See INSTALL for details.
5129
5130 vendorhtml3direxp (vendorhtml3dir.U):
5131         This variable is the ~name expanded version of vendorhtml3dir, so that you
5132         may use it directly in Makefiles or shell scripts.
5133
5134 vendorlib (vendorlib.U):
5135         This variable contains the eventual value of the VENDORLIB symbol,
5136         which is the name of the private library for this package.
5137         The standard distribution will put nothing in this directory.
5138         Vendors who distribute perl may wish to place their own
5139         modules in this directory with
5140         MakeMaker Makefile.PL INSTALLDIRS=vendor
5141         or equivalent.  See INSTALL for details.
5142
5143 vendorlib_stem (vendorlib.U):
5144         This variable is $vendorlibexp with any trailing version-specific component
5145         removed.  The elements in inc_version_list (inc_version_list.U) can
5146         be tacked onto this variable to generate a list of directories to search.
5147
5148 vendorlibexp (vendorlib.U):
5149         This variable is the ~name expanded version of vendorlib, so that you
5150         may use it directly in Makefiles or shell scripts.
5151
5152 vendorman1dir (vendorman1dir.U):
5153         This variable contains the name of the directory for man1
5154         pages.  It may have a ~ on the front.
5155         The standard distribution will put nothing in this directory.
5156         Vendors who distribute perl may wish to place their own
5157         man1 pages in this directory with
5158         MakeMaker Makefile.PL INSTALLDIRS=vendor
5159         or equivalent.  See INSTALL for details.
5160
5161 vendorman1direxp (vendorman1dir.U):
5162         This variable is the ~name expanded version of vendorman1dir, so that you
5163         may use it directly in Makefiles or shell scripts.
5164
5165 vendorman3dir (vendorman3dir.U):
5166         This variable contains the name of the directory for man3
5167         pages.  It may have a ~ on the front.
5168         The standard distribution will put nothing in this directory.
5169         Vendors who distribute perl may wish to place their own
5170         man3 pages in this directory with
5171         MakeMaker Makefile.PL INSTALLDIRS=vendor
5172         or equivalent.  See INSTALL for details.
5173
5174 vendorman3direxp (vendorman3dir.U):
5175         This variable is the ~name expanded version of vendorman3dir, so that you
5176         may use it directly in Makefiles or shell scripts.
5177
5178 vendorprefix (vendorprefix.U):
5179         This variable holds the full absolute path of the directory below
5180         which the vendor will install add-on packages.
5181         See INSTALL for usage and examples.
5182
5183 vendorprefixexp (vendorprefix.U):
5184         This variable holds the full absolute path of the directory below
5185         which the vendor will install add-on packages.  Derived from vendorprefix.
5186
5187 vendorscript (vendorscript.U):
5188         This variable contains the eventual value of the VENDORSCRIPT symbol.
5189         It may have a ~ on the front.
5190         The standard distribution will put nothing in this directory.
5191         Vendors who distribute perl may wish to place additional
5192         executable scripts in this directory with
5193         MakeMaker Makefile.PL INSTALLDIRS=vendor
5194         or equivalent.  See INSTALL for details.
5195
5196 vendorscriptexp (vendorscript.U):
5197         This variable is the ~name expanded version of vendorscript, so that you
5198         may use it directly in Makefiles or shell scripts.
5199
5200 version (patchlevel.U):
5201         The full version number of this package, such as 5.6.1 (or 5_6_1).
5202         This combines revision, patchlevel, and subversion to get the
5203         full version number, including any possible subversions.
5204         This is suitable for use as a directory name, and hence is
5205         filesystem dependent.
5206
5207 version_patchlevel_string (patchlevel.U):
5208         This is a string combining version, subversion and
5209         perl_patchlevel (if perl_patchlevel is non-zero).
5210         It is typically something like
5211         'version 7 subversion 1'  or
5212         'version 7 subversion 1 patchlevel 11224'
5213         It is computed here to avoid duplication of code in myconfig.SH
5214         and lib/Config.pm.
5215
5216 versiononly (versiononly.U):
5217         If set, this symbol indicates that only the version-specific
5218         components of a perl installation should be installed.
5219         This may be useful for making a test installation of a new
5220         version without disturbing the existing installation.
5221         Setting versiononly is equivalent to setting installperl's -v option.
5222         In particular, the non-versioned scripts and programs such as
5223         a2p, c2ph, h2xs, pod2*, and perldoc are not installed
5224         (see INSTALL for a more complete list).  Nor are the man
5225         pages installed.
5226         Usually, this is undef.
5227
5228 vi (Loc.U):
5229         This variable is defined but not used by Configure.
5230         The value is the empty string and is not useful.
5231
5232 voidflags (voidflags.U):
5233         This variable contains the eventual value of the VOIDFLAGS symbol,
5234         which indicates how much support of the void type is given by this
5235         compiler.  See VOIDFLAGS for more info.
5236
5237 xlibpth (libpth.U):
5238         This variable holds extra path (space-separated) used to find
5239         libraries on this platform, for example CPU-specific libraries
5240         (on multi-CPU platforms) may be listed here.
5241
5242 yacc (yacc.U):
5243         This variable holds the name of the compiler compiler we
5244         want to use in the Makefile. It can be yacc, byacc, or bison -y.
5245
5246 yaccflags (yacc.U):
5247         This variable contains any additional yacc flags desired by the
5248         user.  It is up to the Makefile to use this.
5249
5250 zcat (Loc.U):
5251         This variable is defined but not used by Configure.
5252         The value is the empty string and is not useful.
5253
5254 zip (Loc.U):
5255         This variable is used internally by Configure to determine the
5256         full pathname (if any) of the zip program.  After Configure runs,
5257         the value is reset to a plain "zip" and is not useful.
5258