This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
FAQ sync.
[perl5.git] / Porting / Glossary
CommitLineData
d7418ba7 1This file contains a description of all the shell variables whose value is
2determined by the Configure script. Variables intended for use in C
ebc74a4b
GS
3programs (e.g. I_UNISTD) are already described in config_h.SH. [`configpm'
4generates pod documentation for Config.pm from this file--please try to keep
5the formatting regular.]
d7418ba7 6
781b178c
JH
7_a (Unix.U):
8 This variable defines the extension used for ordinary libraries.
9 For unix, it is '.a'. The '.' is included. Other possible
10 values include '.lib'.
11
12_exe (Unix.U):
13 This variable defines the extension used for executable files.
14 For unix it is empty. Other possible values include '.exe'.
15
16_o (Unix.U):
17 This variable defines the extension used for object files.
18 For unix, it is '.o'. The '.' is included. Other possible
19 values include '.obj'.
20
21afs (afs.U):
22 This variable is set to 'true' if AFS (Andrew File System) is used
23 on the system, 'false' otherwise. It is possible to override this
24 with a hint value or command line option, but you'd better know
25 what you are doing.
26
a6d26a0d
JH
27afsroot (afs.U):
28 This variable is by default set to '/afs'. In the unlikely case
29 this is not the correct root, it is possible to override this with
30 a hint value or command line option. This will be used in subsequent
31 tests for AFSness in the Perl configure and test process.
32
781b178c
JH
33alignbytes (alignbytes.U):
34 This variable holds the number of bytes required to align a
87b71857
JH
35 double-- or a long double when applicable. Usual values are
36 2, 4 and 8. The default is eight, for safety.
781b178c
JH
37
38ansi2knr (ansi2knr.U):
39 This variable is set if the user needs to run ansi2knr.
40 Currently, this is not supported, so we just abort.
41
42aphostname (d_gethname.U):
43 This variable contains the command which can be used to compute the
44 host name. The command is fully qualified by its absolute path, to make
45 it safe when used by a process with super-user privileges.
46
ff935051
JH
47api_revision (patchlevel.U):
48 The three variables, api_revision, api_version, and
49 api_subversion, specify the version of the oldest perl binary
50 compatible with the present perl. In a full version string
51 such as '5.6.1', api_revision is the '5'.
52 Prior to 5.5.640, the format was a floating point number,
53 like 5.00563.
54 perl.c:incpush() and lib/lib.pm will automatically search in
55 $sitelib/.. for older directories back to the limit specified
56 by these api_ variables. This is only useful if you have a
57 perl library directory tree structured like the default one.
58 See INSTALL for how this works. The versioned site_perl
59 directory was introduced in 5.005, so that is the lowest
60 possible value. The version list appropriate for the current
61 system is determined in inc_version_list.U.
62 XXX To do: Since compatibility can depend on compile time
63 options (such as bincompat, longlong, etc.) it should
64 (perhaps) be set by Configure, but currently it isn't.
65 Currently, we read a hard-wired value from patchlevel.h.
66 Perhaps what we ought to do is take the hard-wired value from
67 patchlevel.h but then modify it if the current Configure
68 options warrant. patchlevel.h then would use an #ifdef guard.
69
70api_subversion (patchlevel.U):
71 The three variables, api_revision, api_version, and
72 api_subversion, specify the version of the oldest perl binary
73 compatible with the present perl. In a full version string
74 such as '5.6.1', api_subversion is the '1'. See api_revision for
75 full details.
76
77api_version (patchlevel.U):
78 The three variables, api_revision, api_version, and
79 api_subversion, specify the version of the oldest perl binary
80 compatible with the present perl. In a full version string
81 such as '5.6.1', api_version is the '6'. See api_revision for
82 full details. As a special case, 5.5.0 is rendered in the
83 old-style as 5.005. (In the 5.005_0x maintenance series,
84 this was the only versioned directory in $sitelib.)
85
86api_versionstring (patchlevel.U):
87 This variable combines api_revision, api_version, and
88 api_subversion in a format such as 5.6.1 (or 5_6_1) suitable
89 for use as a directory name. This is filesystem dependent.
781b178c
JH
90
91ar (Loc.U):
5bf26616 92 This variable is used internally by Configure to determine the
781b178c
JH
93 full pathname (if any) of the ar program. After Configure runs,
94 the value is reset to a plain "ar" and is not useful.
95
96archlib (archlib.U):
97 This variable holds the name of the directory in which the user wants
98 to put architecture-dependent public library files for $package.
99 It is most often a local directory such as /usr/local/lib.
100 Programs using this variable must be prepared to deal
101 with filename expansion.
102
103archlibexp (archlib.U):
104 This variable is the same as the archlib variable, but is
105 filename expanded at configuration time, for convenient use.
106
107archname64 (use64bits.U):
108 This variable is used for the 64-bitness part of $archname.
109
110archname (archname.U):
111 This variable is a short name to characterize the current
112 architecture. It is used mainly to construct the default archlib.
113
114archobjs (Unix.U):
115 This variable defines any additional objects that must be linked
116 in with the program on this architecture. On unix, it is usually
117 empty. It is typically used to include emulations of unix calls
118 or other facilities. For perl on OS/2, for example, this would
119 include os2/os2.obj.
120
121awk (Loc.U):
5bf26616 122 This variable is used internally by Configure to determine the
781b178c
JH
123 full pathname (if any) of the awk program. After Configure runs,
124 the value is reset to a plain "awk" and is not useful.
125
126baserev (baserev.U):
127 The base revision level of this package, from the .package file.
128
129bash (Loc.U):
130 This variable is defined but not used by Configure.
131 The value is a plain '' and is not useful.
132
133bin (bin.U):
134 This variable holds the name of the directory in which the user wants
135 to put publicly executable images for the package in question. It
136 is most often a local directory such as /usr/local/bin. Programs using
137 this variable must be prepared to deal with ~name substitution.
138
d71b2b6b 139bincompat5005 (bincompat5005.U):
f78bfc9c
JH
140 This variable contains y if this version of Perl should be
141 binary-compatible with Perl 5.005.
d71b2b6b 142
781b178c
JH
143binexp (bin.U):
144 This is the same as the bin variable, but is filename expanded at
145 configuration time, for use in your makefiles.
146
147bison (Loc.U):
2d967e39
JH
148 This variable is used internally by Configure to determine the
149 full pathname (if any) of the bison program. After Configure runs,
150 the value is reset to a plain "bison" and is not useful.
781b178c
JH
151
152byacc (Loc.U):
5bf26616 153 This variable is used internally by Configure to determine the
781b178c
JH
154 full pathname (if any) of the byacc program. After Configure runs,
155 the value is reset to a plain "byacc" and is not useful.
156
157byteorder (byteorder.U):
158 This variable holds the byte order. In the following, larger digits
159 indicate more significance. The variable byteorder is either 4321
160 on a big-endian machine, or 1234 on a little-endian, or 87654321
161 on a Cray ... or 3412 with weird order !
162
163c (n.U):
164 This variable contains the \c string if that is what causes the echo
165 command to suppress newline. Otherwise it is null. Correct usage is
166 $echo $n "prompt for a question: $c".
167
168castflags (d_castneg.U):
169 This variable contains a flag that precise difficulties the
170 compiler has casting odd floating values to unsigned long:
171 0 = ok
172 1 = couldn't cast < 0
173 2 = couldn't cast >= 0x80000000
174 4 = couldn't cast in argument expression list
175
176cat (Loc.U):
5bf26616 177 This variable is used internally by Configure to determine the
781b178c
JH
178 full pathname (if any) of the cat program. After Configure runs,
179 the value is reset to a plain "cat" and is not useful.
180
181cc (cc.U):
182 This variable holds the name of a command to execute a C compiler which
183 can resolve multiple global references that happen to have the same
5869b1f1
JH
184 name. Usual values are 'cc' and 'gcc'.
185 Fervent ANSI compilers may be called 'c89'. AIX has xlc.
781b178c
JH
186
187cccdlflags (dlsrc.U):
188 This variable contains any special flags that might need to be
189 passed with 'cc -c' to compile modules to be used to create a shared
190 library that will be used for dynamic loading. For hpux, this
191 should be +z. It is up to the makefile to use it.
192
193ccdlflags (dlsrc.U):
194 This variable contains any special flags that might need to be
195 passed to cc to link with a shared library for dynamic loading.
196 It is up to the makefile to use it. For sunos 4.1, it should
197 be empty.
198
199ccflags (ccflags.U):
200 This variable contains any additional C compiler flags desired by
201 the user. It is up to the Makefile to use this.
202
af960fef
JH
203ccflags_uselargefiles (uselfs.U):
204 This variable contains the compiler flags needed by large file builds
205 and added to ccflags by hints files.
206
6b356c8e
JH
207ccname (Checkcc.U):
208 This can set either by hints files or by Configure. If using
209 gcc, this is gcc, and if not, usually equal to cc, unimpressive, no?
210 Some platforms, however, make good use of this by storing the
211 flavor of the C compiler being used here. For example if using
212 the Sun WorkShop suite, ccname will be 'workshop'.
213
781b178c
JH
214ccsymbols (Cppsym.U):
215 The variable contains the symbols defined by the C compiler alone.
52c7d5b6
JH
216 The symbols defined by cpp or by cc when it calls cpp are not in
217 this list, see cppsymbols and cppccsymbols.
781b178c
JH
218 The list is a space-separated list of symbol=value tokens.
219
6b356c8e
JH
220ccversion (Checkcc.U):
221 This can set either by hints files or by Configure. If using
222 a (non-gcc) vendor cc, this variable may contain a version for
223 the compiler.
224
781b178c
JH
225cf_by (cf_who.U):
226 Login name of the person who ran the Configure script and answered the
227 questions. This is used to tag both config.sh and config_h.SH.
228
229cf_email (cf_email.U):
230 Electronic mail address of the person who ran Configure. This can be
231 used by units that require the user's e-mail, like MailList.U.
232
233cf_time (cf_who.U):
234 Holds the output of the "date" command when the configuration file was
235 produced. This is used to tag both config.sh and config_h.SH.
236
a22e52b9
JH
237charsize (charsize.U):
238 This variable contains the value of the CHARSIZE symbol, which
239 indicates to the C program how many bytes there are in a character.
240
781b178c
JH
241chgrp (Loc.U):
242 This variable is defined but not used by Configure.
243 The value is a plain '' and is not useful.
244
245chmod (Loc.U):
2765b840
JH
246 This variable is used internally by Configure to determine the
247 full pathname (if any) of the chmod program. After Configure runs,
248 the value is reset to a plain "chmod" and is not useful.
781b178c
JH
249
250chown (Loc.U):
251 This variable is defined but not used by Configure.
252 The value is a plain '' and is not useful.
253
254clocktype (d_times.U):
255 This variable holds the type returned by times(). It can be long,
256 or clock_t on BSD sites (in which case <sys/types.h> should be
257 included).
258
259comm (Loc.U):
5bf26616 260 This variable is used internally by Configure to determine the
781b178c
JH
261 full pathname (if any) of the comm program. After Configure runs,
262 the value is reset to a plain "comm" and is not useful.
263
264compress (Loc.U):
265 This variable is defined but not used by Configure.
266 The value is a plain '' and is not useful.
267
268contains (contains.U):
269 This variable holds the command to do a grep with a proper return
270 status. On most sane systems it is simply "grep". On insane systems
271 it is a grep followed by a cat followed by a test. This variable
272 is primarily for the use of other Configure units.
273
274cp (Loc.U):
5bf26616 275 This variable is used internally by Configure to determine the
781b178c
JH
276 full pathname (if any) of the cp program. After Configure runs,
277 the value is reset to a plain "cp" and is not useful.
278
279cpio (Loc.U):
280 This variable is defined but not used by Configure.
281 The value is a plain '' and is not useful.
282
283cpp (Loc.U):
5bf26616 284 This variable is used internally by Configure to determine the
781b178c
JH
285 full pathname (if any) of the cpp program. After Configure runs,
286 the value is reset to a plain "cpp" and is not useful.
287
288cpp_stuff (cpp_stuff.U):
289 This variable contains an identification of the catenation mechanism
290 used by the C preprocessor.
291
292cppccsymbols (Cppsym.U):
52c7d5b6
JH
293 The variable contains the symbols defined by the C compiler
294 when it calls cpp. The symbols defined by the cc alone or cpp
295 alone are not in this list, see ccsymbols and cppsymbols.
781b178c
JH
296 The list is a space-separated list of symbol=value tokens.
297
298cppflags (ccflags.U):
299 This variable holds the flags that will be passed to the C pre-
300 processor. It is up to the Makefile to use it.
301
302cpplast (cppstdin.U):
303 This variable has the same functionality as cppminus, only it applies
304 to cpprun and not cppstdin.
305
306cppminus (cppstdin.U):
307 This variable contains the second part of the string which will invoke
308 the C preprocessor on the standard input and produce to standard
309 output. This variable will have the value "-" if cppstdin needs
310 a minus to specify standard input, otherwise the value is "".
311
312cpprun (cppstdin.U):
313 This variable contains the command which will invoke a C preprocessor
314 on standard input and put the output to stdout. It is guaranteed not
315 to be a wrapper and may be a null string if no preprocessor can be
316 made directly available. This preprocessor might be different from the
317 one used by the C compiler. Don't forget to append cpplast after the
318 preprocessor options.
319
320cppstdin (cppstdin.U):
321 This variable contains the command which will invoke the C
322 preprocessor on standard input and put the output to stdout.
323 It is primarily used by other Configure units that ask about
324 preprocessor symbols.
325
326cppsymbols (Cppsym.U):
52c7d5b6
JH
327 The variable contains the symbols defined by the C preprocessor
328 alone. The symbols defined by cc or by cc when it calls cpp are
329 not in this list, see ccsymbols and cppccsymbols.
781b178c
JH
330 The list is a space-separated list of symbol=value tokens.
331
781b178c
JH
332cryptlib (d_crypt.U):
333 This variable holds -lcrypt or the path to a libcrypt.a archive if
334 the crypt() function is not defined in the standard C library. It is
335 up to the Makefile to use this.
336
337csh (Loc.U):
5bf26616 338 This variable is used internally by Configure to determine the
781b178c
JH
339 full pathname (if any) of the csh program. After Configure runs,
340 the value is reset to a plain "csh" and is not useful.
341
74cac757
JH
342d__fwalk (d__fwalk.U):
343 This variable conditionally defines HAS__FWALK if _fwalk() is
344 available to apply a function to all the file handles.
345
781b178c
JH
346d_access (d_access.U):
347 This variable conditionally defines HAS_ACCESS if the access() system
348 call is available to check for access permissions using real IDs.
349
350d_accessx (d_accessx.U):
351 This variable conditionally defines the HAS_ACCESSX symbol, which
352 indicates to the C program that the accessx() routine is available.
353
354d_alarm (d_alarm.U):
355 This variable conditionally defines the HAS_ALARM symbol, which
356 indicates to the C program that the alarm() routine is available.
357
358d_archlib (archlib.U):
359 This variable conditionally defines ARCHLIB to hold the pathname
360 of architecture-dependent library files for $package. If
361 $archlib is the same as $privlib, then this is set to undef.
362
11dc3f68
JH
363d_atolf (atolf.U):
364 This variable conditionally defines the HAS_ATOLF symbol, which
365 indicates to the C program that the atolf() routine is available.
366
367d_atoll (atoll.U):
368 This variable conditionally defines the HAS_ATOLL symbol, which
369 indicates to the C program that the atoll() routine is available.
370
781b178c
JH
371d_attribut (d_attribut.U):
372 This variable conditionally defines HASATTRIBUTE, which
373 indicates the C compiler can check for function attributes,
374 such as printf formats.
375
376d_bcmp (d_bcmp.U):
377 This variable conditionally defines the HAS_BCMP symbol if
378 the bcmp() routine is available to compare strings.
379
380d_bcopy (d_bcopy.U):
381 This variable conditionally defines the HAS_BCOPY symbol if
382 the bcopy() routine is available to copy strings.
383
d71b2b6b
JH
384d_bincompat5005 (bincompat5005.U):
385 This variable conditionally defines BINCOMPAT5005 so that embed.h
f78bfc9c
JH
386 can take special action if this version of Perl should be
387 binary-compatible with Perl 5.005. This is impossible for builds
388 that use features like threads and multiplicity it is always $undef
389 for those versions.
d71b2b6b 390
781b178c
JH
391d_bsd (Guess.U):
392 This symbol conditionally defines the symbol BSD when running on a
393 BSD system.
394
395d_bsdgetpgrp (d_getpgrp.U):
396 This variable conditionally defines USE_BSD_GETPGRP if
397 getpgrp needs one arguments whereas USG one needs none.
398
399d_bsdsetpgrp (d_setpgrp.U):
400 This variable conditionally defines USE_BSD_SETPGRP if
401 setpgrp needs two arguments whereas USG one needs none.
402 See also d_setpgid for a POSIX interface.
403
404d_bzero (d_bzero.U):
405 This variable conditionally defines the HAS_BZERO symbol if
406 the bzero() routine is available to set memory to 0.
407
408d_casti32 (d_casti32.U):
409 This variable conditionally defines CASTI32, which indicates
410 whether the C compiler can cast large floats to 32-bit ints.
411
412d_castneg (d_castneg.U):
413 This variable conditionally defines CASTNEG, which indicates
414 wether the C compiler can cast negative float to unsigned.
415
416d_charvspr (d_vprintf.U):
417 This variable conditionally defines CHARVSPRINTF if this system
418 has vsprintf returning type (char*). The trend seems to be to
419 declare it as "int vsprintf()".
420
421d_chown (d_chown.U):
422 This variable conditionally defines the HAS_CHOWN symbol, which
423 indicates to the C program that the chown() routine is available.
424
425d_chroot (d_chroot.U):
426 This variable conditionally defines the HAS_CHROOT symbol, which
427 indicates to the C program that the chroot() routine is available.
428
429d_chsize (d_chsize.U):
430 This variable conditionally defines the CHSIZE symbol, which
431 indicates to the C program that the chsize() routine is available
432 to truncate files. You might need a -lx to get this routine.
433
758a5d79
JH
434d_class (d_class.U):
435 This variable conditionally defines the HAS_CLASS symbol, which
436 indicates to the C program that the class() routine is available.
437
781b178c
JH
438d_closedir (d_closedir.U):
439 This variable conditionally defines HAS_CLOSEDIR if closedir() is
440 available.
441
4e0554ec
JH
442d_cmsghdr_s (d_cmsghdr_s.U):
443 This variable conditionally defines the HAS_STRUCT_CMSGHDR symbol,
444 which indicates that the struct cmsghdr is supported.
445
781b178c
JH
446d_const (d_const.U):
447 This variable conditionally defines the HASCONST symbol, which
448 indicates to the C program that this C compiler knows about the
449 const type.
450
451d_crypt (d_crypt.U):
452 This variable conditionally defines the CRYPT symbol, which
453 indicates to the C program that the crypt() routine is available
454 to encrypt passwords and the like.
455
456d_csh (d_csh.U):
457 This variable conditionally defines the CSH symbol, which
458 indicates to the C program that the C-shell exists.
459
460d_cuserid (d_cuserid.U):
461 This variable conditionally defines the HAS_CUSERID symbol, which
462 indicates to the C program that the cuserid() routine is available
463 to get character login names.
464
465d_dbl_dig (d_dbl_dig.U):
466 This variable conditionally defines d_dbl_dig if this system's
467 header files provide DBL_DIG, which is the number of significant
468 digits in a double precision number.
469
5af95cda
JH
470d_dbminitproto (d_dbminitproto.U):
471 This variable conditionally defines the HAS_DBMINIT_PROTO symbol,
472 which indicates to the C program that the system provides
473 a prototype for the dbminit() function. Otherwise, it is
474 up to the program to supply one.
475
781b178c
JH
476d_difftime (d_difftime.U):
477 This variable conditionally defines the HAS_DIFFTIME symbol, which
478 indicates to the C program that the difftime() routine is available.
479
428dc699
JH
480d_dirfd (d_dirfd.U):
481 This variable conditionally defines the HAS_DIRFD constant,
482 which indicates to the C program that dirfd() is available
483 to return the file descriptor of a directory stream.
484
781b178c
JH
485d_dirnamlen (i_dirent.U):
486 This variable conditionally defines DIRNAMLEN, which indicates
487 to the C program that the length of directory entry names is
488 provided by a d_namelen field.
489
490d_dlerror (d_dlerror.U):
491 This variable conditionally defines the HAS_DLERROR symbol, which
492 indicates to the C program that the dlerror() routine is available.
493
494d_dlopen (d_dlopen.U):
495 This variable conditionally defines the HAS_DLOPEN symbol, which
496 indicates to the C program that the dlopen() routine is available.
497
498d_dlsymun (d_dlsymun.U):
499 This variable conditionally defines DLSYM_NEEDS_UNDERSCORE, which
500 indicates that we need to prepend an underscore to the symbol
501 name before calling dlsym().
502
503d_dosuid (d_dosuid.U):
504 This variable conditionally defines the symbol DOSUID, which
505 tells the C program that it should insert setuid emulation code
506 on hosts which have setuid #! scripts disabled.
507
508d_drand48proto (d_drand48proto.U):
509 This variable conditionally defines the HAS_DRAND48_PROTO symbol,
510 which indicates to the C program that the system provides
511 a prototype for the drand48() function. Otherwise, it is
512 up to the program to supply one.
513
514d_dup2 (d_dup2.U):
515 This variable conditionally defines HAS_DUP2 if dup2() is
516 available to duplicate file descriptors.
517
518d_eaccess (d_eaccess.U):
519 This variable conditionally defines the HAS_EACCESS symbol, which
520 indicates to the C program that the eaccess() routine is available.
521
522d_endgrent (d_endgrent.U):
523 This variable conditionally defines the HAS_ENDGRENT symbol, which
524 indicates to the C program that the endgrent() routine is available
525 for sequential access of the group database.
526
527d_endhent (d_endhent.U):
528 This variable conditionally defines HAS_ENDHOSTENT if endhostent() is
529 available to close whatever was being used for host queries.
530
531d_endnent (d_endnent.U):
532 This variable conditionally defines HAS_ENDNETENT if endnetent() is
533 available to close whatever was being used for network queries.
534
535d_endpent (d_endpent.U):
536 This variable conditionally defines HAS_ENDPROTOENT if endprotoent() is
537 available to close whatever was being used for protocol queries.
538
539d_endpwent (d_endpwent.U):
540 This variable conditionally defines the HAS_ENDPWENT symbol, which
541 indicates to the C program that the endpwent() routine is available
542 for sequential access of the passwd database.
543
544d_endsent (d_endsent.U):
545 This variable conditionally defines HAS_ENDSERVENT if endservent() is
546 available to close whatever was being used for service queries.
547
781b178c
JH
548d_eofnblk (nblock_io.U):
549 This variable conditionally defines EOF_NONBLOCK if EOF can be seen
550 when reading from a non-blocking I/O source.
551
552d_eunice (Guess.U):
553 This variable conditionally defines the symbols EUNICE and VAX, which
554 alerts the C program that it must deal with ideosyncracies of VMS.
555
b363b713
JH
556d_fchdir (d_fchdir.U):
557 This variable conditionally defines the HAS_FCHDIR symbol, which
558 indicates to the C program that the fchdir() routine is available.
559
781b178c
JH
560d_fchmod (d_fchmod.U):
561 This variable conditionally defines the HAS_FCHMOD symbol, which
562 indicates to the C program that the fchmod() routine is available
563 to change mode of opened files.
564
565d_fchown (d_fchown.U):
566 This variable conditionally defines the HAS_FCHOWN symbol, which
567 indicates to the C program that the fchown() routine is available
568 to change ownership of opened files.
569
570d_fcntl (d_fcntl.U):
571 This variable conditionally defines the HAS_FCNTL symbol, and indicates
572 whether the fcntl() function exists
573
9d9004a9
AD
574d_fcntl_can_lock (d_fcntl_can_lock.U):
575 This variable conditionally defines the FCNTL_CAN_LOCK symbol
576 and indicates whether file locking with fcntl() works.
577
781b178c
JH
578d_fd_macros (d_fd_set.U):
579 This variable contains the eventual value of the HAS_FD_MACROS symbol,
580 which indicates if your C compiler knows about the macros which
581 manipulate an fd_set.
582
583d_fd_set (d_fd_set.U):
584 This variable contains the eventual value of the HAS_FD_SET symbol,
585 which indicates if your C compiler knows about the fd_set typedef.
586
587d_fds_bits (d_fd_set.U):
588 This variable contains the eventual value of the HAS_FDS_BITS symbol,
589 which indicates if your fd_set typedef contains the fds_bits member.
590 If you have an fd_set typedef, but the dweebs who installed it did
591 a half-fast job and neglected to provide the macros to manipulate
592 an fd_set, HAS_FDS_BITS will let us know how to fix the gaffe.
593
781b178c
JH
594d_fgetpos (d_fgetpos.U):
595 This variable conditionally defines HAS_FGETPOS if fgetpos() is
596 available to get the file position indicator.
597
758a5d79
JH
598d_finite (d_finite.U):
599 This variable conditionally defines the HAS_FINITE symbol, which
600 indicates to the C program that the finite() routine is available.
601
602d_finitel (d_finitel.U):
603 This variable conditionally defines the HAS_FINITEL symbol, which
604 indicates to the C program that the finitel() routine is available.
605
781b178c
JH
606d_flexfnam (d_flexfnam.U):
607 This variable conditionally defines the FLEXFILENAMES symbol, which
608 indicates that the system supports filenames longer than 14 characters.
609
781b178c
JH
610d_flock (d_flock.U):
611 This variable conditionally defines HAS_FLOCK if flock() is
612 available to do file locking.
613
5af95cda
JH
614d_flockproto (d_flockproto.U):
615 This variable conditionally defines the HAS_FLOCK_PROTO symbol,
616 which indicates to the C program that the system provides
617 a prototype for the flock() function. Otherwise, it is
618 up to the program to supply one.
619
781b178c
JH
620d_fork (d_fork.U):
621 This variable conditionally defines the HAS_FORK symbol, which
622 indicates to the C program that the fork() routine is available.
623
758a5d79
JH
624d_fp_class (d_fp_class.U):
625 This variable conditionally defines the HAS_FP_CLASS symbol, which
626 indicates to the C program that the fp_class() routine is available.
627
781b178c
JH
628d_fpathconf (d_pathconf.U):
629 This variable conditionally defines the HAS_FPATHCONF symbol, which
630 indicates to the C program that the pathconf() routine is available
631 to determine file-system related limits and options associated
632 with a given open file descriptor.
633
758a5d79
JH
634d_fpclass (d_fpclass.U):
635 This variable conditionally defines the HAS_FPCLASS symbol, which
636 indicates to the C program that the fpclass() routine is available.
637
638d_fpclassify (d_fpclassify.U):
639 This variable conditionally defines the HAS_FPCLASSIFY symbol, which
640 indicates to the C program that the fpclassify() routine is available.
641
642d_fpclassl (d_fpclassl.U):
643 This variable conditionally defines the HAS_FPCLASSL symbol, which
644 indicates to the C program that the fpclassl() routine is available.
645
c890dc6c 646d_fpos64_t (d_fpos64_t.U):
ca24dfc6 647 This symbol will be defined if the C compiler supports fpos64_t.
781b178c 648
a3540c92
JH
649d_frexpl (d_frexpl.U):
650 This variable conditionally defines the HAS_FREXPL symbol, which
651 indicates to the C program that the frexpl() routine is available.
652
ad27e871 653d_fs_data_s (d_fs_data_s.U):
0545a864
JH
654 This variable conditionally defines the HAS_STRUCT_FS_DATA symbol,
655 which indicates that the struct fs_data is supported.
656
781b178c
JH
657d_fseeko (d_fseeko.U):
658 This variable conditionally defines the HAS_FSEEKO symbol, which
659 indicates to the C program that the fseeko() routine is available.
660
781b178c
JH
661d_fsetpos (d_fsetpos.U):
662 This variable conditionally defines HAS_FSETPOS if fsetpos() is
663 available to set the file position indicator.
664
0545a864 665d_fstatfs (d_fstatfs.U):
781b178c
JH
666 This variable conditionally defines the HAS_FSTATFS symbol, which
667 indicates to the C program that the fstatfs() routine is available.
668
669d_fstatvfs (d_statvfs.U):
670 This variable conditionally defines the HAS_FSTATVFS symbol, which
671 indicates to the C program that the fstatvfs() routine is available.
672
411ab01c
JH
673d_fsync (d_fsync.U):
674 This variable conditionally defines the HAS_FSYNC symbol, which
675 indicates to the C program that the fsync() routine is available.
676
781b178c
JH
677d_ftello (d_ftello.U):
678 This variable conditionally defines the HAS_FTELLO symbol, which
679 indicates to the C program that the ftello() routine is available.
680
681d_ftime (d_ftime.U):
682 This variable conditionally defines the HAS_FTIME symbol, which indicates
683 that the ftime() routine exists. The ftime() routine is basically
684 a sub-second accuracy clock.
685
ff935051
JH
686d_Gconvert (d_gconvert.U):
687 This variable holds what Gconvert is defined as to convert
688 floating point numbers into strings. It could be 'gconvert'
689 or a more complex macro emulating gconvert with gcvt() or sprintf.
690 Possible values are:
691 d_Gconvert='gconvert((x),(n),(t),(b))'
692 d_Gconvert='gcvt((x),(n),(b))'
693 d_Gconvert='sprintf((b),"%.*g",(n),(x))'
694
49dabb45
JH
695d_getcwd (d_getcwd.U):
696 This variable conditionally defines the HAS_GETCWD symbol, which
697 indicates to the C program that the getcwd() routine is available
698 to get the current working directory.
699
3813c136
JH
700d_getespwnam (d_getespwnam.U):
701 This variable conditionally defines HAS_GETESPWNAM if getespwnam() is
702 available to retrieve enchanced (shadow) password entries by name.
703
c890dc6c
JH
704d_getfsstat (d_getfsstat.U):
705 This variable conditionally defines the HAS_GETFSSTAT symbol, which
706 indicates to the C program that the getfsstat() routine is available.
707
781b178c
JH
708d_getgrent (d_getgrent.U):
709 This variable conditionally defines the HAS_GETGRENT symbol, which
710 indicates to the C program that the getgrent() routine is available
711 for sequential access of the group database.
712
713d_getgrps (d_getgrps.U):
714 This variable conditionally defines the HAS_GETGROUPS symbol, which
715 indicates to the C program that the getgroups() routine is available
716 to get the list of process groups.
717
718d_gethbyaddr (d_gethbyad.U):
719 This variable conditionally defines the HAS_GETHOSTBYADDR symbol, which
720 indicates to the C program that the gethostbyaddr() routine is available
721 to look up hosts by their IP addresses.
722
723d_gethbyname (d_gethbynm.U):
724 This variable conditionally defines the HAS_GETHOSTBYNAME symbol, which
725 indicates to the C program that the gethostbyname() routine is available
726 to look up host names in some data base or other.
727
728d_gethent (d_gethent.U):
729 This variable conditionally defines HAS_GETHOSTENT if gethostent() is
730 available to look up host names in some data base or another.
731
732d_gethname (d_gethname.U):
733 This variable conditionally defines the HAS_GETHOSTNAME symbol, which
734 indicates to the C program that the gethostname() routine may be
735 used to derive the host name.
736
737d_gethostprotos (d_gethostprotos.U):
738 This variable conditionally defines the HAS_GETHOST_PROTOS symbol,
739 which indicates to the C program that <netdb.h> supplies
740 prototypes for the various gethost*() functions.
741 See also netdbtype.U for probing for various netdb types.
742
4e0554ec
JH
743d_getitimer (d_getitimer.U):
744 This variable conditionally defines the HAS_GETITIMER symbol, which
745 indicates to the C program that the getitimer() routine is available.
746
781b178c
JH
747d_getlogin (d_getlogin.U):
748 This variable conditionally defines the HAS_GETLOGIN symbol, which
749 indicates to the C program that the getlogin() routine is available
750 to get the login name.
751
ad27e871
JH
752d_getmnt (d_getmnt.U):
753 This variable conditionally defines the HAS_GETMNT symbol, which
754 indicates to the C program that the getmnt() routine is available
755 to retrieve one or more mount info blocks by filename.
756
781b178c
JH
757d_getmntent (d_getmntent.U):
758 This variable conditionally defines the HAS_GETMNTENT symbol, which
759 indicates to the C program that the getmntent() routine is available
0617aed7 760 to iterate through mounted files to get their mount info.
781b178c
JH
761
762d_getnbyaddr (d_getnbyad.U):
763 This variable conditionally defines the HAS_GETNETBYADDR symbol, which
764 indicates to the C program that the getnetbyaddr() routine is available
765 to look up networks by their IP addresses.
766
767d_getnbyname (d_getnbynm.U):
768 This variable conditionally defines the HAS_GETNETBYNAME symbol, which
769 indicates to the C program that the getnetbyname() routine is available
770 to look up networks by their names.
771
772d_getnent (d_getnent.U):
773 This variable conditionally defines HAS_GETNETENT if getnetent() is
774 available to look up network names in some data base or another.
775
776d_getnetprotos (d_getnetprotos.U):
777 This variable conditionally defines the HAS_GETNET_PROTOS symbol,
778 which indicates to the C program that <netdb.h> supplies
779 prototypes for the various getnet*() functions.
780 See also netdbtype.U for probing for various netdb types.
781
0c0643d0
JH
782d_getpagsz (d_getpagsz.U):
783 This variable conditionally defines HAS_GETPAGESIZE if getpagesize()
784 is available to get the system page size.
785
781b178c
JH
786d_getpbyname (d_getprotby.U):
787 This variable conditionally defines the HAS_GETPROTOBYNAME
788 symbol, which indicates to the C program that the
789 getprotobyname() routine is available to look up protocols
790 by their name.
791
792d_getpbynumber (d_getprotby.U):
793 This variable conditionally defines the HAS_GETPROTOBYNUMBER
794 symbol, which indicates to the C program that the
795 getprotobynumber() routine is available to look up protocols
796 by their number.
797
798d_getpent (d_getpent.U):
799 This variable conditionally defines HAS_GETPROTOENT if getprotoent() is
800 available to look up protocols in some data base or another.
801
802d_getpgid (d_getpgid.U):
803 This variable conditionally defines the HAS_GETPGID symbol, which
804 indicates to the C program that the getpgid(pid) function
805 is available to get the process group id.
806
807d_getpgrp2 (d_getpgrp2.U):
808 This variable conditionally defines the HAS_GETPGRP2 symbol, which
809 indicates to the C program that the getpgrp2() (as in DG/UX) routine
810 is available to get the current process group.
811
812d_getpgrp (d_getpgrp.U):
813 This variable conditionally defines HAS_GETPGRP if getpgrp() is
814 available to get the current process group.
815
816d_getppid (d_getppid.U):
817 This variable conditionally defines the HAS_GETPPID symbol, which
818 indicates to the C program that the getppid() routine is available
819 to get the parent process ID.
820
821d_getprior (d_getprior.U):
822 This variable conditionally defines HAS_GETPRIORITY if getpriority()
823 is available to get a process's priority.
824
825d_getprotoprotos (d_getprotoprotos.U):
826 This variable conditionally defines the HAS_GETPROTO_PROTOS symbol,
827 which indicates to the C program that <netdb.h> supplies
828 prototypes for the various getproto*() functions.
829 See also netdbtype.U for probing for various netdb types.
830
3813c136
JH
831d_getprpwnam (d_getprpwnam.U):
832 This variable conditionally defines HAS_GETPRPWNAM if getprpwnam() is
833 available to retrieve protected (shadow) password entries by name.
834
781b178c
JH
835d_getpwent (d_getpwent.U):
836 This variable conditionally defines the HAS_GETPWENT symbol, which
837 indicates to the C program that the getpwent() routine is available
838 for sequential access of the passwd database.
839
840d_getsbyname (d_getsrvby.U):
841 This variable conditionally defines the HAS_GETSERVBYNAME
842 symbol, which indicates to the C program that the
843 getservbyname() routine is available to look up services
844 by their name.
845
846d_getsbyport (d_getsrvby.U):
847 This variable conditionally defines the HAS_GETSERVBYPORT
848 symbol, which indicates to the C program that the
849 getservbyport() routine is available to look up services
850 by their port.
851
852d_getsent (d_getsent.U):
853 This variable conditionally defines HAS_GETSERVENT if getservent() is
854 available to look up network services in some data base or another.
855
856d_getservprotos (d_getservprotos.U):
857 This variable conditionally defines the HAS_GETSERV_PROTOS symbol,
858 which indicates to the C program that <netdb.h> supplies
859 prototypes for the various getserv*() functions.
860 See also netdbtype.U for probing for various netdb types.
861
781b178c
JH
862d_getspnam (d_getspnam.U):
863 This variable conditionally defines HAS_GETSPNAM if getspnam() is
864 available to retrieve SysV shadow password entries by name.
865
866d_gettimeod (d_ftime.U):
867 This variable conditionally defines the HAS_GETTIMEOFDAY symbol, which
868 indicates that the gettimeofday() system call exists (to obtain a
869 sub-second accuracy clock). You should probably include <sys/resource.h>.
870
871d_gnulibc (d_gnulibc.U):
872 Defined if we're dealing with the GNU C Library.
873
874d_grpasswd (i_grp.U):
875 This variable conditionally defines GRPASSWD, which indicates
876 that struct group in <grp.h> contains gr_passwd.
877
878d_hasmntopt (d_hasmntopt.U):
879 This variable conditionally defines the HAS_HASMNTOPT symbol, which
880 indicates to the C program that the hasmntopt() routine is available
881 to query the mount options of file systems.
882
883d_htonl (d_htonl.U):
884 This variable conditionally defines HAS_HTONL if htonl() and its
885 friends are available to do network order byte swapping.
886
887d_index (d_strchr.U):
888 This variable conditionally defines HAS_INDEX if index() and
889 rindex() are available for string searching.
890
891d_inetaton (d_inetaton.U):
892 This variable conditionally defines the HAS_INET_ATON symbol, which
893 indicates to the C program that the inet_aton() function is available
894 to parse IP address "dotted-quad" strings.
895
13b3f787 896d_int64_t (d_int64_t.U):
781b178c
JH
897 This symbol will be defined if the C compiler supports int64_t.
898
781b178c
JH
899d_isascii (d_isascii.U):
900 This variable conditionally defines the HAS_ISASCII constant,
901 which indicates to the C program that isascii() is available.
902
758a5d79
JH
903d_isfinite (d_isfinite.U):
904 This variable conditionally defines the HAS_ISFINITE symbol, which
905 indicates to the C program that the isfinite() routine is available.
906
907d_isinf (d_isinf.U):
908 This variable conditionally defines the HAS_ISINF symbol, which
909 indicates to the C program that the isinf() routine is available.
910
a3540c92
JH
911d_isnan (d_isnan.U):
912 This variable conditionally defines the HAS_ISNAN symbol, which
913 indicates to the C program that the isnan() routine is available.
914
915d_isnanl (d_isnanl.U):
916 This variable conditionally defines the HAS_ISNANL symbol, which
917 indicates to the C program that the isnanl() routine is available.
918
781b178c
JH
919d_killpg (d_killpg.U):
920 This variable conditionally defines the HAS_KILLPG symbol, which
921 indicates to the C program that the killpg() routine is available
922 to kill process groups.
923
924d_lchown (d_lchown.U):
925 This variable conditionally defines the HAS_LCHOWN symbol, which
926 indicates to the C program that the lchown() routine is available
927 to operate on a symbolic link (instead of following the link).
928
ca24dfc6
LV
929d_ldbl_dig (d_ldbl_dig.U):
930 This variable conditionally defines d_ldbl_dig if this system's
931 header files provide LDBL_DIG, which is the number of significant
932 digits in a long double precision number.
933
781b178c
JH
934d_link (d_link.U):
935 This variable conditionally defines HAS_LINK if link() is
936 available to create hard links.
937
781b178c
JH
938d_locconv (d_locconv.U):
939 This variable conditionally defines HAS_LOCALECONV if localeconv() is
940 available for numeric and monetary formatting conventions.
941
781b178c
JH
942d_lockf (d_lockf.U):
943 This variable conditionally defines HAS_LOCKF if lockf() is
944 available to do file locking.
945
946d_longdbl (d_longdbl.U):
947 This variable conditionally defines HAS_LONG_DOUBLE if
948 the long double type is supported.
949
950d_longlong (d_longlong.U):
951 This variable conditionally defines HAS_LONG_LONG if
952 the long long type is supported.
953
c890dc6c
JH
954d_lseekproto (d_lseekproto.U):
955 This variable conditionally defines the HAS_LSEEK_PROTO symbol,
956 which indicates to the C program that the system provides
957 a prototype for the lseek() function. Otherwise, it is
958 up to the program to supply one.
959
781b178c
JH
960d_lstat (d_lstat.U):
961 This variable conditionally defines HAS_LSTAT if lstat() is
962 available to do file stats on symbolic links.
963
792d8dab
JH
964d_madvise (d_madvise.U):
965 This variable conditionally defines HAS_MADVISE if madvise() is
966 available to map a file into memory.
967
781b178c
JH
968d_mblen (d_mblen.U):
969 This variable conditionally defines the HAS_MBLEN symbol, which
970 indicates to the C program that the mblen() routine is available
971 to find the number of bytes in a multibye character.
972
973d_mbstowcs (d_mbstowcs.U):
974 This variable conditionally defines the HAS_MBSTOWCS symbol, which
975 indicates to the C program that the mbstowcs() routine is available
976 to convert a multibyte string into a wide character string.
977
978d_mbtowc (d_mbtowc.U):
979 This variable conditionally defines the HAS_MBTOWC symbol, which
980 indicates to the C program that the mbtowc() routine is available
981 to convert multibyte to a wide character.
982
983d_memchr (d_memchr.U):
984 This variable conditionally defines the HAS_MEMCHR symbol, which
985 indicates to the C program that the memchr() routine is available
986 to locate characters within a C string.
987
988d_memcmp (d_memcmp.U):
989 This variable conditionally defines the HAS_MEMCMP symbol, which
990 indicates to the C program that the memcmp() routine is available
991 to compare blocks of memory.
992
993d_memcpy (d_memcpy.U):
994 This variable conditionally defines the HAS_MEMCPY symbol, which
995 indicates to the C program that the memcpy() routine is available
996 to copy blocks of memory.
997
998d_memmove (d_memmove.U):
999 This variable conditionally defines the HAS_MEMMOVE symbol, which
1000 indicates to the C program that the memmove() routine is available
1001 to copy potentatially overlapping blocks of memory.
1002
1003d_memset (d_memset.U):
1004 This variable conditionally defines the HAS_MEMSET symbol, which
1005 indicates to the C program that the memset() routine is available
1006 to set blocks of memory.
1007
1008d_mkdir (d_mkdir.U):
1009 This variable conditionally defines the HAS_MKDIR symbol, which
1010 indicates to the C program that the mkdir() routine is available
1011 to create directories..
1012
fe749a9f
JH
1013d_mkdtemp (d_mkdtemp.U):
1014 This variable conditionally defines the HAS_MKDTEMP symbol, which
1015 indicates to the C program that the mkdtemp() routine is available
1016 to exclusively create a uniquely named temporary directory.
1017
781b178c
JH
1018d_mkfifo (d_mkfifo.U):
1019 This variable conditionally defines the HAS_MKFIFO symbol, which
1020 indicates to the C program that the mkfifo() routine is available.
1021
fe749a9f
JH
1022d_mkstemp (d_mkstemp.U):
1023 This variable conditionally defines the HAS_MKSTEMP symbol, which
1024 indicates to the C program that the mkstemp() routine is available
1025 to exclusively create and open a uniquely named temporary file.
1026
1027d_mkstemps (d_mkstemps.U):
1028 This variable conditionally defines the HAS_MKSTEMPS symbol, which
1029 indicates to the C program that the mkstemps() routine is available
1030 to exclusively create and open a uniquely named (with a suffix)
1031 temporary file.
1032
781b178c
JH
1033d_mktime (d_mktime.U):
1034 This variable conditionally defines the HAS_MKTIME symbol, which
1035 indicates to the C program that the mktime() routine is available.
1036
fe749a9f
JH
1037d_mmap (d_mmap.U):
1038 This variable conditionally defines HAS_MMAP if mmap() is
1039 available to map a file into memory.
1040
a3540c92
JH
1041d_modfl (d_modfl.U):
1042 This variable conditionally defines the HAS_MODFL symbol, which
1043 indicates to the C program that the modfl() routine is available.
1044
e67aeab1
JH
1045d_modfl_pow32_bug (d_modfl.U):
1046 This variable conditionally defines the HAS_MODFL_POW32_BUG symbol,
1047 which indicates that modfl() is broken for long doubles >= pow(2, 32).
1048 For example from 4294967303.150000 one would get 4294967302.000000
1049 and 1.150000. The bug has been seen in certain versions of glibc,
1050 release 2.2.2 is known to be okay.
1051
fe749a9f
JH
1052d_mprotect (d_mprotect.U):
1053 This variable conditionally defines HAS_MPROTECT if mprotect() is
1054 available to modify the access protection of a memory mapped file.
1055
781b178c
JH
1056d_msg (d_msg.U):
1057 This variable conditionally defines the HAS_MSG symbol, which
1058 indicates that the entire msg*(2) library is present.
1059
1060d_msg_ctrunc (d_socket.U):
1061 This variable conditionally defines the HAS_MSG_CTRUNC symbol,
1062 which indicates that the MSG_CTRUNC is available. #ifdef is
1063 not enough because it may be an enum, glibc has been known to do this.
1064
1065d_msg_dontroute (d_socket.U):
1066 This variable conditionally defines the HAS_MSG_DONTROUTE symbol,
1067 which indicates that the MSG_DONTROUTE is available. #ifdef is
1068 not enough because it may be an enum, glibc has been known to do this.
1069
1070d_msg_oob (d_socket.U):
1071 This variable conditionally defines the HAS_MSG_OOB symbol,
1072 which indicates that the MSG_OOB is available. #ifdef is
1073 not enough because it may be an enum, glibc has been known to do this.
1074
1075d_msg_peek (d_socket.U):
1076 This variable conditionally defines the HAS_MSG_PEEK symbol,
1077 which indicates that the MSG_PEEK is available. #ifdef is
1078 not enough because it may be an enum, glibc has been known to do this.
1079
1080d_msg_proxy (d_socket.U):
1081 This variable conditionally defines the HAS_MSG_PROXY symbol,
1082 which indicates that the MSG_PROXY is available. #ifdef is
1083 not enough because it may be an enum, glibc has been known to do this.
1084
1085d_msgctl (d_msgctl.U):
1086 This variable conditionally defines the HAS_MSGCTL symbol, which
1087 indicates to the C program that the msgctl() routine is available.
1088
1089d_msgget (d_msgget.U):
1090 This variable conditionally defines the HAS_MSGGET symbol, which
1091 indicates to the C program that the msgget() routine is available.
1092
4e0554ec
JH
1093d_msghdr_s (d_msghdr_s.U):
1094 This variable conditionally defines the HAS_STRUCT_MSGHDR symbol,
1095 which indicates that the struct msghdr is supported.
1096
781b178c
JH
1097d_msgrcv (d_msgrcv.U):
1098 This variable conditionally defines the HAS_MSGRCV symbol, which
1099 indicates to the C program that the msgrcv() routine is available.
1100
1101d_msgsnd (d_msgsnd.U):
1102 This variable conditionally defines the HAS_MSGSND symbol, which
1103 indicates to the C program that the msgsnd() routine is available.
1104
fe749a9f
JH
1105d_msync (d_msync.U):
1106 This variable conditionally defines HAS_MSYNC if msync() is
1107 available to synchronize a mapped file.
1108
1109d_munmap (d_munmap.U):
1110 This variable conditionally defines HAS_MUNMAP if munmap() is
1111 available to unmap a region mapped by mmap().
1112
781b178c
JH
1113d_mymalloc (mallocsrc.U):
1114 This variable conditionally defines MYMALLOC in case other parts
1115 of the source want to take special action if MYMALLOC is used.
1116 This may include different sorts of profiling or error detection.
1117
781b178c
JH
1118d_nice (d_nice.U):
1119 This variable conditionally defines the HAS_NICE symbol, which
1120 indicates to the C program that the nice() routine is available.
1121
2765b840
JH
1122d_nl_langinfo (d_nl_langinfo.U):
1123 This variable conditionally defines the HAS_NL_LANGINFO symbol, which
1124 indicates to the C program that the nl_langinfo() routine is available.
1125
78691af5 1126d_nv_preserves_uv (perlxv.U):
cce08f5b
JH
1127 This variable indicates whether a variable of type nvtype
1128 can preserve all the bits a variable of type uvtype.
1129
d6c14000
JH
1130d_nv_preserves_uv_bits (perlxv.U):
1131 This variable indicates how many of bits type uvtype
1132 a variable nvtype can preserve.
1133
c890dc6c 1134d_off64_t (d_off64_t.U):
781b178c
JH
1135 This symbol will be defined if the C compiler supports off64_t.
1136
781b178c
JH
1137d_old_pthread_create_joinable (d_pthrattrj.U):
1138 This variable conditionally defines pthread_create_joinable.
1139 undef if pthread.h defines PTHREAD_CREATE_JOINABLE.
1140
1141d_oldpthreads (usethreads.U):
1142 This variable conditionally defines the OLD_PTHREADS_API symbol,
1143 and indicates that Perl should be built to use the old
8c09e4ca 1144 draft POSIX threads API. This is only potentially meaningful if
781b178c
JH
1145 usethreads is set.
1146
1147d_oldsock (d_socket.U):
1148 This variable conditionally defines the OLDSOCKET symbol, which
1149 indicates that the BSD socket interface is based on 4.1c and not 4.2.
1150
1151d_open3 (d_open3.U):
1152 This variable conditionally defines the HAS_OPEN3 manifest constant,
1153 which indicates to the C program that the 3 argument version of
1154 the open(2) function is available.
1155
781b178c
JH
1156d_pathconf (d_pathconf.U):
1157 This variable conditionally defines the HAS_PATHCONF symbol, which
1158 indicates to the C program that the pathconf() routine is available
1159 to determine file-system related limits and options associated
1160 with a given filename.
1161
1162d_pause (d_pause.U):
1163 This variable conditionally defines the HAS_PAUSE symbol, which
1164 indicates to the C program that the pause() routine is available
1165 to suspend a process until a signal is received.
1166
3b777bb4
GS
1167d_perl_otherlibdirs (otherlibdirs.U):
1168 This variable conditionally defines PERL_OTHERLIBDIRS, which
1169 contains a colon-separated set of paths for the perl binary to
1170 include in @INC. See also otherlibdirs.
1171
781b178c
JH
1172d_phostname (d_gethname.U):
1173 This variable conditionally defines the HAS_PHOSTNAME symbol, which
1174 contains the shell command which, when fed to popen(), may be
1175 used to derive the host name.
1176
1177d_pipe (d_pipe.U):
1178 This variable conditionally defines the HAS_PIPE symbol, which
1179 indicates to the C program that the pipe() routine is available
1180 to create an inter-process channel.
1181
1182d_poll (d_poll.U):
1183 This variable conditionally defines the HAS_POLL symbol, which
1184 indicates to the C program that the poll() routine is available
1185 to poll active file descriptors.
1186
1187d_portable (d_portable.U):
1188 This variable conditionally defines the PORTABLE symbol, which
1189 indicates to the C program that it should not assume that it is
1190 running on the machine it was compiled on.
1191
ff935051
JH
1192d_PRId64 (quadfio.U):
1193 This variable conditionally defines the PERL_PRId64 symbol, which
1194 indiciates that stdio has a symbol to print 64-bit decimal numbers.
1195
1196d_PRIeldbl (longdblfio.U):
6b356c8e 1197 This variable conditionally defines the PERL_PRIfldbl symbol, which
ff935051
JH
1198 indiciates that stdio has a symbol to print long doubles.
1199
6b356c8e
JH
1200d_PRIEUldbl (longdblfio.U):
1201 This variable conditionally defines the PERL_PRIfldbl symbol, which
ff935051 1202 indiciates that stdio has a symbol to print long doubles.
6b356c8e
JH
1203 The 'U' in the name is to separate this from d_PRIeldbl so that even
1204 case-blind systems can see the difference.
ff935051
JH
1205
1206d_PRIfldbl (longdblfio.U):
6b356c8e 1207 This variable conditionally defines the PERL_PRIfldbl symbol, which
ff935051
JH
1208 indiciates that stdio has a symbol to print long doubles.
1209
6b356c8e
JH
1210d_PRIFUldbl (longdblfio.U):
1211 This variable conditionally defines the PERL_PRIfldbl symbol, which
ff935051 1212 indiciates that stdio has a symbol to print long doubles.
6b356c8e
JH
1213 The 'U' in the name is to separate this from d_PRIfldbl so that even
1214 case-blind systems can see the difference.
ff935051
JH
1215
1216d_PRIgldbl (longdblfio.U):
6b356c8e 1217 This variable conditionally defines the PERL_PRIfldbl symbol, which
ff935051
JH
1218 indiciates that stdio has a symbol to print long doubles.
1219
6b356c8e
JH
1220d_PRIGUldbl (longdblfio.U):
1221 This variable conditionally defines the PERL_PRIfldbl symbol, which
ff935051 1222 indiciates that stdio has a symbol to print long doubles.
6b356c8e
JH
1223 The 'U' in the name is to separate this from d_PRIgldbl so that even
1224 case-blind systems can see the difference.
ff935051
JH
1225
1226d_PRIi64 (quadfio.U):
1227 This variable conditionally defines the PERL_PRIi64 symbol, which
1228 indiciates that stdio has a symbol to print 64-bit decimal numbers.
1229
1230d_PRIo64 (quadfio.U):
1231 This variable conditionally defines the PERL_PRIo64 symbol, which
1232 indiciates that stdio has a symbol to print 64-bit octal numbers.
1233
1234d_PRIu64 (quadfio.U):
1235 This variable conditionally defines the PERL_PRIu64 symbol, which
1236 indiciates that stdio has a symbol to print 64-bit unsigned decimal
1237 numbers.
1238
1239d_PRIx64 (quadfio.U):
1240 This variable conditionally defines the PERL_PRIx64 symbol, which
1241 indiciates that stdio has a symbol to print 64-bit hexadecimal numbers.
1242
6b356c8e
JH
1243d_PRIXU64 (quadfio.U):
1244 This variable conditionally defines the PERL_PRIXU64 symbol, which
ff935051 1245 indiciates that stdio has a symbol to print 64-bit hExADECimAl numbers.
6b356c8e
JH
1246 The 'U' in the name is to separate this from d_PRIx64 so that even
1247 case-blind systems can see the difference.
ff935051 1248
428dc699
JH
1249d_procselfexe (d_procselfexe.U):
1250 Defined if $procselfexe is symlink to the absolute
1251 pathname of the executing program.
1252
d6483fcc
JH
1253d_pthread_atfork (d_pthread_atfork.U):
1254 This variable conditionally defines the HAS_PTHREAD_ATFORK symbol,
1255 which indicates to the C program that the pthread_atfork()
1256 routine is available.
1257
781b178c
JH
1258d_pthread_yield (d_pthread_y.U):
1259 This variable conditionally defines the HAS_PTHREAD_YIELD
1260 symbol if the pthread_yield routine is available to yield
1261 the execution of the current thread.
1262
1263d_pwage (i_pwd.U):
1264 This variable conditionally defines PWAGE, which indicates
1265 that struct passwd contains pw_age.
1266
1267d_pwchange (i_pwd.U):
1268 This variable conditionally defines PWCHANGE, which indicates
1269 that struct passwd contains pw_change.
1270
1271d_pwclass (i_pwd.U):
1272 This variable conditionally defines PWCLASS, which indicates
1273 that struct passwd contains pw_class.
1274
1275d_pwcomment (i_pwd.U):
1276 This variable conditionally defines PWCOMMENT, which indicates
1277 that struct passwd contains pw_comment.
1278
1279d_pwexpire (i_pwd.U):
1280 This variable conditionally defines PWEXPIRE, which indicates
1281 that struct passwd contains pw_expire.
1282
1283d_pwgecos (i_pwd.U):
1284 This variable conditionally defines PWGECOS, which indicates
1285 that struct passwd contains pw_gecos.
1286
1287d_pwpasswd (i_pwd.U):
1288 This variable conditionally defines PWPASSWD, which indicates
1289 that struct passwd contains pw_passwd.
1290
1291d_pwquota (i_pwd.U):
1292 This variable conditionally defines PWQUOTA, which indicates
1293 that struct passwd contains pw_quota.
1294
792d8dab
JH
1295d_qgcvt (d_qgcvt.U):
1296 This variable conditionally defines the HAS_QGCVT symbol, which
1297 indicates to the C program that the qgcvt() routine is available.
1298
de1c2614
JH
1299d_quad (quadtype.U):
1300 This variable, if defined, tells that there's a 64-bit integer type,
1301 quadtype.
1302
781b178c
JH
1303d_readdir (d_readdir.U):
1304 This variable conditionally defines HAS_READDIR if readdir() is
1305 available to read directory entries.
1306
1307d_readlink (d_readlink.U):
1308 This variable conditionally defines the HAS_READLINK symbol, which
1309 indicates to the C program that the readlink() routine is available
1310 to read the value of a symbolic link.
1311
4e0554ec
JH
1312d_readv (d_readv.U):
1313 This variable conditionally defines the HAS_READV symbol, which
1314 indicates to the C program that the readv() routine is available.
1315
1316d_recvmsg (d_recvmsg.U):
1317 This variable conditionally defines the HAS_RECVMSG symbol, which
1318 indicates to the C program that the recvmsg() routine is available.
1319
781b178c
JH
1320d_rename (d_rename.U):
1321 This variable conditionally defines the HAS_RENAME symbol, which
1322 indicates to the C program that the rename() routine is available
1323 to rename files.
1324
1325d_rewinddir (d_readdir.U):
1326 This variable conditionally defines HAS_REWINDDIR if rewinddir() is
1327 available.
1328
1329d_rmdir (d_rmdir.U):
1330 This variable conditionally defines HAS_RMDIR if rmdir() is
1331 available to remove directories.
1332
1333d_safebcpy (d_safebcpy.U):
1334 This variable conditionally defines the HAS_SAFE_BCOPY symbol if
b6cc3bc4
AD
1335 the bcopy() routine can do overlapping copies. Normally, you
1336 should probably use memmove().
781b178c
JH
1337
1338d_safemcpy (d_safemcpy.U):
1339 This variable conditionally defines the HAS_SAFE_MEMCPY symbol if
1340 the memcpy() routine can do overlapping copies.
b6cc3bc4 1341 For overlapping copies, memmove() should be used, if available.
781b178c
JH
1342
1343d_sanemcmp (d_sanemcmp.U):
1344 This variable conditionally defines the HAS_SANE_MEMCMP symbol if
1345 the memcpy() routine is available and can be used to compare relative
1346 magnitudes of chars with their high bits set.
1347
ef9f17be
JH
1348d_sbrkproto (d_sbrkproto.U):
1349 This variable conditionally defines the HAS_SBRK_PROTO symbol,
1350 which indicates to the C program that the system provides
1351 a prototype for the sbrk() function. Otherwise, it is
1352 up to the program to supply one.
1353
781b178c
JH
1354d_sched_yield (d_pthread_y.U):
1355 This variable conditionally defines the HAS_SCHED_YIELD
1356 symbol if the sched_yield routine is available to yield
1357 the execution of the current thread.
1358
1359d_scm_rights (d_socket.U):
1360 This variable conditionally defines the HAS_SCM_RIGHTS symbol,
1361 which indicates that the SCM_RIGHTS is available. #ifdef is
1362 not enough because it may be an enum, glibc has been known to do this.
1363
6b356c8e
JH
1364d_SCNfldbl (longdblfio.U):
1365 This variable conditionally defines the PERL_PRIfldbl symbol, which
1366 indiciates that stdio has a symbol to scan long doubles.
1367
781b178c
JH
1368d_seekdir (d_readdir.U):
1369 This variable conditionally defines HAS_SEEKDIR if seekdir() is
1370 available.
1371
1372d_select (d_select.U):
1373 This variable conditionally defines HAS_SELECT if select() is
1374 available to select active file descriptors. A <sys/time.h>
1375 inclusion may be necessary for the timeout field.
1376
1377d_sem (d_sem.U):
1378 This variable conditionally defines the HAS_SEM symbol, which
1379 indicates that the entire sem*(2) library is present.
1380
1381d_semctl (d_semctl.U):
1382 This variable conditionally defines the HAS_SEMCTL symbol, which
1383 indicates to the C program that the semctl() routine is available.
1384
1385d_semctl_semid_ds (d_union_semun.U):
1386 This variable conditionally defines USE_SEMCTL_SEMID_DS, which
1387 indicates that struct semid_ds * is to be used for semctl IPC_STAT.
1388
1389d_semctl_semun (d_union_semun.U):
1390 This variable conditionally defines USE_SEMCTL_SEMUN, which
1391 indicates that union semun is to be used for semctl IPC_STAT.
1392
1393d_semget (d_semget.U):
1394 This variable conditionally defines the HAS_SEMGET symbol, which
1395 indicates to the C program that the semget() routine is available.
1396
1397d_semop (d_semop.U):
1398 This variable conditionally defines the HAS_SEMOP symbol, which
1399 indicates to the C program that the semop() routine is available.
1400
4e0554ec
JH
1401d_sendmsg (d_sendmsg.U):
1402 This variable conditionally defines the HAS_SENDMSG symbol, which
1403 indicates to the C program that the sendmsg() routine is available.
1404
781b178c
JH
1405d_setegid (d_setegid.U):
1406 This variable conditionally defines the HAS_SETEGID symbol, which
1407 indicates to the C program that the setegid() routine is available
1408 to change the effective gid of the current program.
1409
1410d_seteuid (d_seteuid.U):
1411 This variable conditionally defines the HAS_SETEUID symbol, which
1412 indicates to the C program that the seteuid() routine is available
1413 to change the effective uid of the current program.
1414
1415d_setgrent (d_setgrent.U):
1416 This variable conditionally defines the HAS_SETGRENT symbol, which
1417 indicates to the C program that the setgrent() routine is available
1418 for initializing sequential access to the group database.
1419
1420d_setgrps (d_setgrps.U):
1421 This variable conditionally defines the HAS_SETGROUPS symbol, which
1422 indicates to the C program that the setgroups() routine is available
1423 to set the list of process groups.
1424
1425d_sethent (d_sethent.U):
1426 This variable conditionally defines HAS_SETHOSTENT if sethostent() is
1427 available.
1428
4e0554ec
JH
1429d_setitimer (d_setitimer.U):
1430 This variable conditionally defines the HAS_SETITIMER symbol, which
1431 indicates to the C program that the setitimer() routine is available.
1432
781b178c
JH
1433d_setlinebuf (d_setlnbuf.U):
1434 This variable conditionally defines the HAS_SETLINEBUF symbol, which
1435 indicates to the C program that the setlinebuf() routine is available
1436 to change stderr or stdout from block-buffered or unbuffered to a
1437 line-buffered mode.
1438
1439d_setlocale (d_setlocale.U):
1440 This variable conditionally defines HAS_SETLOCALE if setlocale() is
1441 available to handle locale-specific ctype implementations.
1442
1443d_setnent (d_setnent.U):
1444 This variable conditionally defines HAS_SETNETENT if setnetent() is
1445 available.
1446
1447d_setpent (d_setpent.U):
1448 This variable conditionally defines HAS_SETPROTOENT if setprotoent() is
1449 available.
1450
1451d_setpgid (d_setpgid.U):
1452 This variable conditionally defines the HAS_SETPGID symbol if the
1453 setpgid(pid, gpid) function is available to set process group ID.
1454
1455d_setpgrp2 (d_setpgrp2.U):
1456 This variable conditionally defines the HAS_SETPGRP2 symbol, which
1457 indicates to the C program that the setpgrp2() (as in DG/UX) routine
1458 is available to set the current process group.
1459
1460d_setpgrp (d_setpgrp.U):
1461 This variable conditionally defines HAS_SETPGRP if setpgrp() is
1462 available to set the current process group.
1463
1464d_setprior (d_setprior.U):
1465 This variable conditionally defines HAS_SETPRIORITY if setpriority()
1466 is available to set a process's priority.
1467
af960fef
JH
1468d_setproctitle (d_setproctitle.U):
1469 This variable conditionally defines the HAS_SETPROCTITLE symbol,
1470 which indicates to the C program that the setproctitle() routine
1471 is available.
1472
781b178c
JH
1473d_setpwent (d_setpwent.U):
1474 This variable conditionally defines the HAS_SETPWENT symbol, which
1475 indicates to the C program that the setpwent() routine is available
1476 for initializing sequential access to the passwd database.
1477
1478d_setregid (d_setregid.U):
1479 This variable conditionally defines HAS_SETREGID if setregid() is
1480 available to change the real and effective gid of the current
1481 process.
1482
1483d_setresgid (d_setregid.U):
1484 This variable conditionally defines HAS_SETRESGID if setresgid() is
1485 available to change the real, effective and saved gid of the current
1486 process.
1487
1488d_setresuid (d_setreuid.U):
1489 This variable conditionally defines HAS_SETREUID if setresuid() is
1490 available to change the real, effective and saved uid of the current
1491 process.
1492
1493d_setreuid (d_setreuid.U):
1494 This variable conditionally defines HAS_SETREUID if setreuid() is
1495 available to change the real and effective uid of the current
1496 process.
1497
1498d_setrgid (d_setrgid.U):
1499 This variable conditionally defines the HAS_SETRGID symbol, which
1500 indicates to the C program that the setrgid() routine is available
1501 to change the real gid of the current program.
1502
1503d_setruid (d_setruid.U):
1504 This variable conditionally defines the HAS_SETRUID symbol, which
1505 indicates to the C program that the setruid() routine is available
1506 to change the real uid of the current program.
1507
1508d_setsent (d_setsent.U):
1509 This variable conditionally defines HAS_SETSERVENT if setservent() is
1510 available.
1511
1512d_setsid (d_setsid.U):
1513 This variable conditionally defines HAS_SETSID if setsid() is
1514 available to set the process group ID.
1515
781b178c
JH
1516d_setvbuf (d_setvbuf.U):
1517 This variable conditionally defines the HAS_SETVBUF symbol, which
1518 indicates to the C program that the setvbuf() routine is available
1519 to change buffering on an open stdio stream.
1520
1521d_sfio (d_sfio.U):
1522 This variable conditionally defines the USE_SFIO symbol,
1523 and indicates whether sfio is available (and should be used).
1524
1525d_shm (d_shm.U):
1526 This variable conditionally defines the HAS_SHM symbol, which
1527 indicates that the entire shm*(2) library is present.
1528
1529d_shmat (d_shmat.U):
1530 This variable conditionally defines the HAS_SHMAT symbol, which
1531 indicates to the C program that the shmat() routine is available.
1532
1533d_shmatprototype (d_shmat.U):
1534 This variable conditionally defines the HAS_SHMAT_PROTOTYPE
1535 symbol, which indicates that sys/shm.h has a prototype for
1536 shmat.
1537
1538d_shmctl (d_shmctl.U):
1539 This variable conditionally defines the HAS_SHMCTL symbol, which
1540 indicates to the C program that the shmctl() routine is available.
1541
1542d_shmdt (d_shmdt.U):
1543 This variable conditionally defines the HAS_SHMDT symbol, which
1544 indicates to the C program that the shmdt() routine is available.
1545
1546d_shmget (d_shmget.U):
1547 This variable conditionally defines the HAS_SHMGET symbol, which
1548 indicates to the C program that the shmget() routine is available.
1549
1550d_sigaction (d_sigaction.U):
1551 This variable conditionally defines the HAS_SIGACTION symbol, which
1552 indicates that the Vr4 sigaction() routine is available.
1553
983dbef6
JH
1554d_sigprocmask (d_sigprocmask.U):
1555 This variable conditionally defines HAS_SIGPROCMASK
1556 if sigprocmask() is available to examine or change the signal mask
1557 of the calling process.
1558
781b178c
JH
1559d_sigsetjmp (d_sigsetjmp.U):
1560 This variable conditionally defines the HAS_SIGSETJMP symbol,
1561 which indicates that the sigsetjmp() routine is available to
1562 call setjmp() and optionally save the process's signal mask.
1563
49a78c82
JH
1564d_sockatmark (d_sockatmark.U):
1565 This variable conditionally defines the HAS_SOCKATMARK symbol, which
1566 indicates to the C program that the sockatmark() routine is available.
1567
5af95cda
JH
1568d_sockatmarkproto (d_sockatmarkproto.U):
1569 This variable conditionally defines the HAS_SOCKATMARK_PROTO symbol,
1570 which indicates to the C program that the system provides
1571 a prototype for the sockatmark() function. Otherwise, it is
1572 up to the program to supply one.
1573
781b178c
JH
1574d_socket (d_socket.U):
1575 This variable conditionally defines HAS_SOCKET, which indicates
1576 that the BSD socket interface is supported.
1577
13b3f787
JH
1578d_socklen_t (d_socklen_t.U):
1579 This symbol will be defined if the C compiler supports socklen_t.
1580
781b178c
JH
1581d_sockpair (d_socket.U):
1582 This variable conditionally defines the HAS_SOCKETPAIR symbol, which
1583 indicates that the BSD socketpair() is supported.
1584
6b356c8e
JH
1585d_socks5_init (d_socks5_init.U):
1586 This variable conditionally defines the HAS_SOCKS5_INIT symbol, which
1587 indicates to the C program that the socks5_init() routine is available.
1588
68d4903c
JH
1589d_sqrtl (d_sqrtl.U):
1590 This variable conditionally defines the HAS_SQRTL symbol, which
1591 indicates to the C program that the sqrtl() routine is available.
1592
eef837ea
JH
1593d_sresgproto (d_sresgproto.U):
1594 This variable conditionally defines the HAS_SETRESGID_PROTO symbol,
1595 which indicates to the C program that the system provides
1596 a prototype for the setresgid() function. Otherwise, it is
1597 up to the program to supply one.
1598
640374d0
JH
1599d_sresuproto (d_sresuproto.U):
1600 This variable conditionally defines the HAS_SETRESUID_PROTO symbol,
1601 which indicates to the C program that the system provides
1602 a prototype for the setresuid() function. Otherwise, it is
1603 up to the program to supply one.
1604
781b178c
JH
1605d_statblks (d_statblks.U):
1606 This variable conditionally defines USE_STAT_BLOCKS
1607 if this system has a stat structure declaring
1608 st_blksize and st_blocks.
1609
ad27e871 1610d_statfs_f_flags (d_statfs_f_flags.U):
0545a864 1611 This variable conditionally defines the HAS_STRUCT_STATFS_F_FLAGS
781b178c
JH
1612 symbol, which indicates to struct statfs from has f_flags member.
1613 This kind of struct statfs is coming from sys/mount.h (BSD),
1614 not from sys/statfs.h (SYSV).
1615
ad27e871 1616d_statfs_s (d_statfs_s.U):
0545a864
JH
1617 This variable conditionally defines the HAS_STRUCT_STATFS symbol,
1618 which indicates that the struct statfs is supported.
1619
781b178c
JH
1620d_statvfs (d_statvfs.U):
1621 This variable conditionally defines the HAS_STATVFS symbol, which
1622 indicates to the C program that the statvfs() routine is available.
1623
1624d_stdio_cnt_lval (d_stdstdio.U):
1625 This variable conditionally defines STDIO_CNT_LVALUE if the
1626 FILE_cnt macro can be used as an lvalue.
1627
1628d_stdio_ptr_lval (d_stdstdio.U):
1629 This variable conditionally defines STDIO_PTR_LVALUE if the
1630 FILE_ptr macro can be used as an lvalue.
1631
a7ffa9b9
NC
1632d_stdio_ptr_lval_nochange_cnt (d_stdstdio.U):
1633 This symbol is defined if using the FILE_ptr macro as an lvalue
1634 to increase the pointer by n leaves File_cnt(fp) unchanged.
1635
1636d_stdio_ptr_lval_sets_cnt (d_stdstdio.U):
1637 This symbol is defined if using the FILE_ptr macro as an lvalue
1638 to increase the pointer by n has the side effect of decreasing the
1639 value of File_cnt(fp) by n.
1640
781b178c
JH
1641d_stdio_stream_array (stdio_streams.U):
1642 This variable tells whether there is an array holding
1643 the stdio streams.
1644
1645d_stdiobase (d_stdstdio.U):
1646 This variable conditionally defines USE_STDIO_BASE if this system
1647 has a FILE structure declaring a usable _base field (or equivalent)
1648 in stdio.h.
1649
1650d_stdstdio (d_stdstdio.U):
1651 This variable conditionally defines USE_STDIO_PTR if this system
1652 has a FILE structure declaring usable _ptr and _cnt fields (or
1653 equivalent) in stdio.h.
1654
781b178c
JH
1655d_strchr (d_strchr.U):
1656 This variable conditionally defines HAS_STRCHR if strchr() and
1657 strrchr() are available for string searching.
1658
1659d_strcoll (d_strcoll.U):
1660 This variable conditionally defines HAS_STRCOLL if strcoll() is
1661 available to compare strings using collating information.
1662
1663d_strctcpy (d_strctcpy.U):
1664 This variable conditionally defines the USE_STRUCT_COPY symbol, which
1665 indicates to the C program that this C compiler knows how to copy
1666 structures.
1667
1668d_strerrm (d_strerror.U):
1669 This variable holds what Strerrr is defined as to translate an error
1670 code condition into an error message string. It could be 'strerror'
1671 or a more complex macro emulating strrror with sys_errlist[], or the
1672 "unknown" string when both strerror and sys_errlist are missing.
1673
1674d_strerror (d_strerror.U):
1675 This variable conditionally defines HAS_STRERROR if strerror() is
1676 available to translate error numbers to strings.
1677
b3c85772
JH
1678d_strftime (d_strftime.U):
1679 This variable conditionally defines the HAS_STRFTIME symbol, which
1680 indicates to the C program that the strftime() routine is available.
1681
781b178c
JH
1682d_strtod (d_strtod.U):
1683 This variable conditionally defines the HAS_STRTOD symbol, which
1684 indicates to the C program that the strtod() routine is available
1685 to provide better numeric string conversion than atof().
1686
1687d_strtol (d_strtol.U):
1688 This variable conditionally defines the HAS_STRTOL symbol, which
1689 indicates to the C program that the strtol() routine is available
1690 to provide better numeric string conversion than atoi() and friends.
1691
ff935051
JH
1692d_strtold (d_strtold.U):
1693 This variable conditionally defines the HAS_STRTOLD symbol, which
1694 indicates to the C program that the strtold() routine is available.
1695
76d49b1c
JH
1696d_strtoll (d_strtoll.U):
1697 This variable conditionally defines the HAS_STRTOLL symbol, which
1698 indicates to the C program that the strtoll() routine is available.
1699
d0e6d399
NC
1700d_strtoq (d_strtoq.U):
1701 This variable conditionally defines the HAS_STRTOQ symbol, which
1702 indicates to the C program that the strtoq() routine is available.
1703
781b178c
JH
1704d_strtoul (d_strtoul.U):
1705 This variable conditionally defines the HAS_STRTOUL symbol, which
1706 indicates to the C program that the strtoul() routine is available
1707 to provide conversion of strings to unsigned long.
1708
ff935051 1709d_strtoull (d_strtoull.U):
11dc3f68
JH
1710 This variable conditionally defines the HAS_STRTOULL symbol, which
1711 indicates to the C program that the strtoull() routine is available.
1712
ff935051
JH
1713d_strtouq (d_strtouq.U):
1714 This variable conditionally defines the HAS_STRTOUQ symbol, which
1715 indicates to the C program that the strtouq() routine is available.
1716
781b178c
JH
1717d_strxfrm (d_strxfrm.U):
1718 This variable conditionally defines HAS_STRXFRM if strxfrm() is
1719 available to transform strings.
1720
1721d_suidsafe (d_dosuid.U):
1722 This variable conditionally defines SETUID_SCRIPTS_ARE_SECURE_NOW
1723 if setuid scripts can be secure. This test looks in /dev/fd/.
1724
1725d_symlink (d_symlink.U):
1726 This variable conditionally defines the HAS_SYMLINK symbol, which
1727 indicates to the C program that the symlink() routine is available
1728 to create symbolic links.
1729
1730d_syscall (d_syscall.U):
1731 This variable conditionally defines HAS_SYSCALL if syscall() is
1732 available call arbitrary system calls.
1733
5af95cda
JH
1734d_syscallproto (d_syscallproto.U):
1735 This variable conditionally defines the HAS_SYSCALL_PROTO symbol,
1736 which indicates to the C program that the system provides
1737 a prototype for the syscall() function. Otherwise, it is
1738 up to the program to supply one.
1739
781b178c
JH
1740d_sysconf (d_sysconf.U):
1741 This variable conditionally defines the HAS_SYSCONF symbol, which
1742 indicates to the C program that the sysconf() routine is available
1743 to determine system related limits and options.
1744
1745d_sysernlst (d_strerror.U):
1746 This variable conditionally defines HAS_SYS_ERRNOLIST if sys_errnolist[]
1747 is available to translate error numbers to the symbolic name.
1748
1749d_syserrlst (d_strerror.U):
1750 This variable conditionally defines HAS_SYS_ERRLIST if sys_errlist[] is
1751 available to translate error numbers to strings.
1752
1753d_system (d_system.U):
1754 This variable conditionally defines HAS_SYSTEM if system() is
1755 available to issue a shell command.
1756
1757d_tcgetpgrp (d_tcgtpgrp.U):
1758 This variable conditionally defines the HAS_TCGETPGRP symbol, which
1759 indicates to the C program that the tcgetpgrp() routine is available.
1760 to get foreground process group ID.
1761
1762d_tcsetpgrp (d_tcstpgrp.U):
1763 This variable conditionally defines the HAS_TCSETPGRP symbol, which
1764 indicates to the C program that the tcsetpgrp() routine is available
1765 to set foreground process group ID.
1766
781b178c
JH
1767d_telldir (d_readdir.U):
1768 This variable conditionally defines HAS_TELLDIR if telldir() is
1769 available.
1770
1771d_telldirproto (d_telldirproto.U):
1772 This variable conditionally defines the HAS_TELLDIR_PROTO symbol,
1773 which indicates to the C program that the system provides
1774 a prototype for the telldir() function. Otherwise, it is
1775 up to the program to supply one.
1776
1777d_time (d_time.U):
1778 This variable conditionally defines the HAS_TIME symbol, which indicates
1779 that the time() routine exists. The time() routine is normaly
1780 provided on UNIX systems.
1781
1782d_times (d_times.U):
1783 This variable conditionally defines the HAS_TIMES symbol, which indicates
1784 that the times() routine exists. The times() routine is normaly
1785 provided on UNIX systems. You may have to include <sys/times.h>.
1786
781b178c
JH
1787d_truncate (d_truncate.U):
1788 This variable conditionally defines HAS_TRUNCATE if truncate() is
1789 available to truncate files.
1790
1791d_tzname (d_tzname.U):
1792 This variable conditionally defines HAS_TZNAME if tzname[] is
1793 available to access timezone names.
1794
4e0554ec
JH
1795d_u32align (d_u32align.U):
1796 This variable tells whether you must access character data
1797 through U32-aligned pointers.
1798
1799d_ualarm (d_ualarm.U):
1800 This variable conditionally defines the HAS_UALARM symbol, which
1801 indicates to the C program that the ualarm() routine is available.
1802
781b178c
JH
1803d_umask (d_umask.U):
1804 This variable conditionally defines the HAS_UMASK symbol, which
1805 indicates to the C program that the umask() routine is available.
1806 to set and get the value of the file creation mask.
1807
1808d_uname (d_gethname.U):
1809 This variable conditionally defines the HAS_UNAME symbol, which
1810 indicates to the C program that the uname() routine may be
1811 used to derive the host name.
1812
1813d_union_semun (d_union_semun.U):
1814 This variable conditionally defines HAS_UNION_SEMUN if the
1815 union semun is defined by including <sys/sem.h>.
1816
758a5d79
JH
1817d_unordered (d_unordered.U):
1818 This variable conditionally defines the HAS_UNORDERED symbol, which
1819 indicates to the C program that the unordered() routine is available.
1820
4e0554ec
JH
1821d_usleep (d_usleep.U):
1822 This variable conditionally defines HAS_USLEEP if usleep() is
1823 available to do high granularity sleeps.
1824
5af95cda
JH
1825d_usleepproto (d_usleepproto.U):
1826 This variable conditionally defines the HAS_USLEEP_PROTO symbol,
1827 which indicates to the C program that the system provides
1828 a prototype for the usleep() function. Otherwise, it is
1829 up to the program to supply one.
1830
0545a864
JH
1831d_ustat (d_ustat.U):
1832 This variable conditionally defines HAS_USTAT if ustat() is
1833 available to query file system statistics by dev_t.
1834
526fdc24
MS
1835d_vendorarch (vendorarch.U):
1836 This variable conditionally defined PERL_VENDORARCH.
1837
0617aed7
JH
1838d_vendorbin (vendorbin.U):
1839 This variable conditionally defines PERL_VENDORBIN.
1840
a3635516
JH
1841d_vendorlib (vendorlib.U):
1842 This variable conditionally defines PERL_VENDORLIB.
1843
781b178c
JH
1844d_vfork (d_vfork.U):
1845 This variable conditionally defines the HAS_VFORK symbol, which
1846 indicates the vfork() routine is available.
1847
1848d_void_closedir (d_closedir.U):
1849 This variable conditionally defines VOID_CLOSEDIR if closedir()
1850 does not return a value.
1851
1852d_voidsig (d_voidsig.U):
1853 This variable conditionally defines VOIDSIG if this system
1854 declares "void (*signal(...))()" in signal.h. The old way was to
1855 declare it as "int (*signal(...))()".
1856
1857d_voidtty (i_sysioctl.U):
1858 This variable conditionally defines USE_IOCNOTTY to indicate that the
1859 ioctl() call with TIOCNOTTY should be used to void tty association.
1860 Otherwise (on USG probably), it is enough to close the standard file
1861 decriptors and do a setpgrp().
1862
1863d_volatile (d_volatile.U):
1864 This variable conditionally defines the HASVOLATILE symbol, which
1865 indicates to the C program that this C compiler knows about the
1866 volatile declaration.
1867
1868d_vprintf (d_vprintf.U):
1869 This variable conditionally defines the HAS_VPRINTF symbol, which
1870 indicates to the C program that the vprintf() routine is available
1871 to printf with a pointer to an argument list.
1872
1873d_wait4 (d_wait4.U):
1874 This variable conditionally defines the HAS_WAIT4 symbol, which
1875 indicates the wait4() routine is available.
1876
1877d_waitpid (d_waitpid.U):
1878 This variable conditionally defines HAS_WAITPID if waitpid() is
1879 available to wait for child process.
1880
1881d_wcstombs (d_wcstombs.U):
1882 This variable conditionally defines the HAS_WCSTOMBS symbol, which
1883 indicates to the C program that the wcstombs() routine is available
1884 to convert wide character strings to multibyte strings.
1885
1886d_wctomb (d_wctomb.U):
1887 This variable conditionally defines the HAS_WCTOMB symbol, which
1888 indicates to the C program that the wctomb() routine is available
1889 to convert a wide character to a multibyte.
1890
4e0554ec
JH
1891d_writev (d_writev.U):
1892 This variable conditionally defines the HAS_WRITEV symbol, which
1893 indicates to the C program that the writev() routine is available.
1894
781b178c
JH
1895d_xenix (Guess.U):
1896 This variable conditionally defines the symbol XENIX, which alerts
1897 the C program that it runs under Xenix.
1898
1899date (Loc.U):
5bf26616 1900 This variable is used internally by Configure to determine the
781b178c
JH
1901 full pathname (if any) of the date program. After Configure runs,
1902 the value is reset to a plain "date" and is not useful.
1903
1904db_hashtype (i_db.U):
1905 This variable contains the type of the hash structure element
1906 in the <db.h> header file. In older versions of DB, it was
1907 int, while in newer ones it is u_int32_t.
1908
1909db_prefixtype (i_db.U):
1910 This variable contains the type of the prefix structure element
1911 in the <db.h> header file. In older versions of DB, it was
1912 int, while in newer ones it is size_t.
1913
640374d0
JH
1914db_version_major (i_db.U):
1915 This variable contains the major version number of
1916 Berkeley DB found in the <db.h> header file.
1917
1918db_version_minor (i_db.U):
1919 This variable contains the minor version number of
1920 Berkeley DB found in the <db.h> header file.
1921 For DB version 1 this is always 0.
1922
1923db_version_patch (i_db.U):
1924 This variable contains the patch version number of
1925 Berkeley DB found in the <db.h> header file.
1926 For DB version 1 this is always 0.
1927
781b178c
JH
1928defvoidused (voidflags.U):
1929 This variable contains the default value of the VOIDUSED symbol (15).
1930
1931direntrytype (i_dirent.U):
1932 This symbol is set to 'struct direct' or 'struct dirent' depending on
1933 whether dirent is available or not. You should use this pseudo type to
1934 portably declare your directory entries.
1935
1936dlext (dlext.U):
1937 This variable contains the extension that is to be used for the
1938 dynamically loaded modules that perl generaties.
1939
1940dlsrc (dlsrc.U):
1941 This variable contains the name of the dynamic loading file that
1942 will be used with the package.
1943
1944doublesize (doublesize.U):
1945 This variable contains the value of the DOUBLESIZE symbol, which
1946 indicates to the C program how many bytes there are in a double.
1947
1948drand01 (randfunc.U):
1949 Indicates the macro to be used to generate normalized
1950 random numbers. Uses randfunc, often divided by
1951 (double) (((unsigned long) 1 << randbits)) in order to
1952 normalize the result.
1953 In C programs, the macro 'Drand01' is mapped to drand01.
1954
1955dynamic_ext (Extensions.U):
1956 This variable holds a list of XS extension files we want to
1957 link dynamically into the package. It is used by Makefile.
1958
1959eagain (nblock_io.U):
1960 This variable bears the symbolic errno code set by read() when no
1961 data is present on the file and non-blocking I/O was enabled (otherwise,
1962 read() blocks naturally).
1963
1964ebcdic (ebcdic.U):
1965 This variable conditionally defines EBCDIC if this
1966 system uses EBCDIC encoding. Among other things, this
1967 means that the character ranges are not contiguous.
1968 See trnl.U
1969
1970echo (Loc.U):
5bf26616 1971 This variable is used internally by Configure to determine the
781b178c
JH
1972 full pathname (if any) of the echo program. After Configure runs,
1973 the value is reset to a plain "echo" and is not useful.
1974
1975egrep (Loc.U):
5bf26616 1976 This variable is used internally by Configure to determine the
781b178c
JH
1977 full pathname (if any) of the egrep program. After Configure runs,
1978 the value is reset to a plain "egrep" and is not useful.
1979
1980emacs (Loc.U):
1981 This variable is defined but not used by Configure.
1982 The value is a plain '' and is not useful.
1983
1984eunicefix (Init.U):
1985 When running under Eunice this variable contains a command which will
1986 convert a shell script to the proper form of text file for it to be
1987 executable by the shell. On other systems it is a no-op.
1988
1989exe_ext (Unix.U):
1990 This is an old synonym for _exe.
1991
1992expr (Loc.U):
5bf26616 1993 This variable is used internally by Configure to determine the
781b178c
JH
1994 full pathname (if any) of the expr program. After Configure runs,
1995 the value is reset to a plain "expr" and is not useful.
1996
1997extensions (Extensions.U):
1998 This variable holds a list of all extension files (both XS and
1999 non-xs linked into the package. It is propagated to Config.pm
2000 and is typically used to test whether a particular extesion
2001 is available.
2002
cb7ddd31
JH
2003extras (Extras.U):
2004 This variable holds a list of extra modules to install.
2005
781b178c
JH
2006fflushall (fflushall.U):
2007 This symbol, if defined, tells that to flush
2008 all pending stdio output one must loop through all
2009 the stdio file handles stored in an array and fflush them.
2010 Note that if fflushNULL is defined, fflushall will not
2011 even be probed for and will be left undefined.
2012
ff935051
JH
2013fflushNULL (fflushall.U):
2014 This symbol, if defined, tells that fflush(NULL) does flush
2015 all pending stdio output.
2016
781b178c 2017find (Loc.U):
ff935051
JH
2018 This variable is defined but not used by Configure.
2019 The value is a plain '' and is not useful.
781b178c
JH
2020
2021firstmakefile (Unix.U):
2022 This variable defines the first file searched by make. On unix,
2023 it is makefile (then Makefile). On case-insensitive systems,
2024 it might be something else. This is only used to deal with
2025 convoluted make depend tricks.
2026
2027flex (Loc.U):
2028 This variable is defined but not used by Configure.
2029 The value is a plain '' and is not useful.
2030
a22e52b9
JH
2031fpossize (fpossize.U):
2032 This variable contains the size of a fpostype in bytes.
2033
781b178c 2034fpostype (fpostype.U):
a22e52b9 2035 This variable defines Fpos_t to be something like fpos_t, long,
781b178c
JH
2036 uint, or whatever type is used to declare file positions in libc.
2037
2038freetype (mallocsrc.U):
2039 This variable contains the return type of free(). It is usually
2040 void, but occasionally int.
2041
5440bc8e
JH
2042from (Cross.U):
2043 This variable contains the command used by Configure
2044 to copy files from the target host. Useful and available
2045 only during Perl build.
2046 The string ':' if not cross-compiling.
2047
781b178c
JH
2048full_ar (Loc_ar.U):
2049 This variable contains the full pathname to 'ar', whether or
2050 not the user has specified 'portability'. This is only used
2051 in the Makefile.SH.
2052
2053full_csh (d_csh.U):
2054 This variable contains the full pathname to 'csh', whether or
2055 not the user has specified 'portability'. This is only used
2056 in the compiled C program, and we assume that all systems which
2057 can share this executable will have the same full pathname to
2058 'csh.'
2059
2060full_sed (Loc_sed.U):
2061 This variable contains the full pathname to 'sed', whether or
2062 not the user has specified 'portability'. This is only used
2063 in the compiled C program, and we assume that all systems which
2064 can share this executable will have the same full pathname to
2065 'sed.'
2066
af960fef
JH
2067gccosandvers (gccvers.U):
2068 If GNU cc (gcc) is used, this variable the operating system and
2069 version used to compile the gcc. It is set to '' if not gcc,
2070 or if nothing useful can be parsed as the os version.
2071
2072gccversion (gccvers.U):
781b178c
JH
2073 If GNU cc (gcc) is used, this variable holds '1' or '2' to
2074 indicate whether the compiler is version 1 or 2. This is used in
2075 setting some of the default cflags. It is set to '' if not gcc.
2076
a22e52b9
JH
2077gidformat (gidf.U):
2078 This variable contains the format string used for printing a Gid_t.
2079
785fb66b
JH
2080gidsign (gidsign.U):
2081 This variable contains the signedness of a gidtype.
2082 1 for unsigned, -1 for signed.
2083
2084gidsize (gidsize.U):
2085 This variable contains the size of a gidtype in bytes.
2086
781b178c
JH
2087gidtype (gidtype.U):
2088 This variable defines Gid_t to be something like gid_t, int,
2089 ushort, or whatever type is used to declare the return type
2090 of getgid(). Typically, it is the type of group ids in the kernel.
2091
2092glibpth (libpth.U):
2093 This variable holds the general path (space-separated) used to
2094 find libraries. It may contain directories that do not exist on
2095 this platform, libpth is the cleaned-up version.
2096
2097grep (Loc.U):
5bf26616 2098 This variable is used internally by Configure to determine the
781b178c
JH
2099 full pathname (if any) of the grep program. After Configure runs,
2100 the value is reset to a plain "grep" and is not useful.
2101
2102groupcat (nis.U):
2103 This variable contains a command that produces the text of the
2104 /etc/group file. This is normally "cat /etc/group", but can be
2105 "ypcat group" when NIS is used.
aaacdc8b
GS
2106 On some systems, such as os390, there may be no equivalent
2107 command, in which case this variable is unset.
781b178c
JH
2108
2109groupstype (groupstype.U):
2110 This variable defines Groups_t to be something like gid_t, int,
2111 ushort, or whatever type is used for the second argument to
2112 getgroups() and setgroups(). Usually, this is the same as
2113 gidtype (gid_t), but sometimes it isn't.
2114
2115gzip (Loc.U):
5bf26616 2116 This variable is used internally by Configure to determine the
781b178c
JH
2117 full pathname (if any) of the gzip program. After Configure runs,
2118 the value is reset to a plain "gzip" and is not useful.
2119
2120h_fcntl (h_fcntl.U):
2121 This is variable gets set in various places to tell i_fcntl that
2122 <fcntl.h> should be included.
2123
2124h_sysfile (h_sysfile.U):
2125 This is variable gets set in various places to tell i_sys_file that
2126 <sys/file.h> should be included.
2127
2128hint (Oldconfig.U):
2129 Gives the type of hints used for previous answers. May be one of
2130 "default", "recommended" or "previous".
2131
2132hostcat (nis.U):
2133 This variable contains a command that produces the text of the
2134 /etc/hosts file. This is normally "cat /etc/hosts", but can be
2135 "ypcat hosts" when NIS is used.
aaacdc8b
GS
2136 On some systems, such as os390, there may be no equivalent
2137 command, in which case this variable is unset.
781b178c 2138
a22e52b9
JH
2139i16size (perlxv.U):
2140 This variable is the size of an I16 in bytes.
2141
2142i16type (perlxv.U):
2143 This variable contains the C type used for Perl's I16.
2144
2145i32size (perlxv.U):
2146 This variable is the size of an I32 in bytes.
2147
2148i32type (perlxv.U):
2149 This variable contains the C type used for Perl's I32.
2150
2151i64size (perlxv.U):
2152 This variable is the size of an I64 in bytes.
2153
2154i64type (perlxv.U):
2155 This variable contains the C type used for Perl's I64.
2156
2157i8size (perlxv.U):
2158 This variable is the size of an I8 in bytes.
2159
2160i8type (perlxv.U):
2161 This variable contains the C type used for Perl's I8.
2162
781b178c
JH
2163i_arpainet (i_arpainet.U):
2164 This variable conditionally defines the I_ARPA_INET symbol,
2165 and indicates whether a C program should include <arpa/inet.h>.
2166
2167i_bsdioctl (i_sysioctl.U):
2168 This variable conditionally defines the I_SYS_BSDIOCTL symbol, which
2169 indicates to the C program that <sys/bsdioctl.h> exists and should
2170 be included.
2171
2172i_db (i_db.U):
2173 This variable conditionally defines the I_DB symbol, and indicates
2174 whether a C program may include Berkeley's DB include file <db.h>.
2175
2176i_dbm (i_dbm.U):
2177 This variable conditionally defines the I_DBM symbol, which
2178 indicates to the C program that <dbm.h> exists and should
2179 be included.
2180
2181i_dirent (i_dirent.U):
2182 This variable conditionally defines I_DIRENT, which indicates
2183 to the C program that it should include <dirent.h>.
2184
2185i_dld (i_dld.U):
2186 This variable conditionally defines the I_DLD symbol, which
2187 indicates to the C program that <dld.h> (GNU dynamic loading)
2188 exists and should be included.
2189
2190i_dlfcn (i_dlfcn.U):
2191 This variable conditionally defines the I_DLFCN symbol, which
2192 indicates to the C program that <dlfcn.h> exists and should
2193 be included.
2194
2195i_fcntl (i_fcntl.U):
2196 This variable controls the value of I_FCNTL (which tells
2197 the C program to include <fcntl.h>).
2198
2199i_float (i_float.U):
2200 This variable conditionally defines the I_FLOAT symbol, and indicates
2201 whether a C program may include <float.h> to get symbols like DBL_MAX
2202 or DBL_MIN, i.e. machine dependent floating point values.
2203
758a5d79
JH
2204i_fp (i_fp.U):
2205 This variable conditionally defines the I_FP symbol, and indicates
2206 whether a C program should include <fp.h>.
2207
2208i_fp_class (i_fp_class.U):
2209 This variable conditionally defines the I_FP_CLASS symbol, and indicates
2210 whether a C program should include <fp_class.h>.
2211
781b178c
JH
2212i_gdbm (i_gdbm.U):
2213 This variable conditionally defines the I_GDBM symbol, which
2214 indicates to the C program that <gdbm.h> exists and should
2215 be included.
2216
2217i_grp (i_grp.U):
2218 This variable conditionally defines the I_GRP symbol, and indicates
2219 whether a C program should include <grp.h>.
2220
792d8dab
JH
2221i_ieeefp (i_ieeefp.U):
2222 This variable conditionally defines the I_IEEEFP symbol, and indicates
2223 whether a C program should include <ieeefp.h>.
2224
781b178c
JH
2225i_inttypes (i_inttypes.U):
2226 This variable conditionally defines the I_INTTYPES symbol,
2227 and indicates whether a C program should include <inttypes.h>.
2228
2765b840
JH
2229i_langinfo (i_langinfo.U):
2230 This variable conditionally defines the I_LANGINFO symbol,
2231 and indicates whether a C program should include <langinfo.h>.
2232
af960fef
JH
2233i_libutil (i_libutil.U):
2234 This variable conditionally defines the I_LIBUTIL symbol, and indicates
2235 whether a C program should include <libutil.h>.
2236
781b178c
JH
2237i_limits (i_limits.U):
2238 This variable conditionally defines the I_LIMITS symbol, and indicates
2239 whether a C program may include <limits.h> to get symbols like WORD_BIT
2240 and friends.
2241
2242i_locale (i_locale.U):
2243 This variable conditionally defines the I_LOCALE symbol,
2244 and indicates whether a C program should include <locale.h>.
2245
2246i_machcthr (i_machcthr.U):
2247 This variable conditionally defines the I_MACH_CTHREADS symbol,
2248 and indicates whether a C program should include <mach/cthreads.h>.
2249
2250i_malloc (i_malloc.U):
2251 This variable conditionally defines the I_MALLOC symbol, and indicates
2252 whether a C program should include <malloc.h>.
2253
2254i_math (i_math.U):
2255 This variable conditionally defines the I_MATH symbol, and indicates
2256 whether a C program may include <math.h>.
2257
2258i_memory (i_memory.U):
2259 This variable conditionally defines the I_MEMORY symbol, and indicates
2260 whether a C program should include <memory.h>.
2261
2262i_mntent (i_mntent.U):
2263 This variable conditionally defines the I_MNTENT symbol, and indicates
2264 whether a C program should include <mntent.h>.
2265
2266i_ndbm (i_ndbm.U):
2267 This variable conditionally defines the I_NDBM symbol, which
2268 indicates to the C program that <ndbm.h> exists and should
2269 be included.
2270
2271i_netdb (i_netdb.U):
2272 This variable conditionally defines the I_NETDB symbol, and indicates
2273 whether a C program should include <netdb.h>.
2274
2275i_neterrno (i_neterrno.U):
2276 This variable conditionally defines the I_NET_ERRNO symbol, which
2277 indicates to the C program that <net/errno.h> exists and should
2278 be included.
2279
2280i_netinettcp (i_netinettcp.U):
2281 This variable conditionally defines the I_NETINET_TCP symbol,
2282 and indicates whether a C program should include <netinet/tcp.h>.
2283
2284i_niin (i_niin.U):
2285 This variable conditionally defines I_NETINET_IN, which indicates
2286 to the C program that it should include <netinet/in.h>. Otherwise,
2287 you may try <sys/in.h>.
2288
2289i_poll (i_poll.U):
2290 This variable conditionally defines the I_POLL symbol, and indicates
2291 whether a C program should include <poll.h>.
2292
3813c136
JH
2293i_prot (i_prot.U):
2294 This variable conditionally defines the I_PROT symbol, and indicates
2295 whether a C program should include <prot.h>.
2296
781b178c 2297i_pthread (i_pthread.U):
190b66db 2298 This variable conditionally defines the I_PTHREAD symbol,
781b178c
JH
2299 and indicates whether a C program should include <pthread.h>.
2300
2301i_pwd (i_pwd.U):
2302 This variable conditionally defines I_PWD, which indicates
2303 to the C program that it should include <pwd.h>.
2304
2305i_rpcsvcdbm (i_dbm.U):
2306 This variable conditionally defines the I_RPCSVC_DBM symbol, which
2307 indicates to the C program that <rpcsvc/dbm.h> exists and should
2308 be included. Some System V systems might need this instead of <dbm.h>.
2309
2310i_sfio (i_sfio.U):
2311 This variable conditionally defines the I_SFIO symbol,
2312 and indicates whether a C program should include <sfio.h>.
2313
2314i_sgtty (i_termio.U):
2315 This variable conditionally defines the I_SGTTY symbol, which
2316 indicates to the C program that it should include <sgtty.h> rather
2317 than <termio.h>.
2318
2319i_shadow (i_shadow.U):
2320 This variable conditionally defines the I_SHADOW symbol, and indicates
2321 whether a C program should include <shadow.h>.
2322
2323i_socks (i_socks.U):
2324 This variable conditionally defines the I_SOCKS symbol, and indicates
2325 whether a C program should include <socks.h>.
2326
2327i_stdarg (i_varhdr.U):
2328 This variable conditionally defines the I_STDARG symbol, which
2329 indicates to the C program that <stdarg.h> exists and should
2330 be included.
2331
2332i_stddef (i_stddef.U):
2333 This variable conditionally defines the I_STDDEF symbol, which
2334 indicates to the C program that <stddef.h> exists and should
2335 be included.
2336
2337i_stdlib (i_stdlib.U):
2338 This variable conditionally defines the I_STDLIB symbol, which
2339 indicates to the C program that <stdlib.h> exists and should
2340 be included.
2341
2342i_string (i_string.U):
2343 This variable conditionally defines the I_STRING symbol, which
2344 indicates that <string.h> should be included rather than <strings.h>.
2345
792d8dab
JH
2346i_sunmath (i_sunmath.U):
2347 This variable conditionally defines the I_SUNMATH symbol, and indicates
2348 whether a C program should include <sunmath.h>.
2349
781b178c
JH
2350i_sysaccess (i_sysaccess.U):
2351 This variable conditionally defines the I_SYS_ACCESS symbol,
2352 and indicates whether a C program should include <sys/access.h>.
2353
2354i_sysdir (i_sysdir.U):
2355 This variable conditionally defines the I_SYS_DIR symbol, and indicates
2356 whether a C program should include <sys/dir.h>.
2357
2358i_sysfile (i_sysfile.U):
2359 This variable conditionally defines the I_SYS_FILE symbol, and indicates
2360 whether a C program should include <sys/file.h> to get R_OK and friends.
2361
2362i_sysfilio (i_sysioctl.U):
2363 This variable conditionally defines the I_SYS_FILIO symbol, which
2364 indicates to the C program that <sys/filio.h> exists and should
2365 be included in preference to <sys/ioctl.h>.
2366
2367i_sysin (i_niin.U):
2368 This variable conditionally defines I_SYS_IN, which indicates
2369 to the C program that it should include <sys/in.h> instead of
2370 <netinet/in.h>.
2371
2372i_sysioctl (i_sysioctl.U):
2373 This variable conditionally defines the I_SYS_IOCTL symbol, which
2374 indicates to the C program that <sys/ioctl.h> exists and should
2375 be included.
2376
ca52efda
JH
2377i_syslog (i_syslog.U):
2378 This variable conditionally defines the I_SYSLOG symbol,
2379 and indicates whether a C program should include <syslog.h>.
2380
fe749a9f
JH
2381i_sysmman (i_sysmman.U):
2382 This variable conditionally defines the I_SYS_MMAN symbol, and
2383 indicates whether a C program should include <sys/mman.h>.
2384
87b71857
JH
2385i_sysmode (i_sysmode.U):
2386 This variable conditionally defines the I_SYSMODE symbol,
2387 and indicates whether a C program should include <sys/mode.h>.
2388
781b178c
JH
2389i_sysmount (i_sysmount.U):
2390 This variable conditionally defines the I_SYSMOUNT symbol,
2391 and indicates whether a C program should include <sys/mount.h>.
2392
2393i_sysndir (i_sysndir.U):
2394 This variable conditionally defines the I_SYS_NDIR symbol, and indicates
2395 whether a C program should include <sys/ndir.h>.
2396
2397i_sysparam (i_sysparam.U):
2398 This variable conditionally defines the I_SYS_PARAM symbol, and indicates
2399 whether a C program should include <sys/param.h>.
2400
2401i_sysresrc (i_sysresrc.U):
2402 This variable conditionally defines the I_SYS_RESOURCE symbol,
2403 and indicates whether a C program should include <sys/resource.h>.
2404
2405i_syssecrt (i_syssecrt.U):
2406 This variable conditionally defines the I_SYS_SECURITY symbol,
2407 and indicates whether a C program should include <sys/security.h>.
2408
2409i_sysselct (i_sysselct.U):
2410 This variable conditionally defines I_SYS_SELECT, which indicates
2411 to the C program that it should include <sys/select.h> in order to
2412 get the definition of struct timeval.
2413
2414i_syssockio (i_sysioctl.U):
2415 This variable conditionally defines I_SYS_SOCKIO to indicate to the
2416 C program that socket ioctl codes may be found in <sys/sockio.h>
2417 instead of <sys/ioctl.h>.
2418
2419i_sysstat (i_sysstat.U):
2420 This variable conditionally defines the I_SYS_STAT symbol,
2421 and indicates whether a C program should include <sys/stat.h>.
2422
0545a864
JH
2423i_sysstatfs (i_sysstatfs.U):
2424 This variable conditionally defines the I_SYSSTATFS symbol,
2425 and indicates whether a C program should include <sys/statfs.h>.
2426
781b178c
JH
2427i_sysstatvfs (i_sysstatvfs.U):
2428 This variable conditionally defines the I_SYSSTATVFS symbol,
2429 and indicates whether a C program should include <sys/statvfs.h>.
2430
2431i_systime (i_time.U):
2432 This variable conditionally defines I_SYS_TIME, which indicates
2433 to the C program that it should include <sys/time.h>.
2434
2435i_systimek (i_time.U):
2436 This variable conditionally defines I_SYS_TIME_KERNEL, which
2437 indicates to the C program that it should include <sys/time.h>
2438 with KERNEL defined.
2439
2440i_systimes (i_systimes.U):
2441 This variable conditionally defines the I_SYS_TIMES symbol, and indicates
2442 whether a C program should include <sys/times.h>.
2443
2444i_systypes (i_systypes.U):
2445 This variable conditionally defines the I_SYS_TYPES symbol,
2446 and indicates whether a C program should include <sys/types.h>.
2447
2448i_sysuio (i_sysuio.U):
2449 This variable conditionally defines the I_SYSUIO symbol, and indicates
2450 whether a C program should include <sys/uio.h>.
2451
2452i_sysun (i_sysun.U):
2453 This variable conditionally defines I_SYS_UN, which indicates
2454 to the C program that it should include <sys/un.h> to get UNIX
2455 domain socket definitions.
2456
d4935d7f
JH
2457i_sysutsname (i_sysutsname.U):
2458 This variable conditionally defines the I_SYSUTSNAME symbol,
2459 and indicates whether a C program should include <sys/utsname.h>.
2460
0545a864
JH
2461i_sysvfs (i_sysvfs.U):
2462 This variable conditionally defines the I_SYSVFS symbol,
2463 and indicates whether a C program should include <sys/vfs.h>.
2464
781b178c
JH
2465i_syswait (i_syswait.U):
2466 This variable conditionally defines I_SYS_WAIT, which indicates
2467 to the C program that it should include <sys/wait.h>.
2468
2469i_termio (i_termio.U):
2470 This variable conditionally defines the I_TERMIO symbol, which
2471 indicates to the C program that it should include <termio.h> rather
2472 than <sgtty.h>.
2473
2474i_termios (i_termio.U):
2475 This variable conditionally defines the I_TERMIOS symbol, which
2476 indicates to the C program that the POSIX <termios.h> file is
2477 to be included.
2478
2479i_time (i_time.U):
2480 This variable conditionally defines I_TIME, which indicates
2481 to the C program that it should include <time.h>.
2482
2483i_unistd (i_unistd.U):
2484 This variable conditionally defines the I_UNISTD symbol, and indicates
2485 whether a C program should include <unistd.h>.
2486
0545a864
JH
2487i_ustat (i_ustat.U):
2488 This variable conditionally defines the I_USTAT symbol, and indicates
2489 whether a C program should include <ustat.h>.
2490
781b178c
JH
2491i_utime (i_utime.U):
2492 This variable conditionally defines the I_UTIME symbol, and indicates
2493 whether a C program should include <utime.h>.
2494
2495i_values (i_values.U):
2496 This variable conditionally defines the I_VALUES symbol, and indicates
2497 whether a C program may include <values.h> to get symbols like MAXLONG
2498 and friends.
2499
2500i_varargs (i_varhdr.U):
2501 This variable conditionally defines I_VARARGS, which indicates
2502 to the C program that it should include <varargs.h>.
2503
2504i_varhdr (i_varhdr.U):
2505 Contains the name of the header to be included to get va_dcl definition.
2506 Typically one of varargs.h or stdarg.h.
2507
2508i_vfork (i_vfork.U):
2509 This variable conditionally defines the I_VFORK symbol, and indicates
2510 whether a C program should include vfork.h.
2511
2512ignore_versioned_solibs (libs.U):
2513 This variable should be non-empty if non-versioned shared
2514 libraries (libfoo.so.x.y) are to be ignored (because they
2515 cannot be linked against).
2516
ff935051
JH
2517inc_version_list (inc_version_list.U):
2518 This variable specifies the list of subdirectories in over
2519 which perl.c:incpush() and lib/lib.pm will automatically
3a096bf3
JH
2520 search when adding directories to @INC. The elements in
2521 the list are separated by spaces. This is only useful
ff935051
JH
2522 if you have a perl library directory tree structured like the
2523 default one. See INSTALL for how this works. The versioned
2524 site_perl directory was introduced in 5.005, so that is the
2525 lowest possible value.
2526
3a096bf3
JH
2527inc_version_list_init (inc_version_list.U):
2528 This variable holds the same list as inc_version_list, but
2529 each item is enclosed in double quotes and separated by commas,
2530 suitable for use in the PERL_INC_VERSION_LIST initialization.
2531
781b178c
JH
2532incpath (usrinc.U):
2533 This variable must preceed the normal include path to get hte
2534 right one, as in "$incpath/usr/include" or "$incpath/usr/lib".
2535 Value can be "" or "/bsd43" on mips.
2536
2537inews (Loc.U):
2538 This variable is defined but not used by Configure.
2539 The value is a plain '' and is not useful.
2540
2541installarchlib (archlib.U):
2542 This variable is really the same as archlibexp but may differ on
2543 those systems using AFS. For extra portability, only this variable
2544 should be used in makefiles.
2545
2546installbin (bin.U):
2547 This variable is the same as binexp unless AFS is running in which case
2548 the user is explicitely prompted for it. This variable should always
2549 be used in your makefiles for maximum portability.
2550
2551installman1dir (man1dir.U):
2552 This variable is really the same as man1direxp, unless you are using
2553 AFS in which case it points to the read/write location whereas
2554 man1direxp only points to the read-only access location. For extra
2555 portability, you should only use this variable within your makefiles.
2556
2557installman3dir (man3dir.U):
2558 This variable is really the same as man3direxp, unless you are using
2559 AFS in which case it points to the read/write location whereas
2560 man3direxp only points to the read-only access location. For extra
2561 portability, you should only use this variable within your makefiles.
2562
2563installprefix (installprefix.U):
2564 This variable holds the name of the directory below which
2565 "make install" will install the package. For most users, this
2566 is the same as prefix. However, it is useful for
2567 installing the software into a different (usually temporary)
2568 location after which it can be bundled up and moved somehow
2569 to the final location specified by prefix.
2570
2571installprefixexp (installprefix.U):
2572 This variable holds the full absolute path of installprefix
2573 with all ~-expansion done.
2574
2575installprivlib (privlib.U):
2576 This variable is really the same as privlibexp but may differ on
2577 those systems using AFS. For extra portability, only this variable
2578 should be used in makefiles.
2579
2580installscript (scriptdir.U):
2581 This variable is usually the same as scriptdirexp, unless you are on
2582 a system running AFS, in which case they may differ slightly. You
2583 should always use this variable within your makefiles for portability.
2584
2585installsitearch (sitearch.U):
2586 This variable is really the same as sitearchexp but may differ on
2587 those systems using AFS. For extra portability, only this variable
2588 should be used in makefiles.
2589
0617aed7
JH
2590installsitebin (sitebin.U):
2591 This variable is usually the same as sitebinexp, unless you are on
2592 a system running AFS, in which case they may differ slightly. You
2593 should always use this variable within your makefiles for portability.
2594
781b178c
JH
2595installsitelib (sitelib.U):
2596 This variable is really the same as sitelibexp but may differ on
2597 those systems using AFS. For extra portability, only this variable
2598 should be used in makefiles.
2599
2600installstyle (installstyle.U):
2601 This variable describes the "style" of the perl installation.
2602 This is intended to be useful for tools that need to
2603 manipulate entire perl distributions. Perl itself doesn't use
2604 this to find its libraries -- the library directories are
2605 stored directly in Config.pm. Currently, there are only two
2606 styles: "lib" and "lib/perl5". The default library locations
2607 (e.g. privlib, sitelib) are either $prefix/lib or
2608 $prefix/lib/perl5. The former is useful if $prefix is a
2609 directory dedicated to perl (e.g. /opt/perl), while the latter
2610 is useful if $prefix is shared by many packages, e.g. if
2611 $prefix=/usr/local.
2612 This may later be extended to include other information, so
2613 be careful with pattern-matching on the results.
2614 For compatibility with perl5.005 and earlier, the default
2615 setting is based on whether or not $prefix contains the string
2616 "perl".
2617
2618installusrbinperl (instubperl.U):
2619 This variable tells whether Perl should be installed also as
2620 /usr/bin/perl in addition to
2621 $installbin/perl
2622
526fdc24
MS
2623installvendorarch (vendorarch.U):
2624 This variable is really the same as vendorarchexp but may differ on
2625 those systems using AFS. For extra portability, only this variable
2626 should be used in makefiles.
2627
0617aed7
JH
2628installvendorbin (vendorbin.U):
2629 This variable is really the same as vendorbinexp but may differ on
2630 those systems using AFS. For extra portability, only this variable
2631 should be used in makefiles.
2632
a3635516
JH
2633installvendorlib (vendorlib.U):
2634 This variable is really the same as vendorlibexp but may differ on
2635 those systems using AFS. For extra portability, only this variable
2636 should be used in makefiles.
2637
781b178c
JH
2638intsize (intsize.U):
2639 This variable contains the value of the INTSIZE symbol, which
2640 indicates to the C program how many bytes there are in an int.
2641
4b661809 2642issymlink (issymlink.U):
983dbef6
JH
2643 This variable holds the test command to test for a symbolic link
2644 (if they are supported). Typical values include 'test -h' and
2645 'test -L'.
4b661809 2646
a22e52b9
JH
2647ivdformat (perlxvf.U):
2648 This variable contains the format string used for printing
2649 a Perl IV as a signed decimal integer.
2650
2651ivsize (perlxv.U):
2652 This variable is the size of an IV in bytes.
2653
2654ivtype (perlxv.U):
2655 This variable contains the C type used for Perl's IV.
2656
781b178c
JH
2657known_extensions (Extensions.U):
2658 This variable holds a list of all XS extensions included in
2659 the package.
2660
2661ksh (Loc.U):
2662 This variable is defined but not used by Configure.
2663 The value is a plain '' and is not useful.
2664
781b178c
JH
2665ld (dlsrc.U):
2666 This variable indicates the program to be used to link
2667 libraries for dynamic loading. On some systems, it is 'ld'.
2668 On ELF systems, it should be $cc. Mostly, we'll try to respect
2669 the hint file setting.
2670
2671lddlflags (dlsrc.U):
2672 This variable contains any special flags that might need to be
2673 passed to $ld to create a shared library suitable for dynamic
2674 loading. It is up to the makefile to use it. For hpux, it
2675 should be '-b'. For sunos 4.1, it is empty.
2676
2677ldflags (ccflags.U):
2678 This variable contains any additional C loader flags desired by
2679 the user. It is up to the Makefile to use this.
2680
af960fef
JH
2681ldflags_uselargefiles (uselfs.U):
2682 This variable contains the loader flags needed by large file builds
2683 and added to ldflags by hints files.
2684
781b178c
JH
2685ldlibpthname (libperl.U):
2686 This variable holds the name of the shared library
2687 search path, often LD_LIBRARY_PATH. To get an empty
2688 string, the hints file must set this to 'none'.
2689
2690less (Loc.U):
5bf26616 2691 This variable is used internally by Configure to determine the
781b178c
JH
2692 full pathname (if any) of the less program. After Configure runs,
2693 the value is reset to a plain "less" and is not useful.
2694
2695lib_ext (Unix.U):
2696 This is an old synonym for _a.
2697
2698libc (libc.U):
2699 This variable contains the location of the C library.
2700
2701libperl (libperl.U):
2702 The perl executable is obtained by linking perlmain.c with
2703 libperl, any static extensions (usually just DynaLoader),
2704 and any other libraries needed on this system. libperl
2705 is usually libperl.a, but can also be libperl.so.xxx if
2706 the user wishes to build a perl executable with a shared
2707 library.
2708
2709libpth (libpth.U):
2710 This variable holds the general path (space-separated) used to find
2711 libraries. It is intended to be used by other units.
2712
2713libs (libs.U):
2714 This variable holds the additional libraries we want to use.
2715 It is up to the Makefile to deal with it.
2716
fe749a9f
JH
2717libsdirs (libs.U):
2718 This variable holds the directory names aka dirnames of the libraries
2719 we found and accepted, duplicates are removed.
2720
2721libsfiles (libs.U):
2722 This variable holds the filenames aka basenames of the libraries
2723 we found and accepted.
2724
2725libsfound (libs.U):
2726 This variable holds the full pathnames of the libraries
2727 we found and accepted.
2728
13b3f787
JH
2729libspath (libs.U):
2730 This variable holds the directory names probed for libraries.
2731
781b178c
JH
2732libswanted (Myinit.U):
2733 This variable holds a list of all the libraries we want to
2734 search. The order is chosen to pick up the c library
2735 ahead of ucb or bsd libraries for SVR4.
2736
af960fef
JH
2737libswanted_uselargefiles (uselfs.U):
2738 This variable contains the libraries needed by large file builds
2739 and added to ldflags by hints files. It is a space separated list
2740 of the library names without the "lib" prefix or any suffix, just
2741 like libswanted..
2742
781b178c 2743line (Loc.U):
ff935051
JH
2744 This variable is defined but not used by Configure.
2745 The value is a plain '' and is not useful.
781b178c
JH
2746
2747lint (Loc.U):
2748 This variable is defined but not used by Configure.
2749 The value is a plain '' and is not useful.
2750
2751lkflags (ccflags.U):
2752 This variable contains any additional C partial linker flags desired by
2753 the user. It is up to the Makefile to use this.
2754
2755ln (Loc.U):
5bf26616 2756 This variable is used internally by Configure to determine the
781b178c
JH
2757 full pathname (if any) of the ln program. After Configure runs,
2758 the value is reset to a plain "ln" and is not useful.
2759
2760lns (lns.U):
2761 This variable holds the name of the command to make
2762 symbolic links (if they are supported). It can be used
2763 in the Makefile. It is either 'ln -s' or 'ln'
2764
2765locincpth (ccflags.U):
2766 This variable contains a list of additional directories to be
2767 searched by the compiler. The appropriate '-I' directives will
2768 be added to ccflags. This is intended to simplify setting
2769 local directories from the Configure command line.
2770 It's not much, but it parallels the loclibpth stuff in libpth.U.
2771
2772loclibpth (libpth.U):
2773 This variable holds the paths (space-separated) used to find local
2774 libraries. It is prepended to libpth, and is intended to be easily
2775 set from the command line.
2776
2777longdblsize (d_longdbl.U):
2778 This variable contains the value of the LONG_DOUBLESIZE symbol, which
2779 indicates to the C program how many bytes there are in a long double,
2780 if this system supports long doubles.
2781
2782longlongsize (d_longlong.U):
2783 This variable contains the value of the LONGLONGSIZE symbol, which
2784 indicates to the C program how many bytes there are in a long long,
2785 if this system supports long long.
2786
2787longsize (intsize.U):
2788 This variable contains the value of the LONGSIZE symbol, which
2789 indicates to the C program how many bytes there are in a long.
2790
2791lp (Loc.U):
2792 This variable is defined but not used by Configure.
2793 The value is a plain '' and is not useful.
2794
2795lpr (Loc.U):
2796 This variable is defined but not used by Configure.
2797 The value is a plain '' and is not useful.
2798
2799ls (Loc.U):
5bf26616 2800 This variable is used internally by Configure to determine the
781b178c
JH
2801 full pathname (if any) of the ls program. After Configure runs,
2802 the value is reset to a plain "ls" and is not useful.
2803
2804lseeksize (lseektype.U):
2805 This variable defines lseektype to be something like off_t, long,
2806 or whatever type is used to declare lseek offset's type in the
2807 kernel (which also appears to be lseek's return type).
2808
2809lseektype (lseektype.U):
2810 This variable defines lseektype to be something like off_t, long,
2811 or whatever type is used to declare lseek offset's type in the
2812 kernel (which also appears to be lseek's return type).
2813
2814mail (Loc.U):
2815 This variable is defined but not used by Configure.
2816 The value is a plain '' and is not useful.
2817
2818mailx (Loc.U):
2819 This variable is defined but not used by Configure.
2820 The value is a plain '' and is not useful.
2821
2822make (Loc.U):
5bf26616 2823 This variable is used internally by Configure to determine the
781b178c
JH
2824 full pathname (if any) of the make program. After Configure runs,
2825 the value is reset to a plain "make" and is not useful.
2826
2827make_set_make (make.U):
2828 Some versions of 'make' set the variable MAKE. Others do not.
2829 This variable contains the string to be included in Makefile.SH
2830 so that MAKE is set if needed, and not if not needed.
2831 Possible values are:
2832 make_set_make='#' # If your make program handles this for you,
2833 make_set_make="MAKE=$make" # if it doesn't.
2834 I used a comment character so that we can distinguish a
2835 'set' value (from a previous config.sh or Configure '-D' option)
2836 from an uncomputed value.
2837
2838mallocobj (mallocsrc.U):
2839 This variable contains the name of the malloc.o that this package
2840 generates, if that malloc.o is preferred over the system malloc.
2841 Otherwise the value is null. This variable is intended for generating
2842 Makefiles. See mallocsrc.
2843
2844mallocsrc (mallocsrc.U):
2845 This variable contains the name of the malloc.c that comes with
2846 the package, if that malloc.c is preferred over the system malloc.
2847 Otherwise the value is null. This variable is intended for generating
2848 Makefiles.
2849
2850malloctype (mallocsrc.U):
2851 This variable contains the kind of ptr returned by malloc and realloc.
2852
2853man1dir (man1dir.U):
2854 This variable contains the name of the directory in which manual
2855 source pages are to be put. It is the responsibility of the
2856 Makefile.SH to get the value of this into the proper command.
2857 You must be prepared to do the ~name expansion yourself.
2858
2859man1direxp (man1dir.U):
2860 This variable is the same as the man1dir variable, but is filename
2861 expanded at configuration time, for convenient use in makefiles.
2862
2863man1ext (man1dir.U):
2864 This variable contains the extension that the manual page should
2865 have: one of 'n', 'l', or '1'. The Makefile must supply the '.'.
2866 See man1dir.
2867
2868man3dir (man3dir.U):
2869 This variable contains the name of the directory in which manual
2870 source pages are to be put. It is the responsibility of the
2871 Makefile.SH to get the value of this into the proper command.
2872 You must be prepared to do the ~name expansion yourself.
2873
2874man3direxp (man3dir.U):
2875 This variable is the same as the man3dir variable, but is filename
2876 expanded at configuration time, for convenient use in makefiles.
2877
2878man3ext (man3dir.U):
2879 This variable contains the extension that the manual page should
2880 have: one of 'n', 'l', or '3'. The Makefile must supply the '.'.
2881 See man3dir.
2882
ff935051
JH
2883Mcc (Loc.U):
2884 This variable is used internally by Configure to determine the
2885 full pathname (if any) of the Mcc program. After Configure runs,
2886 the value is reset to a plain "Mcc" and is not useful.
2887
781b178c
JH
2888mips_type (usrinc.U):
2889 This variable holds the environment type for the mips system.
2890 Possible values are "BSD 4.3" and "System V".
2891
2892mkdir (Loc.U):
5bf26616 2893 This variable is used internally by Configure to determine the
781b178c
JH
2894 full pathname (if any) of the mkdir program. After Configure runs,
2895 the value is reset to a plain "mkdir" and is not useful.
2896
fe749a9f
JH
2897mmaptype (d_mmap.U):
2898 This symbol contains the type of pointer returned by mmap()
2899 (and simultaneously the type of the first argument).
2900 It can be 'void *' or 'caddr_t'.
2901
781b178c
JH
2902modetype (modetype.U):
2903 This variable defines modetype to be something like mode_t,
2904 int, unsigned short, or whatever type is used to declare file
2905 modes for system calls.
2906
2907more (Loc.U):
5bf26616 2908 This variable is used internally by Configure to determine the
781b178c
JH
2909 full pathname (if any) of the more program. After Configure runs,
2910 the value is reset to a plain "more" and is not useful.
2911
2912multiarch (multiarch.U):
2913 This variable conditionally defines the MULTIARCH symbol
2914 which signifies the presence of multiplatform files.
2915 This is normally set by hints files.
2916
2917mv (Loc.U):
2918 This variable is defined but not used by Configure.
2919 The value is a plain '' and is not useful.
2920
2921myarchname (archname.U):
2922 This variable holds the architecture name computed by Configure in
2923 a previous run. It is not intended to be perused by any user and
2924 should never be set in a hint file.
2925
2926mydomain (myhostname.U):
2927 This variable contains the eventual value of the MYDOMAIN symbol,
2928 which is the domain of the host the program is going to run on.
2929 The domain must be appended to myhostname to form a complete host name.
2930 The dot comes with mydomain, and need not be supplied by the program.
2931
2932myhostname (myhostname.U):
2933 This variable contains the eventual value of the MYHOSTNAME symbol,
2934 which is the name of the host the program is going to run on.
2935 The domain is not kept with hostname, but must be gotten from mydomain.
2936 The dot comes with mydomain, and need not be supplied by the program.
2937
2938myuname (Oldconfig.U):
2939 The output of 'uname -a' if available, otherwise the hostname. On Xenix,
2940 pseudo variables assignments in the output are stripped, thank you. The
2941 whole thing is then lower-cased.
2942
2943n (n.U):
2944 This variable contains the '-n' flag if that is what causes the echo
2945 command to suppress newline. Otherwise it is null. Correct usage is
2946 $echo $n "prompt for a question: $c".
2947
2cc61e15
DD
2948need_va_copy (need_va_copy.U):
2949 This symbol, if defined, indicates that the system stores
2950 the variable argument list datatype, va_list, in a format
2951 that cannot be copied by simple assignment, so that some
2952 other means must be used when copying is required.
2953 As such systems vary in their provision (or non-provision)
2954 of copying mechanisms, handy.h defines a platform-
2955 independent macro, Perl_va_copy(src, dst), to do the job.
2956
781b178c
JH
2957netdb_hlen_type (netdbtype.U):
2958 This variable holds the type used for the 2nd argument to
2959 gethostbyaddr(). Usually, this is int or size_t or unsigned.
2960 This is only useful if you have gethostbyaddr(), naturally.
2961
2962netdb_host_type (netdbtype.U):
2963 This variable holds the type used for the 1st argument to
2964 gethostbyaddr(). Usually, this is char * or void *, possibly
2965 with or without a const prefix.
2966 This is only useful if you have gethostbyaddr(), naturally.
2967
2968netdb_name_type (netdbtype.U):
2969 This variable holds the type used for the argument to
2970 gethostbyname(). Usually, this is char * or const char *.
2971 This is only useful if you have gethostbyname(), naturally.
2972
2973netdb_net_type (netdbtype.U):
2974 This variable holds the type used for the 1st argument to
2975 getnetbyaddr(). Usually, this is int or long.
2976 This is only useful if you have getnetbyaddr(), naturally.
2977
2978nm (Loc.U):
5bf26616 2979 This variable is used internally by Configure to determine the
781b178c
JH
2980 full pathname (if any) of the nm program. After Configure runs,
2981 the value is reset to a plain "nm" and is not useful.
2982
2983nm_opt (usenm.U):
2984 This variable holds the options that may be necessary for nm.
2985
2986nm_so_opt (usenm.U):
2987 This variable holds the options that may be necessary for nm
2988 to work on a shared library but that can not be used on an
2989 archive library. Currently, this is only used by Linux, where
2990 nm --dynamic is *required* to get symbols from an ELF library which
2991 has been stripped, but nm --dynamic is *fatal* on an archive library.
2992 Maybe Linux should just always set usenm=false.
2993
2994nonxs_ext (Extensions.U):
2995 This variable holds a list of all non-xs extensions included
2996 in the package. All of them will be built.
2997
2998nroff (Loc.U):
5bf26616 2999 This variable is used internally by Configure to determine the
781b178c
JH
3000 full pathname (if any) of the nroff program. After Configure runs,
3001 the value is reset to a plain "nroff" and is not useful.
3002
6b4667fc
A
3003nveformat (perlxvf.U):
3004 This variable contains the format string used for printing
3005 a Perl NV using %e-ish floating point format.
3006
6b356c8e 3007nvEUformat (perlxvf.U):
6b4667fc
A
3008 This variable contains the format string used for printing
3009 a Perl NV using %E-ish floating point format.
3010
3011nvfformat (perlxvf.U):
3012 This variable confains the format string used for printing
3013 a Perl NV using %f-ish floating point format.
3014
6b356c8e 3015nvFUformat (perlxvf.U):
6b4667fc
A
3016 This variable confains the format string used for printing
3017 a Perl NV using %F-ish floating point format.
3018
3019nvgformat (perlxvf.U):
3020 This variable contains the format string used for printing
3021 a Perl NV using %g-ish floating point format.
3022
6b356c8e 3023nvGUformat (perlxvf.U):
6b4667fc
A
3024 This variable contains the format string used for printing
3025 a Perl NV using %G-ish floating point format.
3026
a22e52b9
JH
3027nvsize (perlxv.U):
3028 This variable is the size of an NV in bytes.
3029
3030nvtype (perlxv.U):
3031 This variable contains the C type used for Perl's NV.
3032
781b178c
JH
3033o_nonblock (nblock_io.U):
3034 This variable bears the symbol value to be used during open() or fcntl()
3035 to turn on non-blocking I/O for a file descriptor. If you wish to switch
3036 between blocking and non-blocking, you may try ioctl(FIOSNBIO) instead,
3037 but that is only supported by some devices.
3038
3039obj_ext (Unix.U):
3040 This is an old synonym for _o.
3041
3042old_pthread_create_joinable (d_pthrattrj.U):
3043 This variable defines the constant to use for creating joinable
3044 (aka undetached) pthreads. Unused if pthread.h defines
3045 PTHREAD_CREATE_JOINABLE. If used, possible values are
3046 PTHREAD_CREATE_UNDETACHED and __UNDETACHED.
3047
3048optimize (ccflags.U):
3049 This variable contains any optimizer/debugger flag that should be used.
3050 It is up to the Makefile to use it.
3051
3052orderlib (orderlib.U):
3053 This variable is "true" if the components of libraries must be ordered
3054 (with `lorder $* | tsort`) before placing them in an archive. Set to
3055 "false" if ranlib or ar can generate random libraries.
3056
3057osname (Oldconfig.U):
3058 This variable contains the operating system name (e.g. sunos,
3059 solaris, hpux, etc.). It can be useful later on for setting
3060 defaults. Any spaces are replaced with underscores. It is set
3061 to a null string if we can't figure it out.
3062
3063osvers (Oldconfig.U):
3064 This variable contains the operating system version (e.g.
3065 4.1.3, 5.2, etc.). It is primarily used for helping select
3066 an appropriate hints file, but might be useful elsewhere for
3067 setting defaults. It is set to '' if we can't figure it out.
3068 We try to be flexible about how much of the version number
3069 to keep, e.g. if 4.1.1, 4.1.2, and 4.1.3 are essentially the
3070 same for this package, hints files might just be os_4.0 or
3071 os_4.1, etc., not keeping separate files for each little release.
3072
3b777bb4
GS
3073otherlibdirs (otherlibdirs.U):
3074 This variable contains a colon-separated set of paths for the perl
3075 binary to search for additional library files or modules.
3076 These directories will be tacked to the end of @INC.
3077 Perl will automatically search below each path for version-
3078 and architecture-specific directories. See inc_version_list
3079 for more details.
3080 A value of ' ' means 'none' and is used to preserve this value
3081 for the next run through Configure.
3082
781b178c
JH
3083package (package.U):
3084 This variable contains the name of the package being constructed.
3085 It is primarily intended for the use of later Configure units.
3086
3087pager (pager.U):
3088 This variable contains the name of the preferred pager on the system.
3089 Usual values are (the full pathnames of) more, less, pg, or cat.
3090
3091passcat (nis.U):
3092 This variable contains a command that produces the text of the
3093 /etc/passwd file. This is normally "cat /etc/passwd", but can be
3094 "ypcat passwd" when NIS is used.
aaacdc8b
GS
3095 On some systems, such as os390, there may be no equivalent
3096 command, in which case this variable is unset.
781b178c
JH
3097
3098patchlevel (patchlevel.U):
3099 The patchlevel level of this package.
3100 The value of patchlevel comes from the patchlevel.h file.
ff935051 3101 In a version number such as 5.6.1, this is the "6".
c890dc6c 3102 In patchlevel.h, this is referred to as "PERL_VERSION".
781b178c
JH
3103
3104path_sep (Unix.U):
3105 This is an old synonym for p_ in Head.U, the character
3106 used to separate elements in the command shell search PATH.
3107
c890dc6c
JH
3108perl5 (perl5.U):
3109 This variable contains the full path (if any) to a previously
3110 installed perl5.005 or later suitable for running the script
3111 to determine inc_version_list.
3112
781b178c 3113perl (Loc.U):
c890dc6c
JH
3114 This variable is defined but not used by Configure.
3115 The value is a plain '' and is not useful.
781b178c 3116
a6d26a0d
JH
3117perl_patchlevel (patchlevel.U):
3118 This is the Perl patch level, a numeric change identifier,
3119 as defined by whichever source code maintenance system
3120 is used to maintain the patches; currently Perforce.
3121 It does not correlate with the Perl version numbers or
3122 the maintenance versus development dichotomy except
3123 by also being increasing.
3124
ff935051
JH
3125PERL_REVISION (Oldsyms.U):
3126 In a Perl version number such as 5.6.2, this is the 5.
3127 This value is manually set in patchlevel.h
3128
3129PERL_SUBVERSION (Oldsyms.U):
3130 In a Perl version number such as 5.6.2, this is the 2.
3131 Values greater than 50 represent potentially unstable
3132 development subversions.
3133 This value is manually set in patchlevel.h
3134
3135PERL_VERSION (Oldsyms.U):
3136 In a Perl version number such as 5.6.2, this is the 6.
3137 This value is manually set in patchlevel.h
3138
781b178c
JH
3139perladmin (perladmin.U):
3140 Electronic mail address of the perl5 administrator.
3141
b7a73309
JH
3142perllibs (End.U):
3143 The list of libraries needed by Perl only (any libraries needed
3144 by extensions only will by dropped, if using dynamic loading).
3145
781b178c
JH
3146perlpath (perlpath.U):
3147 This variable contains the eventual value of the PERLPATH symbol,
3148 which contains the name of the perl interpreter to be used in
3149 shell scripts and in the "eval 'exec'" idiom.
3150
3151pg (Loc.U):
5bf26616 3152 This variable is used internally by Configure to determine the
781b178c
JH
3153 full pathname (if any) of the pg program. After Configure runs,
3154 the value is reset to a plain "pg" and is not useful.
3155
3156phostname (myhostname.U):
3157 This variable contains the eventual value of the PHOSTNAME symbol,
3158 which is a command that can be fed to popen() to get the host name.
3159 The program should probably not presume that the domain is or isn't
3160 there already.
3161
3162pidtype (pidtype.U):
3163 This variable defines PIDTYPE to be something like pid_t, int,
3164 ushort, or whatever type is used to declare process ids in the kernel.
3165
3166plibpth (libpth.U):
3167 Holds the private path used by Configure to find out the libraries.
3168 Its value is prepend to libpth. This variable takes care of special
3169 machines, like the mips. Usually, it should be empty.
3170
fe749a9f
JH
3171pm_apiversion (xs_apiversion.U):
3172 This variable contains the version of the oldest perl
3173 compatible with the present perl. (That is, pure perl modules
3174 written for $pm_apiversion will still work for the current
3175 version). perl.c:incpush() and lib/lib.pm will automatically
3176 search in $sitelib for older directories across major versions
3177 back to pm_apiversion. This is only useful if you have a perl
3178 library directory tree structured like the default one. The
3179 versioned site_perl library was introduced in 5.005, so that's
3180 the default setting for this variable. It's hard to imagine
3181 it changing before Perl6. It is included here for symmetry
3182 with xs_apiveprsion -- the searching algorithms will
3183 (presumably) be similar.
3184 See the INSTALL file for how this works.
3185
781b178c
JH
3186pmake (Loc.U):
3187 This variable is defined but not used by Configure.
3188 The value is a plain '' and is not useful.
3189
3190pr (Loc.U):
3191 This variable is defined but not used by Configure.
3192 The value is a plain '' and is not useful.
3193
3194prefix (prefix.U):
3195 This variable holds the name of the directory below which the
3196 user will install the package. Usually, this is /usr/local, and
3197 executables go in /usr/local/bin, library stuff in /usr/local/lib,
3198 man pages in /usr/local/man, etc. It is only used to set defaults
3199 for things in bin.U, mansrc.U, privlib.U, or scriptdir.U.
3200
3201prefixexp (prefix.U):
3202 This variable holds the full absolute path of the directory below
3203 which the user will install the package. Derived from prefix.
3204
3205privlib (privlib.U):
3206 This variable contains the eventual value of the PRIVLIB symbol,
3207 which is the name of the private library for this package. It may
3208 have a ~ on the front. It is up to the makefile to eventually create
3209 this directory while performing installation (with ~ substitution).
3210
3211privlibexp (privlib.U):
3212 This variable is the ~name expanded version of privlib, so that you
3213 may use it directly in Makefiles or shell scripts.
3214
428dc699
JH
3215procselfexe (d_procselfexe.U):
3216 If d_procselfexe is defined, $procselfexe is the filename
3217 of the symbolic link pointing to the absolute pathname of
3218 the executing program.
3219
781b178c
JH
3220prototype (prototype.U):
3221 This variable holds the eventual value of CAN_PROTOTYPE, which
3222 indicates the C compiler can handle funciton prototypes.
3223
3224ptrsize (ptrsize.U):
3225 This variable contains the value of the PTRSIZE symbol, which
3226 indicates to the C program how many bytes there are in a pointer.
3227
e0a10278 3228quadkind (quadtype.U):
0befd8de
JH
3229 This variable, if defined, encodes the type of a quad:
3230 1 = int, 2 = long, 3 = long long, 4 = int64_t.
3231
3232quadtype (quadtype.U):
3233 This variable defines Quad_t to be something like long, int,
3234 long long, int64_t, or whatever type is used for 64-bit integers.
3235
781b178c
JH
3236randbits (randfunc.U):
3237 Indicates how many bits are produced by the function used to
3238 generate normalized random numbers.
3239
3240randfunc (randfunc.U):
3241 Indicates the name of the random number function to use.
3242 Values include drand48, random, and rand. In C programs,
3243 the 'Drand01' macro is defined to generate uniformly distributed
3244 random numbers over the range [0., 1.[ (see drand01 and nrand).
3245
3246randseedtype (randfunc.U):
3247 Indicates the type of the argument of the seedfunc.
3248
3249ranlib (orderlib.U):
3250 This variable is set to the pathname of the ranlib program, if it is
3251 needed to generate random libraries. Set to ":" if ar can generate
3252 random libraries or if random libraries are not supported
3253
3254rd_nodata (nblock_io.U):
3255 This variable holds the return code from read() when no data is
3256 present. It should be -1, but some systems return 0 when O_NDELAY is
3257 used, which is a shame because you cannot make the difference between
3258 no data and an EOF.. Sigh!
3259
c890dc6c
JH
3260revision (patchlevel.U):
3261 The value of revision comes from the patchlevel.h file.
3262 In a version number such as 5.6.1, this is the "5".
3263 In patchlevel.h, this is referred to as "PERL_REVISION".
3264
781b178c 3265rm (Loc.U):
5bf26616 3266 This variable is used internally by Configure to determine the
781b178c
JH
3267 full pathname (if any) of the rm program. After Configure runs,
3268 the value is reset to a plain "rm" and is not useful.
3269
3270rmail (Loc.U):
3271 This variable is defined but not used by Configure.
3272 The value is a plain '' and is not useful.
3273
5440bc8e
JH
3274run (Cross.U):
3275 This variable contains the command used by Configure
3276 to copy and execute a cross-compiled executable in the
3277 target host. Useful and available only during Perl build.
3278 Empty string '' if not cross-compiling.
3279
781b178c
JH
3280runnm (usenm.U):
3281 This variable contains 'true' or 'false' depending whether the
3282 nm extraction should be performed or not, according to the value
3283 of usenm and the flags on the Configure command line.
3284
3285sched_yield (d_pthread_y.U):
3286 This variable defines the way to yield the execution
3287 of the current thread.
3288
3289scriptdir (scriptdir.U):
3290 This variable holds the name of the directory in which the user wants
3291 to put publicly scripts for the package in question. It is either
3292 the same directory as for binaries, or a special one that can be
3293 mounted across different architectures, like /usr/share. Programs
3294 must be prepared to deal with ~name expansion.
3295
3296scriptdirexp (scriptdir.U):
3297 This variable is the same as scriptdir, but is filename expanded
3298 at configuration time, for programs not wanting to bother with it.
3299
3300sed (Loc.U):
5bf26616 3301 This variable is used internally by Configure to determine the
781b178c
JH
3302 full pathname (if any) of the sed program. After Configure runs,
3303 the value is reset to a plain "sed" and is not useful.
3304
3305seedfunc (randfunc.U):
3306 Indicates the random number generating seed function.
3307 Values include srand48, srandom, and srand.
3308
3309selectminbits (selectminbits.U):
3310 This variable holds the minimum number of bits operated by select.
3311 That is, if you do select(n, ...), how many bits at least will be
3312 cleared in the masks if some activity is detected. Usually this
3313 is either n or 32*ceil(n/32), especially many little-endians do
3314 the latter. This is only useful if you have select(), naturally.
3315
3316selecttype (selecttype.U):
3317 This variable holds the type used for the 2nd, 3rd, and 4th
3318 arguments to select. Usually, this is 'fd_set *', if HAS_FD_SET
3319 is defined, and 'int *' otherwise. This is only useful if you
3320 have select(), naturally.
3321
3322sendmail (Loc.U):
ff935051
JH
3323 This variable is defined but not used by Configure.
3324 The value is a plain '' and is not useful.
781b178c
JH
3325
3326sh (sh.U):
3327 This variable contains the full pathname of the shell used
3328 on this system to execute Bourne shell scripts. Usually, this will be
3329 /bin/sh, though it's possible that some systems will have /bin/ksh,
3330 /bin/pdksh, /bin/ash, /bin/bash, or even something such as
3331 D:/bin/sh.exe.
3332 This unit comes before Options.U, so you can't set sh with a '-D'
3333 option, though you can override this (and startsh)
3334 with '-O -Dsh=/bin/whatever -Dstartsh=whatever'
3335
3336shar (Loc.U):
3337 This variable is defined but not used by Configure.
3338 The value is a plain '' and is not useful.
3339
3340sharpbang (spitshell.U):
3341 This variable contains the string #! if this system supports that
3342 construct.
3343
3344shmattype (d_shmat.U):
3345 This symbol contains the type of pointer returned by shmat().
3346 It can be 'void *' or 'char *'.
3347
3348shortsize (intsize.U):
3349 This variable contains the value of the SHORTSIZE symbol which
3350 indicates to the C program how many bytes there are in a short.
3351
3352shrpenv (libperl.U):
3353 If the user builds a shared libperl.so, then we need to tell the
3354 'perl' executable where it will be able to find the installed libperl.so.
3355 One way to do this on some systems is to set the environment variable
3356 LD_RUN_PATH to the directory that will be the final location of the
3357 shared libperl.so. The makefile can use this with something like
3358 $shrpenv $(CC) -o perl perlmain.o $libperl $libs
3359 Typical values are
3360 shrpenv="env LD_RUN_PATH=$archlibexp/CORE"
3361 or
3362 shrpenv=''
3363 See the main perl Makefile.SH for actual working usage.
3364 Alternatively, we might be able to use a command line option such
3365 as -R $archlibexp/CORE (Solaris, NetBSD) or -Wl,-rpath
3366 $archlibexp/CORE (Linux).
3367
3368shsharp (spitshell.U):
3369 This variable tells further Configure units whether your sh can
3370 handle # comments.
3371
3372sig_count (sig_name.U):
3373 This variable holds a number larger than the largest valid
3374 signal number. This is usually the same as the NSIG macro.
3375
3376sig_name (sig_name.U):
3377 This variable holds the signal names, space separated. The leading
3378 SIG in signal name is removed. A ZERO is prepended to the
3379 list. This is currently not used.
3380
3381sig_name_init (sig_name.U):
3382 This variable holds the signal names, enclosed in double quotes and
3383 separated by commas, suitable for use in the SIG_NAME definition
3384 below. A "ZERO" is prepended to the list, and the list is
3385 terminated with a plain 0. The leading SIG in signal names
3386 is removed. See sig_num.
3387
3388sig_num (sig_name.U):
3389 This variable holds the signal numbers, space separated. A ZERO is
3390 prepended to the list (corresponding to the fake SIGZERO), and
3391 the list is terminated with a 0. Those numbers correspond to
3392 the value of the signal listed in the same place within the
3393 sig_name list.
3394
3395sig_num_init (sig_name.U):
3396 This variable holds the signal numbers, enclosed in double quotes and
3397 separated by commas, suitable for use in the SIG_NUM definition
3398 below. A "ZERO" is prepended to the list, and the list is
3399 terminated with a plain 0.
3400
76d3c696
JH
3401sig_size (sig_name.U):
3402 This variable contains the number of elements of the sig_name
8966e0c4 3403 and sig_num arrays, excluding the final NULL entry.
76d3c696 3404
781b178c
JH
3405signal_t (d_voidsig.U):
3406 This variable holds the type of the signal handler (void or int).
3407
3408sitearch (sitearch.U):
3409 This variable contains the eventual value of the SITEARCH symbol,
3410 which is the name of the private library for this package. It may
3411 have a ~ on the front. It is up to the makefile to eventually create
3412 this directory while performing installation (with ~ substitution).
f868067f
JH
3413 The standard distribution will put nothing in this directory.
3414 After perl has been installed, users may install their own local
3415 architecture-dependent modules in this directory with
3416 MakeMaker Makefile.PL
3417 or equivalent. See INSTALL for details.
781b178c
JH
3418
3419sitearchexp (sitearch.U):
3420 This variable is the ~name expanded version of sitearch, so that you
3421 may use it directly in Makefiles or shell scripts.
3422
0617aed7
JH
3423sitebin (sitebin.U):
3424 This variable holds the name of the directory in which the user wants
3425 to put add-on publicly executable files for the package in question. It
3426 is most often a local directory such as /usr/local/bin. Programs using
3427 this variable must be prepared to deal with ~name substitution.
f868067f
JH
3428 The standard distribution will put nothing in this directory.
3429 After perl has been installed, users may install their own local
3430 executables in this directory with
3431 MakeMaker Makefile.PL
3432 or equivalent. See INSTALL for details.
0617aed7
JH
3433
3434sitebinexp (sitebin.U):
3435 This is the same as the sitebin variable, but is filename expanded at
3436 configuration time, for use in your makefiles.
3437
781b178c
JH
3438sitelib (sitelib.U):
3439 This variable contains the eventual value of the SITELIB symbol,
3440 which is the name of the private library for this package. It may
3441 have a ~ on the front. It is up to the makefile to eventually create
3442 this directory while performing installation (with ~ substitution).
f868067f
JH
3443 The standard distribution will put nothing in this directory.
3444 After perl has been installed, users may install their own local
3445 architecture-independent modules in this directory with
3446 MakeMaker Makefile.PL
3447 or equivalent. See INSTALL for details.
781b178c 3448
526fdc24
MS
3449sitelib_stem (sitelib.U):
3450 This variable is $sitelibexp with any trailing version-specific component
3451 removed. The elements in inc_version_list (inc_version_list.U) can
3452 be tacked onto this variable to generate a list of directories to search.
3453
781b178c
JH
3454sitelibexp (sitelib.U):
3455 This variable is the ~name expanded version of sitelib, so that you
3456 may use it directly in Makefiles or shell scripts.
3457
3458siteprefix (siteprefix.U):
3459 This variable holds the full absolute path of the directory below
3460 which the user will install add-on packages.
f868067f 3461 See INSTALL for usage and examples.
781b178c
JH
3462
3463siteprefixexp (siteprefix.U):
3464 This variable holds the full absolute path of the directory below
3465 which the user will install add-on packages. Derived from siteprefix.
3466
a13ea748
JH
3467sizesize (sizesize.U):
3468 This variable contains the size of a sizetype in bytes.
3469
781b178c
JH
3470sizetype (sizetype.U):
3471 This variable defines sizetype to be something like size_t,
3472 unsigned long, or whatever type is used to declare length
3473 parameters for string functions.
3474
3475sleep (Loc.U):
3476 This variable is defined but not used by Configure.
3477 The value is a plain '' and is not useful.
3478
3479smail (Loc.U):
3480 This variable is defined but not used by Configure.
3481 The value is a plain '' and is not useful.
3482
781b178c
JH
3483so (so.U):
3484 This variable holds the extension used to identify shared libraries
3485 (also known as shared objects) on the system. Usually set to 'so'.
3486
3487sockethdr (d_socket.U):
3488 This variable has any cpp '-I' flags needed for socket support.
3489
3490socketlib (d_socket.U):
3491 This variable has the names of any libraries needed for socket support.
3492
c890dc6c
JH
3493socksizetype (socksizetype.U):
3494 This variable holds the type used for the size argument
3495 for various socket calls like accept. Usual values include
3496 socklen_t, size_t, and int.
3497
781b178c 3498sort (Loc.U):
5bf26616 3499 This variable is used internally by Configure to determine the
781b178c
JH
3500 full pathname (if any) of the sort program. After Configure runs,
3501 the value is reset to a plain "sort" and is not useful.
3502
3503spackage (package.U):
3504 This variable contains the name of the package being constructed,
3505 with the first letter uppercased, i.e. suitable for starting
3506 sentences.
3507
3508spitshell (spitshell.U):
3509 This variable contains the command necessary to spit out a runnable
3510 shell on this system. It is either cat or a grep '-v' for # comments.
3511
ff935051
JH
3512sPRId64 (quadfio.U):
3513 This variable, if defined, contains the string used by stdio to
3514 format 64-bit decimal numbers (format 'd') for output.
3515
3516sPRIeldbl (longdblfio.U):
3517 This variable, if defined, contains the string used by stdio to
3518 format long doubles (format 'e') for output.
3519
6b356c8e 3520sPRIEUldbl (longdblfio.U):
ff935051
JH
3521 This variable, if defined, contains the string used by stdio to
3522 format long doubles (format 'E') for output.
6b356c8e
JH
3523 The 'U' in the name is to separate this from sPRIeldbl so that even
3524 case-blind systems can see the difference.
ff935051
JH
3525
3526sPRIfldbl (longdblfio.U):
3527 This variable, if defined, contains the string used by stdio to
3528 format long doubles (format 'f') for output.
3529
6b356c8e 3530sPRIFUldbl (longdblfio.U):
ff935051
JH
3531 This variable, if defined, contains the string used by stdio to
3532 format long doubles (format 'F') for output.
6b356c8e
JH
3533 The 'U' in the name is to separate this from sPRIfldbl so that even
3534 case-blind systems can see the difference.
ff935051
JH
3535
3536sPRIgldbl (longdblfio.U):
3537 This variable, if defined, contains the string used by stdio to
3538 format long doubles (format 'g') for output.
3539
6b356c8e 3540sPRIGUldbl (longdblfio.U):
ff935051
JH
3541 This variable, if defined, contains the string used by stdio to
3542 format long doubles (format 'G') for output.
6b356c8e
JH
3543 The 'U' in the name is to separate this from sPRIgldbl so that even
3544 case-blind systems can see the difference.
ff935051
JH
3545
3546sPRIi64 (quadfio.U):
3547 This variable, if defined, contains the string used by stdio to
3548 format 64-bit decimal numbers (format 'i') for output.
3549
3550sPRIo64 (quadfio.U):
3551 This variable, if defined, contains the string used by stdio to
3552 format 64-bit octal numbers (format 'o') for output.
3553
3554sPRIu64 (quadfio.U):
3555 This variable, if defined, contains the string used by stdio to
3556 format 64-bit unsigned decimal numbers (format 'u') for output.
3557
3558sPRIx64 (quadfio.U):
3559 This variable, if defined, contains the string used by stdio to
3560 format 64-bit hexadecimal numbers (format 'x') for output.
3561
6b356c8e 3562sPRIXU64 (quadfio.U):
ff935051
JH
3563 This variable, if defined, contains the string used by stdio to
3564 format 64-bit hExADECimAl numbers (format 'X') for output.
6b356c8e
JH
3565 The 'U' in the name is to separate this from sPRIx64 so that even
3566 case-blind systems can see the difference.
ff935051 3567
781b178c
JH
3568src (src.U):
3569 This variable holds the path to the package source. It is up to
3570 the Makefile to use this variable and set VPATH accordingly to
3571 find the sources remotely.
3572
6b356c8e
JH
3573sSCNfldbl (longdblfio.U):
3574 This variable, if defined, contains the string used by stdio to
3575 format long doubles (format 'f') for input.
3576
781b178c
JH
3577ssizetype (ssizetype.U):
3578 This variable defines ssizetype to be something like ssize_t,
3579 long or int. It is used by functions that return a count
3580 of bytes or an error condition. It must be a signed type.
3581 We will pick a type such that sizeof(SSize_t) == sizeof(Size_t).
3582
3583startperl (startperl.U):
3584 This variable contains the string to put on the front of a perl
3585 script to make sure (hopefully) that it runs with perl and not some
3586 shell. Of course, that leading line must be followed by the classical
3587 perl idiom:
3588 eval 'exec perl -S $0 ${1+"$@"}'
3589 if $running_under_some_shell;
3590 to guarantee perl startup should the shell execute the script. Note
3591 that this magic incatation is not understood by csh.
3592
3593startsh (startsh.U):
3594 This variable contains the string to put on the front of a shell
3595 script to make sure (hopefully) that it runs with sh and not some
3596 other shell.
3597
3598static_ext (Extensions.U):
3599 This variable holds a list of XS extension files we want to
3600 link statically into the package. It is used by Makefile.
3601
3602stdchar (stdchar.U):
3603 This variable conditionally defines STDCHAR to be the type of char
3604 used in stdio.h. It has the values "unsigned char" or "char".
3605
3606stdio_base (d_stdstdio.U):
3607 This variable defines how, given a FILE pointer, fp, to access the
3608 _base field (or equivalent) of stdio.h's FILE structure. This will
3609 be used to define the macro FILE_base(fp).
3610
3611stdio_bufsiz (d_stdstdio.U):
3612 This variable defines how, given a FILE pointer, fp, to determine
3613 the number of bytes store in the I/O buffer pointer to by the
3614 _base field (or equivalent) of stdio.h's FILE structure. This will
3615 be used to define the macro FILE_bufsiz(fp).
3616
3617stdio_cnt (d_stdstdio.U):
3618 This variable defines how, given a FILE pointer, fp, to access the
3619 _cnt field (or equivalent) of stdio.h's FILE structure. This will
3620 be used to define the macro FILE_cnt(fp).
3621
3622stdio_filbuf (d_stdstdio.U):
3623 This variable defines how, given a FILE pointer, fp, to tell
022735b4 3624 stdio to refill its internal buffers (?). This will
781b178c
JH
3625 be used to define the macro FILE_filbuf(fp).
3626
3627stdio_ptr (d_stdstdio.U):
3628 This variable defines how, given a FILE pointer, fp, to access the
3629 _ptr field (or equivalent) of stdio.h's FILE structure. This will
3630 be used to define the macro FILE_ptr(fp).
3631
3632stdio_stream_array (stdio_streams.U):
3633 This variable tells the name of the array holding the stdio streams.
3634 Usual values include _iob, __iob, and __sF.
3635
3636strings (i_string.U):
3637 This variable holds the full path of the string header that will be
3638 used. Typically /usr/include/string.h or /usr/include/strings.h.
3639
3640submit (Loc.U):
3641 This variable is defined but not used by Configure.
3642 The value is a plain '' and is not useful.
3643
3644subversion (patchlevel.U):
3645 The subversion level of this package.
3646 The value of subversion comes from the patchlevel.h file.
ff935051 3647 In a version number such as 5.6.1, this is the "1".
c890dc6c 3648 In patchlevel.h, this is referred to as "PERL_SUBVERSION".
781b178c
JH
3649 This is unique to perl.
3650
3651sysman (sysman.U):
3652 This variable holds the place where the manual is located on this
3653 system. It is not the place where the user wants to put his manual
3654 pages. Rather it is the place where Configure may look to find manual
3655 for unix commands (section 1 of the manual usually). See mansrc.
3656
3657tail (Loc.U):
3658 This variable is defined but not used by Configure.
3659 The value is a plain '' and is not useful.
3660
3661tar (Loc.U):
3662 This variable is defined but not used by Configure.
3663 The value is a plain '' and is not useful.
3664
5440bc8e
JH
3665targetarch (Cross.U):
3666 If cross-compiling, this variable contains the target architecture.
3667 If not, this will be empty.
3668
781b178c
JH
3669tbl (Loc.U):
3670 This variable is defined but not used by Configure.
3671 The value is a plain '' and is not useful.
3672
3673tee (Loc.U):
3674 This variable is defined but not used by Configure.
3675 The value is a plain '' and is not useful.
3676
3677test (Loc.U):
5bf26616 3678 This variable is used internally by Configure to determine the
781b178c
JH
3679 full pathname (if any) of the test program. After Configure runs,
3680 the value is reset to a plain "test" and is not useful.
3681
3682timeincl (i_time.U):
3683 This variable holds the full path of the included time header(s).
3684
3685timetype (d_time.U):
3686 This variable holds the type returned by time(). It can be long,
3687 or time_t on BSD sites (in which case <sys/types.h> should be
3688 included). Anyway, the type Time_t should be used.
3689
5440bc8e
JH
3690to (Cross.U):
3691 This variable contains the command used by Configure
3692 to copy to from the target host. Useful and available
3693 only during Perl build.
3694 The string ':' if not cross-compiling.
3695
781b178c 3696touch (Loc.U):
5bf26616 3697 This variable is used internally by Configure to determine the
781b178c
JH
3698 full pathname (if any) of the touch program. After Configure runs,
3699 the value is reset to a plain "touch" and is not useful.
3700
3701tr (Loc.U):
5bf26616 3702 This variable is used internally by Configure to determine the
781b178c
JH
3703 full pathname (if any) of the tr program. After Configure runs,
3704 the value is reset to a plain "tr" and is not useful.
3705
3706trnl (trnl.U):
3707 This variable contains the value to be passed to the tr(1)
3708 command to transliterate a newline. Typical values are
3709 '\012' and '\n'. This is needed for EBCDIC systems where
3710 newline is not necessarily '\012'.
3711
3712troff (Loc.U):
3713 This variable is defined but not used by Configure.
3714 The value is a plain '' and is not useful.
3715
a22e52b9
JH
3716u16size (perlxv.U):
3717 This variable is the size of an U16 in bytes.
3718
3719u16type (perlxv.U):
3720 This variable contains the C type used for Perl's U16.
3721
3722u32size (perlxv.U):
3723 This variable is the size of an U32 in bytes.
3724
3725u32type (perlxv.U):
3726 This variable contains the C type used for Perl's U32.
3727
3728u64size (perlxv.U):
3729 This variable is the size of an U64 in bytes.
3730
3731u64type (perlxv.U):
3732 This variable contains the C type used for Perl's U64.
3733
3734u8size (perlxv.U):
3735 This variable is the size of an U8 in bytes.
3736
3737u8type (perlxv.U):
3738 This variable contains the C type used for Perl's U8.
3739
3740uidformat (uidf.U):
3741 This variable contains the format string used for printing a Uid_t.
3742
2d228ff3
JH
3743uidsign (uidsign.U):
3744 This variable contains the signedness of a uidtype.
3745 1 for unsigned, -1 for signed.
3746
785fb66b
JH
3747uidsize (uidsize.U):
3748 This variable contains the size of a uidtype in bytes.
3749
781b178c
JH
3750uidtype (uidtype.U):
3751 This variable defines Uid_t to be something like uid_t, int,
3752 ushort, or whatever type is used to declare user ids in the kernel.
3753
3754uname (Loc.U):
5bf26616 3755 This variable is used internally by Configure to determine the
781b178c
JH
3756 full pathname (if any) of the uname program. After Configure runs,
3757 the value is reset to a plain "uname" and is not useful.
3758
3759uniq (Loc.U):
5bf26616 3760 This variable is used internally by Configure to determine the
781b178c
JH
3761 full pathname (if any) of the uniq program. After Configure runs,
3762 the value is reset to a plain "uniq" and is not useful.
3763
0befd8de
JH
3764uquadtype (quadtype.U):
3765 This variable defines Uquad_t to be something like unsigned long,
3766 unsigned int, unsigned long long, uint64_t, or whatever type is
3767 used for 64-bit integers.
3768
aaacdc8b
GS
3769use5005threads (usethreads.U):
3770 This variable conditionally defines the USE_5005THREADS symbol,
3771 and indicates that Perl should be built to use the 5.005-based
3772 threading implementation.
3773
10cc9d2a
JH
3774use64bitall (use64bits.U):
3775 This variable conditionally defines the USE_64_BIT_ALL symbol,
3776 and indicates that 64-bit integer types should be used
3777 when available. The maximal possible
3778 64-bitness is employed: LP64 or ILP64, meaning that you will
3779 be able to use more than 2 gigabytes of memory. This mode is
3780 even more binary incompatible than USE_64_BIT_INT. You may not
3781 be able to run the resulting executable in a 32-bit CPU at all or
3782 you may need at least to reboot your OS to 64-bit mode.
3783
3784use64bitint (use64bits.U):
3785 This variable conditionally defines the USE_64_BIT_INT symbol,
aaacdc8b 3786 and indicates that 64-bit integer types should be used
c890dc6c
JH
3787 when available. The minimal possible 64-bitness
3788 is employed, just enough to get 64-bit integers into Perl.
3789 This may mean using for example "long longs", while your memory
3790 may still be limited to 2 gigabytes.
781b178c 3791
5440bc8e
JH
3792usecrosscompile (Cross.U):
3793 This variable conditionally defines the USE_CROSS_COMPILE symbol,
3794 and indicates that Perl has been cross-compiled.
3795
781b178c 3796usedl (dlsrc.U):
ff935051 3797 This variable indicates if the system supports dynamic
781b178c
JH
3798 loading of some sort. See also dlsrc and dlobj.
3799
aaacdc8b
GS
3800useithreads (usethreads.U):
3801 This variable conditionally defines the USE_ITHREADS symbol,
3802 and indicates that Perl should be built to use the interpreter-based
3803 threading implementation.
3804
5bf26616 3805uselargefiles (uselfs.U):
1baac590
JH
3806 This variable conditionally defines the USE_LARGE_FILES symbol,
3807 and indicates that large file interfaces should be used when
c890dc6c 3808 available.
1baac590 3809
ca24dfc6
LV
3810uselongdouble (uselongdbl.U):
3811 This variable conditionally defines the USE_LONG_DOUBLE symbol,
3812 and indicates that long doubles should be used when available.
3813
1baac590
JH
3814usemorebits (usemorebits.U):
3815 This variable conditionally defines the USE_MORE_BITS symbol,
3816 and indicates that explicit 64-bit interfaces and long doubles
3817 should be used when available.
3818
781b178c
JH
3819usemultiplicity (usemultiplicity.U):
3820 This variable conditionally defines the MULTIPLICITY symbol,
3821 and indicates that Perl should be built to use multiplicity.
3822
3823usemymalloc (mallocsrc.U):
3824 This variable contains y if the malloc that comes with this package
3825 is desired over the system's version of malloc. People often include
3826 special versions of malloc for effiency, but such versions are often
3827 less portable. See also mallocsrc and mallocobj.
3828 If this is 'y', then -lmalloc is removed from $libs.
3829
3830usenm (usenm.U):
3831 This variable contains 'true' or 'false' depending whether the
3832 nm extraction is wanted or not.
3833
3834useopcode (Extensions.U):
3835 This variable holds either 'true' or 'false' to indicate
3836 whether the Opcode extension should be used. The sole
3837 use for this currently is to allow an easy mechanism
3838 for users to skip the Opcode extension from the Configure
3839 command line.
3840
3841useperlio (useperlio.U):
3842 This variable conditionally defines the USE_PERLIO symbol,
3843 and indicates that the PerlIO abstraction should be
3844 used throughout.
3845
3846useposix (Extensions.U):
3847 This variable holds either 'true' or 'false' to indicate
3848 whether the POSIX extension should be used. The sole
3849 use for this currently is to allow an easy mechanism
3850 for hints files to indicate that POSIX will not compile
3851 on a particular system.
3852
9514c62b
JH
3853usereentrant (usethreads.U):
3854 This variable conditionally defines the USE_REENTRANT_API symbol,
3855 which indicates that the thread code may try to use the various
3856 _r versions of library functions. This is only potentially
3857 meaningful if usethreads is set and is very experimental, it is
3858 not even prompted for.
3859
781b178c
JH
3860usesfio (d_sfio.U):
3861 This variable is set to true when the user agrees to use sfio.
3862 It is set to false when sfio is not available or when the user
3863 explicitely requests not to use sfio. It is here primarily so
3864 that command-line settings can override the auto-detection of
3865 d_sfio without running into a "WHOA THERE".
3866
3867useshrplib (libperl.U):
3868 This variable is set to 'yes' if the user wishes
3869 to build a shared libperl, and 'no' otherwise.
3870
3871usesocks (usesocks.U):
3872 This variable conditionally defines the USE_SOCKS symbol,
3873 and indicates that Perl should be built to use SOCKS.
3874
3875usethreads (usethreads.U):
b99a9337 3876 This variable conditionally defines the USE_THREADS symbol,
781b178c
JH
3877 and indicates that Perl should be built to use threads.
3878
9f50e519
NA
3879usevendorprefix (vendorprefix.U):
3880 This variable tells whether the vendorprefix
3881 and consequently other vendor* paths are in use.
3882
781b178c
JH
3883usevfork (d_vfork.U):
3884 This variable is set to true when the user accepts to use vfork.
3885 It is set to false when no vfork is available or when the user
3886 explicitely requests not to use vfork.
3887
3888usrinc (usrinc.U):
3889 This variable holds the path of the include files, which is
3890 usually /usr/include. It is mainly used by other Configure units.
3891
3892uuname (Loc.U):
3893 This variable is defined but not used by Configure.
3894 The value is a plain '' and is not useful.
3895
a22e52b9
JH
3896uvoformat (perlxvf.U):
3897 This variable contains the format string used for printing
3898 a Perl UV as an unsigned octal integer.
3899
3900uvsize (perlxv.U):
3901 This variable is the size of a UV in bytes.
3902
3903uvtype (perlxv.U):
3904 This variable contains the C type used for Perl's UV.
3905
3906uvuformat (perlxvf.U):
3907 This variable contains the format string used for printing
3908 a Perl UV as an unsigned decimal integer.
3909
3910uvxformat (perlxvf.U):
3911 This variable contains the format string used for printing
6b4667fc
A
3912 a Perl UV as an unsigned hexadecimal integer in lowercase abcdef.
3913
6b356c8e 3914uvXUformat (perlxvf.U):
6b4667fc
A
3915 This variable contains the format string used for printing
3916 a Perl UV as an unsigned hexadecimal integer in uppercase ABCDEF.
a22e52b9 3917
526fdc24
MS
3918vendorarch (vendorarch.U):
3919 This variable contains the value of the PERL_VENDORARCH symbol.
3920 It may have a ~ on the front.
3921 The standard distribution will put nothing in this directory.
3922 Vendors who distribute perl may wish to place their own
3923 architecture-dependent modules and extensions in this directory with
3924 MakeMaker Makefile.PL INSTALLDIRS=vendor
3925 or equivalent. See INSTALL for details.
3926
3927vendorarchexp (vendorarch.U):
3928 This variable is the ~name expanded version of vendorarch, so that you
3929 may use it directly in Makefiles or shell scripts.
3930
0617aed7 3931vendorbin (vendorbin.U):
f868067f
JH
3932 This variable contains the eventual value of the VENDORBIN symbol.
3933 It may have a ~ on the front.
3934 The standard distribution will put nothing in this directory.
3935 Vendors who distribute perl may wish to place additional
3936 binaries in this directory with
3937 MakeMaker Makefile.PL INSTALLDIRS=vendor
3938 or equivalent. See INSTALL for details.
0617aed7
JH
3939
3940vendorbinexp (vendorbin.U):
3941 This variable is the ~name expanded version of vendorbin, so that you
3942 may use it directly in Makefiles or shell scripts.
3943
a3635516
JH
3944vendorlib (vendorlib.U):
3945 This variable contains the eventual value of the VENDORLIB symbol,
f868067f
JH
3946 which is the name of the private library for this package.
3947 The standard distribution will put nothing in this directory.
3948 Vendors who distribute perl may wish to place their own
3949 modules in this directory with
3950 MakeMaker Makefile.PL INSTALLDIRS=vendor
3951 or equivalent. See INSTALL for details.
a3635516 3952
526fdc24
MS
3953vendorlib_stem (vendorlib.U):
3954 This variable is $vendorlibexp with any trailing version-specific component
3955 removed. The elements in inc_version_list (inc_version_list.U) can
3956 be tacked onto this variable to generate a list of directories to search.
3957
a3635516
JH
3958vendorlibexp (vendorlib.U):
3959 This variable is the ~name expanded version of vendorlib, so that you
3960 may use it directly in Makefiles or shell scripts.
3961
3962vendorprefix (vendorprefix.U):
3963 This variable holds the full absolute path of the directory below
3964 which the vendor will install add-on packages.
f868067f 3965 See INSTALL for usage and examples.
a3635516
JH
3966
3967vendorprefixexp (vendorprefix.U):
3968 This variable holds the full absolute path of the directory below
3969 which the vendor will install add-on packages. Derived from vendorprefix.
3970
781b178c 3971version (patchlevel.U):
ff935051 3972 The full version number of this package, such as 5.6.1 (or 5_6_1).
c890dc6c 3973 This combines revision, patchlevel, and subversion to get the
ff935051
JH
3974 full version number, including any possible subversions.
3975 This is suitable for use as a directory name, and hence is
3976 filesystem dependent.
781b178c 3977
27713a04
JH
3978version_patchlevel_string (patchlevel.U):
3979 This is a string combining version, subversion and
3980 perl_patchlevel (if perl_patchlevel is non-zero).
3981 It is typically something like
3982 'version 7 subversion 1' or
3983 'version 7 subversion 1 patchlevel 11224'
3984 It is computed here to avoid duplication of code in myconfig.SH
3985 and lib/Config.pm.
3986
d56c5707
JH
3987versiononly (versiononly.U):
3988 If set, this symbol indicates that only the version-specific
3989 components of a perl installation should be installed.
3990 This may be useful for making a test installation of a new
3991 version without disturbing the existing installation.
3992 Setting versiononly is equivalent to setting installperl's -v option.
3993 In particular, the non-versioned scripts and programs such as
3994 a2p, c2ph, h2xs, pod2*, and perldoc are not installed
3995 (see INSTALL for a more complete list). Nor are the man
3996 pages installed.
3997 Usually, this is undef.
3998
781b178c
JH
3999vi (Loc.U):
4000 This variable is defined but not used by Configure.
4001 The value is a plain '' and is not useful.
4002
4003voidflags (voidflags.U):
4004 This variable contains the eventual value of the VOIDFLAGS symbol,
4005 which indicates how much support of the void type is given by this
4006 compiler. See VOIDFLAGS for more info.
4007
4008xlibpth (libpth.U):
4009 This variable holds extra path (space-separated) used to find
4010 libraries on this platform, for example CPU-specific libraries
4011 (on multi-CPU platforms) may be listed here.
4012
fe749a9f
JH
4013xs_apiversion (xs_apiversion.U):
4014 This variable contains the version of the oldest perl binary
4015 compatible with the present perl. perl.c:incpush() and
4016 lib/lib.pm will automatically search in $sitearch for older
4017 directories across major versions back to xs_apiversion.
4018 This is only useful if you have a perl library directory tree
4019 structured like the default one.
4020 See INSTALL for how this works.
4021 The versioned site_perl directory was introduced in 5.005,
4022 so that is the lowest possible value.
4023 Since this can depend on compile time options (such as
4024 bincompat) it is set by Configure. Other non-default sources
4025 of potential incompatibility, such as multiplicity, threads,
4026 debugging, 64bits, sfio, etc., are not checked for currently,
4027 though in principle we could go snooping around in old
4028 Config.pm files.
4029
2d967e39
JH
4030yacc (yacc.U):
4031 This variable holds the name of the compiler compiler we
4032 want to use in the Makefile. It can be yacc, byacc, or bison -y.
4033
4034yaccflags (yacc.U):
4035 This variable contains any additional yacc flags desired by the
4036 user. It is up to the Makefile to use this.
4037
781b178c
JH
4038zcat (Loc.U):
4039 This variable is defined but not used by Configure.
4040 The value is a plain '' and is not useful.
4041
4042zip (Loc.U):
5bf26616 4043 This variable is used internally by Configure to determine the
781b178c
JH
4044 full pathname (if any) of the zip program. After Configure runs,
4045 the value is reset to a plain "zip" and is not useful.
4046