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