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