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