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