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