1 This file contains a description of all the shell variables whose value is
2 determined by the Configure script. Variables intended for use in C
3 programs (e.g. I_UNISTD) are already described in config_h.SH. [`configpm'
4 generates pod documentation for Config.pm from this file--please try to keep
5 the formatting regular.]
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'.
13 This variable defines the extension used for executable files.
14 For unix it is empty. Other possible values include '.exe'.
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'.
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
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.
33 alignbytes (alignbytes.U):
34 This variable holds the number of bytes required to align a
35 double-- or a long double when applicable. Usual values are
36 2, 4 and 8. The default is eight, for safety.
38 ansi2knr (ansi2knr.U):
39 This variable is set if the user needs to run ansi2knr.
40 Currently, this is not supported, so we just abort.
42 aphostname (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.
47 api_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,
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.
70 api_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
77 api_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.)
86 api_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.
92 This variable is used internally by Configure to determine the
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.
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.
103 archlibexp (archlib.U):
104 This variable is the same as the archlib variable, but is
105 filename expanded at configuration time, for convenient use.
107 archname64 (use64bits.U):
108 This variable is used for the 64-bitness part of $archname.
110 archname (archname.U):
111 This variable is a short name to characterize the current
112 architecture. It is used mainly to construct the default archlib.
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
122 This variable is used internally by Configure to determine the
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.
127 The base revision level of this package, from the .package file.
130 This variable is defined but not used by Configure.
131 The value is a plain '' and is not useful.
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.
139 bincompat5005 (bincompat5005.U):
140 This variable contains y if this version of Perl should be
141 binary-compatible with Perl 5.005.
144 This is the same as the bin variable, but is filename expanded at
145 configuration time, for use in your makefiles.
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.
153 This variable is used internally by Configure to determine the
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.
157 byteorder (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 !
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".
168 castflags (d_castneg.U):
169 This variable contains a flag that precise difficulties the
170 compiler has casting odd floating values to unsigned long:
172 1 = couldn't cast < 0
173 2 = couldn't cast >= 0x80000000
174 4 = couldn't cast in argument expression list
177 This variable is used internally by Configure to determine the
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.
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
184 name. Usual values are 'cc' and 'gcc'.
185 Fervent ANSI compilers may be called 'c89'. AIX has xlc.
187 cccdlflags (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.
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
200 This variable contains any additional C compiler flags desired by
201 the user. It is up to the Makefile to use this.
203 ccflags_uselargefiles (uselfs.U):
204 This variable contains the compiler flags needed by large file builds
205 and added to ccflags by hints files.
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'.
214 ccsymbols (Cppsym.U):
215 The variable contains the symbols defined by the C compiler alone.
216 The symbols defined by cpp or by cc when it calls cpp are not in
217 this list, see cppsymbols and cppccsymbols.
218 The list is a space-separated list of symbol=value tokens.
220 ccversion (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
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.
229 cf_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.
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.
237 charsize (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.
242 This variable is defined but not used by Configure.
243 The value is a plain '' and is not useful.
246 This variable is defined but not used by Configure.
247 The value is a plain '' and is not useful.
250 This variable is defined but not used by Configure.
251 The value is a plain '' and is not useful.
253 clocktype (d_times.U):
254 This variable holds the type returned by times(). It can be long,
255 or clock_t on BSD sites (in which case <sys/types.h> should be
259 This variable is used internally by Configure to determine the
260 full pathname (if any) of the comm program. After Configure runs,
261 the value is reset to a plain "comm" and is not useful.
264 This variable is defined but not used by Configure.
265 The value is a plain '' and is not useful.
267 contains (contains.U):
268 This variable holds the command to do a grep with a proper return
269 status. On most sane systems it is simply "grep". On insane systems
270 it is a grep followed by a cat followed by a test. This variable
271 is primarily for the use of other Configure units.
274 This variable is used internally by Configure to determine the
275 full pathname (if any) of the cp program. After Configure runs,
276 the value is reset to a plain "cp" and is not useful.
279 This variable is defined but not used by Configure.
280 The value is a plain '' and is not useful.
283 This variable is used internally by Configure to determine the
284 full pathname (if any) of the cpp program. After Configure runs,
285 the value is reset to a plain "cpp" and is not useful.
287 cpp_stuff (cpp_stuff.U):
288 This variable contains an identification of the catenation mechanism
289 used by the C preprocessor.
291 cppccsymbols (Cppsym.U):
292 The variable contains the symbols defined by the C compiler
293 when it calls cpp. The symbols defined by the cc alone or cpp
294 alone are not in this list, see ccsymbols and cppsymbols.
295 The list is a space-separated list of symbol=value tokens.
297 cppflags (ccflags.U):
298 This variable holds the flags that will be passed to the C pre-
299 processor. It is up to the Makefile to use it.
301 cpplast (cppstdin.U):
302 This variable has the same functionality as cppminus, only it applies
303 to cpprun and not cppstdin.
305 cppminus (cppstdin.U):
306 This variable contains the second part of the string which will invoke
307 the C preprocessor on the standard input and produce to standard
308 output. This variable will have the value "-" if cppstdin needs
309 a minus to specify standard input, otherwise the value is "".
312 This variable contains the command which will invoke a C preprocessor
313 on standard input and put the output to stdout. It is guaranteed not
314 to be a wrapper and may be a null string if no preprocessor can be
315 made directly available. This preprocessor might be different from the
316 one used by the C compiler. Don't forget to append cpplast after the
317 preprocessor options.
319 cppstdin (cppstdin.U):
320 This variable contains the command which will invoke the C
321 preprocessor on standard input and put the output to stdout.
322 It is primarily used by other Configure units that ask about
323 preprocessor symbols.
325 cppsymbols (Cppsym.U):
326 The variable contains the symbols defined by the C preprocessor
327 alone. The symbols defined by cc or by cc when it calls cpp are
328 not in this list, see ccsymbols and cppccsymbols.
329 The list is a space-separated list of symbol=value tokens.
331 cryptlib (d_crypt.U):
332 This variable holds -lcrypt or the path to a libcrypt.a archive if
333 the crypt() function is not defined in the standard C library. It is
334 up to the Makefile to use this.
337 This variable is used internally by Configure to determine the
338 full pathname (if any) of the csh program. After Configure runs,
339 the value is reset to a plain "csh" and is not useful.
341 d__fwalk (d__fwalk.U):
342 This variable conditionally defines HAS__FWALK if _fwalk() is
343 available to apply a function to all the file handles.
345 d_access (d_access.U):
346 This variable conditionally defines HAS_ACCESS if the access() system
347 call is available to check for access permissions using real IDs.
349 d_accessx (d_accessx.U):
350 This variable conditionally defines the HAS_ACCESSX symbol, which
351 indicates to the C program that the accessx() routine is available.
354 This variable conditionally defines the HAS_ALARM symbol, which
355 indicates to the C program that the alarm() routine is available.
357 d_archlib (archlib.U):
358 This variable conditionally defines ARCHLIB to hold the pathname
359 of architecture-dependent library files for $package. If
360 $archlib is the same as $privlib, then this is set to undef.
363 This variable conditionally defines the HAS_ATOLF symbol, which
364 indicates to the C program that the atolf() routine is available.
367 This variable conditionally defines the HAS_ATOLL symbol, which
368 indicates to the C program that the atoll() routine is available.
370 d_attribut (d_attribut.U):
371 This variable conditionally defines HASATTRIBUTE, which
372 indicates the C compiler can check for function attributes,
373 such as printf formats.
376 This variable conditionally defines the HAS_BCMP symbol if
377 the bcmp() routine is available to compare strings.
380 This variable conditionally defines the HAS_BCOPY symbol if
381 the bcopy() routine is available to copy strings.
383 d_bincompat5005 (bincompat5005.U):
384 This variable conditionally defines BINCOMPAT5005 so that embed.h
385 can take special action if this version of Perl should be
386 binary-compatible with Perl 5.005. This is impossible for builds
387 that use features like threads and multiplicity it is always $undef
391 This symbol conditionally defines the symbol BSD when running on a
394 d_bsdgetpgrp (d_getpgrp.U):
395 This variable conditionally defines USE_BSD_GETPGRP if
396 getpgrp needs one arguments whereas USG one needs none.
398 d_bsdsetpgrp (d_setpgrp.U):
399 This variable conditionally defines USE_BSD_SETPGRP if
400 setpgrp needs two arguments whereas USG one needs none.
401 See also d_setpgid for a POSIX interface.
404 This variable conditionally defines the HAS_BZERO symbol if
405 the bzero() routine is available to set memory to 0.
407 d_casti32 (d_casti32.U):
408 This variable conditionally defines CASTI32, which indicates
409 whether the C compiler can cast large floats to 32-bit ints.
411 d_castneg (d_castneg.U):
412 This variable conditionally defines CASTNEG, which indicates
413 wether the C compiler can cast negative float to unsigned.
415 d_charvspr (d_vprintf.U):
416 This variable conditionally defines CHARVSPRINTF if this system
417 has vsprintf returning type (char*). The trend seems to be to
418 declare it as "int vsprintf()".
421 This variable conditionally defines the HAS_CHOWN symbol, which
422 indicates to the C program that the chown() routine is available.
424 d_chroot (d_chroot.U):
425 This variable conditionally defines the HAS_CHROOT symbol, which
426 indicates to the C program that the chroot() routine is available.
428 d_chsize (d_chsize.U):
429 This variable conditionally defines the CHSIZE symbol, which
430 indicates to the C program that the chsize() routine is available
431 to truncate files. You might need a -lx to get this routine.
433 d_closedir (d_closedir.U):
434 This variable conditionally defines HAS_CLOSEDIR if closedir() is
437 d_cmsghdr_s (d_cmsghdr_s.U):
438 This variable conditionally defines the HAS_STRUCT_CMSGHDR symbol,
439 which indicates that the struct cmsghdr is supported.
442 This variable conditionally defines the HASCONST symbol, which
443 indicates to the C program that this C compiler knows about the
447 This variable conditionally defines the CRYPT symbol, which
448 indicates to the C program that the crypt() routine is available
449 to encrypt passwords and the like.
452 This variable conditionally defines the CSH symbol, which
453 indicates to the C program that the C-shell exists.
455 d_cuserid (d_cuserid.U):
456 This variable conditionally defines the HAS_CUSERID symbol, which
457 indicates to the C program that the cuserid() routine is available
458 to get character login names.
460 d_dbl_dig (d_dbl_dig.U):
461 This variable conditionally defines d_dbl_dig if this system's
462 header files provide DBL_DIG, which is the number of significant
463 digits in a double precision number.
465 d_dbminitproto (d_dbminitproto.U):
466 This variable conditionally defines the HAS_DBMINIT_PROTO symbol,
467 which indicates to the C program that the system provides
468 a prototype for the dbminit() function. Otherwise, it is
469 up to the program to supply one.
471 d_difftime (d_difftime.U):
472 This variable conditionally defines the HAS_DIFFTIME symbol, which
473 indicates to the C program that the difftime() routine is available.
475 d_dirnamlen (i_dirent.U):
476 This variable conditionally defines DIRNAMLEN, which indicates
477 to the C program that the length of directory entry names is
478 provided by a d_namelen field.
480 d_dlerror (d_dlerror.U):
481 This variable conditionally defines the HAS_DLERROR symbol, which
482 indicates to the C program that the dlerror() routine is available.
484 d_dlopen (d_dlopen.U):
485 This variable conditionally defines the HAS_DLOPEN symbol, which
486 indicates to the C program that the dlopen() routine is available.
488 d_dlsymun (d_dlsymun.U):
489 This variable conditionally defines DLSYM_NEEDS_UNDERSCORE, which
490 indicates that we need to prepend an underscore to the symbol
491 name before calling dlsym().
493 d_dosuid (d_dosuid.U):
494 This variable conditionally defines the symbol DOSUID, which
495 tells the C program that it should insert setuid emulation code
496 on hosts which have setuid #! scripts disabled.
498 d_drand48proto (d_drand48proto.U):
499 This variable conditionally defines the HAS_DRAND48_PROTO symbol,
500 which indicates to the C program that the system provides
501 a prototype for the drand48() function. Otherwise, it is
502 up to the program to supply one.
505 This variable conditionally defines HAS_DUP2 if dup2() is
506 available to duplicate file descriptors.
508 d_eaccess (d_eaccess.U):
509 This variable conditionally defines the HAS_EACCESS symbol, which
510 indicates to the C program that the eaccess() routine is available.
512 d_endgrent (d_endgrent.U):
513 This variable conditionally defines the HAS_ENDGRENT symbol, which
514 indicates to the C program that the endgrent() routine is available
515 for sequential access of the group database.
517 d_endhent (d_endhent.U):
518 This variable conditionally defines HAS_ENDHOSTENT if endhostent() is
519 available to close whatever was being used for host queries.
521 d_endnent (d_endnent.U):
522 This variable conditionally defines HAS_ENDNETENT if endnetent() is
523 available to close whatever was being used for network queries.
525 d_endpent (d_endpent.U):
526 This variable conditionally defines HAS_ENDPROTOENT if endprotoent() is
527 available to close whatever was being used for protocol queries.
529 d_endpwent (d_endpwent.U):
530 This variable conditionally defines the HAS_ENDPWENT symbol, which
531 indicates to the C program that the endpwent() routine is available
532 for sequential access of the passwd database.
534 d_endsent (d_endsent.U):
535 This variable conditionally defines HAS_ENDSERVENT if endservent() is
536 available to close whatever was being used for service queries.
538 d_eofnblk (nblock_io.U):
539 This variable conditionally defines EOF_NONBLOCK if EOF can be seen
540 when reading from a non-blocking I/O source.
543 This variable conditionally defines the symbols EUNICE and VAX, which
544 alerts the C program that it must deal with ideosyncracies of VMS.
546 d_fchdir (d_fchdir.U):
547 This variable conditionally defines the HAS_FCHDIR symbol, which
548 indicates to the C program that the fchdir() routine is available.
550 d_fchmod (d_fchmod.U):
551 This variable conditionally defines the HAS_FCHMOD symbol, which
552 indicates to the C program that the fchmod() routine is available
553 to change mode of opened files.
555 d_fchown (d_fchown.U):
556 This variable conditionally defines the HAS_FCHOWN symbol, which
557 indicates to the C program that the fchown() routine is available
558 to change ownership of opened files.
561 This variable conditionally defines the HAS_FCNTL symbol, and indicates
562 whether the fcntl() function exists
564 d_fcntl_can_lock (d_fcntl_can_lock.U):
565 This variable conditionally defines the FCNTL_CAN_LOCK symbol
566 and indicates whether file locking with fcntl() works.
568 d_fd_macros (d_fd_set.U):
569 This variable contains the eventual value of the HAS_FD_MACROS symbol,
570 which indicates if your C compiler knows about the macros which
571 manipulate an fd_set.
573 d_fd_set (d_fd_set.U):
574 This variable contains the eventual value of the HAS_FD_SET symbol,
575 which indicates if your C compiler knows about the fd_set typedef.
577 d_fds_bits (d_fd_set.U):
578 This variable contains the eventual value of the HAS_FDS_BITS symbol,
579 which indicates if your fd_set typedef contains the fds_bits member.
580 If you have an fd_set typedef, but the dweebs who installed it did
581 a half-fast job and neglected to provide the macros to manipulate
582 an fd_set, HAS_FDS_BITS will let us know how to fix the gaffe.
584 d_fgetpos (d_fgetpos.U):
585 This variable conditionally defines HAS_FGETPOS if fgetpos() is
586 available to get the file position indicator.
588 d_flexfnam (d_flexfnam.U):
589 This variable conditionally defines the FLEXFILENAMES symbol, which
590 indicates that the system supports filenames longer than 14 characters.
593 This variable conditionally defines HAS_FLOCK if flock() is
594 available to do file locking.
596 d_flockproto (d_flockproto.U):
597 This variable conditionally defines the HAS_FLOCK_PROTO symbol,
598 which indicates to the C program that the system provides
599 a prototype for the flock() function. Otherwise, it is
600 up to the program to supply one.
603 This variable conditionally defines the HAS_FORK symbol, which
604 indicates to the C program that the fork() routine is available.
606 d_fpathconf (d_pathconf.U):
607 This variable conditionally defines the HAS_FPATHCONF symbol, which
608 indicates to the C program that the pathconf() routine is available
609 to determine file-system related limits and options associated
610 with a given open file descriptor.
612 d_fpos64_t (d_fpos64_t.U):
613 This symbol will be defined if the C compiler supports fpos64_t.
615 d_frexpl (d_frexpl.U):
616 This variable conditionally defines the HAS_FREXPL symbol, which
617 indicates to the C program that the frexpl() routine is available.
619 d_fs_data_s (d_fs_data_s.U):
620 This variable conditionally defines the HAS_STRUCT_FS_DATA symbol,
621 which indicates that the struct fs_data is supported.
623 d_fseeko (d_fseeko.U):
624 This variable conditionally defines the HAS_FSEEKO symbol, which
625 indicates to the C program that the fseeko() routine is available.
627 d_fsetpos (d_fsetpos.U):
628 This variable conditionally defines HAS_FSETPOS if fsetpos() is
629 available to set the file position indicator.
631 d_fstatfs (d_fstatfs.U):
632 This variable conditionally defines the HAS_FSTATFS symbol, which
633 indicates to the C program that the fstatfs() routine is available.
635 d_fstatvfs (d_statvfs.U):
636 This variable conditionally defines the HAS_FSTATVFS symbol, which
637 indicates to the C program that the fstatvfs() routine is available.
640 This variable conditionally defines the HAS_FSYNC symbol, which
641 indicates to the C program that the fsync() routine is available.
643 d_ftello (d_ftello.U):
644 This variable conditionally defines the HAS_FTELLO symbol, which
645 indicates to the C program that the ftello() routine is available.
648 This variable conditionally defines the HAS_FTIME symbol, which indicates
649 that the ftime() routine exists. The ftime() routine is basically
650 a sub-second accuracy clock.
652 d_Gconvert (d_gconvert.U):
653 This variable holds what Gconvert is defined as to convert
654 floating point numbers into strings. It could be 'gconvert'
655 or a more complex macro emulating gconvert with gcvt() or sprintf.
657 d_Gconvert='gconvert((x),(n),(t),(b))'
658 d_Gconvert='gcvt((x),(n),(b))'
659 d_Gconvert='sprintf((b),"%.*g",(n),(x))'
661 d_getcwd (d_getcwd.U):
662 This variable conditionally defines the HAS_GETCWD symbol, which
663 indicates to the C program that the getcwd() routine is available
664 to get the current working directory.
666 d_getespwnam (d_getespwnam.U):
667 This variable conditionally defines HAS_GETESPWNAM if getespwnam() is
668 available to retrieve enchanced (shadow) password entries by name.
670 d_getfsstat (d_getfsstat.U):
671 This variable conditionally defines the HAS_GETFSSTAT symbol, which
672 indicates to the C program that the getfsstat() routine is available.
674 d_getgrent (d_getgrent.U):
675 This variable conditionally defines the HAS_GETGRENT symbol, which
676 indicates to the C program that the getgrent() routine is available
677 for sequential access of the group database.
679 d_getgrps (d_getgrps.U):
680 This variable conditionally defines the HAS_GETGROUPS symbol, which
681 indicates to the C program that the getgroups() routine is available
682 to get the list of process groups.
684 d_gethbyaddr (d_gethbyad.U):
685 This variable conditionally defines the HAS_GETHOSTBYADDR symbol, which
686 indicates to the C program that the gethostbyaddr() routine is available
687 to look up hosts by their IP addresses.
689 d_gethbyname (d_gethbynm.U):
690 This variable conditionally defines the HAS_GETHOSTBYNAME symbol, which
691 indicates to the C program that the gethostbyname() routine is available
692 to look up host names in some data base or other.
694 d_gethent (d_gethent.U):
695 This variable conditionally defines HAS_GETHOSTENT if gethostent() is
696 available to look up host names in some data base or another.
698 d_gethname (d_gethname.U):
699 This variable conditionally defines the HAS_GETHOSTNAME symbol, which
700 indicates to the C program that the gethostname() routine may be
701 used to derive the host name.
703 d_gethostprotos (d_gethostprotos.U):
704 This variable conditionally defines the HAS_GETHOST_PROTOS symbol,
705 which indicates to the C program that <netdb.h> supplies
706 prototypes for the various gethost*() functions.
707 See also netdbtype.U for probing for various netdb types.
709 d_getitimer (d_getitimer.U):
710 This variable conditionally defines the HAS_GETITIMER symbol, which
711 indicates to the C program that the getitimer() routine is available.
713 d_getlogin (d_getlogin.U):
714 This variable conditionally defines the HAS_GETLOGIN symbol, which
715 indicates to the C program that the getlogin() routine is available
716 to get the login name.
718 d_getmnt (d_getmnt.U):
719 This variable conditionally defines the HAS_GETMNT symbol, which
720 indicates to the C program that the getmnt() routine is available
721 to retrieve one or more mount info blocks by filename.
723 d_getmntent (d_getmntent.U):
724 This variable conditionally defines the HAS_GETMNTENT symbol, which
725 indicates to the C program that the getmntent() routine is available
726 to iterate through mounted files to get their mount info.
728 d_getnbyaddr (d_getnbyad.U):
729 This variable conditionally defines the HAS_GETNETBYADDR symbol, which
730 indicates to the C program that the getnetbyaddr() routine is available
731 to look up networks by their IP addresses.
733 d_getnbyname (d_getnbynm.U):
734 This variable conditionally defines the HAS_GETNETBYNAME symbol, which
735 indicates to the C program that the getnetbyname() routine is available
736 to look up networks by their names.
738 d_getnent (d_getnent.U):
739 This variable conditionally defines HAS_GETNETENT if getnetent() is
740 available to look up network names in some data base or another.
742 d_getnetprotos (d_getnetprotos.U):
743 This variable conditionally defines the HAS_GETNET_PROTOS symbol,
744 which indicates to the C program that <netdb.h> supplies
745 prototypes for the various getnet*() functions.
746 See also netdbtype.U for probing for various netdb types.
748 d_getpagsz (d_getpagsz.U):
749 This variable conditionally defines HAS_GETPAGESIZE if getpagesize()
750 is available to get the system page size.
752 d_getpbyname (d_getprotby.U):
753 This variable conditionally defines the HAS_GETPROTOBYNAME
754 symbol, which indicates to the C program that the
755 getprotobyname() routine is available to look up protocols
758 d_getpbynumber (d_getprotby.U):
759 This variable conditionally defines the HAS_GETPROTOBYNUMBER
760 symbol, which indicates to the C program that the
761 getprotobynumber() routine is available to look up protocols
764 d_getpent (d_getpent.U):
765 This variable conditionally defines HAS_GETPROTOENT if getprotoent() is
766 available to look up protocols in some data base or another.
768 d_getpgid (d_getpgid.U):
769 This variable conditionally defines the HAS_GETPGID symbol, which
770 indicates to the C program that the getpgid(pid) function
771 is available to get the process group id.
773 d_getpgrp2 (d_getpgrp2.U):
774 This variable conditionally defines the HAS_GETPGRP2 symbol, which
775 indicates to the C program that the getpgrp2() (as in DG/UX) routine
776 is available to get the current process group.
778 d_getpgrp (d_getpgrp.U):
779 This variable conditionally defines HAS_GETPGRP if getpgrp() is
780 available to get the current process group.
782 d_getppid (d_getppid.U):
783 This variable conditionally defines the HAS_GETPPID symbol, which
784 indicates to the C program that the getppid() routine is available
785 to get the parent process ID.
787 d_getprior (d_getprior.U):
788 This variable conditionally defines HAS_GETPRIORITY if getpriority()
789 is available to get a process's priority.
791 d_getprotoprotos (d_getprotoprotos.U):
792 This variable conditionally defines the HAS_GETPROTO_PROTOS symbol,
793 which indicates to the C program that <netdb.h> supplies
794 prototypes for the various getproto*() functions.
795 See also netdbtype.U for probing for various netdb types.
797 d_getprpwnam (d_getprpwnam.U):
798 This variable conditionally defines HAS_GETPRPWNAM if getprpwnam() is
799 available to retrieve protected (shadow) password entries by name.
801 d_getpwent (d_getpwent.U):
802 This variable conditionally defines the HAS_GETPWENT symbol, which
803 indicates to the C program that the getpwent() routine is available
804 for sequential access of the passwd database.
806 d_getsbyname (d_getsrvby.U):
807 This variable conditionally defines the HAS_GETSERVBYNAME
808 symbol, which indicates to the C program that the
809 getservbyname() routine is available to look up services
812 d_getsbyport (d_getsrvby.U):
813 This variable conditionally defines the HAS_GETSERVBYPORT
814 symbol, which indicates to the C program that the
815 getservbyport() routine is available to look up services
818 d_getsent (d_getsent.U):
819 This variable conditionally defines HAS_GETSERVENT if getservent() is
820 available to look up network services in some data base or another.
822 d_getservprotos (d_getservprotos.U):
823 This variable conditionally defines the HAS_GETSERV_PROTOS symbol,
824 which indicates to the C program that <netdb.h> supplies
825 prototypes for the various getserv*() functions.
826 See also netdbtype.U for probing for various netdb types.
828 d_getspnam (d_getspnam.U):
829 This variable conditionally defines HAS_GETSPNAM if getspnam() is
830 available to retrieve SysV shadow password entries by name.
832 d_gettimeod (d_ftime.U):
833 This variable conditionally defines the HAS_GETTIMEOFDAY symbol, which
834 indicates that the gettimeofday() system call exists (to obtain a
835 sub-second accuracy clock). You should probably include <sys/resource.h>.
837 d_gnulibc (d_gnulibc.U):
838 Defined if we're dealing with the GNU C Library.
840 d_grpasswd (i_grp.U):
841 This variable conditionally defines GRPASSWD, which indicates
842 that struct group in <grp.h> contains gr_passwd.
844 d_hasmntopt (d_hasmntopt.U):
845 This variable conditionally defines the HAS_HASMNTOPT symbol, which
846 indicates to the C program that the hasmntopt() routine is available
847 to query the mount options of file systems.
850 This variable conditionally defines HAS_HTONL if htonl() and its
851 friends are available to do network order byte swapping.
854 This variable conditionally defines the HAS_ICONV symbol, which
855 indicates to the C program that the iconv() routine is available.
857 d_index (d_strchr.U):
858 This variable conditionally defines HAS_INDEX if index() and
859 rindex() are available for string searching.
861 d_inetaton (d_inetaton.U):
862 This variable conditionally defines the HAS_INET_ATON symbol, which
863 indicates to the C program that the inet_aton() function is available
864 to parse IP address "dotted-quad" strings.
866 d_int64_t (d_int64_t.U):
867 This symbol will be defined if the C compiler supports int64_t.
869 d_isascii (d_isascii.U):
870 This variable conditionally defines the HAS_ISASCII constant,
871 which indicates to the C program that isascii() is available.
874 This variable conditionally defines the HAS_ISNAN symbol, which
875 indicates to the C program that the isnan() routine is available.
877 d_isnanl (d_isnanl.U):
878 This variable conditionally defines the HAS_ISNANL symbol, which
879 indicates to the C program that the isnanl() routine is available.
881 d_killpg (d_killpg.U):
882 This variable conditionally defines the HAS_KILLPG symbol, which
883 indicates to the C program that the killpg() routine is available
884 to kill process groups.
886 d_lchown (d_lchown.U):
887 This variable conditionally defines the HAS_LCHOWN symbol, which
888 indicates to the C program that the lchown() routine is available
889 to operate on a symbolic link (instead of following the link).
891 d_ldbl_dig (d_ldbl_dig.U):
892 This variable conditionally defines d_ldbl_dig if this system's
893 header files provide LDBL_DIG, which is the number of significant
894 digits in a long double precision number.
897 This variable conditionally defines HAS_LINK if link() is
898 available to create hard links.
900 d_locconv (d_locconv.U):
901 This variable conditionally defines HAS_LOCALECONV if localeconv() is
902 available for numeric and monetary formatting conventions.
905 This variable conditionally defines HAS_LOCKF if lockf() is
906 available to do file locking.
908 d_longdbl (d_longdbl.U):
909 This variable conditionally defines HAS_LONG_DOUBLE if
910 the long double type is supported.
912 d_longlong (d_longlong.U):
913 This variable conditionally defines HAS_LONG_LONG if
914 the long long type is supported.
916 d_lseekproto (d_lseekproto.U):
917 This variable conditionally defines the HAS_LSEEK_PROTO symbol,
918 which indicates to the C program that the system provides
919 a prototype for the lseek() function. Otherwise, it is
920 up to the program to supply one.
923 This variable conditionally defines HAS_LSTAT if lstat() is
924 available to do file stats on symbolic links.
926 d_madvise (d_madvise.U):
927 This variable conditionally defines HAS_MADVISE if madvise() is
928 available to map a file into memory.
931 This variable conditionally defines the HAS_MBLEN symbol, which
932 indicates to the C program that the mblen() routine is available
933 to find the number of bytes in a multibye character.
935 d_mbstowcs (d_mbstowcs.U):
936 This variable conditionally defines the HAS_MBSTOWCS symbol, which
937 indicates to the C program that the mbstowcs() routine is available
938 to convert a multibyte string into a wide character string.
940 d_mbtowc (d_mbtowc.U):
941 This variable conditionally defines the HAS_MBTOWC symbol, which
942 indicates to the C program that the mbtowc() routine is available
943 to convert multibyte to a wide character.
945 d_memchr (d_memchr.U):
946 This variable conditionally defines the HAS_MEMCHR symbol, which
947 indicates to the C program that the memchr() routine is available
948 to locate characters within a C string.
950 d_memcmp (d_memcmp.U):
951 This variable conditionally defines the HAS_MEMCMP symbol, which
952 indicates to the C program that the memcmp() routine is available
953 to compare blocks of memory.
955 d_memcpy (d_memcpy.U):
956 This variable conditionally defines the HAS_MEMCPY symbol, which
957 indicates to the C program that the memcpy() routine is available
958 to copy blocks of memory.
960 d_memmove (d_memmove.U):
961 This variable conditionally defines the HAS_MEMMOVE symbol, which
962 indicates to the C program that the memmove() routine is available
963 to copy potentatially overlapping blocks of memory.
965 d_memset (d_memset.U):
966 This variable conditionally defines the HAS_MEMSET symbol, which
967 indicates to the C program that the memset() routine is available
968 to set blocks of memory.
971 This variable conditionally defines the HAS_MKDIR symbol, which
972 indicates to the C program that the mkdir() routine is available
973 to create directories..
975 d_mkdtemp (d_mkdtemp.U):
976 This variable conditionally defines the HAS_MKDTEMP symbol, which
977 indicates to the C program that the mkdtemp() routine is available
978 to exclusively create a uniquely named temporary directory.
980 d_mkfifo (d_mkfifo.U):
981 This variable conditionally defines the HAS_MKFIFO symbol, which
982 indicates to the C program that the mkfifo() routine is available.
984 d_mkstemp (d_mkstemp.U):
985 This variable conditionally defines the HAS_MKSTEMP symbol, which
986 indicates to the C program that the mkstemp() routine is available
987 to exclusively create and open a uniquely named temporary file.
989 d_mkstemps (d_mkstemps.U):
990 This variable conditionally defines the HAS_MKSTEMPS symbol, which
991 indicates to the C program that the mkstemps() routine is available
992 to exclusively create and open a uniquely named (with a suffix)
995 d_mktime (d_mktime.U):
996 This variable conditionally defines the HAS_MKTIME symbol, which
997 indicates to the C program that the mktime() routine is available.
1000 This variable conditionally defines HAS_MMAP if mmap() is
1001 available to map a file into memory.
1003 d_modfl (d_modfl.U):
1004 This variable conditionally defines the HAS_MODFL symbol, which
1005 indicates to the C program that the modfl() routine is available.
1007 d_modfl_pow32_bug (d_modfl.U):
1008 This variable conditionally defines the HAS_MODFL_POW32_BUG symbol,
1009 which indicates that modfl() is broken for long doubles >= pow(2, 32).
1010 For example from 4294967303.150000 one would get 4294967302.000000
1011 and 1.150000. The bug has been seen in certain versions of glibc,
1012 release 2.2.2 is known to be okay.
1014 d_mprotect (d_mprotect.U):
1015 This variable conditionally defines HAS_MPROTECT if mprotect() is
1016 available to modify the access protection of a memory mapped file.
1019 This variable conditionally defines the HAS_MSG symbol, which
1020 indicates that the entire msg*(2) library is present.
1022 d_msg_ctrunc (d_socket.U):
1023 This variable conditionally defines the HAS_MSG_CTRUNC symbol,
1024 which indicates that the MSG_CTRUNC is available. #ifdef is
1025 not enough because it may be an enum, glibc has been known to do this.
1027 d_msg_dontroute (d_socket.U):
1028 This variable conditionally defines the HAS_MSG_DONTROUTE symbol,
1029 which indicates that the MSG_DONTROUTE is available. #ifdef is
1030 not enough because it may be an enum, glibc has been known to do this.
1032 d_msg_oob (d_socket.U):
1033 This variable conditionally defines the HAS_MSG_OOB symbol,
1034 which indicates that the MSG_OOB is available. #ifdef is
1035 not enough because it may be an enum, glibc has been known to do this.
1037 d_msg_peek (d_socket.U):
1038 This variable conditionally defines the HAS_MSG_PEEK symbol,
1039 which indicates that the MSG_PEEK is available. #ifdef is
1040 not enough because it may be an enum, glibc has been known to do this.
1042 d_msg_proxy (d_socket.U):
1043 This variable conditionally defines the HAS_MSG_PROXY symbol,
1044 which indicates that the MSG_PROXY is available. #ifdef is
1045 not enough because it may be an enum, glibc has been known to do this.
1047 d_msgctl (d_msgctl.U):
1048 This variable conditionally defines the HAS_MSGCTL symbol, which
1049 indicates to the C program that the msgctl() routine is available.
1051 d_msgget (d_msgget.U):
1052 This variable conditionally defines the HAS_MSGGET symbol, which
1053 indicates to the C program that the msgget() routine is available.
1055 d_msghdr_s (d_msghdr_s.U):
1056 This variable conditionally defines the HAS_STRUCT_MSGHDR symbol,
1057 which indicates that the struct msghdr is supported.
1059 d_msgrcv (d_msgrcv.U):
1060 This variable conditionally defines the HAS_MSGRCV symbol, which
1061 indicates to the C program that the msgrcv() routine is available.
1063 d_msgsnd (d_msgsnd.U):
1064 This variable conditionally defines the HAS_MSGSND symbol, which
1065 indicates to the C program that the msgsnd() routine is available.
1067 d_msync (d_msync.U):
1068 This variable conditionally defines HAS_MSYNC if msync() is
1069 available to synchronize a mapped file.
1071 d_munmap (d_munmap.U):
1072 This variable conditionally defines HAS_MUNMAP if munmap() is
1073 available to unmap a region mapped by mmap().
1075 d_mymalloc (mallocsrc.U):
1076 This variable conditionally defines MYMALLOC in case other parts
1077 of the source want to take special action if MYMALLOC is used.
1078 This may include different sorts of profiling or error detection.
1081 This variable conditionally defines the HAS_NICE symbol, which
1082 indicates to the C program that the nice() routine is available.
1084 d_nv_preserves_uv (perlxv.U):
1085 This variable indicates whether a variable of type nvtype
1086 can preserve all the bits a variable of type uvtype.
1088 d_nv_preserves_uv_bits (perlxv.U):
1089 This variable indicates how many of bits type uvtype
1090 a variable nvtype can preserve.
1092 d_off64_t (d_off64_t.U):
1093 This symbol will be defined if the C compiler supports off64_t.
1095 d_old_pthread_create_joinable (d_pthrattrj.U):
1096 This variable conditionally defines pthread_create_joinable.
1097 undef if pthread.h defines PTHREAD_CREATE_JOINABLE.
1099 d_oldpthreads (usethreads.U):
1100 This variable conditionally defines the OLD_PTHREADS_API symbol,
1101 and indicates that Perl should be built to use the old
1102 draft POSIX threads API. This is only potentially meaningful if
1105 d_oldsock (d_socket.U):
1106 This variable conditionally defines the OLDSOCKET symbol, which
1107 indicates that the BSD socket interface is based on 4.1c and not 4.2.
1109 d_open3 (d_open3.U):
1110 This variable conditionally defines the HAS_OPEN3 manifest constant,
1111 which indicates to the C program that the 3 argument version of
1112 the open(2) function is available.
1114 d_pathconf (d_pathconf.U):
1115 This variable conditionally defines the HAS_PATHCONF symbol, which
1116 indicates to the C program that the pathconf() routine is available
1117 to determine file-system related limits and options associated
1118 with a given filename.
1120 d_pause (d_pause.U):
1121 This variable conditionally defines the HAS_PAUSE symbol, which
1122 indicates to the C program that the pause() routine is available
1123 to suspend a process until a signal is received.
1125 d_perl_otherlibdirs (otherlibdirs.U):
1126 This variable conditionally defines PERL_OTHERLIBDIRS, which
1127 contains a colon-separated set of paths for the perl binary to
1128 include in @INC. See also otherlibdirs.
1130 d_phostname (d_gethname.U):
1131 This variable conditionally defines the HAS_PHOSTNAME symbol, which
1132 contains the shell command which, when fed to popen(), may be
1133 used to derive the host name.
1136 This variable conditionally defines the HAS_PIPE symbol, which
1137 indicates to the C program that the pipe() routine is available
1138 to create an inter-process channel.
1141 This variable conditionally defines the HAS_POLL symbol, which
1142 indicates to the C program that the poll() routine is available
1143 to poll active file descriptors.
1145 d_portable (d_portable.U):
1146 This variable conditionally defines the PORTABLE symbol, which
1147 indicates to the C program that it should not assume that it is
1148 running on the machine it was compiled on.
1150 d_PRId64 (quadfio.U):
1151 This variable conditionally defines the PERL_PRId64 symbol, which
1152 indiciates that stdio has a symbol to print 64-bit decimal numbers.
1154 d_PRIeldbl (longdblfio.U):
1155 This variable conditionally defines the PERL_PRIfldbl symbol, which
1156 indiciates that stdio has a symbol to print long doubles.
1158 d_PRIEUldbl (longdblfio.U):
1159 This variable conditionally defines the PERL_PRIfldbl symbol, which
1160 indiciates that stdio has a symbol to print long doubles.
1161 The 'U' in the name is to separate this from d_PRIeldbl so that even
1162 case-blind systems can see the difference.
1164 d_PRIfldbl (longdblfio.U):
1165 This variable conditionally defines the PERL_PRIfldbl symbol, which
1166 indiciates that stdio has a symbol to print long doubles.
1168 d_PRIFUldbl (longdblfio.U):
1169 This variable conditionally defines the PERL_PRIfldbl symbol, which
1170 indiciates that stdio has a symbol to print long doubles.
1171 The 'U' in the name is to separate this from d_PRIfldbl so that even
1172 case-blind systems can see the difference.
1174 d_PRIgldbl (longdblfio.U):
1175 This variable conditionally defines the PERL_PRIfldbl symbol, which
1176 indiciates that stdio has a symbol to print long doubles.
1178 d_PRIGUldbl (longdblfio.U):
1179 This variable conditionally defines the PERL_PRIfldbl symbol, which
1180 indiciates that stdio has a symbol to print long doubles.
1181 The 'U' in the name is to separate this from d_PRIgldbl so that even
1182 case-blind systems can see the difference.
1184 d_PRIi64 (quadfio.U):
1185 This variable conditionally defines the PERL_PRIi64 symbol, which
1186 indiciates that stdio has a symbol to print 64-bit decimal numbers.
1188 d_PRIo64 (quadfio.U):
1189 This variable conditionally defines the PERL_PRIo64 symbol, which
1190 indiciates that stdio has a symbol to print 64-bit octal numbers.
1192 d_PRIu64 (quadfio.U):
1193 This variable conditionally defines the PERL_PRIu64 symbol, which
1194 indiciates that stdio has a symbol to print 64-bit unsigned decimal
1197 d_PRIx64 (quadfio.U):
1198 This variable conditionally defines the PERL_PRIx64 symbol, which
1199 indiciates that stdio has a symbol to print 64-bit hexadecimal numbers.
1201 d_PRIXU64 (quadfio.U):
1202 This variable conditionally defines the PERL_PRIXU64 symbol, which
1203 indiciates that stdio has a symbol to print 64-bit hExADECimAl numbers.
1204 The 'U' in the name is to separate this from d_PRIx64 so that even
1205 case-blind systems can see the difference.
1207 d_pthread_yield (d_pthread_y.U):
1208 This variable conditionally defines the HAS_PTHREAD_YIELD
1209 symbol if the pthread_yield routine is available to yield
1210 the execution of the current thread.
1213 This variable conditionally defines PWAGE, which indicates
1214 that struct passwd contains pw_age.
1216 d_pwchange (i_pwd.U):
1217 This variable conditionally defines PWCHANGE, which indicates
1218 that struct passwd contains pw_change.
1220 d_pwclass (i_pwd.U):
1221 This variable conditionally defines PWCLASS, which indicates
1222 that struct passwd contains pw_class.
1224 d_pwcomment (i_pwd.U):
1225 This variable conditionally defines PWCOMMENT, which indicates
1226 that struct passwd contains pw_comment.
1228 d_pwexpire (i_pwd.U):
1229 This variable conditionally defines PWEXPIRE, which indicates
1230 that struct passwd contains pw_expire.
1232 d_pwgecos (i_pwd.U):
1233 This variable conditionally defines PWGECOS, which indicates
1234 that struct passwd contains pw_gecos.
1236 d_pwpasswd (i_pwd.U):
1237 This variable conditionally defines PWPASSWD, which indicates
1238 that struct passwd contains pw_passwd.
1240 d_pwquota (i_pwd.U):
1241 This variable conditionally defines PWQUOTA, which indicates
1242 that struct passwd contains pw_quota.
1244 d_qgcvt (d_qgcvt.U):
1245 This variable conditionally defines the HAS_QGCVT symbol, which
1246 indicates to the C program that the qgcvt() routine is available.
1248 d_quad (quadtype.U):
1249 This variable, if defined, tells that there's a 64-bit integer type,
1252 d_readdir (d_readdir.U):
1253 This variable conditionally defines HAS_READDIR if readdir() is
1254 available to read directory entries.
1256 d_readlink (d_readlink.U):
1257 This variable conditionally defines the HAS_READLINK symbol, which
1258 indicates to the C program that the readlink() routine is available
1259 to read the value of a symbolic link.
1261 d_readv (d_readv.U):
1262 This variable conditionally defines the HAS_READV symbol, which
1263 indicates to the C program that the readv() routine is available.
1265 d_recvmsg (d_recvmsg.U):
1266 This variable conditionally defines the HAS_RECVMSG symbol, which
1267 indicates to the C program that the recvmsg() routine is available.
1269 d_rename (d_rename.U):
1270 This variable conditionally defines the HAS_RENAME symbol, which
1271 indicates to the C program that the rename() routine is available
1274 d_rewinddir (d_readdir.U):
1275 This variable conditionally defines HAS_REWINDDIR if rewinddir() is
1278 d_rmdir (d_rmdir.U):
1279 This variable conditionally defines HAS_RMDIR if rmdir() is
1280 available to remove directories.
1282 d_safebcpy (d_safebcpy.U):
1283 This variable conditionally defines the HAS_SAFE_BCOPY symbol if
1284 the bcopy() routine can do overlapping copies. Normally, you
1285 should probably use memmove().
1287 d_safemcpy (d_safemcpy.U):
1288 This variable conditionally defines the HAS_SAFE_MEMCPY symbol if
1289 the memcpy() routine can do overlapping copies.
1290 For overlapping copies, memmove() should be used, if available.
1292 d_sanemcmp (d_sanemcmp.U):
1293 This variable conditionally defines the HAS_SANE_MEMCMP symbol if
1294 the memcpy() routine is available and can be used to compare relative
1295 magnitudes of chars with their high bits set.
1297 d_sbrkproto (d_sbrkproto.U):
1298 This variable conditionally defines the HAS_SBRK_PROTO symbol,
1299 which indicates to the C program that the system provides
1300 a prototype for the sbrk() function. Otherwise, it is
1301 up to the program to supply one.
1303 d_sched_yield (d_pthread_y.U):
1304 This variable conditionally defines the HAS_SCHED_YIELD
1305 symbol if the sched_yield routine is available to yield
1306 the execution of the current thread.
1308 d_scm_rights (d_socket.U):
1309 This variable conditionally defines the HAS_SCM_RIGHTS symbol,
1310 which indicates that the SCM_RIGHTS is available. #ifdef is
1311 not enough because it may be an enum, glibc has been known to do this.
1313 d_SCNfldbl (longdblfio.U):
1314 This variable conditionally defines the PERL_PRIfldbl symbol, which
1315 indiciates that stdio has a symbol to scan long doubles.
1317 d_seekdir (d_readdir.U):
1318 This variable conditionally defines HAS_SEEKDIR if seekdir() is
1321 d_select (d_select.U):
1322 This variable conditionally defines HAS_SELECT if select() is
1323 available to select active file descriptors. A <sys/time.h>
1324 inclusion may be necessary for the timeout field.
1327 This variable conditionally defines the HAS_SEM symbol, which
1328 indicates that the entire sem*(2) library is present.
1330 d_semctl (d_semctl.U):
1331 This variable conditionally defines the HAS_SEMCTL symbol, which
1332 indicates to the C program that the semctl() routine is available.
1334 d_semctl_semid_ds (d_union_semun.U):
1335 This variable conditionally defines USE_SEMCTL_SEMID_DS, which
1336 indicates that struct semid_ds * is to be used for semctl IPC_STAT.
1338 d_semctl_semun (d_union_semun.U):
1339 This variable conditionally defines USE_SEMCTL_SEMUN, which
1340 indicates that union semun is to be used for semctl IPC_STAT.
1342 d_semget (d_semget.U):
1343 This variable conditionally defines the HAS_SEMGET symbol, which
1344 indicates to the C program that the semget() routine is available.
1346 d_semop (d_semop.U):
1347 This variable conditionally defines the HAS_SEMOP symbol, which
1348 indicates to the C program that the semop() routine is available.
1350 d_sendmsg (d_sendmsg.U):
1351 This variable conditionally defines the HAS_SENDMSG symbol, which
1352 indicates to the C program that the sendmsg() routine is available.
1354 d_setegid (d_setegid.U):
1355 This variable conditionally defines the HAS_SETEGID symbol, which
1356 indicates to the C program that the setegid() routine is available
1357 to change the effective gid of the current program.
1359 d_seteuid (d_seteuid.U):
1360 This variable conditionally defines the HAS_SETEUID symbol, which
1361 indicates to the C program that the seteuid() routine is available
1362 to change the effective uid of the current program.
1364 d_setgrent (d_setgrent.U):
1365 This variable conditionally defines the HAS_SETGRENT symbol, which
1366 indicates to the C program that the setgrent() routine is available
1367 for initializing sequential access to the group database.
1369 d_setgrps (d_setgrps.U):
1370 This variable conditionally defines the HAS_SETGROUPS symbol, which
1371 indicates to the C program that the setgroups() routine is available
1372 to set the list of process groups.
1374 d_sethent (d_sethent.U):
1375 This variable conditionally defines HAS_SETHOSTENT if sethostent() is
1378 d_setitimer (d_setitimer.U):
1379 This variable conditionally defines the HAS_SETITIMER symbol, which
1380 indicates to the C program that the setitimer() routine is available.
1382 d_setlinebuf (d_setlnbuf.U):
1383 This variable conditionally defines the HAS_SETLINEBUF symbol, which
1384 indicates to the C program that the setlinebuf() routine is available
1385 to change stderr or stdout from block-buffered or unbuffered to a
1388 d_setlocale (d_setlocale.U):
1389 This variable conditionally defines HAS_SETLOCALE if setlocale() is
1390 available to handle locale-specific ctype implementations.
1392 d_setnent (d_setnent.U):
1393 This variable conditionally defines HAS_SETNETENT if setnetent() is
1396 d_setpent (d_setpent.U):
1397 This variable conditionally defines HAS_SETPROTOENT if setprotoent() is
1400 d_setpgid (d_setpgid.U):
1401 This variable conditionally defines the HAS_SETPGID symbol if the
1402 setpgid(pid, gpid) function is available to set process group ID.
1404 d_setpgrp2 (d_setpgrp2.U):
1405 This variable conditionally defines the HAS_SETPGRP2 symbol, which
1406 indicates to the C program that the setpgrp2() (as in DG/UX) routine
1407 is available to set the current process group.
1409 d_setpgrp (d_setpgrp.U):
1410 This variable conditionally defines HAS_SETPGRP if setpgrp() is
1411 available to set the current process group.
1413 d_setprior (d_setprior.U):
1414 This variable conditionally defines HAS_SETPRIORITY if setpriority()
1415 is available to set a process's priority.
1417 d_setproctitle (d_setproctitle.U):
1418 This variable conditionally defines the HAS_SETPROCTITLE symbol,
1419 which indicates to the C program that the setproctitle() routine
1422 d_setpwent (d_setpwent.U):
1423 This variable conditionally defines the HAS_SETPWENT symbol, which
1424 indicates to the C program that the setpwent() routine is available
1425 for initializing sequential access to the passwd database.
1427 d_setregid (d_setregid.U):
1428 This variable conditionally defines HAS_SETREGID if setregid() is
1429 available to change the real and effective gid of the current
1432 d_setresgid (d_setregid.U):
1433 This variable conditionally defines HAS_SETRESGID if setresgid() is
1434 available to change the real, effective and saved gid of the current
1437 d_setresuid (d_setreuid.U):
1438 This variable conditionally defines HAS_SETREUID if setresuid() is
1439 available to change the real, effective and saved uid of the current
1442 d_setreuid (d_setreuid.U):
1443 This variable conditionally defines HAS_SETREUID if setreuid() is
1444 available to change the real and effective uid of the current
1447 d_setrgid (d_setrgid.U):
1448 This variable conditionally defines the HAS_SETRGID symbol, which
1449 indicates to the C program that the setrgid() routine is available
1450 to change the real gid of the current program.
1452 d_setruid (d_setruid.U):
1453 This variable conditionally defines the HAS_SETRUID symbol, which
1454 indicates to the C program that the setruid() routine is available
1455 to change the real uid of the current program.
1457 d_setsent (d_setsent.U):
1458 This variable conditionally defines HAS_SETSERVENT if setservent() is
1461 d_setsid (d_setsid.U):
1462 This variable conditionally defines HAS_SETSID if setsid() is
1463 available to set the process group ID.
1465 d_setvbuf (d_setvbuf.U):
1466 This variable conditionally defines the HAS_SETVBUF symbol, which
1467 indicates to the C program that the setvbuf() routine is available
1468 to change buffering on an open stdio stream.
1471 This variable conditionally defines the USE_SFIO symbol,
1472 and indicates whether sfio is available (and should be used).
1475 This variable conditionally defines the HAS_SHM symbol, which
1476 indicates that the entire shm*(2) library is present.
1478 d_shmat (d_shmat.U):
1479 This variable conditionally defines the HAS_SHMAT symbol, which
1480 indicates to the C program that the shmat() routine is available.
1482 d_shmatprototype (d_shmat.U):
1483 This variable conditionally defines the HAS_SHMAT_PROTOTYPE
1484 symbol, which indicates that sys/shm.h has a prototype for
1487 d_shmctl (d_shmctl.U):
1488 This variable conditionally defines the HAS_SHMCTL symbol, which
1489 indicates to the C program that the shmctl() routine is available.
1491 d_shmdt (d_shmdt.U):
1492 This variable conditionally defines the HAS_SHMDT symbol, which
1493 indicates to the C program that the shmdt() routine is available.
1495 d_shmget (d_shmget.U):
1496 This variable conditionally defines the HAS_SHMGET symbol, which
1497 indicates to the C program that the shmget() routine is available.
1499 d_sigaction (d_sigaction.U):
1500 This variable conditionally defines the HAS_SIGACTION symbol, which
1501 indicates that the Vr4 sigaction() routine is available.
1503 d_sigprocmask (d_sigprocmask.U):
1504 This variable conditionally defines HAS_SIGPROCMASK
1505 if sigprocmask() is available to examine or change the signal mask
1506 of the calling process.
1508 d_sigsetjmp (d_sigsetjmp.U):
1509 This variable conditionally defines the HAS_SIGSETJMP symbol,
1510 which indicates that the sigsetjmp() routine is available to
1511 call setjmp() and optionally save the process's signal mask.
1513 d_sockatmark (d_sockatmark.U):
1514 This variable conditionally defines the HAS_SOCKATMARK symbol, which
1515 indicates to the C program that the sockatmark() routine is available.
1517 d_sockatmarkproto (d_sockatmarkproto.U):
1518 This variable conditionally defines the HAS_SOCKATMARK_PROTO symbol,
1519 which indicates to the C program that the system provides
1520 a prototype for the sockatmark() function. Otherwise, it is
1521 up to the program to supply one.
1523 d_socket (d_socket.U):
1524 This variable conditionally defines HAS_SOCKET, which indicates
1525 that the BSD socket interface is supported.
1527 d_socklen_t (d_socklen_t.U):
1528 This symbol will be defined if the C compiler supports socklen_t.
1530 d_sockpair (d_socket.U):
1531 This variable conditionally defines the HAS_SOCKETPAIR symbol, which
1532 indicates that the BSD socketpair() is supported.
1534 d_socks5_init (d_socks5_init.U):
1535 This variable conditionally defines the HAS_SOCKS5_INIT symbol, which
1536 indicates to the C program that the socks5_init() routine is available.
1538 d_sqrtl (d_sqrtl.U):
1539 This variable conditionally defines the HAS_SQRTL symbol, which
1540 indicates to the C program that the sqrtl() routine is available.
1542 d_sresgproto (d_sresgproto.U):
1543 This variable conditionally defines the HAS_SETRESGID_PROTO symbol,
1544 which indicates to the C program that the system provides
1545 a prototype for the setresgid() function. Otherwise, it is
1546 up to the program to supply one.
1548 d_sresuproto (d_sresuproto.U):
1549 This variable conditionally defines the HAS_SETRESUID_PROTO symbol,
1550 which indicates to the C program that the system provides
1551 a prototype for the setresuid() function. Otherwise, it is
1552 up to the program to supply one.
1554 d_statblks (d_statblks.U):
1555 This variable conditionally defines USE_STAT_BLOCKS
1556 if this system has a stat structure declaring
1557 st_blksize and st_blocks.
1559 d_statfs_f_flags (d_statfs_f_flags.U):
1560 This variable conditionally defines the HAS_STRUCT_STATFS_F_FLAGS
1561 symbol, which indicates to struct statfs from has f_flags member.
1562 This kind of struct statfs is coming from sys/mount.h (BSD),
1563 not from sys/statfs.h (SYSV).
1565 d_statfs_s (d_statfs_s.U):
1566 This variable conditionally defines the HAS_STRUCT_STATFS symbol,
1567 which indicates that the struct statfs is supported.
1569 d_statvfs (d_statvfs.U):
1570 This variable conditionally defines the HAS_STATVFS symbol, which
1571 indicates to the C program that the statvfs() routine is available.
1573 d_stdio_cnt_lval (d_stdstdio.U):
1574 This variable conditionally defines STDIO_CNT_LVALUE if the
1575 FILE_cnt macro can be used as an lvalue.
1577 d_stdio_ptr_lval (d_stdstdio.U):
1578 This variable conditionally defines STDIO_PTR_LVALUE if the
1579 FILE_ptr macro can be used as an lvalue.
1581 d_stdio_ptr_lval_nochange_cnt (d_stdstdio.U):
1582 This symbol is defined if using the FILE_ptr macro as an lvalue
1583 to increase the pointer by n leaves File_cnt(fp) unchanged.
1585 d_stdio_ptr_lval_sets_cnt (d_stdstdio.U):
1586 This symbol is defined if using the FILE_ptr macro as an lvalue
1587 to increase the pointer by n has the side effect of decreasing the
1588 value of File_cnt(fp) by n.
1590 d_stdio_stream_array (stdio_streams.U):
1591 This variable tells whether there is an array holding
1594 d_stdiobase (d_stdstdio.U):
1595 This variable conditionally defines USE_STDIO_BASE if this system
1596 has a FILE structure declaring a usable _base field (or equivalent)
1599 d_stdstdio (d_stdstdio.U):
1600 This variable conditionally defines USE_STDIO_PTR if this system
1601 has a FILE structure declaring usable _ptr and _cnt fields (or
1602 equivalent) in stdio.h.
1604 d_strchr (d_strchr.U):
1605 This variable conditionally defines HAS_STRCHR if strchr() and
1606 strrchr() are available for string searching.
1608 d_strcoll (d_strcoll.U):
1609 This variable conditionally defines HAS_STRCOLL if strcoll() is
1610 available to compare strings using collating information.
1612 d_strctcpy (d_strctcpy.U):
1613 This variable conditionally defines the USE_STRUCT_COPY symbol, which
1614 indicates to the C program that this C compiler knows how to copy
1617 d_strerrm (d_strerror.U):
1618 This variable holds what Strerrr is defined as to translate an error
1619 code condition into an error message string. It could be 'strerror'
1620 or a more complex macro emulating strrror with sys_errlist[], or the
1621 "unknown" string when both strerror and sys_errlist are missing.
1623 d_strerror (d_strerror.U):
1624 This variable conditionally defines HAS_STRERROR if strerror() is
1625 available to translate error numbers to strings.
1627 d_strftime (d_strftime.U):
1628 This variable conditionally defines the HAS_STRFTIME symbol, which
1629 indicates to the C program that the strftime() routine is available.
1631 d_strtod (d_strtod.U):
1632 This variable conditionally defines the HAS_STRTOD symbol, which
1633 indicates to the C program that the strtod() routine is available
1634 to provide better numeric string conversion than atof().
1636 d_strtol (d_strtol.U):
1637 This variable conditionally defines the HAS_STRTOL symbol, which
1638 indicates to the C program that the strtol() routine is available
1639 to provide better numeric string conversion than atoi() and friends.
1641 d_strtold (d_strtold.U):
1642 This variable conditionally defines the HAS_STRTOLD symbol, which
1643 indicates to the C program that the strtold() routine is available.
1645 d_strtoll (d_strtoll.U):
1646 This variable conditionally defines the HAS_STRTOLL symbol, which
1647 indicates to the C program that the strtoll() routine is available.
1649 d_strtoq (d_strtoq.U):
1650 This variable conditionally defines the HAS_STRTOQ symbol, which
1651 indicates to the C program that the strtoq() routine is available.
1653 d_strtoul (d_strtoul.U):
1654 This variable conditionally defines the HAS_STRTOUL symbol, which
1655 indicates to the C program that the strtoul() routine is available
1656 to provide conversion of strings to unsigned long.
1658 d_strtoull (d_strtoull.U):
1659 This variable conditionally defines the HAS_STRTOULL symbol, which
1660 indicates to the C program that the strtoull() routine is available.
1662 d_strtouq (d_strtouq.U):
1663 This variable conditionally defines the HAS_STRTOUQ symbol, which
1664 indicates to the C program that the strtouq() routine is available.
1666 d_strxfrm (d_strxfrm.U):
1667 This variable conditionally defines HAS_STRXFRM if strxfrm() is
1668 available to transform strings.
1670 d_suidsafe (d_dosuid.U):
1671 This variable conditionally defines SETUID_SCRIPTS_ARE_SECURE_NOW
1672 if setuid scripts can be secure. This test looks in /dev/fd/.
1674 d_symlink (d_symlink.U):
1675 This variable conditionally defines the HAS_SYMLINK symbol, which
1676 indicates to the C program that the symlink() routine is available
1677 to create symbolic links.
1679 d_syscall (d_syscall.U):
1680 This variable conditionally defines HAS_SYSCALL if syscall() is
1681 available call arbitrary system calls.
1683 d_syscallproto (d_syscallproto.U):
1684 This variable conditionally defines the HAS_SYSCALL_PROTO symbol,
1685 which indicates to the C program that the system provides
1686 a prototype for the syscall() function. Otherwise, it is
1687 up to the program to supply one.
1689 d_sysconf (d_sysconf.U):
1690 This variable conditionally defines the HAS_SYSCONF symbol, which
1691 indicates to the C program that the sysconf() routine is available
1692 to determine system related limits and options.
1694 d_sysernlst (d_strerror.U):
1695 This variable conditionally defines HAS_SYS_ERRNOLIST if sys_errnolist[]
1696 is available to translate error numbers to the symbolic name.
1698 d_syserrlst (d_strerror.U):
1699 This variable conditionally defines HAS_SYS_ERRLIST if sys_errlist[] is
1700 available to translate error numbers to strings.
1702 d_system (d_system.U):
1703 This variable conditionally defines HAS_SYSTEM if system() is
1704 available to issue a shell command.
1706 d_tcgetpgrp (d_tcgtpgrp.U):
1707 This variable conditionally defines the HAS_TCGETPGRP symbol, which
1708 indicates to the C program that the tcgetpgrp() routine is available.
1709 to get foreground process group ID.
1711 d_tcsetpgrp (d_tcstpgrp.U):
1712 This variable conditionally defines the HAS_TCSETPGRP symbol, which
1713 indicates to the C program that the tcsetpgrp() routine is available
1714 to set foreground process group ID.
1716 d_telldir (d_readdir.U):
1717 This variable conditionally defines HAS_TELLDIR if telldir() is
1720 d_telldirproto (d_telldirproto.U):
1721 This variable conditionally defines the HAS_TELLDIR_PROTO symbol,
1722 which indicates to the C program that the system provides
1723 a prototype for the telldir() function. Otherwise, it is
1724 up to the program to supply one.
1727 This variable conditionally defines the HAS_TIME symbol, which indicates
1728 that the time() routine exists. The time() routine is normaly
1729 provided on UNIX systems.
1731 d_times (d_times.U):
1732 This variable conditionally defines the HAS_TIMES symbol, which indicates
1733 that the times() routine exists. The times() routine is normaly
1734 provided on UNIX systems. You may have to include <sys/times.h>.
1736 d_truncate (d_truncate.U):
1737 This variable conditionally defines HAS_TRUNCATE if truncate() is
1738 available to truncate files.
1740 d_tzname (d_tzname.U):
1741 This variable conditionally defines HAS_TZNAME if tzname[] is
1742 available to access timezone names.
1744 d_u32align (d_u32align.U):
1745 This variable tells whether you must access character data
1746 through U32-aligned pointers.
1748 d_ualarm (d_ualarm.U):
1749 This variable conditionally defines the HAS_UALARM symbol, which
1750 indicates to the C program that the ualarm() routine is available.
1752 d_umask (d_umask.U):
1753 This variable conditionally defines the HAS_UMASK symbol, which
1754 indicates to the C program that the umask() routine is available.
1755 to set and get the value of the file creation mask.
1757 d_uname (d_gethname.U):
1758 This variable conditionally defines the HAS_UNAME symbol, which
1759 indicates to the C program that the uname() routine may be
1760 used to derive the host name.
1762 d_union_semun (d_union_semun.U):
1763 This variable conditionally defines HAS_UNION_SEMUN if the
1764 union semun is defined by including <sys/sem.h>.
1766 d_usleep (d_usleep.U):
1767 This variable conditionally defines HAS_USLEEP if usleep() is
1768 available to do high granularity sleeps.
1770 d_usleepproto (d_usleepproto.U):
1771 This variable conditionally defines the HAS_USLEEP_PROTO symbol,
1772 which indicates to the C program that the system provides
1773 a prototype for the usleep() function. Otherwise, it is
1774 up to the program to supply one.
1776 d_ustat (d_ustat.U):
1777 This variable conditionally defines HAS_USTAT if ustat() is
1778 available to query file system statistics by dev_t.
1780 d_vendorarch (vendorarch.U):
1781 This variable conditionally defined PERL_VENDORARCH.
1783 d_vendorbin (vendorbin.U):
1784 This variable conditionally defines PERL_VENDORBIN.
1786 d_vendorlib (vendorlib.U):
1787 This variable conditionally defines PERL_VENDORLIB.
1789 d_vfork (d_vfork.U):
1790 This variable conditionally defines the HAS_VFORK symbol, which
1791 indicates the vfork() routine is available.
1793 d_void_closedir (d_closedir.U):
1794 This variable conditionally defines VOID_CLOSEDIR if closedir()
1795 does not return a value.
1797 d_voidsig (d_voidsig.U):
1798 This variable conditionally defines VOIDSIG if this system
1799 declares "void (*signal(...))()" in signal.h. The old way was to
1800 declare it as "int (*signal(...))()".
1802 d_voidtty (i_sysioctl.U):
1803 This variable conditionally defines USE_IOCNOTTY to indicate that the
1804 ioctl() call with TIOCNOTTY should be used to void tty association.
1805 Otherwise (on USG probably), it is enough to close the standard file
1806 decriptors and do a setpgrp().
1808 d_volatile (d_volatile.U):
1809 This variable conditionally defines the HASVOLATILE symbol, which
1810 indicates to the C program that this C compiler knows about the
1811 volatile declaration.
1813 d_vprintf (d_vprintf.U):
1814 This variable conditionally defines the HAS_VPRINTF symbol, which
1815 indicates to the C program that the vprintf() routine is available
1816 to printf with a pointer to an argument list.
1818 d_wait4 (d_wait4.U):
1819 This variable conditionally defines the HAS_WAIT4 symbol, which
1820 indicates the wait4() routine is available.
1822 d_waitpid (d_waitpid.U):
1823 This variable conditionally defines HAS_WAITPID if waitpid() is
1824 available to wait for child process.
1826 d_wcstombs (d_wcstombs.U):
1827 This variable conditionally defines the HAS_WCSTOMBS symbol, which
1828 indicates to the C program that the wcstombs() routine is available
1829 to convert wide character strings to multibyte strings.
1831 d_wctomb (d_wctomb.U):
1832 This variable conditionally defines the HAS_WCTOMB symbol, which
1833 indicates to the C program that the wctomb() routine is available
1834 to convert a wide character to a multibyte.
1836 d_writev (d_writev.U):
1837 This variable conditionally defines the HAS_WRITEV symbol, which
1838 indicates to the C program that the writev() routine is available.
1841 This variable conditionally defines the symbol XENIX, which alerts
1842 the C program that it runs under Xenix.
1845 This variable is used internally by Configure to determine the
1846 full pathname (if any) of the date program. After Configure runs,
1847 the value is reset to a plain "date" and is not useful.
1849 db_hashtype (i_db.U):
1850 This variable contains the type of the hash structure element
1851 in the <db.h> header file. In older versions of DB, it was
1852 int, while in newer ones it is u_int32_t.
1854 db_prefixtype (i_db.U):
1855 This variable contains the type of the prefix structure element
1856 in the <db.h> header file. In older versions of DB, it was
1857 int, while in newer ones it is size_t.
1859 db_version_major (i_db.U):
1860 This variable contains the major version number of
1861 Berkeley DB found in the <db.h> header file.
1863 db_version_minor (i_db.U):
1864 This variable contains the minor version number of
1865 Berkeley DB found in the <db.h> header file.
1866 For DB version 1 this is always 0.
1868 db_version_patch (i_db.U):
1869 This variable contains the patch version number of
1870 Berkeley DB found in the <db.h> header file.
1871 For DB version 1 this is always 0.
1873 defvoidused (voidflags.U):
1874 This variable contains the default value of the VOIDUSED symbol (15).
1876 direntrytype (i_dirent.U):
1877 This symbol is set to 'struct direct' or 'struct dirent' depending on
1878 whether dirent is available or not. You should use this pseudo type to
1879 portably declare your directory entries.
1882 This variable contains the extension that is to be used for the
1883 dynamically loaded modules that perl generaties.
1886 This variable contains the name of the dynamic loading file that
1887 will be used with the package.
1889 doublesize (doublesize.U):
1890 This variable contains the value of the DOUBLESIZE symbol, which
1891 indicates to the C program how many bytes there are in a double.
1893 drand01 (randfunc.U):
1894 Indicates the macro to be used to generate normalized
1895 random numbers. Uses randfunc, often divided by
1896 (double) (((unsigned long) 1 << randbits)) in order to
1897 normalize the result.
1898 In C programs, the macro 'Drand01' is mapped to drand01.
1900 dynamic_ext (Extensions.U):
1901 This variable holds a list of XS extension files we want to
1902 link dynamically into the package. It is used by Makefile.
1904 eagain (nblock_io.U):
1905 This variable bears the symbolic errno code set by read() when no
1906 data is present on the file and non-blocking I/O was enabled (otherwise,
1907 read() blocks naturally).
1910 This variable conditionally defines EBCDIC if this
1911 system uses EBCDIC encoding. Among other things, this
1912 means that the character ranges are not contiguous.
1916 This variable is used internally by Configure to determine the
1917 full pathname (if any) of the echo program. After Configure runs,
1918 the value is reset to a plain "echo" and is not useful.
1921 This variable is used internally by Configure to determine the
1922 full pathname (if any) of the egrep program. After Configure runs,
1923 the value is reset to a plain "egrep" and is not useful.
1926 This variable is defined but not used by Configure.
1927 The value is a plain '' and is not useful.
1930 When running under Eunice this variable contains a command which will
1931 convert a shell script to the proper form of text file for it to be
1932 executable by the shell. On other systems it is a no-op.
1935 This is an old synonym for _exe.
1938 This variable is used internally by Configure to determine the
1939 full pathname (if any) of the expr program. After Configure runs,
1940 the value is reset to a plain "expr" and is not useful.
1942 extensions (Extensions.U):
1943 This variable holds a list of all extension files (both XS and
1944 non-xs linked into the package. It is propagated to Config.pm
1945 and is typically used to test whether a particular extesion
1948 fflushall (fflushall.U):
1949 This symbol, if defined, tells that to flush
1950 all pending stdio output one must loop through all
1951 the stdio file handles stored in an array and fflush them.
1952 Note that if fflushNULL is defined, fflushall will not
1953 even be probed for and will be left undefined.
1955 fflushNULL (fflushall.U):
1956 This symbol, if defined, tells that fflush(NULL) does flush
1957 all pending stdio output.
1960 This variable is defined but not used by Configure.
1961 The value is a plain '' and is not useful.
1963 firstmakefile (Unix.U):
1964 This variable defines the first file searched by make. On unix,
1965 it is makefile (then Makefile). On case-insensitive systems,
1966 it might be something else. This is only used to deal with
1967 convoluted make depend tricks.
1970 This variable is defined but not used by Configure.
1971 The value is a plain '' and is not useful.
1973 fpossize (fpossize.U):
1974 This variable contains the size of a fpostype in bytes.
1976 fpostype (fpostype.U):
1977 This variable defines Fpos_t to be something like fpos_t, long,
1978 uint, or whatever type is used to declare file positions in libc.
1980 freetype (mallocsrc.U):
1981 This variable contains the return type of free(). It is usually
1982 void, but occasionally int.
1985 This variable contains the command used by Configure
1986 to copy files from the target host. Useful and available
1987 only during Perl build.
1988 The string ':' if not cross-compiling.
1991 This variable contains the full pathname to 'ar', whether or
1992 not the user has specified 'portability'. This is only used
1996 This variable contains the full pathname to 'csh', whether or
1997 not the user has specified 'portability'. This is only used
1998 in the compiled C program, and we assume that all systems which
1999 can share this executable will have the same full pathname to
2002 full_sed (Loc_sed.U):
2003 This variable contains the full pathname to 'sed', whether or
2004 not the user has specified 'portability'. This is only used
2005 in the compiled C program, and we assume that all systems which
2006 can share this executable will have the same full pathname to
2009 gccosandvers (gccvers.U):
2010 If GNU cc (gcc) is used, this variable the operating system and
2011 version used to compile the gcc. It is set to '' if not gcc,
2012 or if nothing useful can be parsed as the os version.
2014 gccversion (gccvers.U):
2015 If GNU cc (gcc) is used, this variable holds '1' or '2' to
2016 indicate whether the compiler is version 1 or 2. This is used in
2017 setting some of the default cflags. It is set to '' if not gcc.
2020 This variable contains the format string used for printing a Gid_t.
2022 gidsign (gidsign.U):
2023 This variable contains the signedness of a gidtype.
2024 1 for unsigned, -1 for signed.
2026 gidsize (gidsize.U):
2027 This variable contains the size of a gidtype in bytes.
2029 gidtype (gidtype.U):
2030 This variable defines Gid_t to be something like gid_t, int,
2031 ushort, or whatever type is used to declare the return type
2032 of getgid(). Typically, it is the type of group ids in the kernel.
2035 This variable holds the general path (space-separated) used to
2036 find libraries. It may contain directories that do not exist on
2037 this platform, libpth is the cleaned-up version.
2040 This variable is used internally by Configure to determine the
2041 full pathname (if any) of the grep program. After Configure runs,
2042 the value is reset to a plain "grep" and is not useful.
2045 This variable contains a command that produces the text of the
2046 /etc/group file. This is normally "cat /etc/group", but can be
2047 "ypcat group" when NIS is used.
2048 On some systems, such as os390, there may be no equivalent
2049 command, in which case this variable is unset.
2051 groupstype (groupstype.U):
2052 This variable defines Groups_t to be something like gid_t, int,
2053 ushort, or whatever type is used for the second argument to
2054 getgroups() and setgroups(). Usually, this is the same as
2055 gidtype (gid_t), but sometimes it isn't.
2058 This variable is used internally by Configure to determine the
2059 full pathname (if any) of the gzip program. After Configure runs,
2060 the value is reset to a plain "gzip" and is not useful.
2062 h_fcntl (h_fcntl.U):
2063 This is variable gets set in various places to tell i_fcntl that
2064 <fcntl.h> should be included.
2066 h_sysfile (h_sysfile.U):
2067 This is variable gets set in various places to tell i_sys_file that
2068 <sys/file.h> should be included.
2071 Gives the type of hints used for previous answers. May be one of
2072 "default", "recommended" or "previous".
2075 This variable contains a command that produces the text of the
2076 /etc/hosts file. This is normally "cat /etc/hosts", but can be
2077 "ypcat hosts" when NIS is used.
2078 On some systems, such as os390, there may be no equivalent
2079 command, in which case this variable is unset.
2082 This variable is the size of an I16 in bytes.
2085 This variable contains the C type used for Perl's I16.
2088 This variable is the size of an I32 in bytes.
2091 This variable contains the C type used for Perl's I32.
2094 This variable is the size of an I64 in bytes.
2097 This variable contains the C type used for Perl's I64.
2100 This variable is the size of an I8 in bytes.
2103 This variable contains the C type used for Perl's I8.
2105 i_arpainet (i_arpainet.U):
2106 This variable conditionally defines the I_ARPA_INET symbol,
2107 and indicates whether a C program should include <arpa/inet.h>.
2109 i_bsdioctl (i_sysioctl.U):
2110 This variable conditionally defines the I_SYS_BSDIOCTL symbol, which
2111 indicates to the C program that <sys/bsdioctl.h> exists and should
2115 This variable conditionally defines the I_DB symbol, and indicates
2116 whether a C program may include Berkeley's DB include file <db.h>.
2119 This variable conditionally defines the I_DBM symbol, which
2120 indicates to the C program that <dbm.h> exists and should
2123 i_dirent (i_dirent.U):
2124 This variable conditionally defines I_DIRENT, which indicates
2125 to the C program that it should include <dirent.h>.
2128 This variable conditionally defines the I_DLD symbol, which
2129 indicates to the C program that <dld.h> (GNU dynamic loading)
2130 exists and should be included.
2132 i_dlfcn (i_dlfcn.U):
2133 This variable conditionally defines the I_DLFCN symbol, which
2134 indicates to the C program that <dlfcn.h> exists and should
2137 i_fcntl (i_fcntl.U):
2138 This variable controls the value of I_FCNTL (which tells
2139 the C program to include <fcntl.h>).
2141 i_float (i_float.U):
2142 This variable conditionally defines the I_FLOAT symbol, and indicates
2143 whether a C program may include <float.h> to get symbols like DBL_MAX
2144 or DBL_MIN, i.e. machine dependent floating point values.
2147 This variable conditionally defines the I_GDBM symbol, which
2148 indicates to the C program that <gdbm.h> exists and should
2152 This variable conditionally defines the I_GRP symbol, and indicates
2153 whether a C program should include <grp.h>.
2155 i_iconv (i_iconv.U):
2156 This variable conditionally defines the I_ICONV symbol, and indicates
2157 whether a C program should include <iconv.h>.
2159 i_ieeefp (i_ieeefp.U):
2160 This variable conditionally defines the I_IEEEFP symbol, and indicates
2161 whether a C program should include <ieeefp.h>.
2163 i_inttypes (i_inttypes.U):
2164 This variable conditionally defines the I_INTTYPES symbol,
2165 and indicates whether a C program should include <inttypes.h>.
2167 i_libutil (i_libutil.U):
2168 This variable conditionally defines the I_LIBUTIL symbol, and indicates
2169 whether a C program should include <libutil.h>.
2171 i_limits (i_limits.U):
2172 This variable conditionally defines the I_LIMITS symbol, and indicates
2173 whether a C program may include <limits.h> to get symbols like WORD_BIT
2176 i_locale (i_locale.U):
2177 This variable conditionally defines the I_LOCALE symbol,
2178 and indicates whether a C program should include <locale.h>.
2180 i_machcthr (i_machcthr.U):
2181 This variable conditionally defines the I_MACH_CTHREADS symbol,
2182 and indicates whether a C program should include <mach/cthreads.h>.
2184 i_malloc (i_malloc.U):
2185 This variable conditionally defines the I_MALLOC symbol, and indicates
2186 whether a C program should include <malloc.h>.
2189 This variable conditionally defines the I_MATH symbol, and indicates
2190 whether a C program may include <math.h>.
2192 i_memory (i_memory.U):
2193 This variable conditionally defines the I_MEMORY symbol, and indicates
2194 whether a C program should include <memory.h>.
2196 i_mntent (i_mntent.U):
2197 This variable conditionally defines the I_MNTENT symbol, and indicates
2198 whether a C program should include <mntent.h>.
2201 This variable conditionally defines the I_NDBM symbol, which
2202 indicates to the C program that <ndbm.h> exists and should
2205 i_netdb (i_netdb.U):
2206 This variable conditionally defines the I_NETDB symbol, and indicates
2207 whether a C program should include <netdb.h>.
2209 i_neterrno (i_neterrno.U):
2210 This variable conditionally defines the I_NET_ERRNO symbol, which
2211 indicates to the C program that <net/errno.h> exists and should
2214 i_netinettcp (i_netinettcp.U):
2215 This variable conditionally defines the I_NETINET_TCP symbol,
2216 and indicates whether a C program should include <netinet/tcp.h>.
2219 This variable conditionally defines I_NETINET_IN, which indicates
2220 to the C program that it should include <netinet/in.h>. Otherwise,
2221 you may try <sys/in.h>.
2224 This variable conditionally defines the I_POLL symbol, and indicates
2225 whether a C program should include <poll.h>.
2228 This variable conditionally defines the I_PROT symbol, and indicates
2229 whether a C program should include <prot.h>.
2231 i_pthread (i_pthread.U):
2232 This variable conditionally defines the I_PTHREAD symbol,
2233 and indicates whether a C program should include <pthread.h>.
2236 This variable conditionally defines I_PWD, which indicates
2237 to the C program that it should include <pwd.h>.
2239 i_rpcsvcdbm (i_dbm.U):
2240 This variable conditionally defines the I_RPCSVC_DBM symbol, which
2241 indicates to the C program that <rpcsvc/dbm.h> exists and should
2242 be included. Some System V systems might need this instead of <dbm.h>.
2245 This variable conditionally defines the I_SFIO symbol,
2246 and indicates whether a C program should include <sfio.h>.
2248 i_sgtty (i_termio.U):
2249 This variable conditionally defines the I_SGTTY symbol, which
2250 indicates to the C program that it should include <sgtty.h> rather
2253 i_shadow (i_shadow.U):
2254 This variable conditionally defines the I_SHADOW symbol, and indicates
2255 whether a C program should include <shadow.h>.
2257 i_socks (i_socks.U):
2258 This variable conditionally defines the I_SOCKS symbol, and indicates
2259 whether a C program should include <socks.h>.
2261 i_stdarg (i_varhdr.U):
2262 This variable conditionally defines the I_STDARG symbol, which
2263 indicates to the C program that <stdarg.h> exists and should
2266 i_stddef (i_stddef.U):
2267 This variable conditionally defines the I_STDDEF symbol, which
2268 indicates to the C program that <stddef.h> exists and should
2271 i_stdlib (i_stdlib.U):
2272 This variable conditionally defines the I_STDLIB symbol, which
2273 indicates to the C program that <stdlib.h> exists and should
2276 i_string (i_string.U):
2277 This variable conditionally defines the I_STRING symbol, which
2278 indicates that <string.h> should be included rather than <strings.h>.
2280 i_sunmath (i_sunmath.U):
2281 This variable conditionally defines the I_SUNMATH symbol, and indicates
2282 whether a C program should include <sunmath.h>.
2284 i_sysaccess (i_sysaccess.U):
2285 This variable conditionally defines the I_SYS_ACCESS symbol,
2286 and indicates whether a C program should include <sys/access.h>.
2288 i_sysdir (i_sysdir.U):
2289 This variable conditionally defines the I_SYS_DIR symbol, and indicates
2290 whether a C program should include <sys/dir.h>.
2292 i_sysfile (i_sysfile.U):
2293 This variable conditionally defines the I_SYS_FILE symbol, and indicates
2294 whether a C program should include <sys/file.h> to get R_OK and friends.
2296 i_sysfilio (i_sysioctl.U):
2297 This variable conditionally defines the I_SYS_FILIO symbol, which
2298 indicates to the C program that <sys/filio.h> exists and should
2299 be included in preference to <sys/ioctl.h>.
2302 This variable conditionally defines I_SYS_IN, which indicates
2303 to the C program that it should include <sys/in.h> instead of
2306 i_sysioctl (i_sysioctl.U):
2307 This variable conditionally defines the I_SYS_IOCTL symbol, which
2308 indicates to the C program that <sys/ioctl.h> exists and should
2311 i_syslog (i_syslog.U):
2312 This variable conditionally defines the I_SYSLOG symbol,
2313 and indicates whether a C program should include <syslog.h>.
2315 i_sysmman (i_sysmman.U):
2316 This variable conditionally defines the I_SYS_MMAN symbol, and
2317 indicates whether a C program should include <sys/mman.h>.
2319 i_sysmode (i_sysmode.U):
2320 This variable conditionally defines the I_SYSMODE symbol,
2321 and indicates whether a C program should include <sys/mode.h>.
2323 i_sysmount (i_sysmount.U):
2324 This variable conditionally defines the I_SYSMOUNT symbol,
2325 and indicates whether a C program should include <sys/mount.h>.
2327 i_sysndir (i_sysndir.U):
2328 This variable conditionally defines the I_SYS_NDIR symbol, and indicates
2329 whether a C program should include <sys/ndir.h>.
2331 i_sysparam (i_sysparam.U):
2332 This variable conditionally defines the I_SYS_PARAM symbol, and indicates
2333 whether a C program should include <sys/param.h>.
2335 i_sysresrc (i_sysresrc.U):
2336 This variable conditionally defines the I_SYS_RESOURCE symbol,
2337 and indicates whether a C program should include <sys/resource.h>.
2339 i_syssecrt (i_syssecrt.U):
2340 This variable conditionally defines the I_SYS_SECURITY symbol,
2341 and indicates whether a C program should include <sys/security.h>.
2343 i_sysselct (i_sysselct.U):
2344 This variable conditionally defines I_SYS_SELECT, which indicates
2345 to the C program that it should include <sys/select.h> in order to
2346 get the definition of struct timeval.
2348 i_syssockio (i_sysioctl.U):
2349 This variable conditionally defines I_SYS_SOCKIO to indicate to the
2350 C program that socket ioctl codes may be found in <sys/sockio.h>
2351 instead of <sys/ioctl.h>.
2353 i_sysstat (i_sysstat.U):
2354 This variable conditionally defines the I_SYS_STAT symbol,
2355 and indicates whether a C program should include <sys/stat.h>.
2357 i_sysstatfs (i_sysstatfs.U):
2358 This variable conditionally defines the I_SYSSTATFS symbol,
2359 and indicates whether a C program should include <sys/statfs.h>.
2361 i_sysstatvfs (i_sysstatvfs.U):
2362 This variable conditionally defines the I_SYSSTATVFS symbol,
2363 and indicates whether a C program should include <sys/statvfs.h>.
2365 i_systime (i_time.U):
2366 This variable conditionally defines I_SYS_TIME, which indicates
2367 to the C program that it should include <sys/time.h>.
2369 i_systimek (i_time.U):
2370 This variable conditionally defines I_SYS_TIME_KERNEL, which
2371 indicates to the C program that it should include <sys/time.h>
2372 with KERNEL defined.
2374 i_systimes (i_systimes.U):
2375 This variable conditionally defines the I_SYS_TIMES symbol, and indicates
2376 whether a C program should include <sys/times.h>.
2378 i_systypes (i_systypes.U):
2379 This variable conditionally defines the I_SYS_TYPES symbol,
2380 and indicates whether a C program should include <sys/types.h>.
2382 i_sysuio (i_sysuio.U):
2383 This variable conditionally defines the I_SYSUIO symbol, and indicates
2384 whether a C program should include <sys/uio.h>.
2386 i_sysun (i_sysun.U):
2387 This variable conditionally defines I_SYS_UN, which indicates
2388 to the C program that it should include <sys/un.h> to get UNIX
2389 domain socket definitions.
2391 i_sysutsname (i_sysutsname.U):
2392 This variable conditionally defines the I_SYSUTSNAME symbol,
2393 and indicates whether a C program should include <sys/utsname.h>.
2395 i_sysvfs (i_sysvfs.U):
2396 This variable conditionally defines the I_SYSVFS symbol,
2397 and indicates whether a C program should include <sys/vfs.h>.
2399 i_syswait (i_syswait.U):
2400 This variable conditionally defines I_SYS_WAIT, which indicates
2401 to the C program that it should include <sys/wait.h>.
2403 i_termio (i_termio.U):
2404 This variable conditionally defines the I_TERMIO symbol, which
2405 indicates to the C program that it should include <termio.h> rather
2408 i_termios (i_termio.U):
2409 This variable conditionally defines the I_TERMIOS symbol, which
2410 indicates to the C program that the POSIX <termios.h> file is
2414 This variable conditionally defines I_TIME, which indicates
2415 to the C program that it should include <time.h>.
2417 i_unistd (i_unistd.U):
2418 This variable conditionally defines the I_UNISTD symbol, and indicates
2419 whether a C program should include <unistd.h>.
2421 i_ustat (i_ustat.U):
2422 This variable conditionally defines the I_USTAT symbol, and indicates
2423 whether a C program should include <ustat.h>.
2425 i_utime (i_utime.U):
2426 This variable conditionally defines the I_UTIME symbol, and indicates
2427 whether a C program should include <utime.h>.
2429 i_values (i_values.U):
2430 This variable conditionally defines the I_VALUES symbol, and indicates
2431 whether a C program may include <values.h> to get symbols like MAXLONG
2434 i_varargs (i_varhdr.U):
2435 This variable conditionally defines I_VARARGS, which indicates
2436 to the C program that it should include <varargs.h>.
2438 i_varhdr (i_varhdr.U):
2439 Contains the name of the header to be included to get va_dcl definition.
2440 Typically one of varargs.h or stdarg.h.
2442 i_vfork (i_vfork.U):
2443 This variable conditionally defines the I_VFORK symbol, and indicates
2444 whether a C program should include vfork.h.
2446 ignore_versioned_solibs (libs.U):
2447 This variable should be non-empty if non-versioned shared
2448 libraries (libfoo.so.x.y) are to be ignored (because they
2449 cannot be linked against).
2451 inc_version_list (inc_version_list.U):
2452 This variable specifies the list of subdirectories in over
2453 which perl.c:incpush() and lib/lib.pm will automatically
2454 search when adding directories to @INC. The elements in
2455 the list are separated by spaces. This is only useful
2456 if you have a perl library directory tree structured like the
2457 default one. See INSTALL for how this works. The versioned
2458 site_perl directory was introduced in 5.005, so that is the
2459 lowest possible value.
2461 inc_version_list_init (inc_version_list.U):
2462 This variable holds the same list as inc_version_list, but
2463 each item is enclosed in double quotes and separated by commas,
2464 suitable for use in the PERL_INC_VERSION_LIST initialization.
2467 This variable must preceed the normal include path to get hte
2468 right one, as in "$incpath/usr/include" or "$incpath/usr/lib".
2469 Value can be "" or "/bsd43" on mips.
2472 This variable is defined but not used by Configure.
2473 The value is a plain '' and is not useful.
2475 installarchlib (archlib.U):
2476 This variable is really the same as archlibexp but may differ on
2477 those systems using AFS. For extra portability, only this variable
2478 should be used in makefiles.
2481 This variable is the same as binexp unless AFS is running in which case
2482 the user is explicitely prompted for it. This variable should always
2483 be used in your makefiles for maximum portability.
2485 installman1dir (man1dir.U):
2486 This variable is really the same as man1direxp, unless you are using
2487 AFS in which case it points to the read/write location whereas
2488 man1direxp only points to the read-only access location. For extra
2489 portability, you should only use this variable within your makefiles.
2491 installman3dir (man3dir.U):
2492 This variable is really the same as man3direxp, unless you are using
2493 AFS in which case it points to the read/write location whereas
2494 man3direxp only points to the read-only access location. For extra
2495 portability, you should only use this variable within your makefiles.
2497 installprefix (installprefix.U):
2498 This variable holds the name of the directory below which
2499 "make install" will install the package. For most users, this
2500 is the same as prefix. However, it is useful for
2501 installing the software into a different (usually temporary)
2502 location after which it can be bundled up and moved somehow
2503 to the final location specified by prefix.
2505 installprefixexp (installprefix.U):
2506 This variable holds the full absolute path of installprefix
2507 with all ~-expansion done.
2509 installprivlib (privlib.U):
2510 This variable is really the same as privlibexp but may differ on
2511 those systems using AFS. For extra portability, only this variable
2512 should be used in makefiles.
2514 installscript (scriptdir.U):
2515 This variable is usually the same as scriptdirexp, unless you are on
2516 a system running AFS, in which case they may differ slightly. You
2517 should always use this variable within your makefiles for portability.
2519 installsitearch (sitearch.U):
2520 This variable is really the same as sitearchexp but may differ on
2521 those systems using AFS. For extra portability, only this variable
2522 should be used in makefiles.
2524 installsitebin (sitebin.U):
2525 This variable is usually the same as sitebinexp, unless you are on
2526 a system running AFS, in which case they may differ slightly. You
2527 should always use this variable within your makefiles for portability.
2529 installsitelib (sitelib.U):
2530 This variable is really the same as sitelibexp but may differ on
2531 those systems using AFS. For extra portability, only this variable
2532 should be used in makefiles.
2534 installstyle (installstyle.U):
2535 This variable describes the "style" of the perl installation.
2536 This is intended to be useful for tools that need to
2537 manipulate entire perl distributions. Perl itself doesn't use
2538 this to find its libraries -- the library directories are
2539 stored directly in Config.pm. Currently, there are only two
2540 styles: "lib" and "lib/perl5". The default library locations
2541 (e.g. privlib, sitelib) are either $prefix/lib or
2542 $prefix/lib/perl5. The former is useful if $prefix is a
2543 directory dedicated to perl (e.g. /opt/perl), while the latter
2544 is useful if $prefix is shared by many packages, e.g. if
2546 This may later be extended to include other information, so
2547 be careful with pattern-matching on the results.
2548 For compatibility with perl5.005 and earlier, the default
2549 setting is based on whether or not $prefix contains the string
2552 installusrbinperl (instubperl.U):
2553 This variable tells whether Perl should be installed also as
2554 /usr/bin/perl in addition to
2557 installvendorarch (vendorarch.U):
2558 This variable is really the same as vendorarchexp but may differ on
2559 those systems using AFS. For extra portability, only this variable
2560 should be used in makefiles.
2562 installvendorbin (vendorbin.U):
2563 This variable is really the same as vendorbinexp but may differ on
2564 those systems using AFS. For extra portability, only this variable
2565 should be used in makefiles.
2567 installvendorlib (vendorlib.U):
2568 This variable is really the same as vendorlibexp but may differ on
2569 those systems using AFS. For extra portability, only this variable
2570 should be used in makefiles.
2572 intsize (intsize.U):
2573 This variable contains the value of the INTSIZE symbol, which
2574 indicates to the C program how many bytes there are in an int.
2576 issymlink (issymlink.U):
2577 This variable holds the test command to test for a symbolic link
2578 (if they are supported). Typical values include 'test -h' and
2581 ivdformat (perlxvf.U):
2582 This variable contains the format string used for printing
2583 a Perl IV as a signed decimal integer.
2586 This variable is the size of an IV in bytes.
2589 This variable contains the C type used for Perl's IV.
2591 known_extensions (Extensions.U):
2592 This variable holds a list of all XS extensions included in
2596 This variable is defined but not used by Configure.
2597 The value is a plain '' and is not useful.
2600 This variable indicates the program to be used to link
2601 libraries for dynamic loading. On some systems, it is 'ld'.
2602 On ELF systems, it should be $cc. Mostly, we'll try to respect
2603 the hint file setting.
2605 lddlflags (dlsrc.U):
2606 This variable contains any special flags that might need to be
2607 passed to $ld to create a shared library suitable for dynamic
2608 loading. It is up to the makefile to use it. For hpux, it
2609 should be '-b'. For sunos 4.1, it is empty.
2611 ldflags (ccflags.U):
2612 This variable contains any additional C loader flags desired by
2613 the user. It is up to the Makefile to use this.
2615 ldflags_uselargefiles (uselfs.U):
2616 This variable contains the loader flags needed by large file builds
2617 and added to ldflags by hints files.
2619 ldlibpthname (libperl.U):
2620 This variable holds the name of the shared library
2621 search path, often LD_LIBRARY_PATH. To get an empty
2622 string, the hints file must set this to 'none'.
2625 This variable is used internally by Configure to determine the
2626 full pathname (if any) of the less program. After Configure runs,
2627 the value is reset to a plain "less" and is not useful.
2630 This is an old synonym for _a.
2633 This variable contains the location of the C library.
2635 libperl (libperl.U):
2636 The perl executable is obtained by linking perlmain.c with
2637 libperl, any static extensions (usually just DynaLoader),
2638 and any other libraries needed on this system. libperl
2639 is usually libperl.a, but can also be libperl.so.xxx if
2640 the user wishes to build a perl executable with a shared
2644 This variable holds the general path (space-separated) used to find
2645 libraries. It is intended to be used by other units.
2648 This variable holds the additional libraries we want to use.
2649 It is up to the Makefile to deal with it.
2652 This variable holds the directory names aka dirnames of the libraries
2653 we found and accepted, duplicates are removed.
2656 This variable holds the filenames aka basenames of the libraries
2657 we found and accepted.
2660 This variable holds the full pathnames of the libraries
2661 we found and accepted.
2664 This variable holds the directory names probed for libraries.
2666 libswanted (Myinit.U):
2667 This variable holds a list of all the libraries we want to
2668 search. The order is chosen to pick up the c library
2669 ahead of ucb or bsd libraries for SVR4.
2671 libswanted_uselargefiles (uselfs.U):
2672 This variable contains the libraries needed by large file builds
2673 and added to ldflags by hints files. It is a space separated list
2674 of the library names without the "lib" prefix or any suffix, just
2678 This variable is defined but not used by Configure.
2679 The value is a plain '' and is not useful.
2682 This variable is defined but not used by Configure.
2683 The value is a plain '' and is not useful.
2685 lkflags (ccflags.U):
2686 This variable contains any additional C partial linker flags desired by
2687 the user. It is up to the Makefile to use this.
2690 This variable is used internally by Configure to determine the
2691 full pathname (if any) of the ln program. After Configure runs,
2692 the value is reset to a plain "ln" and is not useful.
2695 This variable holds the name of the command to make
2696 symbolic links (if they are supported). It can be used
2697 in the Makefile. It is either 'ln -s' or 'ln'
2699 locincpth (ccflags.U):
2700 This variable contains a list of additional directories to be
2701 searched by the compiler. The appropriate '-I' directives will
2702 be added to ccflags. This is intended to simplify setting
2703 local directories from the Configure command line.
2704 It's not much, but it parallels the loclibpth stuff in libpth.U.
2706 loclibpth (libpth.U):
2707 This variable holds the paths (space-separated) used to find local
2708 libraries. It is prepended to libpth, and is intended to be easily
2709 set from the command line.
2711 longdblsize (d_longdbl.U):
2712 This variable contains the value of the LONG_DOUBLESIZE symbol, which
2713 indicates to the C program how many bytes there are in a long double,
2714 if this system supports long doubles.
2716 longlongsize (d_longlong.U):
2717 This variable contains the value of the LONGLONGSIZE symbol, which
2718 indicates to the C program how many bytes there are in a long long,
2719 if this system supports long long.
2721 longsize (intsize.U):
2722 This variable contains the value of the LONGSIZE symbol, which
2723 indicates to the C program how many bytes there are in a long.
2726 This variable is defined but not used by Configure.
2727 The value is a plain '' and is not useful.
2730 This variable is defined but not used by Configure.
2731 The value is a plain '' and is not useful.
2734 This variable is used internally by Configure to determine the
2735 full pathname (if any) of the ls program. After Configure runs,
2736 the value is reset to a plain "ls" and is not useful.
2738 lseeksize (lseektype.U):
2739 This variable defines lseektype to be something like off_t, long,
2740 or whatever type is used to declare lseek offset's type in the
2741 kernel (which also appears to be lseek's return type).
2743 lseektype (lseektype.U):
2744 This variable defines lseektype to be something like off_t, long,
2745 or whatever type is used to declare lseek offset's type in the
2746 kernel (which also appears to be lseek's return type).
2749 This variable is defined but not used by Configure.
2750 The value is a plain '' and is not useful.
2753 This variable is defined but not used by Configure.
2754 The value is a plain '' and is not useful.
2757 This variable is used internally by Configure to determine the
2758 full pathname (if any) of the make program. After Configure runs,
2759 the value is reset to a plain "make" and is not useful.
2761 make_set_make (make.U):
2762 Some versions of 'make' set the variable MAKE. Others do not.
2763 This variable contains the string to be included in Makefile.SH
2764 so that MAKE is set if needed, and not if not needed.
2765 Possible values are:
2766 make_set_make='#' # If your make program handles this for you,
2767 make_set_make="MAKE=$make" # if it doesn't.
2768 I used a comment character so that we can distinguish a
2769 'set' value (from a previous config.sh or Configure '-D' option)
2770 from an uncomputed value.
2772 mallocobj (mallocsrc.U):
2773 This variable contains the name of the malloc.o that this package
2774 generates, if that malloc.o is preferred over the system malloc.
2775 Otherwise the value is null. This variable is intended for generating
2776 Makefiles. See mallocsrc.
2778 mallocsrc (mallocsrc.U):
2779 This variable contains the name of the malloc.c that comes with
2780 the package, if that malloc.c is preferred over the system malloc.
2781 Otherwise the value is null. This variable is intended for generating
2784 malloctype (mallocsrc.U):
2785 This variable contains the kind of ptr returned by malloc and realloc.
2787 man1dir (man1dir.U):
2788 This variable contains the name of the directory in which manual
2789 source pages are to be put. It is the responsibility of the
2790 Makefile.SH to get the value of this into the proper command.
2791 You must be prepared to do the ~name expansion yourself.
2793 man1direxp (man1dir.U):
2794 This variable is the same as the man1dir variable, but is filename
2795 expanded at configuration time, for convenient use in makefiles.
2797 man1ext (man1dir.U):
2798 This variable contains the extension that the manual page should
2799 have: one of 'n', 'l', or '1'. The Makefile must supply the '.'.
2802 man3dir (man3dir.U):
2803 This variable contains the name of the directory in which manual
2804 source pages are to be put. It is the responsibility of the
2805 Makefile.SH to get the value of this into the proper command.
2806 You must be prepared to do the ~name expansion yourself.
2808 man3direxp (man3dir.U):
2809 This variable is the same as the man3dir variable, but is filename
2810 expanded at configuration time, for convenient use in makefiles.
2812 man3ext (man3dir.U):
2813 This variable contains the extension that the manual page should
2814 have: one of 'n', 'l', or '3'. The Makefile must supply the '.'.
2818 This variable is used internally by Configure to determine the
2819 full pathname (if any) of the Mcc program. After Configure runs,
2820 the value is reset to a plain "Mcc" and is not useful.
2822 mips_type (usrinc.U):
2823 This variable holds the environment type for the mips system.
2824 Possible values are "BSD 4.3" and "System V".
2827 This variable is used internally by Configure to determine the
2828 full pathname (if any) of the mkdir program. After Configure runs,
2829 the value is reset to a plain "mkdir" and is not useful.
2831 mmaptype (d_mmap.U):
2832 This symbol contains the type of pointer returned by mmap()
2833 (and simultaneously the type of the first argument).
2834 It can be 'void *' or 'caddr_t'.
2836 modetype (modetype.U):
2837 This variable defines modetype to be something like mode_t,
2838 int, unsigned short, or whatever type is used to declare file
2839 modes for system calls.
2842 This variable is used internally by Configure to determine the
2843 full pathname (if any) of the more program. After Configure runs,
2844 the value is reset to a plain "more" and is not useful.
2846 multiarch (multiarch.U):
2847 This variable conditionally defines the MULTIARCH symbol
2848 which signifies the presence of multiplatform files.
2849 This is normally set by hints files.
2852 This variable is defined but not used by Configure.
2853 The value is a plain '' and is not useful.
2855 myarchname (archname.U):
2856 This variable holds the architecture name computed by Configure in
2857 a previous run. It is not intended to be perused by any user and
2858 should never be set in a hint file.
2860 mydomain (myhostname.U):
2861 This variable contains the eventual value of the MYDOMAIN symbol,
2862 which is the domain of the host the program is going to run on.
2863 The domain must be appended to myhostname to form a complete host name.
2864 The dot comes with mydomain, and need not be supplied by the program.
2866 myhostname (myhostname.U):
2867 This variable contains the eventual value of the MYHOSTNAME symbol,
2868 which is the name of the host the program is going to run on.
2869 The domain is not kept with hostname, but must be gotten from mydomain.
2870 The dot comes with mydomain, and need not be supplied by the program.
2872 myuname (Oldconfig.U):
2873 The output of 'uname -a' if available, otherwise the hostname. On Xenix,
2874 pseudo variables assignments in the output are stripped, thank you. The
2875 whole thing is then lower-cased.
2878 This variable contains the '-n' flag if that is what causes the echo
2879 command to suppress newline. Otherwise it is null. Correct usage is
2880 $echo $n "prompt for a question: $c".
2882 need_va_copy (need_va_copy.U):
2883 This symbol, if defined, indicates that the system stores
2884 the variable argument list datatype, va_list, in a format
2885 that cannot be copied by simple assignment, so that some
2886 other means must be used when copying is required.
2887 As such systems vary in their provision (or non-provision)
2888 of copying mechanisms, handy.h defines a platform-
2889 independent macro, Perl_va_copy(src, dst), to do the job.
2891 netdb_hlen_type (netdbtype.U):
2892 This variable holds the type used for the 2nd argument to
2893 gethostbyaddr(). Usually, this is int or size_t or unsigned.
2894 This is only useful if you have gethostbyaddr(), naturally.
2896 netdb_host_type (netdbtype.U):
2897 This variable holds the type used for the 1st argument to
2898 gethostbyaddr(). Usually, this is char * or void *, possibly
2899 with or without a const prefix.
2900 This is only useful if you have gethostbyaddr(), naturally.
2902 netdb_name_type (netdbtype.U):
2903 This variable holds the type used for the argument to
2904 gethostbyname(). Usually, this is char * or const char *.
2905 This is only useful if you have gethostbyname(), naturally.
2907 netdb_net_type (netdbtype.U):
2908 This variable holds the type used for the 1st argument to
2909 getnetbyaddr(). Usually, this is int or long.
2910 This is only useful if you have getnetbyaddr(), naturally.
2913 This variable is used internally by Configure to determine the
2914 full pathname (if any) of the nm program. After Configure runs,
2915 the value is reset to a plain "nm" and is not useful.
2918 This variable holds the options that may be necessary for nm.
2920 nm_so_opt (usenm.U):
2921 This variable holds the options that may be necessary for nm
2922 to work on a shared library but that can not be used on an
2923 archive library. Currently, this is only used by Linux, where
2924 nm --dynamic is *required* to get symbols from an ELF library which
2925 has been stripped, but nm --dynamic is *fatal* on an archive library.
2926 Maybe Linux should just always set usenm=false.
2928 nonxs_ext (Extensions.U):
2929 This variable holds a list of all non-xs extensions included
2930 in the package. All of them will be built.
2933 This variable is used internally by Configure to determine the
2934 full pathname (if any) of the nroff program. After Configure runs,
2935 the value is reset to a plain "nroff" and is not useful.
2937 nveformat (perlxvf.U):
2938 This variable contains the format string used for printing
2939 a Perl NV using %e-ish floating point format.
2941 nvEUformat (perlxvf.U):
2942 This variable contains the format string used for printing
2943 a Perl NV using %E-ish floating point format.
2945 nvfformat (perlxvf.U):
2946 This variable confains the format string used for printing
2947 a Perl NV using %f-ish floating point format.
2949 nvFUformat (perlxvf.U):
2950 This variable confains the format string used for printing
2951 a Perl NV using %F-ish floating point format.
2953 nvgformat (perlxvf.U):
2954 This variable contains the format string used for printing
2955 a Perl NV using %g-ish floating point format.
2957 nvGUformat (perlxvf.U):
2958 This variable contains the format string used for printing
2959 a Perl NV using %G-ish floating point format.
2962 This variable is the size of an NV in bytes.
2965 This variable contains the C type used for Perl's NV.
2967 o_nonblock (nblock_io.U):
2968 This variable bears the symbol value to be used during open() or fcntl()
2969 to turn on non-blocking I/O for a file descriptor. If you wish to switch
2970 between blocking and non-blocking, you may try ioctl(FIOSNBIO) instead,
2971 but that is only supported by some devices.
2974 This is an old synonym for _o.
2976 old_pthread_create_joinable (d_pthrattrj.U):
2977 This variable defines the constant to use for creating joinable
2978 (aka undetached) pthreads. Unused if pthread.h defines
2979 PTHREAD_CREATE_JOINABLE. If used, possible values are
2980 PTHREAD_CREATE_UNDETACHED and __UNDETACHED.
2982 optimize (ccflags.U):
2983 This variable contains any optimizer/debugger flag that should be used.
2984 It is up to the Makefile to use it.
2986 orderlib (orderlib.U):
2987 This variable is "true" if the components of libraries must be ordered
2988 (with `lorder $* | tsort`) before placing them in an archive. Set to
2989 "false" if ranlib or ar can generate random libraries.
2991 osname (Oldconfig.U):
2992 This variable contains the operating system name (e.g. sunos,
2993 solaris, hpux, etc.). It can be useful later on for setting
2994 defaults. Any spaces are replaced with underscores. It is set
2995 to a null string if we can't figure it out.
2997 osvers (Oldconfig.U):
2998 This variable contains the operating system version (e.g.
2999 4.1.3, 5.2, etc.). It is primarily used for helping select
3000 an appropriate hints file, but might be useful elsewhere for
3001 setting defaults. It is set to '' if we can't figure it out.
3002 We try to be flexible about how much of the version number
3003 to keep, e.g. if 4.1.1, 4.1.2, and 4.1.3 are essentially the
3004 same for this package, hints files might just be os_4.0 or
3005 os_4.1, etc., not keeping separate files for each little release.
3007 otherlibdirs (otherlibdirs.U):
3008 This variable contains a colon-separated set of paths for the perl
3009 binary to search for additional library files or modules.
3010 These directories will be tacked to the end of @INC.
3011 Perl will automatically search below each path for version-
3012 and architecture-specific directories. See inc_version_list
3014 A value of ' ' means 'none' and is used to preserve this value
3015 for the next run through Configure.
3017 package (package.U):
3018 This variable contains the name of the package being constructed.
3019 It is primarily intended for the use of later Configure units.
3022 This variable contains the name of the preferred pager on the system.
3023 Usual values are (the full pathnames of) more, less, pg, or cat.
3026 This variable contains a command that produces the text of the
3027 /etc/passwd file. This is normally "cat /etc/passwd", but can be
3028 "ypcat passwd" when NIS is used.
3029 On some systems, such as os390, there may be no equivalent
3030 command, in which case this variable is unset.
3032 patchlevel (patchlevel.U):
3033 The patchlevel level of this package.
3034 The value of patchlevel comes from the patchlevel.h file.
3035 In a version number such as 5.6.1, this is the "6".
3036 In patchlevel.h, this is referred to as "PERL_VERSION".
3039 This is an old synonym for p_ in Head.U, the character
3040 used to separate elements in the command shell search PATH.
3043 This variable contains the full path (if any) to a previously
3044 installed perl5.005 or later suitable for running the script
3045 to determine inc_version_list.
3048 This variable is defined but not used by Configure.
3049 The value is a plain '' and is not useful.
3051 perl_patchlevel (patchlevel.U):
3052 This is the Perl patch level, a numeric change identifier,
3053 as defined by whichever source code maintenance system
3054 is used to maintain the patches; currently Perforce.
3055 It does not correlate with the Perl version numbers or
3056 the maintenance versus development dichotomy except
3057 by also being increasing.
3059 PERL_REVISION (Oldsyms.U):
3060 In a Perl version number such as 5.6.2, this is the 5.
3061 This value is manually set in patchlevel.h
3063 PERL_SUBVERSION (Oldsyms.U):
3064 In a Perl version number such as 5.6.2, this is the 2.
3065 Values greater than 50 represent potentially unstable
3066 development subversions.
3067 This value is manually set in patchlevel.h
3069 PERL_VERSION (Oldsyms.U):
3070 In a Perl version number such as 5.6.2, this is the 6.
3071 This value is manually set in patchlevel.h
3073 perladmin (perladmin.U):
3074 Electronic mail address of the perl5 administrator.
3077 The list of libraries needed by Perl only (any libraries needed
3078 by extensions only will by dropped, if using dynamic loading).
3080 perlpath (perlpath.U):
3081 This variable contains the eventual value of the PERLPATH symbol,
3082 which contains the name of the perl interpreter to be used in
3083 shell scripts and in the "eval 'exec'" idiom.
3086 This variable is used internally by Configure to determine the
3087 full pathname (if any) of the pg program. After Configure runs,
3088 the value is reset to a plain "pg" and is not useful.
3090 phostname (myhostname.U):
3091 This variable contains the eventual value of the PHOSTNAME symbol,
3092 which is a command that can be fed to popen() to get the host name.
3093 The program should probably not presume that the domain is or isn't
3096 pidtype (pidtype.U):
3097 This variable defines PIDTYPE to be something like pid_t, int,
3098 ushort, or whatever type is used to declare process ids in the kernel.
3101 Holds the private path used by Configure to find out the libraries.
3102 Its value is prepend to libpth. This variable takes care of special
3103 machines, like the mips. Usually, it should be empty.
3105 pm_apiversion (xs_apiversion.U):
3106 This variable contains the version of the oldest perl
3107 compatible with the present perl. (That is, pure perl modules
3108 written for $pm_apiversion will still work for the current
3109 version). perl.c:incpush() and lib/lib.pm will automatically
3110 search in $sitelib for older directories across major versions
3111 back to pm_apiversion. This is only useful if you have a perl
3112 library directory tree structured like the default one. The
3113 versioned site_perl library was introduced in 5.005, so that's
3114 the default setting for this variable. It's hard to imagine
3115 it changing before Perl6. It is included here for symmetry
3116 with xs_apiveprsion -- the searching algorithms will
3117 (presumably) be similar.
3118 See the INSTALL file for how this works.
3121 This variable is defined but not used by Configure.
3122 The value is a plain '' and is not useful.
3125 This variable is defined but not used by Configure.
3126 The value is a plain '' and is not useful.
3129 This variable holds the name of the directory below which the
3130 user will install the package. Usually, this is /usr/local, and
3131 executables go in /usr/local/bin, library stuff in /usr/local/lib,
3132 man pages in /usr/local/man, etc. It is only used to set defaults
3133 for things in bin.U, mansrc.U, privlib.U, or scriptdir.U.
3135 prefixexp (prefix.U):
3136 This variable holds the full absolute path of the directory below
3137 which the user will install the package. Derived from prefix.
3139 privlib (privlib.U):
3140 This variable contains the eventual value of the PRIVLIB symbol,
3141 which is the name of the private library for this package. It may
3142 have a ~ on the front. It is up to the makefile to eventually create
3143 this directory while performing installation (with ~ substitution).
3145 privlibexp (privlib.U):
3146 This variable is the ~name expanded version of privlib, so that you
3147 may use it directly in Makefiles or shell scripts.
3149 prototype (prototype.U):
3150 This variable holds the eventual value of CAN_PROTOTYPE, which
3151 indicates the C compiler can handle funciton prototypes.
3153 ptrsize (ptrsize.U):
3154 This variable contains the value of the PTRSIZE symbol, which
3155 indicates to the C program how many bytes there are in a pointer.
3157 quadkind (quadtype.U):
3158 This variable, if defined, encodes the type of a quad:
3159 1 = int, 2 = long, 3 = long long, 4 = int64_t.
3161 quadtype (quadtype.U):
3162 This variable defines Quad_t to be something like long, int,
3163 long long, int64_t, or whatever type is used for 64-bit integers.
3165 randbits (randfunc.U):
3166 Indicates how many bits are produced by the function used to
3167 generate normalized random numbers.
3169 randfunc (randfunc.U):
3170 Indicates the name of the random number function to use.
3171 Values include drand48, random, and rand. In C programs,
3172 the 'Drand01' macro is defined to generate uniformly distributed
3173 random numbers over the range [0., 1.[ (see drand01 and nrand).
3175 randseedtype (randfunc.U):
3176 Indicates the type of the argument of the seedfunc.
3178 ranlib (orderlib.U):
3179 This variable is set to the pathname of the ranlib program, if it is
3180 needed to generate random libraries. Set to ":" if ar can generate
3181 random libraries or if random libraries are not supported
3183 rd_nodata (nblock_io.U):
3184 This variable holds the return code from read() when no data is
3185 present. It should be -1, but some systems return 0 when O_NDELAY is
3186 used, which is a shame because you cannot make the difference between
3187 no data and an EOF.. Sigh!
3189 revision (patchlevel.U):
3190 The value of revision comes from the patchlevel.h file.
3191 In a version number such as 5.6.1, this is the "5".
3192 In patchlevel.h, this is referred to as "PERL_REVISION".
3195 This variable is used internally by Configure to determine the
3196 full pathname (if any) of the rm program. After Configure runs,
3197 the value is reset to a plain "rm" and is not useful.
3200 This variable is defined but not used by Configure.
3201 The value is a plain '' and is not useful.
3204 This variable contains the command used by Configure
3205 to copy and execute a cross-compiled executable in the
3206 target host. Useful and available only during Perl build.
3207 Empty string '' if not cross-compiling.
3210 This variable contains 'true' or 'false' depending whether the
3211 nm extraction should be performed or not, according to the value
3212 of usenm and the flags on the Configure command line.
3214 sched_yield (d_pthread_y.U):
3215 This variable defines the way to yield the execution
3216 of the current thread.
3218 scriptdir (scriptdir.U):
3219 This variable holds the name of the directory in which the user wants
3220 to put publicly scripts for the package in question. It is either
3221 the same directory as for binaries, or a special one that can be
3222 mounted across different architectures, like /usr/share. Programs
3223 must be prepared to deal with ~name expansion.
3225 scriptdirexp (scriptdir.U):
3226 This variable is the same as scriptdir, but is filename expanded
3227 at configuration time, for programs not wanting to bother with it.
3230 This variable is used internally by Configure to determine the
3231 full pathname (if any) of the sed program. After Configure runs,
3232 the value is reset to a plain "sed" and is not useful.
3234 seedfunc (randfunc.U):
3235 Indicates the random number generating seed function.
3236 Values include srand48, srandom, and srand.
3238 selectminbits (selectminbits.U):
3239 This variable holds the minimum number of bits operated by select.
3240 That is, if you do select(n, ...), how many bits at least will be
3241 cleared in the masks if some activity is detected. Usually this
3242 is either n or 32*ceil(n/32), especially many little-endians do
3243 the latter. This is only useful if you have select(), naturally.
3245 selecttype (selecttype.U):
3246 This variable holds the type used for the 2nd, 3rd, and 4th
3247 arguments to select. Usually, this is 'fd_set *', if HAS_FD_SET
3248 is defined, and 'int *' otherwise. This is only useful if you
3249 have select(), naturally.
3252 This variable is defined but not used by Configure.
3253 The value is a plain '' and is not useful.
3256 This variable contains the full pathname of the shell used
3257 on this system to execute Bourne shell scripts. Usually, this will be
3258 /bin/sh, though it's possible that some systems will have /bin/ksh,
3259 /bin/pdksh, /bin/ash, /bin/bash, or even something such as
3261 This unit comes before Options.U, so you can't set sh with a '-D'
3262 option, though you can override this (and startsh)
3263 with '-O -Dsh=/bin/whatever -Dstartsh=whatever'
3266 This variable is defined but not used by Configure.
3267 The value is a plain '' and is not useful.
3269 sharpbang (spitshell.U):
3270 This variable contains the string #! if this system supports that
3273 shmattype (d_shmat.U):
3274 This symbol contains the type of pointer returned by shmat().
3275 It can be 'void *' or 'char *'.
3277 shortsize (intsize.U):
3278 This variable contains the value of the SHORTSIZE symbol which
3279 indicates to the C program how many bytes there are in a short.
3281 shrpenv (libperl.U):
3282 If the user builds a shared libperl.so, then we need to tell the
3283 'perl' executable where it will be able to find the installed libperl.so.
3284 One way to do this on some systems is to set the environment variable
3285 LD_RUN_PATH to the directory that will be the final location of the
3286 shared libperl.so. The makefile can use this with something like
3287 $shrpenv $(CC) -o perl perlmain.o $libperl $libs
3289 shrpenv="env LD_RUN_PATH=$archlibexp/CORE"
3292 See the main perl Makefile.SH for actual working usage.
3293 Alternatively, we might be able to use a command line option such
3294 as -R $archlibexp/CORE (Solaris, NetBSD) or -Wl,-rpath
3295 $archlibexp/CORE (Linux).
3297 shsharp (spitshell.U):
3298 This variable tells further Configure units whether your sh can
3301 sig_count (sig_name.U):
3302 This variable holds a number larger than the largest valid
3303 signal number. This is usually the same as the NSIG macro.
3305 sig_name (sig_name.U):
3306 This variable holds the signal names, space separated. The leading
3307 SIG in signal name is removed. A ZERO is prepended to the
3308 list. This is currently not used.
3310 sig_name_init (sig_name.U):
3311 This variable holds the signal names, enclosed in double quotes and
3312 separated by commas, suitable for use in the SIG_NAME definition
3313 below. A "ZERO" is prepended to the list, and the list is
3314 terminated with a plain 0. The leading SIG in signal names
3315 is removed. See sig_num.
3317 sig_num (sig_name.U):
3318 This variable holds the signal numbers, space separated. A ZERO is
3319 prepended to the list (corresponding to the fake SIGZERO), and
3320 the list is terminated with a 0. Those numbers correspond to
3321 the value of the signal listed in the same place within the
3324 sig_num_init (sig_name.U):
3325 This variable holds the signal numbers, enclosed in double quotes and
3326 separated by commas, suitable for use in the SIG_NUM definition
3327 below. A "ZERO" is prepended to the list, and the list is
3328 terminated with a plain 0.
3330 sig_size (sig_name.U):
3331 This variable contains the number of elements of the sig_name
3332 and sig_num arrays, excluding the final NULL entry.
3334 signal_t (d_voidsig.U):
3335 This variable holds the type of the signal handler (void or int).
3337 sitearch (sitearch.U):
3338 This variable contains the eventual value of the SITEARCH symbol,
3339 which is the name of the private library for this package. It may
3340 have a ~ on the front. It is up to the makefile to eventually create
3341 this directory while performing installation (with ~ substitution).
3342 The standard distribution will put nothing in this directory.
3343 After perl has been installed, users may install their own local
3344 architecture-dependent modules in this directory with
3345 MakeMaker Makefile.PL
3346 or equivalent. See INSTALL for details.
3348 sitearchexp (sitearch.U):
3349 This variable is the ~name expanded version of sitearch, so that you
3350 may use it directly in Makefiles or shell scripts.
3352 sitebin (sitebin.U):
3353 This variable holds the name of the directory in which the user wants
3354 to put add-on publicly executable files for the package in question. It
3355 is most often a local directory such as /usr/local/bin. Programs using
3356 this variable must be prepared to deal with ~name substitution.
3357 The standard distribution will put nothing in this directory.
3358 After perl has been installed, users may install their own local
3359 executables in this directory with
3360 MakeMaker Makefile.PL
3361 or equivalent. See INSTALL for details.
3363 sitebinexp (sitebin.U):
3364 This is the same as the sitebin variable, but is filename expanded at
3365 configuration time, for use in your makefiles.
3367 sitelib (sitelib.U):
3368 This variable contains the eventual value of the SITELIB symbol,
3369 which is the name of the private library for this package. It may
3370 have a ~ on the front. It is up to the makefile to eventually create
3371 this directory while performing installation (with ~ substitution).
3372 The standard distribution will put nothing in this directory.
3373 After perl has been installed, users may install their own local
3374 architecture-independent modules in this directory with
3375 MakeMaker Makefile.PL
3376 or equivalent. See INSTALL for details.
3378 sitelib_stem (sitelib.U):
3379 This variable is $sitelibexp with any trailing version-specific component
3380 removed. The elements in inc_version_list (inc_version_list.U) can
3381 be tacked onto this variable to generate a list of directories to search.
3383 sitelibexp (sitelib.U):
3384 This variable is the ~name expanded version of sitelib, so that you
3385 may use it directly in Makefiles or shell scripts.
3387 siteprefix (siteprefix.U):
3388 This variable holds the full absolute path of the directory below
3389 which the user will install add-on packages.
3390 See INSTALL for usage and examples.
3392 siteprefixexp (siteprefix.U):
3393 This variable holds the full absolute path of the directory below
3394 which the user will install add-on packages. Derived from siteprefix.
3396 sizesize (sizesize.U):
3397 This variable contains the size of a sizetype in bytes.
3399 sizetype (sizetype.U):
3400 This variable defines sizetype to be something like size_t,
3401 unsigned long, or whatever type is used to declare length
3402 parameters for string functions.
3405 This variable is defined but not used by Configure.
3406 The value is a plain '' and is not useful.
3409 This variable is defined but not used by Configure.
3410 The value is a plain '' and is not useful.
3413 This variable holds the extension used to identify shared libraries
3414 (also known as shared objects) on the system. Usually set to 'so'.
3416 sockethdr (d_socket.U):
3417 This variable has any cpp '-I' flags needed for socket support.
3419 socketlib (d_socket.U):
3420 This variable has the names of any libraries needed for socket support.
3422 socksizetype (socksizetype.U):
3423 This variable holds the type used for the size argument
3424 for various socket calls like accept. Usual values include
3425 socklen_t, size_t, and int.
3428 This variable is used internally by Configure to determine the
3429 full pathname (if any) of the sort program. After Configure runs,
3430 the value is reset to a plain "sort" and is not useful.
3432 spackage (package.U):
3433 This variable contains the name of the package being constructed,
3434 with the first letter uppercased, i.e. suitable for starting
3437 spitshell (spitshell.U):
3438 This variable contains the command necessary to spit out a runnable
3439 shell on this system. It is either cat or a grep '-v' for # comments.
3441 sPRId64 (quadfio.U):
3442 This variable, if defined, contains the string used by stdio to
3443 format 64-bit decimal numbers (format 'd') for output.
3445 sPRIeldbl (longdblfio.U):
3446 This variable, if defined, contains the string used by stdio to
3447 format long doubles (format 'e') for output.
3449 sPRIEUldbl (longdblfio.U):
3450 This variable, if defined, contains the string used by stdio to
3451 format long doubles (format 'E') for output.
3452 The 'U' in the name is to separate this from sPRIeldbl so that even
3453 case-blind systems can see the difference.
3455 sPRIfldbl (longdblfio.U):
3456 This variable, if defined, contains the string used by stdio to
3457 format long doubles (format 'f') for output.
3459 sPRIFUldbl (longdblfio.U):
3460 This variable, if defined, contains the string used by stdio to
3461 format long doubles (format 'F') for output.
3462 The 'U' in the name is to separate this from sPRIfldbl so that even
3463 case-blind systems can see the difference.
3465 sPRIgldbl (longdblfio.U):
3466 This variable, if defined, contains the string used by stdio to
3467 format long doubles (format 'g') for output.
3469 sPRIGUldbl (longdblfio.U):
3470 This variable, if defined, contains the string used by stdio to
3471 format long doubles (format 'G') for output.
3472 The 'U' in the name is to separate this from sPRIgldbl so that even
3473 case-blind systems can see the difference.
3475 sPRIi64 (quadfio.U):
3476 This variable, if defined, contains the string used by stdio to
3477 format 64-bit decimal numbers (format 'i') for output.
3479 sPRIo64 (quadfio.U):
3480 This variable, if defined, contains the string used by stdio to
3481 format 64-bit octal numbers (format 'o') for output.
3483 sPRIu64 (quadfio.U):
3484 This variable, if defined, contains the string used by stdio to
3485 format 64-bit unsigned decimal numbers (format 'u') for output.
3487 sPRIx64 (quadfio.U):
3488 This variable, if defined, contains the string used by stdio to
3489 format 64-bit hexadecimal numbers (format 'x') for output.
3491 sPRIXU64 (quadfio.U):
3492 This variable, if defined, contains the string used by stdio to
3493 format 64-bit hExADECimAl numbers (format 'X') for output.
3494 The 'U' in the name is to separate this from sPRIx64 so that even
3495 case-blind systems can see the difference.
3498 This variable holds the path to the package source. It is up to
3499 the Makefile to use this variable and set VPATH accordingly to
3500 find the sources remotely.
3502 sSCNfldbl (longdblfio.U):
3503 This variable, if defined, contains the string used by stdio to
3504 format long doubles (format 'f') for input.
3506 ssizetype (ssizetype.U):
3507 This variable defines ssizetype to be something like ssize_t,
3508 long or int. It is used by functions that return a count
3509 of bytes or an error condition. It must be a signed type.
3510 We will pick a type such that sizeof(SSize_t) == sizeof(Size_t).
3512 startperl (startperl.U):
3513 This variable contains the string to put on the front of a perl
3514 script to make sure (hopefully) that it runs with perl and not some
3515 shell. Of course, that leading line must be followed by the classical
3517 eval 'exec perl -S $0 ${1+"$@"}'
3518 if $running_under_some_shell;
3519 to guarantee perl startup should the shell execute the script. Note
3520 that this magic incatation is not understood by csh.
3522 startsh (startsh.U):
3523 This variable contains the string to put on the front of a shell
3524 script to make sure (hopefully) that it runs with sh and not some
3527 static_ext (Extensions.U):
3528 This variable holds a list of XS extension files we want to
3529 link statically into the package. It is used by Makefile.
3531 stdchar (stdchar.U):
3532 This variable conditionally defines STDCHAR to be the type of char
3533 used in stdio.h. It has the values "unsigned char" or "char".
3535 stdio_base (d_stdstdio.U):
3536 This variable defines how, given a FILE pointer, fp, to access the
3537 _base field (or equivalent) of stdio.h's FILE structure. This will
3538 be used to define the macro FILE_base(fp).
3540 stdio_bufsiz (d_stdstdio.U):
3541 This variable defines how, given a FILE pointer, fp, to determine
3542 the number of bytes store in the I/O buffer pointer to by the
3543 _base field (or equivalent) of stdio.h's FILE structure. This will
3544 be used to define the macro FILE_bufsiz(fp).
3546 stdio_cnt (d_stdstdio.U):
3547 This variable defines how, given a FILE pointer, fp, to access the
3548 _cnt field (or equivalent) of stdio.h's FILE structure. This will
3549 be used to define the macro FILE_cnt(fp).
3551 stdio_filbuf (d_stdstdio.U):
3552 This variable defines how, given a FILE pointer, fp, to tell
3553 stdio to refill it's internal buffers (?). This will
3554 be used to define the macro FILE_filbuf(fp).
3556 stdio_ptr (d_stdstdio.U):
3557 This variable defines how, given a FILE pointer, fp, to access the
3558 _ptr field (or equivalent) of stdio.h's FILE structure. This will
3559 be used to define the macro FILE_ptr(fp).
3561 stdio_stream_array (stdio_streams.U):
3562 This variable tells the name of the array holding the stdio streams.
3563 Usual values include _iob, __iob, and __sF.
3565 strings (i_string.U):
3566 This variable holds the full path of the string header that will be
3567 used. Typically /usr/include/string.h or /usr/include/strings.h.
3570 This variable is defined but not used by Configure.
3571 The value is a plain '' and is not useful.
3573 subversion (patchlevel.U):
3574 The subversion level of this package.
3575 The value of subversion comes from the patchlevel.h file.
3576 In a version number such as 5.6.1, this is the "1".
3577 In patchlevel.h, this is referred to as "PERL_SUBVERSION".
3578 This is unique to perl.
3581 This variable holds the place where the manual is located on this
3582 system. It is not the place where the user wants to put his manual
3583 pages. Rather it is the place where Configure may look to find manual
3584 for unix commands (section 1 of the manual usually). See mansrc.
3587 This variable is defined but not used by Configure.
3588 The value is a plain '' and is not useful.
3591 This variable is defined but not used by Configure.
3592 The value is a plain '' and is not useful.
3594 targetarch (Cross.U):
3595 If cross-compiling, this variable contains the target architecture.
3596 If not, this will be empty.
3599 This variable is defined but not used by Configure.
3600 The value is a plain '' and is not useful.
3603 This variable is defined but not used by Configure.
3604 The value is a plain '' and is not useful.
3607 This variable is used internally by Configure to determine the
3608 full pathname (if any) of the test program. After Configure runs,
3609 the value is reset to a plain "test" and is not useful.
3611 timeincl (i_time.U):
3612 This variable holds the full path of the included time header(s).
3614 timetype (d_time.U):
3615 This variable holds the type returned by time(). It can be long,
3616 or time_t on BSD sites (in which case <sys/types.h> should be
3617 included). Anyway, the type Time_t should be used.
3620 This variable contains the command used by Configure
3621 to copy to from the target host. Useful and available
3622 only during Perl build.
3623 The string ':' if not cross-compiling.
3626 This variable is used internally by Configure to determine the
3627 full pathname (if any) of the touch program. After Configure runs,
3628 the value is reset to a plain "touch" and is not useful.
3631 This variable is used internally by Configure to determine the
3632 full pathname (if any) of the tr program. After Configure runs,
3633 the value is reset to a plain "tr" and is not useful.
3636 This variable contains the value to be passed to the tr(1)
3637 command to transliterate a newline. Typical values are
3638 '\012' and '\n'. This is needed for EBCDIC systems where
3639 newline is not necessarily '\012'.
3642 This variable is defined but not used by Configure.
3643 The value is a plain '' and is not useful.
3646 This variable is the size of an U16 in bytes.
3649 This variable contains the C type used for Perl's U16.
3652 This variable is the size of an U32 in bytes.
3655 This variable contains the C type used for Perl's U32.
3658 This variable is the size of an U64 in bytes.
3661 This variable contains the C type used for Perl's U64.
3664 This variable is the size of an U8 in bytes.
3667 This variable contains the C type used for Perl's U8.
3670 This variable contains the format string used for printing a Uid_t.
3672 uidsign (uidsign.U):
3673 This variable contains the signedness of a uidtype.
3674 1 for unsigned, -1 for signed.
3676 uidsize (uidsize.U):
3677 This variable contains the size of a uidtype in bytes.
3679 uidtype (uidtype.U):
3680 This variable defines Uid_t to be something like uid_t, int,
3681 ushort, or whatever type is used to declare user ids in the kernel.
3684 This variable is used internally by Configure to determine the
3685 full pathname (if any) of the uname program. After Configure runs,
3686 the value is reset to a plain "uname" and is not useful.
3689 This variable is used internally by Configure to determine the
3690 full pathname (if any) of the uniq program. After Configure runs,
3691 the value is reset to a plain "uniq" and is not useful.
3693 uquadtype (quadtype.U):
3694 This variable defines Uquad_t to be something like unsigned long,
3695 unsigned int, unsigned long long, uint64_t, or whatever type is
3696 used for 64-bit integers.
3698 use5005threads (usethreads.U):
3699 This variable conditionally defines the USE_5005THREADS symbol,
3700 and indicates that Perl should be built to use the 5.005-based
3701 threading implementation.
3703 use64bitall (use64bits.U):
3704 This variable conditionally defines the USE_64_BIT_ALL symbol,
3705 and indicates that 64-bit integer types should be used
3706 when available. The maximal possible
3707 64-bitness is employed: LP64 or ILP64, meaning that you will
3708 be able to use more than 2 gigabytes of memory. This mode is
3709 even more binary incompatible than USE_64_BIT_INT. You may not
3710 be able to run the resulting executable in a 32-bit CPU at all or
3711 you may need at least to reboot your OS to 64-bit mode.
3713 use64bitint (use64bits.U):
3714 This variable conditionally defines the USE_64_BIT_INT symbol,
3715 and indicates that 64-bit integer types should be used
3716 when available. The minimal possible 64-bitness
3717 is employed, just enough to get 64-bit integers into Perl.
3718 This may mean using for example "long longs", while your memory
3719 may still be limited to 2 gigabytes.
3721 usecrosscompile (Cross.U):
3722 This variable conditionally defines the USE_CROSS_COMPILE symbol,
3723 and indicates that Perl has been cross-compiled.
3726 This variable indicates if the system supports dynamic
3727 loading of some sort. See also dlsrc and dlobj.
3729 useithreads (usethreads.U):
3730 This variable conditionally defines the USE_ITHREADS symbol,
3731 and indicates that Perl should be built to use the interpreter-based
3732 threading implementation.
3734 uselargefiles (uselfs.U):
3735 This variable conditionally defines the USE_LARGE_FILES symbol,
3736 and indicates that large file interfaces should be used when
3739 uselongdouble (uselongdbl.U):
3740 This variable conditionally defines the USE_LONG_DOUBLE symbol,
3741 and indicates that long doubles should be used when available.
3743 usemorebits (usemorebits.U):
3744 This variable conditionally defines the USE_MORE_BITS symbol,
3745 and indicates that explicit 64-bit interfaces and long doubles
3746 should be used when available.
3748 usemultiplicity (usemultiplicity.U):
3749 This variable conditionally defines the MULTIPLICITY symbol,
3750 and indicates that Perl should be built to use multiplicity.
3752 usemymalloc (mallocsrc.U):
3753 This variable contains y if the malloc that comes with this package
3754 is desired over the system's version of malloc. People often include
3755 special versions of malloc for effiency, but such versions are often
3756 less portable. See also mallocsrc and mallocobj.
3757 If this is 'y', then -lmalloc is removed from $libs.
3760 This variable contains 'true' or 'false' depending whether the
3761 nm extraction is wanted or not.
3763 useopcode (Extensions.U):
3764 This variable holds either 'true' or 'false' to indicate
3765 whether the Opcode extension should be used. The sole
3766 use for this currently is to allow an easy mechanism
3767 for users to skip the Opcode extension from the Configure
3770 useperlio (useperlio.U):
3771 This variable conditionally defines the USE_PERLIO symbol,
3772 and indicates that the PerlIO abstraction should be
3775 useposix (Extensions.U):
3776 This variable holds either 'true' or 'false' to indicate
3777 whether the POSIX extension should be used. The sole
3778 use for this currently is to allow an easy mechanism
3779 for hints files to indicate that POSIX will not compile
3780 on a particular system.
3782 usereentrant (usethreads.U):
3783 This variable conditionally defines the USE_REENTRANT_API symbol,
3784 which indicates that the thread code may try to use the various
3785 _r versions of library functions. This is only potentially
3786 meaningful if usethreads is set and is very experimental, it is
3787 not even prompted for.
3790 This variable is set to true when the user agrees to use sfio.
3791 It is set to false when sfio is not available or when the user
3792 explicitely requests not to use sfio. It is here primarily so
3793 that command-line settings can override the auto-detection of
3794 d_sfio without running into a "WHOA THERE".
3796 useshrplib (libperl.U):
3797 This variable is set to 'yes' if the user wishes
3798 to build a shared libperl, and 'no' otherwise.
3800 usesocks (usesocks.U):
3801 This variable conditionally defines the USE_SOCKS symbol,
3802 and indicates that Perl should be built to use SOCKS.
3804 usethreads (usethreads.U):
3805 This variable conditionally defines the USE_THREADS symbol,
3806 and indicates that Perl should be built to use threads.
3808 usevendorprefix (vendorprefix.U):
3809 This variable tells whether the vendorprefix
3810 and consequently other vendor* paths are in use.
3812 usevfork (d_vfork.U):
3813 This variable is set to true when the user accepts to use vfork.
3814 It is set to false when no vfork is available or when the user
3815 explicitely requests not to use vfork.
3818 This variable holds the path of the include files, which is
3819 usually /usr/include. It is mainly used by other Configure units.
3822 This variable is defined but not used by Configure.
3823 The value is a plain '' and is not useful.
3825 uvoformat (perlxvf.U):
3826 This variable contains the format string used for printing
3827 a Perl UV as an unsigned octal integer.
3830 This variable is the size of a UV in bytes.
3833 This variable contains the C type used for Perl's UV.
3835 uvuformat (perlxvf.U):
3836 This variable contains the format string used for printing
3837 a Perl UV as an unsigned decimal integer.
3839 uvxformat (perlxvf.U):
3840 This variable contains the format string used for printing
3841 a Perl UV as an unsigned hexadecimal integer in lowercase abcdef.
3843 uvXUformat (perlxvf.U):
3844 This variable contains the format string used for printing
3845 a Perl UV as an unsigned hexadecimal integer in uppercase ABCDEF.
3847 vendorarch (vendorarch.U):
3848 This variable contains the value of the PERL_VENDORARCH symbol.
3849 It may have a ~ on the front.
3850 The standard distribution will put nothing in this directory.
3851 Vendors who distribute perl may wish to place their own
3852 architecture-dependent modules and extensions in this directory with
3853 MakeMaker Makefile.PL INSTALLDIRS=vendor
3854 or equivalent. See INSTALL for details.
3856 vendorarchexp (vendorarch.U):
3857 This variable is the ~name expanded version of vendorarch, so that you
3858 may use it directly in Makefiles or shell scripts.
3860 vendorbin (vendorbin.U):
3861 This variable contains the eventual value of the VENDORBIN symbol.
3862 It may have a ~ on the front.
3863 The standard distribution will put nothing in this directory.
3864 Vendors who distribute perl may wish to place additional
3865 binaries in this directory with
3866 MakeMaker Makefile.PL INSTALLDIRS=vendor
3867 or equivalent. See INSTALL for details.
3869 vendorbinexp (vendorbin.U):
3870 This variable is the ~name expanded version of vendorbin, so that you
3871 may use it directly in Makefiles or shell scripts.
3873 vendorlib (vendorlib.U):
3874 This variable contains the eventual value of the VENDORLIB symbol,
3875 which is the name of the private library for this package.
3876 The standard distribution will put nothing in this directory.
3877 Vendors who distribute perl may wish to place their own
3878 modules in this directory with
3879 MakeMaker Makefile.PL INSTALLDIRS=vendor
3880 or equivalent. See INSTALL for details.
3882 vendorlib_stem (vendorlib.U):
3883 This variable is $vendorlibexp with any trailing version-specific component
3884 removed. The elements in inc_version_list (inc_version_list.U) can
3885 be tacked onto this variable to generate a list of directories to search.
3887 vendorlibexp (vendorlib.U):
3888 This variable is the ~name expanded version of vendorlib, so that you
3889 may use it directly in Makefiles or shell scripts.
3891 vendorprefix (vendorprefix.U):
3892 This variable holds the full absolute path of the directory below
3893 which the vendor will install add-on packages.
3894 See INSTALL for usage and examples.
3896 vendorprefixexp (vendorprefix.U):
3897 This variable holds the full absolute path of the directory below
3898 which the vendor will install add-on packages. Derived from vendorprefix.
3900 version (patchlevel.U):
3901 The full version number of this package, such as 5.6.1 (or 5_6_1).
3902 This combines revision, patchlevel, and subversion to get the
3903 full version number, including any possible subversions.
3904 This is suitable for use as a directory name, and hence is
3905 filesystem dependent.
3907 versiononly (versiononly.U):
3908 If set, this symbol indicates that only the version-specific
3909 components of a perl installation should be installed.
3910 This may be useful for making a test installation of a new
3911 version without disturbing the existing installation.
3912 Setting versiononly is equivalent to setting installperl's -v option.
3913 In particular, the non-versioned scripts and programs such as
3914 a2p, c2ph, h2xs, pod2*, and perldoc are not installed
3915 (see INSTALL for a more complete list). Nor are the man
3917 Usually, this is undef.
3920 This variable is defined but not used by Configure.
3921 The value is a plain '' and is not useful.
3923 voidflags (voidflags.U):
3924 This variable contains the eventual value of the VOIDFLAGS symbol,
3925 which indicates how much support of the void type is given by this
3926 compiler. See VOIDFLAGS for more info.
3929 This variable holds extra path (space-separated) used to find
3930 libraries on this platform, for example CPU-specific libraries
3931 (on multi-CPU platforms) may be listed here.
3933 xs_apiversion (xs_apiversion.U):
3934 This variable contains the version of the oldest perl binary
3935 compatible with the present perl. perl.c:incpush() and
3936 lib/lib.pm will automatically search in $sitearch for older
3937 directories across major versions back to xs_apiversion.
3938 This is only useful if you have a perl library directory tree
3939 structured like the default one.
3940 See INSTALL for how this works.
3941 The versioned site_perl directory was introduced in 5.005,
3942 so that is the lowest possible value.
3943 Since this can depend on compile time options (such as
3944 bincompat) it is set by Configure. Other non-default sources
3945 of potential incompatibility, such as multiplicity, threads,
3946 debugging, 64bits, sfio, etc., are not checked for currently,
3947 though in principle we could go snooping around in old
3951 This variable holds the name of the compiler compiler we
3952 want to use in the Makefile. It can be yacc, byacc, or bison -y.
3955 This variable contains any additional yacc flags desired by the
3956 user. It is up to the Makefile to use this.
3959 This variable is defined but not used by Configure.
3960 The value is a plain '' and is not useful.
3963 This variable is used internally by Configure to determine the
3964 full pathname (if any) of the zip program. After Configure runs,
3965 the value is reset to a plain "zip" and is not useful.