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