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