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