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