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 used internally by Configure to determine the
247 full pathname (if any) of the chmod program. After Configure runs,
248 the value is reset to a plain "chmod" and is not useful.
251 This variable is defined but not used by Configure.
252 The value is a plain '' and is not useful.
254 clocktype (d_times.U):
255 This variable holds the type returned by times(). It can be long,
256 or clock_t on BSD sites (in which case <sys/types.h> should be
260 This variable is used internally by Configure to determine the
261 full pathname (if any) of the comm program. After Configure runs,
262 the value is reset to a plain "comm" and is not useful.
265 This variable is defined but not used by Configure.
266 The value is a plain '' and is not useful.
268 contains (contains.U):
269 This variable holds the command to do a grep with a proper return
270 status. On most sane systems it is simply "grep". On insane systems
271 it is a grep followed by a cat followed by a test. This variable
272 is primarily for the use of other Configure units.
275 This variable is used internally by Configure to determine the
276 full pathname (if any) of the cp program. After Configure runs,
277 the value is reset to a plain "cp" and is not useful.
280 This variable is defined but not used by Configure.
281 The value is a plain '' and is not useful.
284 This variable is used internally by Configure to determine the
285 full pathname (if any) of the cpp program. After Configure runs,
286 the value is reset to a plain "cpp" and is not useful.
288 cpp_stuff (cpp_stuff.U):
289 This variable contains an identification of the catenation mechanism
290 used by the C preprocessor.
292 cppccsymbols (Cppsym.U):
293 The variable contains the symbols defined by the C compiler
294 when it calls cpp. The symbols defined by the cc alone or cpp
295 alone are not in this list, see ccsymbols and cppsymbols.
296 The list is a space-separated list of symbol=value tokens.
298 cppflags (ccflags.U):
299 This variable holds the flags that will be passed to the C pre-
300 processor. It is up to the Makefile to use it.
302 cpplast (cppstdin.U):
303 This variable has the same functionality as cppminus, only it applies
304 to cpprun and not cppstdin.
306 cppminus (cppstdin.U):
307 This variable contains the second part of the string which will invoke
308 the C preprocessor on the standard input and produce to standard
309 output. This variable will have the value "-" if cppstdin needs
310 a minus to specify standard input, otherwise the value is "".
313 This variable contains the command which will invoke a C preprocessor
314 on standard input and put the output to stdout. It is guaranteed not
315 to be a wrapper and may be a null string if no preprocessor can be
316 made directly available. This preprocessor might be different from the
317 one used by the C compiler. Don't forget to append cpplast after the
318 preprocessor options.
320 cppstdin (cppstdin.U):
321 This variable contains the command which will invoke the C
322 preprocessor on standard input and put the output to stdout.
323 It is primarily used by other Configure units that ask about
324 preprocessor symbols.
326 cppsymbols (Cppsym.U):
327 The variable contains the symbols defined by the C preprocessor
328 alone. The symbols defined by cc or by cc when it calls cpp are
329 not in this list, see ccsymbols and cppccsymbols.
330 The list is a space-separated list of symbol=value tokens.
332 cryptlib (d_crypt.U):
333 This variable holds -lcrypt or the path to a libcrypt.a archive if
334 the crypt() function is not defined in the standard C library. It is
335 up to the Makefile to use this.
338 This variable is used internally by Configure to determine the
339 full pathname (if any) of the csh program. After Configure runs,
340 the value is reset to a plain "csh" and is not useful.
342 d__fwalk (d__fwalk.U):
343 This variable conditionally defines HAS__FWALK if _fwalk() is
344 available to apply a function to all the file handles.
346 d_access (d_access.U):
347 This variable conditionally defines HAS_ACCESS if the access() system
348 call is available to check for access permissions using real IDs.
350 d_accessx (d_accessx.U):
351 This variable conditionally defines the HAS_ACCESSX symbol, which
352 indicates to the C program that the accessx() routine is available.
355 This variable conditionally defines the HAS_ALARM symbol, which
356 indicates to the C program that the alarm() routine is available.
358 d_archlib (archlib.U):
359 This variable conditionally defines ARCHLIB to hold the pathname
360 of architecture-dependent library files for $package. If
361 $archlib is the same as $privlib, then this is set to undef.
364 This variable conditionally defines the HAS_ATOLF symbol, which
365 indicates to the C program that the atolf() routine is available.
368 This variable conditionally defines the HAS_ATOLL symbol, which
369 indicates to the C program that the atoll() routine is available.
371 d_attribut (d_attribut.U):
372 This variable conditionally defines HASATTRIBUTE, which
373 indicates the C compiler can check for function attributes,
374 such as printf formats.
377 This variable conditionally defines the HAS_BCMP symbol if
378 the bcmp() routine is available to compare strings.
381 This variable conditionally defines the HAS_BCOPY symbol if
382 the bcopy() routine is available to copy strings.
384 d_bincompat5005 (bincompat5005.U):
385 This variable conditionally defines BINCOMPAT5005 so that embed.h
386 can take special action if this version of Perl should be
387 binary-compatible with Perl 5.005. This is impossible for builds
388 that use features like threads and multiplicity it is always $undef
392 This symbol conditionally defines the symbol BSD when running on a
395 d_bsdgetpgrp (d_getpgrp.U):
396 This variable conditionally defines USE_BSD_GETPGRP if
397 getpgrp needs one arguments whereas USG one needs none.
399 d_bsdsetpgrp (d_setpgrp.U):
400 This variable conditionally defines USE_BSD_SETPGRP if
401 setpgrp needs two arguments whereas USG one needs none.
402 See also d_setpgid for a POSIX interface.
405 This variable conditionally defines the HAS_BZERO symbol if
406 the bzero() routine is available to set memory to 0.
408 d_casti32 (d_casti32.U):
409 This variable conditionally defines CASTI32, which indicates
410 whether the C compiler can cast large floats to 32-bit ints.
412 d_castneg (d_castneg.U):
413 This variable conditionally defines CASTNEG, which indicates
414 wether the C compiler can cast negative float to unsigned.
416 d_charvspr (d_vprintf.U):
417 This variable conditionally defines CHARVSPRINTF if this system
418 has vsprintf returning type (char*). The trend seems to be to
419 declare it as "int vsprintf()".
422 This variable conditionally defines the HAS_CHOWN symbol, which
423 indicates to the C program that the chown() routine is available.
425 d_chroot (d_chroot.U):
426 This variable conditionally defines the HAS_CHROOT symbol, which
427 indicates to the C program that the chroot() routine is available.
429 d_chsize (d_chsize.U):
430 This variable conditionally defines the CHSIZE symbol, which
431 indicates to the C program that the chsize() routine is available
432 to truncate files. You might need a -lx to get this routine.
435 This variable conditionally defines the HAS_CLASS symbol, which
436 indicates to the C program that the class() routine is available.
438 d_closedir (d_closedir.U):
439 This variable conditionally defines HAS_CLOSEDIR if closedir() is
442 d_cmsghdr_s (d_cmsghdr_s.U):
443 This variable conditionally defines the HAS_STRUCT_CMSGHDR symbol,
444 which indicates that the struct cmsghdr is supported.
447 This variable conditionally defines the HASCONST symbol, which
448 indicates to the C program that this C compiler knows about the
452 This variable conditionally defines the CRYPT symbol, which
453 indicates to the C program that the crypt() routine is available
454 to encrypt passwords and the like.
457 This variable conditionally defines the CSH symbol, which
458 indicates to the C program that the C-shell exists.
460 d_cuserid (d_cuserid.U):
461 This variable conditionally defines the HAS_CUSERID symbol, which
462 indicates to the C program that the cuserid() routine is available
463 to get character login names.
465 d_dbl_dig (d_dbl_dig.U):
466 This variable conditionally defines d_dbl_dig if this system's
467 header files provide DBL_DIG, which is the number of significant
468 digits in a double precision number.
470 d_dbminitproto (d_dbminitproto.U):
471 This variable conditionally defines the HAS_DBMINIT_PROTO symbol,
472 which indicates to the C program that the system provides
473 a prototype for the dbminit() function. Otherwise, it is
474 up to the program to supply one.
476 d_difftime (d_difftime.U):
477 This variable conditionally defines the HAS_DIFFTIME symbol, which
478 indicates to the C program that the difftime() routine is available.
481 This variable conditionally defines the HAS_DIRFD constant,
482 which indicates to the C program that dirfd() is available
483 to return the file descriptor of a directory stream.
485 d_dirnamlen (i_dirent.U):
486 This variable conditionally defines DIRNAMLEN, which indicates
487 to the C program that the length of directory entry names is
488 provided by a d_namelen field.
490 d_dlerror (d_dlerror.U):
491 This variable conditionally defines the HAS_DLERROR symbol, which
492 indicates to the C program that the dlerror() routine is available.
494 d_dlopen (d_dlopen.U):
495 This variable conditionally defines the HAS_DLOPEN symbol, which
496 indicates to the C program that the dlopen() routine is available.
498 d_dlsymun (d_dlsymun.U):
499 This variable conditionally defines DLSYM_NEEDS_UNDERSCORE, which
500 indicates that we need to prepend an underscore to the symbol
501 name before calling dlsym().
503 d_dosuid (d_dosuid.U):
504 This variable conditionally defines the symbol DOSUID, which
505 tells the C program that it should insert setuid emulation code
506 on hosts which have setuid #! scripts disabled.
508 d_drand48proto (d_drand48proto.U):
509 This variable conditionally defines the HAS_DRAND48_PROTO symbol,
510 which indicates to the C program that the system provides
511 a prototype for the drand48() function. Otherwise, it is
512 up to the program to supply one.
515 This variable conditionally defines HAS_DUP2 if dup2() is
516 available to duplicate file descriptors.
518 d_eaccess (d_eaccess.U):
519 This variable conditionally defines the HAS_EACCESS symbol, which
520 indicates to the C program that the eaccess() routine is available.
522 d_endgrent (d_endgrent.U):
523 This variable conditionally defines the HAS_ENDGRENT symbol, which
524 indicates to the C program that the endgrent() routine is available
525 for sequential access of the group database.
527 d_endhent (d_endhent.U):
528 This variable conditionally defines HAS_ENDHOSTENT if endhostent() is
529 available to close whatever was being used for host queries.
531 d_endnent (d_endnent.U):
532 This variable conditionally defines HAS_ENDNETENT if endnetent() is
533 available to close whatever was being used for network queries.
535 d_endpent (d_endpent.U):
536 This variable conditionally defines HAS_ENDPROTOENT if endprotoent() is
537 available to close whatever was being used for protocol queries.
539 d_endpwent (d_endpwent.U):
540 This variable conditionally defines the HAS_ENDPWENT symbol, which
541 indicates to the C program that the endpwent() routine is available
542 for sequential access of the passwd database.
544 d_endsent (d_endsent.U):
545 This variable conditionally defines HAS_ENDSERVENT if endservent() is
546 available to close whatever was being used for service queries.
548 d_eofnblk (nblock_io.U):
549 This variable conditionally defines EOF_NONBLOCK if EOF can be seen
550 when reading from a non-blocking I/O source.
553 This variable conditionally defines the symbols EUNICE and VAX, which
554 alerts the C program that it must deal with ideosyncracies of VMS.
556 d_fchdir (d_fchdir.U):
557 This variable conditionally defines the HAS_FCHDIR symbol, which
558 indicates to the C program that the fchdir() routine is available.
560 d_fchmod (d_fchmod.U):
561 This variable conditionally defines the HAS_FCHMOD symbol, which
562 indicates to the C program that the fchmod() routine is available
563 to change mode of opened files.
565 d_fchown (d_fchown.U):
566 This variable conditionally defines the HAS_FCHOWN symbol, which
567 indicates to the C program that the fchown() routine is available
568 to change ownership of opened files.
571 This variable conditionally defines the HAS_FCNTL symbol, and indicates
572 whether the fcntl() function exists
574 d_fcntl_can_lock (d_fcntl_can_lock.U):
575 This variable conditionally defines the FCNTL_CAN_LOCK symbol
576 and indicates whether file locking with fcntl() works.
578 d_fd_macros (d_fd_set.U):
579 This variable contains the eventual value of the HAS_FD_MACROS symbol,
580 which indicates if your C compiler knows about the macros which
581 manipulate an fd_set.
583 d_fd_set (d_fd_set.U):
584 This variable contains the eventual value of the HAS_FD_SET symbol,
585 which indicates if your C compiler knows about the fd_set typedef.
587 d_fds_bits (d_fd_set.U):
588 This variable contains the eventual value of the HAS_FDS_BITS symbol,
589 which indicates if your fd_set typedef contains the fds_bits member.
590 If you have an fd_set typedef, but the dweebs who installed it did
591 a half-fast job and neglected to provide the macros to manipulate
592 an fd_set, HAS_FDS_BITS will let us know how to fix the gaffe.
594 d_fgetpos (d_fgetpos.U):
595 This variable conditionally defines HAS_FGETPOS if fgetpos() is
596 available to get the file position indicator.
598 d_finite (d_finite.U):
599 This variable conditionally defines the HAS_FINITE symbol, which
600 indicates to the C program that the finite() routine is available.
602 d_finitel (d_finitel.U):
603 This variable conditionally defines the HAS_FINITEL symbol, which
604 indicates to the C program that the finitel() routine is available.
606 d_flexfnam (d_flexfnam.U):
607 This variable conditionally defines the FLEXFILENAMES symbol, which
608 indicates that the system supports filenames longer than 14 characters.
611 This variable conditionally defines HAS_FLOCK if flock() is
612 available to do file locking.
614 d_flockproto (d_flockproto.U):
615 This variable conditionally defines the HAS_FLOCK_PROTO symbol,
616 which indicates to the C program that the system provides
617 a prototype for the flock() function. Otherwise, it is
618 up to the program to supply one.
621 This variable conditionally defines the HAS_FORK symbol, which
622 indicates to the C program that the fork() routine is available.
624 d_fp_class (d_fp_class.U):
625 This variable conditionally defines the HAS_FP_CLASS symbol, which
626 indicates to the C program that the fp_class() routine is available.
628 d_fpathconf (d_pathconf.U):
629 This variable conditionally defines the HAS_FPATHCONF symbol, which
630 indicates to the C program that the pathconf() routine is available
631 to determine file-system related limits and options associated
632 with a given open file descriptor.
634 d_fpclass (d_fpclass.U):
635 This variable conditionally defines the HAS_FPCLASS symbol, which
636 indicates to the C program that the fpclass() routine is available.
638 d_fpclassify (d_fpclassify.U):
639 This variable conditionally defines the HAS_FPCLASSIFY symbol, which
640 indicates to the C program that the fpclassify() routine is available.
642 d_fpclassl (d_fpclassl.U):
643 This variable conditionally defines the HAS_FPCLASSL symbol, which
644 indicates to the C program that the fpclassl() routine is available.
646 d_fpos64_t (d_fpos64_t.U):
647 This symbol will be defined if the C compiler supports fpos64_t.
649 d_frexpl (d_frexpl.U):
650 This variable conditionally defines the HAS_FREXPL symbol, which
651 indicates to the C program that the frexpl() routine is available.
653 d_fs_data_s (d_fs_data_s.U):
654 This variable conditionally defines the HAS_STRUCT_FS_DATA symbol,
655 which indicates that the struct fs_data is supported.
657 d_fseeko (d_fseeko.U):
658 This variable conditionally defines the HAS_FSEEKO symbol, which
659 indicates to the C program that the fseeko() routine is available.
661 d_fsetpos (d_fsetpos.U):
662 This variable conditionally defines HAS_FSETPOS if fsetpos() is
663 available to set the file position indicator.
665 d_fstatfs (d_fstatfs.U):
666 This variable conditionally defines the HAS_FSTATFS symbol, which
667 indicates to the C program that the fstatfs() routine is available.
669 d_fstatvfs (d_statvfs.U):
670 This variable conditionally defines the HAS_FSTATVFS symbol, which
671 indicates to the C program that the fstatvfs() routine is available.
674 This variable conditionally defines the HAS_FSYNC symbol, which
675 indicates to the C program that the fsync() routine is available.
677 d_ftello (d_ftello.U):
678 This variable conditionally defines the HAS_FTELLO symbol, which
679 indicates to the C program that the ftello() routine is available.
682 This variable conditionally defines the HAS_FTIME symbol, which indicates
683 that the ftime() routine exists. The ftime() routine is basically
684 a sub-second accuracy clock.
686 d_Gconvert (d_gconvert.U):
687 This variable holds what Gconvert is defined as to convert
688 floating point numbers into strings. By default, Configure
689 sets this macro to use the first of gconvert, gcvt, or sprintf
690 that pass sprintf-%g-like behaviour tests. If perl is using
691 long doubles, the macro uses the first of the following
692 functions that pass Configure's tests: qgcvt, sprintf (if
693 Configure knows how to make sprintf format long doubles--see
694 sPRIgldbl), gconvert, gcvt, and sprintf (casting to double).
695 The gconvert_preference and gconvert_ld_preference variables
696 can be used to alter Configure's preferences, for doubles and
697 long doubles, respectively. If present, they contain a
698 space-separated list of one or more of the above function
699 names in the order they should be tried.
700 d_Gconvert may be set to override Configure with a platform-
701 specific function. If this function expects a double, a
702 different value may need to be set by the uselongdouble.cbu
703 call-back unit so that long doubles can be formatted without
706 d_getcwd (d_getcwd.U):
707 This variable conditionally defines the HAS_GETCWD symbol, which
708 indicates to the C program that the getcwd() routine is available
709 to get the current working directory.
711 d_getespwnam (d_getespwnam.U):
712 This variable conditionally defines HAS_GETESPWNAM if getespwnam() is
713 available to retrieve enchanced (shadow) password entries by name.
715 d_getfsstat (d_getfsstat.U):
716 This variable conditionally defines the HAS_GETFSSTAT symbol, which
717 indicates to the C program that the getfsstat() routine is available.
719 d_getgrent (d_getgrent.U):
720 This variable conditionally defines the HAS_GETGRENT symbol, which
721 indicates to the C program that the getgrent() routine is available
722 for sequential access of the group database.
724 d_getgrps (d_getgrps.U):
725 This variable conditionally defines the HAS_GETGROUPS symbol, which
726 indicates to the C program that the getgroups() routine is available
727 to get the list of process groups.
729 d_gethbyaddr (d_gethbyad.U):
730 This variable conditionally defines the HAS_GETHOSTBYADDR symbol, which
731 indicates to the C program that the gethostbyaddr() routine is available
732 to look up hosts by their IP addresses.
734 d_gethbyname (d_gethbynm.U):
735 This variable conditionally defines the HAS_GETHOSTBYNAME symbol, which
736 indicates to the C program that the gethostbyname() routine is available
737 to look up host names in some data base or other.
739 d_gethent (d_gethent.U):
740 This variable conditionally defines HAS_GETHOSTENT if gethostent() is
741 available to look up host names in some data base or another.
743 d_gethname (d_gethname.U):
744 This variable conditionally defines the HAS_GETHOSTNAME symbol, which
745 indicates to the C program that the gethostname() routine may be
746 used to derive the host name.
748 d_gethostprotos (d_gethostprotos.U):
749 This variable conditionally defines the HAS_GETHOST_PROTOS symbol,
750 which indicates to the C program that <netdb.h> supplies
751 prototypes for the various gethost*() functions.
752 See also netdbtype.U for probing for various netdb types.
754 d_getitimer (d_getitimer.U):
755 This variable conditionally defines the HAS_GETITIMER symbol, which
756 indicates to the C program that the getitimer() routine is available.
758 d_getlogin (d_getlogin.U):
759 This variable conditionally defines the HAS_GETLOGIN symbol, which
760 indicates to the C program that the getlogin() routine is available
761 to get the login name.
763 d_getmnt (d_getmnt.U):
764 This variable conditionally defines the HAS_GETMNT symbol, which
765 indicates to the C program that the getmnt() routine is available
766 to retrieve one or more mount info blocks by filename.
768 d_getmntent (d_getmntent.U):
769 This variable conditionally defines the HAS_GETMNTENT symbol, which
770 indicates to the C program that the getmntent() routine is available
771 to iterate through mounted files to get their mount info.
773 d_getnbyaddr (d_getnbyad.U):
774 This variable conditionally defines the HAS_GETNETBYADDR symbol, which
775 indicates to the C program that the getnetbyaddr() routine is available
776 to look up networks by their IP addresses.
778 d_getnbyname (d_getnbynm.U):
779 This variable conditionally defines the HAS_GETNETBYNAME symbol, which
780 indicates to the C program that the getnetbyname() routine is available
781 to look up networks by their names.
783 d_getnent (d_getnent.U):
784 This variable conditionally defines HAS_GETNETENT if getnetent() is
785 available to look up network names in some data base or another.
787 d_getnetprotos (d_getnetprotos.U):
788 This variable conditionally defines the HAS_GETNET_PROTOS symbol,
789 which indicates to the C program that <netdb.h> supplies
790 prototypes for the various getnet*() functions.
791 See also netdbtype.U for probing for various netdb types.
793 d_getpagsz (d_getpagsz.U):
794 This variable conditionally defines HAS_GETPAGESIZE if getpagesize()
795 is available to get the system page size.
797 d_getpbyname (d_getprotby.U):
798 This variable conditionally defines the HAS_GETPROTOBYNAME
799 symbol, which indicates to the C program that the
800 getprotobyname() routine is available to look up protocols
803 d_getpbynumber (d_getprotby.U):
804 This variable conditionally defines the HAS_GETPROTOBYNUMBER
805 symbol, which indicates to the C program that the
806 getprotobynumber() routine is available to look up protocols
809 d_getpent (d_getpent.U):
810 This variable conditionally defines HAS_GETPROTOENT if getprotoent() is
811 available to look up protocols in some data base or another.
813 d_getpgid (d_getpgid.U):
814 This variable conditionally defines the HAS_GETPGID symbol, which
815 indicates to the C program that the getpgid(pid) function
816 is available to get the process group id.
818 d_getpgrp2 (d_getpgrp2.U):
819 This variable conditionally defines the HAS_GETPGRP2 symbol, which
820 indicates to the C program that the getpgrp2() (as in DG/UX) routine
821 is available to get the current process group.
823 d_getpgrp (d_getpgrp.U):
824 This variable conditionally defines HAS_GETPGRP if getpgrp() is
825 available to get the current process group.
827 d_getppid (d_getppid.U):
828 This variable conditionally defines the HAS_GETPPID symbol, which
829 indicates to the C program that the getppid() routine is available
830 to get the parent process ID.
832 d_getprior (d_getprior.U):
833 This variable conditionally defines HAS_GETPRIORITY if getpriority()
834 is available to get a process's priority.
836 d_getprotoprotos (d_getprotoprotos.U):
837 This variable conditionally defines the HAS_GETPROTO_PROTOS symbol,
838 which indicates to the C program that <netdb.h> supplies
839 prototypes for the various getproto*() functions.
840 See also netdbtype.U for probing for various netdb types.
842 d_getprpwnam (d_getprpwnam.U):
843 This variable conditionally defines HAS_GETPRPWNAM if getprpwnam() is
844 available to retrieve protected (shadow) password entries by name.
846 d_getpwent (d_getpwent.U):
847 This variable conditionally defines the HAS_GETPWENT symbol, which
848 indicates to the C program that the getpwent() routine is available
849 for sequential access of the passwd database.
851 d_getsbyname (d_getsrvby.U):
852 This variable conditionally defines the HAS_GETSERVBYNAME
853 symbol, which indicates to the C program that the
854 getservbyname() routine is available to look up services
857 d_getsbyport (d_getsrvby.U):
858 This variable conditionally defines the HAS_GETSERVBYPORT
859 symbol, which indicates to the C program that the
860 getservbyport() routine is available to look up services
863 d_getsent (d_getsent.U):
864 This variable conditionally defines HAS_GETSERVENT if getservent() is
865 available to look up network services in some data base or another.
867 d_getservprotos (d_getservprotos.U):
868 This variable conditionally defines the HAS_GETSERV_PROTOS symbol,
869 which indicates to the C program that <netdb.h> supplies
870 prototypes for the various getserv*() functions.
871 See also netdbtype.U for probing for various netdb types.
873 d_getspnam (d_getspnam.U):
874 This variable conditionally defines HAS_GETSPNAM if getspnam() is
875 available to retrieve SysV shadow password entries by name.
877 d_gettimeod (d_ftime.U):
878 This variable conditionally defines the HAS_GETTIMEOFDAY symbol, which
879 indicates that the gettimeofday() system call exists (to obtain a
880 sub-second accuracy clock). You should probably include <sys/resource.h>.
882 d_gnulibc (d_gnulibc.U):
883 Defined if we're dealing with the GNU C Library.
885 d_grpasswd (i_grp.U):
886 This variable conditionally defines GRPASSWD, which indicates
887 that struct group in <grp.h> contains gr_passwd.
889 d_hasmntopt (d_hasmntopt.U):
890 This variable conditionally defines the HAS_HASMNTOPT symbol, which
891 indicates to the C program that the hasmntopt() routine is available
892 to query the mount options of file systems.
895 This variable conditionally defines HAS_HTONL if htonl() and its
896 friends are available to do network order byte swapping.
898 d_index (d_strchr.U):
899 This variable conditionally defines HAS_INDEX if index() and
900 rindex() are available for string searching.
902 d_inetaton (d_inetaton.U):
903 This variable conditionally defines the HAS_INET_ATON symbol, which
904 indicates to the C program that the inet_aton() function is available
905 to parse IP address "dotted-quad" strings.
907 d_int64_t (d_int64_t.U):
908 This symbol will be defined if the C compiler supports int64_t.
910 d_isascii (d_isascii.U):
911 This variable conditionally defines the HAS_ISASCII constant,
912 which indicates to the C program that isascii() is available.
914 d_isfinite (d_isfinite.U):
915 This variable conditionally defines the HAS_ISFINITE symbol, which
916 indicates to the C program that the isfinite() routine is available.
919 This variable conditionally defines the HAS_ISINF symbol, which
920 indicates to the C program that the isinf() routine is available.
923 This variable conditionally defines the HAS_ISNAN symbol, which
924 indicates to the C program that the isnan() routine is available.
926 d_isnanl (d_isnanl.U):
927 This variable conditionally defines the HAS_ISNANL symbol, which
928 indicates to the C program that the isnanl() routine is available.
930 d_killpg (d_killpg.U):
931 This variable conditionally defines the HAS_KILLPG symbol, which
932 indicates to the C program that the killpg() routine is available
933 to kill process groups.
935 d_lchown (d_lchown.U):
936 This variable conditionally defines the HAS_LCHOWN symbol, which
937 indicates to the C program that the lchown() routine is available
938 to operate on a symbolic link (instead of following the link).
940 d_ldbl_dig (d_ldbl_dig.U):
941 This variable conditionally defines d_ldbl_dig if this system's
942 header files provide LDBL_DIG, which is the number of significant
943 digits in a long double precision number.
946 This variable conditionally defines HAS_LINK if link() is
947 available to create hard links.
949 d_locconv (d_locconv.U):
950 This variable conditionally defines HAS_LOCALECONV if localeconv() is
951 available for numeric and monetary formatting conventions.
954 This variable conditionally defines HAS_LOCKF if lockf() is
955 available to do file locking.
957 d_longdbl (d_longdbl.U):
958 This variable conditionally defines HAS_LONG_DOUBLE if
959 the long double type is supported.
961 d_longlong (d_longlong.U):
962 This variable conditionally defines HAS_LONG_LONG if
963 the long long type is supported.
965 d_lseekproto (d_lseekproto.U):
966 This variable conditionally defines the HAS_LSEEK_PROTO symbol,
967 which indicates to the C program that the system provides
968 a prototype for the lseek() function. Otherwise, it is
969 up to the program to supply one.
972 This variable conditionally defines HAS_LSTAT if lstat() is
973 available to do file stats on symbolic links.
975 d_madvise (d_madvise.U):
976 This variable conditionally defines HAS_MADVISE if madvise() is
977 available to map a file into memory.
980 This variable conditionally defines the HAS_MBLEN symbol, which
981 indicates to the C program that the mblen() routine is available
982 to find the number of bytes in a multibye character.
984 d_mbstowcs (d_mbstowcs.U):
985 This variable conditionally defines the HAS_MBSTOWCS symbol, which
986 indicates to the C program that the mbstowcs() routine is available
987 to convert a multibyte string into a wide character string.
989 d_mbtowc (d_mbtowc.U):
990 This variable conditionally defines the HAS_MBTOWC symbol, which
991 indicates to the C program that the mbtowc() routine is available
992 to convert multibyte to a wide character.
994 d_memchr (d_memchr.U):
995 This variable conditionally defines the HAS_MEMCHR symbol, which
996 indicates to the C program that the memchr() routine is available
997 to locate characters within a C string.
999 d_memcmp (d_memcmp.U):
1000 This variable conditionally defines the HAS_MEMCMP symbol, which
1001 indicates to the C program that the memcmp() routine is available
1002 to compare blocks of memory.
1004 d_memcpy (d_memcpy.U):
1005 This variable conditionally defines the HAS_MEMCPY symbol, which
1006 indicates to the C program that the memcpy() routine is available
1007 to copy blocks of memory.
1009 d_memmove (d_memmove.U):
1010 This variable conditionally defines the HAS_MEMMOVE symbol, which
1011 indicates to the C program that the memmove() routine is available
1012 to copy potentatially overlapping blocks of memory.
1014 d_memset (d_memset.U):
1015 This variable conditionally defines the HAS_MEMSET symbol, which
1016 indicates to the C program that the memset() routine is available
1017 to set blocks of memory.
1019 d_mkdir (d_mkdir.U):
1020 This variable conditionally defines the HAS_MKDIR symbol, which
1021 indicates to the C program that the mkdir() routine is available
1022 to create directories..
1024 d_mkdtemp (d_mkdtemp.U):
1025 This variable conditionally defines the HAS_MKDTEMP symbol, which
1026 indicates to the C program that the mkdtemp() routine is available
1027 to exclusively create a uniquely named temporary directory.
1029 d_mkfifo (d_mkfifo.U):
1030 This variable conditionally defines the HAS_MKFIFO symbol, which
1031 indicates to the C program that the mkfifo() routine is available.
1033 d_mkstemp (d_mkstemp.U):
1034 This variable conditionally defines the HAS_MKSTEMP symbol, which
1035 indicates to the C program that the mkstemp() routine is available
1036 to exclusively create and open a uniquely named temporary file.
1038 d_mkstemps (d_mkstemps.U):
1039 This variable conditionally defines the HAS_MKSTEMPS symbol, which
1040 indicates to the C program that the mkstemps() routine is available
1041 to exclusively create and open a uniquely named (with a suffix)
1044 d_mktime (d_mktime.U):
1045 This variable conditionally defines the HAS_MKTIME symbol, which
1046 indicates to the C program that the mktime() routine is available.
1049 This variable conditionally defines HAS_MMAP if mmap() is
1050 available to map a file into memory.
1052 d_modfl (d_modfl.U):
1053 This variable conditionally defines the HAS_MODFL symbol, which
1054 indicates to the C program that the modfl() routine is available.
1056 d_modfl_pow32_bug (d_modfl.U):
1057 This variable conditionally defines the HAS_MODFL_POW32_BUG symbol,
1058 which indicates that modfl() is broken for long doubles >= pow(2, 32).
1059 For example from 4294967303.150000 one would get 4294967302.000000
1060 and 1.150000. The bug has been seen in certain versions of glibc,
1061 release 2.2.2 is known to be okay.
1063 d_mprotect (d_mprotect.U):
1064 This variable conditionally defines HAS_MPROTECT if mprotect() is
1065 available to modify the access protection of a memory mapped file.
1068 This variable conditionally defines the HAS_MSG symbol, which
1069 indicates that the entire msg*(2) library is present.
1071 d_msg_ctrunc (d_socket.U):
1072 This variable conditionally defines the HAS_MSG_CTRUNC symbol,
1073 which indicates that the MSG_CTRUNC is available. #ifdef is
1074 not enough because it may be an enum, glibc has been known to do this.
1076 d_msg_dontroute (d_socket.U):
1077 This variable conditionally defines the HAS_MSG_DONTROUTE symbol,
1078 which indicates that the MSG_DONTROUTE is available. #ifdef is
1079 not enough because it may be an enum, glibc has been known to do this.
1081 d_msg_oob (d_socket.U):
1082 This variable conditionally defines the HAS_MSG_OOB symbol,
1083 which indicates that the MSG_OOB is available. #ifdef is
1084 not enough because it may be an enum, glibc has been known to do this.
1086 d_msg_peek (d_socket.U):
1087 This variable conditionally defines the HAS_MSG_PEEK symbol,
1088 which indicates that the MSG_PEEK is available. #ifdef is
1089 not enough because it may be an enum, glibc has been known to do this.
1091 d_msg_proxy (d_socket.U):
1092 This variable conditionally defines the HAS_MSG_PROXY symbol,
1093 which indicates that the MSG_PROXY is available. #ifdef is
1094 not enough because it may be an enum, glibc has been known to do this.
1096 d_msgctl (d_msgctl.U):
1097 This variable conditionally defines the HAS_MSGCTL symbol, which
1098 indicates to the C program that the msgctl() routine is available.
1100 d_msgget (d_msgget.U):
1101 This variable conditionally defines the HAS_MSGGET symbol, which
1102 indicates to the C program that the msgget() routine is available.
1104 d_msghdr_s (d_msghdr_s.U):
1105 This variable conditionally defines the HAS_STRUCT_MSGHDR symbol,
1106 which indicates that the struct msghdr is supported.
1108 d_msgrcv (d_msgrcv.U):
1109 This variable conditionally defines the HAS_MSGRCV symbol, which
1110 indicates to the C program that the msgrcv() routine is available.
1112 d_msgsnd (d_msgsnd.U):
1113 This variable conditionally defines the HAS_MSGSND symbol, which
1114 indicates to the C program that the msgsnd() routine is available.
1116 d_msync (d_msync.U):
1117 This variable conditionally defines HAS_MSYNC if msync() is
1118 available to synchronize a mapped file.
1120 d_munmap (d_munmap.U):
1121 This variable conditionally defines HAS_MUNMAP if munmap() is
1122 available to unmap a region mapped by mmap().
1124 d_mymalloc (mallocsrc.U):
1125 This variable conditionally defines MYMALLOC in case other parts
1126 of the source want to take special action if MYMALLOC is used.
1127 This may include different sorts of profiling or error detection.
1130 This variable conditionally defines the HAS_NICE symbol, which
1131 indicates to the C program that the nice() routine is available.
1133 d_nl_langinfo (d_nl_langinfo.U):
1134 This variable conditionally defines the HAS_NL_LANGINFO symbol, which
1135 indicates to the C program that the nl_langinfo() routine is available.
1137 d_nv_preserves_uv (perlxv.U):
1138 This variable indicates whether a variable of type nvtype
1139 can preserve all the bits a variable of type uvtype.
1141 d_nv_preserves_uv_bits (perlxv.U):
1142 This variable indicates how many of bits type uvtype
1143 a variable nvtype can preserve.
1145 d_off64_t (d_off64_t.U):
1146 This symbol will be defined if the C compiler supports off64_t.
1148 d_old_pthread_create_joinable (d_pthrattrj.U):
1149 This variable conditionally defines pthread_create_joinable.
1150 undef if pthread.h defines PTHREAD_CREATE_JOINABLE.
1152 d_oldpthreads (usethreads.U):
1153 This variable conditionally defines the OLD_PTHREADS_API symbol,
1154 and indicates that Perl should be built to use the old
1155 draft POSIX threads API. This is only potentially meaningful if
1158 d_oldsock (d_socket.U):
1159 This variable conditionally defines the OLDSOCKET symbol, which
1160 indicates that the BSD socket interface is based on 4.1c and not 4.2.
1162 d_open3 (d_open3.U):
1163 This variable conditionally defines the HAS_OPEN3 manifest constant,
1164 which indicates to the C program that the 3 argument version of
1165 the open(2) function is available.
1167 d_pathconf (d_pathconf.U):
1168 This variable conditionally defines the HAS_PATHCONF symbol, which
1169 indicates to the C program that the pathconf() routine is available
1170 to determine file-system related limits and options associated
1171 with a given filename.
1173 d_pause (d_pause.U):
1174 This variable conditionally defines the HAS_PAUSE symbol, which
1175 indicates to the C program that the pause() routine is available
1176 to suspend a process until a signal is received.
1178 d_perl_otherlibdirs (otherlibdirs.U):
1179 This variable conditionally defines PERL_OTHERLIBDIRS, which
1180 contains a colon-separated set of paths for the perl binary to
1181 include in @INC. See also otherlibdirs.
1183 d_phostname (d_gethname.U):
1184 This variable conditionally defines the HAS_PHOSTNAME symbol, which
1185 contains the shell command which, when fed to popen(), may be
1186 used to derive the host name.
1189 This variable conditionally defines the HAS_PIPE symbol, which
1190 indicates to the C program that the pipe() routine is available
1191 to create an inter-process channel.
1194 This variable conditionally defines the HAS_POLL symbol, which
1195 indicates to the C program that the poll() routine is available
1196 to poll active file descriptors.
1198 d_portable (d_portable.U):
1199 This variable conditionally defines the PORTABLE symbol, which
1200 indicates to the C program that it should not assume that it is
1201 running on the machine it was compiled on.
1203 d_PRId64 (quadfio.U):
1204 This variable conditionally defines the PERL_PRId64 symbol, which
1205 indiciates that stdio has a symbol to print 64-bit decimal numbers.
1207 d_PRIeldbl (longdblfio.U):
1208 This variable conditionally defines the PERL_PRIfldbl symbol, which
1209 indiciates that stdio has a symbol to print long doubles.
1211 d_PRIEUldbl (longdblfio.U):
1212 This variable conditionally defines the PERL_PRIfldbl symbol, which
1213 indiciates that stdio has a symbol to print long doubles.
1214 The 'U' in the name is to separate this from d_PRIeldbl so that even
1215 case-blind systems can see the difference.
1217 d_PRIfldbl (longdblfio.U):
1218 This variable conditionally defines the PERL_PRIfldbl symbol, which
1219 indiciates that stdio has a symbol to print long doubles.
1221 d_PRIFUldbl (longdblfio.U):
1222 This variable conditionally defines the PERL_PRIfldbl symbol, which
1223 indiciates that stdio has a symbol to print long doubles.
1224 The 'U' in the name is to separate this from d_PRIfldbl so that even
1225 case-blind systems can see the difference.
1227 d_PRIgldbl (longdblfio.U):
1228 This variable conditionally defines the PERL_PRIfldbl symbol, which
1229 indiciates that stdio has a symbol to print long doubles.
1231 d_PRIGUldbl (longdblfio.U):
1232 This variable conditionally defines the PERL_PRIfldbl symbol, which
1233 indiciates that stdio has a symbol to print long doubles.
1234 The 'U' in the name is to separate this from d_PRIgldbl so that even
1235 case-blind systems can see the difference.
1237 d_PRIi64 (quadfio.U):
1238 This variable conditionally defines the PERL_PRIi64 symbol, which
1239 indiciates that stdio has a symbol to print 64-bit decimal numbers.
1241 d_PRIo64 (quadfio.U):
1242 This variable conditionally defines the PERL_PRIo64 symbol, which
1243 indiciates that stdio has a symbol to print 64-bit octal numbers.
1245 d_PRIu64 (quadfio.U):
1246 This variable conditionally defines the PERL_PRIu64 symbol, which
1247 indiciates that stdio has a symbol to print 64-bit unsigned decimal
1250 d_PRIx64 (quadfio.U):
1251 This variable conditionally defines the PERL_PRIx64 symbol, which
1252 indiciates that stdio has a symbol to print 64-bit hexadecimal numbers.
1254 d_PRIXU64 (quadfio.U):
1255 This variable conditionally defines the PERL_PRIXU64 symbol, which
1256 indiciates that stdio has a symbol to print 64-bit hExADECimAl numbers.
1257 The 'U' in the name is to separate this from d_PRIx64 so that even
1258 case-blind systems can see the difference.
1260 d_procselfexe (d_procselfexe.U):
1261 Defined if $procselfexe is symlink to the absolute
1262 pathname of the executing program.
1264 d_pthread_atfork (d_pthread_atfork.U):
1265 This variable conditionally defines the HAS_PTHREAD_ATFORK symbol,
1266 which indicates to the C program that the pthread_atfork()
1267 routine is available.
1269 d_pthread_yield (d_pthread_y.U):
1270 This variable conditionally defines the HAS_PTHREAD_YIELD
1271 symbol if the pthread_yield routine is available to yield
1272 the execution of the current thread.
1275 This variable conditionally defines PWAGE, which indicates
1276 that struct passwd contains pw_age.
1278 d_pwchange (i_pwd.U):
1279 This variable conditionally defines PWCHANGE, which indicates
1280 that struct passwd contains pw_change.
1282 d_pwclass (i_pwd.U):
1283 This variable conditionally defines PWCLASS, which indicates
1284 that struct passwd contains pw_class.
1286 d_pwcomment (i_pwd.U):
1287 This variable conditionally defines PWCOMMENT, which indicates
1288 that struct passwd contains pw_comment.
1290 d_pwexpire (i_pwd.U):
1291 This variable conditionally defines PWEXPIRE, which indicates
1292 that struct passwd contains pw_expire.
1294 d_pwgecos (i_pwd.U):
1295 This variable conditionally defines PWGECOS, which indicates
1296 that struct passwd contains pw_gecos.
1298 d_pwpasswd (i_pwd.U):
1299 This variable conditionally defines PWPASSWD, which indicates
1300 that struct passwd contains pw_passwd.
1302 d_pwquota (i_pwd.U):
1303 This variable conditionally defines PWQUOTA, which indicates
1304 that struct passwd contains pw_quota.
1306 d_qgcvt (d_qgcvt.U):
1307 This variable conditionally defines the HAS_QGCVT symbol, which
1308 indicates to the C program that the qgcvt() routine is available.
1310 d_quad (quadtype.U):
1311 This variable, if defined, tells that there's a 64-bit integer type,
1314 d_readdir (d_readdir.U):
1315 This variable conditionally defines HAS_READDIR if readdir() is
1316 available to read directory entries.
1318 d_readlink (d_readlink.U):
1319 This variable conditionally defines the HAS_READLINK symbol, which
1320 indicates to the C program that the readlink() routine is available
1321 to read the value of a symbolic link.
1323 d_readv (d_readv.U):
1324 This variable conditionally defines the HAS_READV symbol, which
1325 indicates to the C program that the readv() routine is available.
1327 d_recvmsg (d_recvmsg.U):
1328 This variable conditionally defines the HAS_RECVMSG symbol, which
1329 indicates to the C program that the recvmsg() routine is available.
1331 d_rename (d_rename.U):
1332 This variable conditionally defines the HAS_RENAME symbol, which
1333 indicates to the C program that the rename() routine is available
1336 d_rewinddir (d_readdir.U):
1337 This variable conditionally defines HAS_REWINDDIR if rewinddir() is
1340 d_rmdir (d_rmdir.U):
1341 This variable conditionally defines HAS_RMDIR if rmdir() is
1342 available to remove directories.
1344 d_safebcpy (d_safebcpy.U):
1345 This variable conditionally defines the HAS_SAFE_BCOPY symbol if
1346 the bcopy() routine can do overlapping copies. Normally, you
1347 should probably use memmove().
1349 d_safemcpy (d_safemcpy.U):
1350 This variable conditionally defines the HAS_SAFE_MEMCPY symbol if
1351 the memcpy() routine can do overlapping copies.
1352 For overlapping copies, memmove() should be used, if available.
1354 d_sanemcmp (d_sanemcmp.U):
1355 This variable conditionally defines the HAS_SANE_MEMCMP symbol if
1356 the memcpy() routine is available and can be used to compare relative
1357 magnitudes of chars with their high bits set.
1359 d_sbrkproto (d_sbrkproto.U):
1360 This variable conditionally defines the HAS_SBRK_PROTO symbol,
1361 which indicates to the C program that the system provides
1362 a prototype for the sbrk() function. Otherwise, it is
1363 up to the program to supply one.
1365 d_sched_yield (d_pthread_y.U):
1366 This variable conditionally defines the HAS_SCHED_YIELD
1367 symbol if the sched_yield routine is available to yield
1368 the execution of the current thread.
1370 d_scm_rights (d_socket.U):
1371 This variable conditionally defines the HAS_SCM_RIGHTS symbol,
1372 which indicates that the SCM_RIGHTS is available. #ifdef is
1373 not enough because it may be an enum, glibc has been known to do this.
1375 d_SCNfldbl (longdblfio.U):
1376 This variable conditionally defines the PERL_PRIfldbl symbol, which
1377 indiciates that stdio has a symbol to scan long doubles.
1379 d_seekdir (d_readdir.U):
1380 This variable conditionally defines HAS_SEEKDIR if seekdir() is
1383 d_select (d_select.U):
1384 This variable conditionally defines HAS_SELECT if select() is
1385 available to select active file descriptors. A <sys/time.h>
1386 inclusion may be necessary for the timeout field.
1389 This variable conditionally defines the HAS_SEM symbol, which
1390 indicates that the entire sem*(2) library is present.
1392 d_semctl (d_semctl.U):
1393 This variable conditionally defines the HAS_SEMCTL symbol, which
1394 indicates to the C program that the semctl() routine is available.
1396 d_semctl_semid_ds (d_union_semun.U):
1397 This variable conditionally defines USE_SEMCTL_SEMID_DS, which
1398 indicates that struct semid_ds * is to be used for semctl IPC_STAT.
1400 d_semctl_semun (d_union_semun.U):
1401 This variable conditionally defines USE_SEMCTL_SEMUN, which
1402 indicates that union semun is to be used for semctl IPC_STAT.
1404 d_semget (d_semget.U):
1405 This variable conditionally defines the HAS_SEMGET symbol, which
1406 indicates to the C program that the semget() routine is available.
1408 d_semop (d_semop.U):
1409 This variable conditionally defines the HAS_SEMOP symbol, which
1410 indicates to the C program that the semop() routine is available.
1412 d_sendmsg (d_sendmsg.U):
1413 This variable conditionally defines the HAS_SENDMSG symbol, which
1414 indicates to the C program that the sendmsg() routine is available.
1416 d_setegid (d_setegid.U):
1417 This variable conditionally defines the HAS_SETEGID symbol, which
1418 indicates to the C program that the setegid() routine is available
1419 to change the effective gid of the current program.
1421 d_seteuid (d_seteuid.U):
1422 This variable conditionally defines the HAS_SETEUID symbol, which
1423 indicates to the C program that the seteuid() routine is available
1424 to change the effective uid of the current program.
1426 d_setgrent (d_setgrent.U):
1427 This variable conditionally defines the HAS_SETGRENT symbol, which
1428 indicates to the C program that the setgrent() routine is available
1429 for initializing sequential access to the group database.
1431 d_setgrps (d_setgrps.U):
1432 This variable conditionally defines the HAS_SETGROUPS symbol, which
1433 indicates to the C program that the setgroups() routine is available
1434 to set the list of process groups.
1436 d_sethent (d_sethent.U):
1437 This variable conditionally defines HAS_SETHOSTENT if sethostent() is
1440 d_setitimer (d_setitimer.U):
1441 This variable conditionally defines the HAS_SETITIMER symbol, which
1442 indicates to the C program that the setitimer() routine is available.
1444 d_setlinebuf (d_setlnbuf.U):
1445 This variable conditionally defines the HAS_SETLINEBUF symbol, which
1446 indicates to the C program that the setlinebuf() routine is available
1447 to change stderr or stdout from block-buffered or unbuffered to a
1450 d_setlocale (d_setlocale.U):
1451 This variable conditionally defines HAS_SETLOCALE if setlocale() is
1452 available to handle locale-specific ctype implementations.
1454 d_setnent (d_setnent.U):
1455 This variable conditionally defines HAS_SETNETENT if setnetent() is
1458 d_setpent (d_setpent.U):
1459 This variable conditionally defines HAS_SETPROTOENT if setprotoent() is
1462 d_setpgid (d_setpgid.U):
1463 This variable conditionally defines the HAS_SETPGID symbol if the
1464 setpgid(pid, gpid) function is available to set process group ID.
1466 d_setpgrp2 (d_setpgrp2.U):
1467 This variable conditionally defines the HAS_SETPGRP2 symbol, which
1468 indicates to the C program that the setpgrp2() (as in DG/UX) routine
1469 is available to set the current process group.
1471 d_setpgrp (d_setpgrp.U):
1472 This variable conditionally defines HAS_SETPGRP if setpgrp() is
1473 available to set the current process group.
1475 d_setprior (d_setprior.U):
1476 This variable conditionally defines HAS_SETPRIORITY if setpriority()
1477 is available to set a process's priority.
1479 d_setproctitle (d_setproctitle.U):
1480 This variable conditionally defines the HAS_SETPROCTITLE symbol,
1481 which indicates to the C program that the setproctitle() routine
1484 d_setpwent (d_setpwent.U):
1485 This variable conditionally defines the HAS_SETPWENT symbol, which
1486 indicates to the C program that the setpwent() routine is available
1487 for initializing sequential access to the passwd database.
1489 d_setregid (d_setregid.U):
1490 This variable conditionally defines HAS_SETREGID if setregid() is
1491 available to change the real and effective gid of the current
1494 d_setresgid (d_setregid.U):
1495 This variable conditionally defines HAS_SETRESGID if setresgid() is
1496 available to change the real, effective and saved gid of the current
1499 d_setresuid (d_setreuid.U):
1500 This variable conditionally defines HAS_SETREUID if setresuid() is
1501 available to change the real, effective and saved uid of the current
1504 d_setreuid (d_setreuid.U):
1505 This variable conditionally defines HAS_SETREUID if setreuid() is
1506 available to change the real and effective uid of the current
1509 d_setrgid (d_setrgid.U):
1510 This variable conditionally defines the HAS_SETRGID symbol, which
1511 indicates to the C program that the setrgid() routine is available
1512 to change the real gid of the current program.
1514 d_setruid (d_setruid.U):
1515 This variable conditionally defines the HAS_SETRUID symbol, which
1516 indicates to the C program that the setruid() routine is available
1517 to change the real uid of the current program.
1519 d_setsent (d_setsent.U):
1520 This variable conditionally defines HAS_SETSERVENT if setservent() is
1523 d_setsid (d_setsid.U):
1524 This variable conditionally defines HAS_SETSID if setsid() is
1525 available to set the process group ID.
1527 d_setvbuf (d_setvbuf.U):
1528 This variable conditionally defines the HAS_SETVBUF symbol, which
1529 indicates to the C program that the setvbuf() routine is available
1530 to change buffering on an open stdio stream.
1533 This variable conditionally defines the USE_SFIO symbol,
1534 and indicates whether sfio is available (and should be used).
1537 This variable conditionally defines the HAS_SHM symbol, which
1538 indicates that the entire shm*(2) library is present.
1540 d_shmat (d_shmat.U):
1541 This variable conditionally defines the HAS_SHMAT symbol, which
1542 indicates to the C program that the shmat() routine is available.
1544 d_shmatprototype (d_shmat.U):
1545 This variable conditionally defines the HAS_SHMAT_PROTOTYPE
1546 symbol, which indicates that sys/shm.h has a prototype for
1549 d_shmctl (d_shmctl.U):
1550 This variable conditionally defines the HAS_SHMCTL symbol, which
1551 indicates to the C program that the shmctl() routine is available.
1553 d_shmdt (d_shmdt.U):
1554 This variable conditionally defines the HAS_SHMDT symbol, which
1555 indicates to the C program that the shmdt() routine is available.
1557 d_shmget (d_shmget.U):
1558 This variable conditionally defines the HAS_SHMGET symbol, which
1559 indicates to the C program that the shmget() routine is available.
1561 d_sigaction (d_sigaction.U):
1562 This variable conditionally defines the HAS_SIGACTION symbol, which
1563 indicates that the Vr4 sigaction() routine is available.
1565 d_sigprocmask (d_sigprocmask.U):
1566 This variable conditionally defines HAS_SIGPROCMASK
1567 if sigprocmask() is available to examine or change the signal mask
1568 of the calling process.
1570 d_sigsetjmp (d_sigsetjmp.U):
1571 This variable conditionally defines the HAS_SIGSETJMP symbol,
1572 which indicates that the sigsetjmp() routine is available to
1573 call setjmp() and optionally save the process's signal mask.
1575 d_sockatmark (d_sockatmark.U):
1576 This variable conditionally defines the HAS_SOCKATMARK symbol, which
1577 indicates to the C program that the sockatmark() routine is available.
1579 d_sockatmarkproto (d_sockatmarkproto.U):
1580 This variable conditionally defines the HAS_SOCKATMARK_PROTO symbol,
1581 which indicates to the C program that the system provides
1582 a prototype for the sockatmark() function. Otherwise, it is
1583 up to the program to supply one.
1585 d_socket (d_socket.U):
1586 This variable conditionally defines HAS_SOCKET, which indicates
1587 that the BSD socket interface is supported.
1589 d_socklen_t (d_socklen_t.U):
1590 This symbol will be defined if the C compiler supports socklen_t.
1592 d_sockpair (d_socket.U):
1593 This variable conditionally defines the HAS_SOCKETPAIR symbol, which
1594 indicates that the BSD socketpair() is supported.
1596 d_socks5_init (d_socks5_init.U):
1597 This variable conditionally defines the HAS_SOCKS5_INIT symbol, which
1598 indicates to the C program that the socks5_init() routine is available.
1600 d_sqrtl (d_sqrtl.U):
1601 This variable conditionally defines the HAS_SQRTL symbol, which
1602 indicates to the C program that the sqrtl() routine is available.
1604 d_sresgproto (d_sresgproto.U):
1605 This variable conditionally defines the HAS_SETRESGID_PROTO symbol,
1606 which indicates to the C program that the system provides
1607 a prototype for the setresgid() function. Otherwise, it is
1608 up to the program to supply one.
1610 d_sresuproto (d_sresuproto.U):
1611 This variable conditionally defines the HAS_SETRESUID_PROTO symbol,
1612 which indicates to the C program that the system provides
1613 a prototype for the setresuid() function. Otherwise, it is
1614 up to the program to supply one.
1616 d_statblks (d_statblks.U):
1617 This variable conditionally defines USE_STAT_BLOCKS
1618 if this system has a stat structure declaring
1619 st_blksize and st_blocks.
1621 d_statfs_f_flags (d_statfs_f_flags.U):
1622 This variable conditionally defines the HAS_STRUCT_STATFS_F_FLAGS
1623 symbol, which indicates to struct statfs from has f_flags member.
1624 This kind of struct statfs is coming from sys/mount.h (BSD),
1625 not from sys/statfs.h (SYSV).
1627 d_statfs_s (d_statfs_s.U):
1628 This variable conditionally defines the HAS_STRUCT_STATFS symbol,
1629 which indicates that the struct statfs is supported.
1631 d_statvfs (d_statvfs.U):
1632 This variable conditionally defines the HAS_STATVFS symbol, which
1633 indicates to the C program that the statvfs() routine is available.
1635 d_stdio_cnt_lval (d_stdstdio.U):
1636 This variable conditionally defines STDIO_CNT_LVALUE if the
1637 FILE_cnt macro can be used as an lvalue.
1639 d_stdio_ptr_lval (d_stdstdio.U):
1640 This variable conditionally defines STDIO_PTR_LVALUE if the
1641 FILE_ptr macro can be used as an lvalue.
1643 d_stdio_ptr_lval_nochange_cnt (d_stdstdio.U):
1644 This symbol is defined if using the FILE_ptr macro as an lvalue
1645 to increase the pointer by n leaves File_cnt(fp) unchanged.
1647 d_stdio_ptr_lval_sets_cnt (d_stdstdio.U):
1648 This symbol is defined if using the FILE_ptr macro as an lvalue
1649 to increase the pointer by n has the side effect of decreasing the
1650 value of File_cnt(fp) by n.
1652 d_stdio_stream_array (stdio_streams.U):
1653 This variable tells whether there is an array holding
1656 d_stdiobase (d_stdstdio.U):
1657 This variable conditionally defines USE_STDIO_BASE if this system
1658 has a FILE structure declaring a usable _base field (or equivalent)
1661 d_stdstdio (d_stdstdio.U):
1662 This variable conditionally defines USE_STDIO_PTR if this system
1663 has a FILE structure declaring usable _ptr and _cnt fields (or
1664 equivalent) in stdio.h.
1666 d_strchr (d_strchr.U):
1667 This variable conditionally defines HAS_STRCHR if strchr() and
1668 strrchr() are available for string searching.
1670 d_strcoll (d_strcoll.U):
1671 This variable conditionally defines HAS_STRCOLL if strcoll() is
1672 available to compare strings using collating information.
1674 d_strctcpy (d_strctcpy.U):
1675 This variable conditionally defines the USE_STRUCT_COPY symbol, which
1676 indicates to the C program that this C compiler knows how to copy
1679 d_strerrm (d_strerror.U):
1680 This variable holds what Strerrr is defined as to translate an error
1681 code condition into an error message string. It could be 'strerror'
1682 or a more complex macro emulating strrror with sys_errlist[], or the
1683 "unknown" string when both strerror and sys_errlist are missing.
1685 d_strerror (d_strerror.U):
1686 This variable conditionally defines HAS_STRERROR if strerror() is
1687 available to translate error numbers to strings.
1689 d_strftime (d_strftime.U):
1690 This variable conditionally defines the HAS_STRFTIME symbol, which
1691 indicates to the C program that the strftime() routine is available.
1693 d_strtod (d_strtod.U):
1694 This variable conditionally defines the HAS_STRTOD symbol, which
1695 indicates to the C program that the strtod() routine is available
1696 to provide better numeric string conversion than atof().
1698 d_strtol (d_strtol.U):
1699 This variable conditionally defines the HAS_STRTOL symbol, which
1700 indicates to the C program that the strtol() routine is available
1701 to provide better numeric string conversion than atoi() and friends.
1703 d_strtold (d_strtold.U):
1704 This variable conditionally defines the HAS_STRTOLD symbol, which
1705 indicates to the C program that the strtold() routine is available.
1707 d_strtoll (d_strtoll.U):
1708 This variable conditionally defines the HAS_STRTOLL symbol, which
1709 indicates to the C program that the strtoll() routine is available.
1711 d_strtoq (d_strtoq.U):
1712 This variable conditionally defines the HAS_STRTOQ symbol, which
1713 indicates to the C program that the strtoq() routine is available.
1715 d_strtoul (d_strtoul.U):
1716 This variable conditionally defines the HAS_STRTOUL symbol, which
1717 indicates to the C program that the strtoul() routine is available
1718 to provide conversion of strings to unsigned long.
1720 d_strtoull (d_strtoull.U):
1721 This variable conditionally defines the HAS_STRTOULL symbol, which
1722 indicates to the C program that the strtoull() routine is available.
1724 d_strtouq (d_strtouq.U):
1725 This variable conditionally defines the HAS_STRTOUQ symbol, which
1726 indicates to the C program that the strtouq() routine is available.
1728 d_strxfrm (d_strxfrm.U):
1729 This variable conditionally defines HAS_STRXFRM if strxfrm() is
1730 available to transform strings.
1732 d_suidsafe (d_dosuid.U):
1733 This variable conditionally defines SETUID_SCRIPTS_ARE_SECURE_NOW
1734 if setuid scripts can be secure. This test looks in /dev/fd/.
1736 d_symlink (d_symlink.U):
1737 This variable conditionally defines the HAS_SYMLINK symbol, which
1738 indicates to the C program that the symlink() routine is available
1739 to create symbolic links.
1741 d_syscall (d_syscall.U):
1742 This variable conditionally defines HAS_SYSCALL if syscall() is
1743 available call arbitrary system calls.
1745 d_syscallproto (d_syscallproto.U):
1746 This variable conditionally defines the HAS_SYSCALL_PROTO symbol,
1747 which indicates to the C program that the system provides
1748 a prototype for the syscall() function. Otherwise, it is
1749 up to the program to supply one.
1751 d_sysconf (d_sysconf.U):
1752 This variable conditionally defines the HAS_SYSCONF symbol, which
1753 indicates to the C program that the sysconf() routine is available
1754 to determine system related limits and options.
1756 d_sysernlst (d_strerror.U):
1757 This variable conditionally defines HAS_SYS_ERRNOLIST if sys_errnolist[]
1758 is available to translate error numbers to the symbolic name.
1760 d_syserrlst (d_strerror.U):
1761 This variable conditionally defines HAS_SYS_ERRLIST if sys_errlist[] is
1762 available to translate error numbers to strings.
1764 d_system (d_system.U):
1765 This variable conditionally defines HAS_SYSTEM if system() is
1766 available to issue a shell command.
1768 d_tcgetpgrp (d_tcgtpgrp.U):
1769 This variable conditionally defines the HAS_TCGETPGRP symbol, which
1770 indicates to the C program that the tcgetpgrp() routine is available.
1771 to get foreground process group ID.
1773 d_tcsetpgrp (d_tcstpgrp.U):
1774 This variable conditionally defines the HAS_TCSETPGRP symbol, which
1775 indicates to the C program that the tcsetpgrp() routine is available
1776 to set foreground process group ID.
1778 d_telldir (d_readdir.U):
1779 This variable conditionally defines HAS_TELLDIR if telldir() is
1782 d_telldirproto (d_telldirproto.U):
1783 This variable conditionally defines the HAS_TELLDIR_PROTO symbol,
1784 which indicates to the C program that the system provides
1785 a prototype for the telldir() function. Otherwise, it is
1786 up to the program to supply one.
1789 This variable conditionally defines the HAS_TIME symbol, which indicates
1790 that the time() routine exists. The time() routine is normaly
1791 provided on UNIX systems.
1793 d_times (d_times.U):
1794 This variable conditionally defines the HAS_TIMES symbol, which indicates
1795 that the times() routine exists. The times() routine is normaly
1796 provided on UNIX systems. You may have to include <sys/times.h>.
1798 d_truncate (d_truncate.U):
1799 This variable conditionally defines HAS_TRUNCATE if truncate() is
1800 available to truncate files.
1802 d_tzname (d_tzname.U):
1803 This variable conditionally defines HAS_TZNAME if tzname[] is
1804 available to access timezone names.
1806 d_u32align (d_u32align.U):
1807 This variable tells whether you must access character data
1808 through U32-aligned pointers.
1810 d_ualarm (d_ualarm.U):
1811 This variable conditionally defines the HAS_UALARM symbol, which
1812 indicates to the C program that the ualarm() routine is available.
1814 d_umask (d_umask.U):
1815 This variable conditionally defines the HAS_UMASK symbol, which
1816 indicates to the C program that the umask() routine is available.
1817 to set and get the value of the file creation mask.
1819 d_uname (d_gethname.U):
1820 This variable conditionally defines the HAS_UNAME symbol, which
1821 indicates to the C program that the uname() routine may be
1822 used to derive the host name.
1824 d_union_semun (d_union_semun.U):
1825 This variable conditionally defines HAS_UNION_SEMUN if the
1826 union semun is defined by including <sys/sem.h>.
1828 d_unordered (d_unordered.U):
1829 This variable conditionally defines the HAS_UNORDERED symbol, which
1830 indicates to the C program that the unordered() routine is available.
1832 d_usleep (d_usleep.U):
1833 This variable conditionally defines HAS_USLEEP if usleep() is
1834 available to do high granularity sleeps.
1836 d_usleepproto (d_usleepproto.U):
1837 This variable conditionally defines the HAS_USLEEP_PROTO symbol,
1838 which indicates to the C program that the system provides
1839 a prototype for the usleep() function. Otherwise, it is
1840 up to the program to supply one.
1842 d_ustat (d_ustat.U):
1843 This variable conditionally defines HAS_USTAT if ustat() is
1844 available to query file system statistics by dev_t.
1846 d_vendorarch (vendorarch.U):
1847 This variable conditionally defined PERL_VENDORARCH.
1849 d_vendorbin (vendorbin.U):
1850 This variable conditionally defines PERL_VENDORBIN.
1852 d_vendorlib (vendorlib.U):
1853 This variable conditionally defines PERL_VENDORLIB.
1855 d_vfork (d_vfork.U):
1856 This variable conditionally defines the HAS_VFORK symbol, which
1857 indicates the vfork() routine is available.
1859 d_void_closedir (d_closedir.U):
1860 This variable conditionally defines VOID_CLOSEDIR if closedir()
1861 does not return a value.
1863 d_voidsig (d_voidsig.U):
1864 This variable conditionally defines VOIDSIG if this system
1865 declares "void (*signal(...))()" in signal.h. The old way was to
1866 declare it as "int (*signal(...))()".
1868 d_voidtty (i_sysioctl.U):
1869 This variable conditionally defines USE_IOCNOTTY to indicate that the
1870 ioctl() call with TIOCNOTTY should be used to void tty association.
1871 Otherwise (on USG probably), it is enough to close the standard file
1872 decriptors and do a setpgrp().
1874 d_volatile (d_volatile.U):
1875 This variable conditionally defines the HASVOLATILE symbol, which
1876 indicates to the C program that this C compiler knows about the
1877 volatile declaration.
1879 d_vprintf (d_vprintf.U):
1880 This variable conditionally defines the HAS_VPRINTF symbol, which
1881 indicates to the C program that the vprintf() routine is available
1882 to printf with a pointer to an argument list.
1884 d_wait4 (d_wait4.U):
1885 This variable conditionally defines the HAS_WAIT4 symbol, which
1886 indicates the wait4() routine is available.
1888 d_waitpid (d_waitpid.U):
1889 This variable conditionally defines HAS_WAITPID if waitpid() is
1890 available to wait for child process.
1892 d_wcstombs (d_wcstombs.U):
1893 This variable conditionally defines the HAS_WCSTOMBS symbol, which
1894 indicates to the C program that the wcstombs() routine is available
1895 to convert wide character strings to multibyte strings.
1897 d_wctomb (d_wctomb.U):
1898 This variable conditionally defines the HAS_WCTOMB symbol, which
1899 indicates to the C program that the wctomb() routine is available
1900 to convert a wide character to a multibyte.
1902 d_writev (d_writev.U):
1903 This variable conditionally defines the HAS_WRITEV symbol, which
1904 indicates to the C program that the writev() routine is available.
1907 This variable conditionally defines the symbol XENIX, which alerts
1908 the C program that it runs under Xenix.
1911 This variable is used internally by Configure to determine the
1912 full pathname (if any) of the date program. After Configure runs,
1913 the value is reset to a plain "date" and is not useful.
1915 db_hashtype (i_db.U):
1916 This variable contains the type of the hash structure element
1917 in the <db.h> header file. In older versions of DB, it was
1918 int, while in newer ones it is u_int32_t.
1920 db_prefixtype (i_db.U):
1921 This variable contains the type of the prefix structure element
1922 in the <db.h> header file. In older versions of DB, it was
1923 int, while in newer ones it is size_t.
1925 db_version_major (i_db.U):
1926 This variable contains the major version number of
1927 Berkeley DB found in the <db.h> header file.
1929 db_version_minor (i_db.U):
1930 This variable contains the minor version number of
1931 Berkeley DB found in the <db.h> header file.
1932 For DB version 1 this is always 0.
1934 db_version_patch (i_db.U):
1935 This variable contains the patch version number of
1936 Berkeley DB found in the <db.h> header file.
1937 For DB version 1 this is always 0.
1939 defvoidused (voidflags.U):
1940 This variable contains the default value of the VOIDUSED symbol (15).
1942 direntrytype (i_dirent.U):
1943 This symbol is set to 'struct direct' or 'struct dirent' depending on
1944 whether dirent is available or not. You should use this pseudo type to
1945 portably declare your directory entries.
1948 This variable contains the extension that is to be used for the
1949 dynamically loaded modules that perl generaties.
1952 This variable contains the name of the dynamic loading file that
1953 will be used with the package.
1955 doublesize (doublesize.U):
1956 This variable contains the value of the DOUBLESIZE symbol, which
1957 indicates to the C program how many bytes there are in a double.
1959 drand01 (randfunc.U):
1960 Indicates the macro to be used to generate normalized
1961 random numbers. Uses randfunc, often divided by
1962 (double) (((unsigned long) 1 << randbits)) in order to
1963 normalize the result.
1964 In C programs, the macro 'Drand01' is mapped to drand01.
1966 dynamic_ext (Extensions.U):
1967 This variable holds a list of XS extension files we want to
1968 link dynamically into the package. It is used by Makefile.
1970 eagain (nblock_io.U):
1971 This variable bears the symbolic errno code set by read() when no
1972 data is present on the file and non-blocking I/O was enabled (otherwise,
1973 read() blocks naturally).
1976 This variable conditionally defines EBCDIC if this
1977 system uses EBCDIC encoding. Among other things, this
1978 means that the character ranges are not contiguous.
1982 This variable is used internally by Configure to determine the
1983 full pathname (if any) of the echo program. After Configure runs,
1984 the value is reset to a plain "echo" and is not useful.
1987 This variable is used internally by Configure to determine the
1988 full pathname (if any) of the egrep program. After Configure runs,
1989 the value is reset to a plain "egrep" and is not useful.
1992 This variable is defined but not used by Configure.
1993 The value is a plain '' and is not useful.
1996 When running under Eunice this variable contains a command which will
1997 convert a shell script to the proper form of text file for it to be
1998 executable by the shell. On other systems it is a no-op.
2001 This is an old synonym for _exe.
2004 This variable is used internally by Configure to determine the
2005 full pathname (if any) of the expr program. After Configure runs,
2006 the value is reset to a plain "expr" and is not useful.
2008 extensions (Extensions.U):
2009 This variable holds a list of all extension files (both XS and
2010 non-xs linked into the package. It is propagated to Config.pm
2011 and is typically used to test whether a particular extesion
2015 This variable holds a list of extra modules to install.
2017 fflushall (fflushall.U):
2018 This symbol, if defined, tells that to flush
2019 all pending stdio output one must loop through all
2020 the stdio file handles stored in an array and fflush them.
2021 Note that if fflushNULL is defined, fflushall will not
2022 even be probed for and will be left undefined.
2024 fflushNULL (fflushall.U):
2025 This symbol, if defined, tells that fflush(NULL) does flush
2026 all pending stdio output.
2029 This variable is defined but not used by Configure.
2030 The value is a plain '' and is not useful.
2032 firstmakefile (Unix.U):
2033 This variable defines the first file searched by make. On unix,
2034 it is makefile (then Makefile). On case-insensitive systems,
2035 it might be something else. This is only used to deal with
2036 convoluted make depend tricks.
2039 This variable is defined but not used by Configure.
2040 The value is a plain '' and is not useful.
2042 fpossize (fpossize.U):
2043 This variable contains the size of a fpostype in bytes.
2045 fpostype (fpostype.U):
2046 This variable defines Fpos_t to be something like fpos_t, long,
2047 uint, or whatever type is used to declare file positions in libc.
2049 freetype (mallocsrc.U):
2050 This variable contains the return type of free(). It is usually
2051 void, but occasionally int.
2054 This variable contains the command used by Configure
2055 to copy files from the target host. Useful and available
2056 only during Perl build.
2057 The string ':' if not cross-compiling.
2060 This variable contains the full pathname to 'ar', whether or
2061 not the user has specified 'portability'. This is only used
2065 This variable contains the full pathname to 'csh', whether or
2066 not the user has specified 'portability'. This is only used
2067 in the compiled C program, and we assume that all systems which
2068 can share this executable will have the same full pathname to
2071 full_sed (Loc_sed.U):
2072 This variable contains the full pathname to 'sed', whether or
2073 not the user has specified 'portability'. This is only used
2074 in the compiled C program, and we assume that all systems which
2075 can share this executable will have the same full pathname to
2078 gccosandvers (gccvers.U):
2079 If GNU cc (gcc) is used, this variable the operating system and
2080 version used to compile the gcc. It is set to '' if not gcc,
2081 or if nothing useful can be parsed as the os version.
2083 gccversion (gccvers.U):
2084 If GNU cc (gcc) is used, this variable holds '1' or '2' to
2085 indicate whether the compiler is version 1 or 2. This is used in
2086 setting some of the default cflags. It is set to '' if not gcc.
2089 This variable contains the format string used for printing a Gid_t.
2091 gidsign (gidsign.U):
2092 This variable contains the signedness of a gidtype.
2093 1 for unsigned, -1 for signed.
2095 gidsize (gidsize.U):
2096 This variable contains the size of a gidtype in bytes.
2098 gidtype (gidtype.U):
2099 This variable defines Gid_t to be something like gid_t, int,
2100 ushort, or whatever type is used to declare the return type
2101 of getgid(). Typically, it is the type of group ids in the kernel.
2104 This variable holds the general path (space-separated) used to
2105 find libraries. It may contain directories that do not exist on
2106 this platform, libpth is the cleaned-up version.
2109 This variable is used internally by Configure to determine the
2110 full pathname (if any) of the gmake program. After Configure runs,
2111 the value is reset to a plain "gmake" and is not useful.
2114 This variable is used internally by Configure to determine the
2115 full pathname (if any) of the grep program. After Configure runs,
2116 the value is reset to a plain "grep" and is not useful.
2119 This variable contains a command that produces the text of the
2120 /etc/group file. This is normally "cat /etc/group", but can be
2121 "ypcat group" when NIS is used.
2122 On some systems, such as os390, there may be no equivalent
2123 command, in which case this variable is unset.
2125 groupstype (groupstype.U):
2126 This variable defines Groups_t to be something like gid_t, int,
2127 ushort, or whatever type is used for the second argument to
2128 getgroups() and setgroups(). Usually, this is the same as
2129 gidtype (gid_t), but sometimes it isn't.
2132 This variable is used internally by Configure to determine the
2133 full pathname (if any) of the gzip program. After Configure runs,
2134 the value is reset to a plain "gzip" and is not useful.
2136 h_fcntl (h_fcntl.U):
2137 This is variable gets set in various places to tell i_fcntl that
2138 <fcntl.h> should be included.
2140 h_sysfile (h_sysfile.U):
2141 This is variable gets set in various places to tell i_sys_file that
2142 <sys/file.h> should be included.
2145 Gives the type of hints used for previous answers. May be one of
2146 "default", "recommended" or "previous".
2149 This variable contains a command that produces the text of the
2150 /etc/hosts file. This is normally "cat /etc/hosts", but can be
2151 "ypcat hosts" when NIS is used.
2152 On some systems, such as os390, there may be no equivalent
2153 command, in which case this variable is unset.
2156 This variable is the size of an I16 in bytes.
2159 This variable contains the C type used for Perl's I16.
2162 This variable is the size of an I32 in bytes.
2165 This variable contains the C type used for Perl's I32.
2168 This variable is the size of an I64 in bytes.
2171 This variable contains the C type used for Perl's I64.
2174 This variable is the size of an I8 in bytes.
2177 This variable contains the C type used for Perl's I8.
2179 i_arpainet (i_arpainet.U):
2180 This variable conditionally defines the I_ARPA_INET symbol,
2181 and indicates whether a C program should include <arpa/inet.h>.
2183 i_bsdioctl (i_sysioctl.U):
2184 This variable conditionally defines the I_SYS_BSDIOCTL symbol, which
2185 indicates to the C program that <sys/bsdioctl.h> exists and should
2189 This variable conditionally defines the I_DB symbol, and indicates
2190 whether a C program may include Berkeley's DB include file <db.h>.
2193 This variable conditionally defines the I_DBM symbol, which
2194 indicates to the C program that <dbm.h> exists and should
2197 i_dirent (i_dirent.U):
2198 This variable conditionally defines I_DIRENT, which indicates
2199 to the C program that it should include <dirent.h>.
2202 This variable conditionally defines the I_DLD symbol, which
2203 indicates to the C program that <dld.h> (GNU dynamic loading)
2204 exists and should be included.
2206 i_dlfcn (i_dlfcn.U):
2207 This variable conditionally defines the I_DLFCN symbol, which
2208 indicates to the C program that <dlfcn.h> exists and should
2211 i_fcntl (i_fcntl.U):
2212 This variable controls the value of I_FCNTL (which tells
2213 the C program to include <fcntl.h>).
2215 i_float (i_float.U):
2216 This variable conditionally defines the I_FLOAT symbol, and indicates
2217 whether a C program may include <float.h> to get symbols like DBL_MAX
2218 or DBL_MIN, i.e. machine dependent floating point values.
2221 This variable conditionally defines the I_FP symbol, and indicates
2222 whether a C program should include <fp.h>.
2224 i_fp_class (i_fp_class.U):
2225 This variable conditionally defines the I_FP_CLASS symbol, and indicates
2226 whether a C program should include <fp_class.h>.
2229 This variable conditionally defines the I_GDBM symbol, which
2230 indicates to the C program that <gdbm.h> exists and should
2234 This variable conditionally defines the I_GRP symbol, and indicates
2235 whether a C program should include <grp.h>.
2237 i_ieeefp (i_ieeefp.U):
2238 This variable conditionally defines the I_IEEEFP symbol, and indicates
2239 whether a C program should include <ieeefp.h>.
2241 i_inttypes (i_inttypes.U):
2242 This variable conditionally defines the I_INTTYPES symbol,
2243 and indicates whether a C program should include <inttypes.h>.
2245 i_langinfo (i_langinfo.U):
2246 This variable conditionally defines the I_LANGINFO symbol,
2247 and indicates whether a C program should include <langinfo.h>.
2249 i_libutil (i_libutil.U):
2250 This variable conditionally defines the I_LIBUTIL symbol, and indicates
2251 whether a C program should include <libutil.h>.
2253 i_limits (i_limits.U):
2254 This variable conditionally defines the I_LIMITS symbol, and indicates
2255 whether a C program may include <limits.h> to get symbols like WORD_BIT
2258 i_locale (i_locale.U):
2259 This variable conditionally defines the I_LOCALE symbol,
2260 and indicates whether a C program should include <locale.h>.
2262 i_machcthr (i_machcthr.U):
2263 This variable conditionally defines the I_MACH_CTHREADS symbol,
2264 and indicates whether a C program should include <mach/cthreads.h>.
2266 i_malloc (i_malloc.U):
2267 This variable conditionally defines the I_MALLOC symbol, and indicates
2268 whether a C program should include <malloc.h>.
2271 This variable conditionally defines the I_MATH symbol, and indicates
2272 whether a C program may include <math.h>.
2274 i_memory (i_memory.U):
2275 This variable conditionally defines the I_MEMORY symbol, and indicates
2276 whether a C program should include <memory.h>.
2278 i_mntent (i_mntent.U):
2279 This variable conditionally defines the I_MNTENT symbol, and indicates
2280 whether a C program should include <mntent.h>.
2283 This variable conditionally defines the I_NDBM symbol, which
2284 indicates to the C program that <ndbm.h> exists and should
2287 i_netdb (i_netdb.U):
2288 This variable conditionally defines the I_NETDB symbol, and indicates
2289 whether a C program should include <netdb.h>.
2291 i_neterrno (i_neterrno.U):
2292 This variable conditionally defines the I_NET_ERRNO symbol, which
2293 indicates to the C program that <net/errno.h> exists and should
2296 i_netinettcp (i_netinettcp.U):
2297 This variable conditionally defines the I_NETINET_TCP symbol,
2298 and indicates whether a C program should include <netinet/tcp.h>.
2301 This variable conditionally defines I_NETINET_IN, which indicates
2302 to the C program that it should include <netinet/in.h>. Otherwise,
2303 you may try <sys/in.h>.
2306 This variable conditionally defines the I_POLL symbol, and indicates
2307 whether a C program should include <poll.h>.
2310 This variable conditionally defines the I_PROT symbol, and indicates
2311 whether a C program should include <prot.h>.
2313 i_pthread (i_pthread.U):
2314 This variable conditionally defines the I_PTHREAD symbol,
2315 and indicates whether a C program should include <pthread.h>.
2318 This variable conditionally defines I_PWD, which indicates
2319 to the C program that it should include <pwd.h>.
2321 i_rpcsvcdbm (i_dbm.U):
2322 This variable conditionally defines the I_RPCSVC_DBM symbol, which
2323 indicates to the C program that <rpcsvc/dbm.h> exists and should
2324 be included. Some System V systems might need this instead of <dbm.h>.
2327 This variable conditionally defines the I_SFIO symbol,
2328 and indicates whether a C program should include <sfio.h>.
2330 i_sgtty (i_termio.U):
2331 This variable conditionally defines the I_SGTTY symbol, which
2332 indicates to the C program that it should include <sgtty.h> rather
2335 i_shadow (i_shadow.U):
2336 This variable conditionally defines the I_SHADOW symbol, and indicates
2337 whether a C program should include <shadow.h>.
2339 i_socks (i_socks.U):
2340 This variable conditionally defines the I_SOCKS symbol, and indicates
2341 whether a C program should include <socks.h>.
2343 i_stdarg (i_varhdr.U):
2344 This variable conditionally defines the I_STDARG symbol, which
2345 indicates to the C program that <stdarg.h> exists and should
2348 i_stddef (i_stddef.U):
2349 This variable conditionally defines the I_STDDEF symbol, which
2350 indicates to the C program that <stddef.h> exists and should
2353 i_stdlib (i_stdlib.U):
2354 This variable conditionally defines the I_STDLIB symbol, which
2355 indicates to the C program that <stdlib.h> exists and should
2358 i_string (i_string.U):
2359 This variable conditionally defines the I_STRING symbol, which
2360 indicates that <string.h> should be included rather than <strings.h>.
2362 i_sunmath (i_sunmath.U):
2363 This variable conditionally defines the I_SUNMATH symbol, and indicates
2364 whether a C program should include <sunmath.h>.
2366 i_sysaccess (i_sysaccess.U):
2367 This variable conditionally defines the I_SYS_ACCESS symbol,
2368 and indicates whether a C program should include <sys/access.h>.
2370 i_sysdir (i_sysdir.U):
2371 This variable conditionally defines the I_SYS_DIR symbol, and indicates
2372 whether a C program should include <sys/dir.h>.
2374 i_sysfile (i_sysfile.U):
2375 This variable conditionally defines the I_SYS_FILE symbol, and indicates
2376 whether a C program should include <sys/file.h> to get R_OK and friends.
2378 i_sysfilio (i_sysioctl.U):
2379 This variable conditionally defines the I_SYS_FILIO symbol, which
2380 indicates to the C program that <sys/filio.h> exists and should
2381 be included in preference to <sys/ioctl.h>.
2384 This variable conditionally defines I_SYS_IN, which indicates
2385 to the C program that it should include <sys/in.h> instead of
2388 i_sysioctl (i_sysioctl.U):
2389 This variable conditionally defines the I_SYS_IOCTL symbol, which
2390 indicates to the C program that <sys/ioctl.h> exists and should
2393 i_syslog (i_syslog.U):
2394 This variable conditionally defines the I_SYSLOG symbol,
2395 and indicates whether a C program should include <syslog.h>.
2397 i_sysmman (i_sysmman.U):
2398 This variable conditionally defines the I_SYS_MMAN symbol, and
2399 indicates whether a C program should include <sys/mman.h>.
2401 i_sysmode (i_sysmode.U):
2402 This variable conditionally defines the I_SYSMODE symbol,
2403 and indicates whether a C program should include <sys/mode.h>.
2405 i_sysmount (i_sysmount.U):
2406 This variable conditionally defines the I_SYSMOUNT symbol,
2407 and indicates whether a C program should include <sys/mount.h>.
2409 i_sysndir (i_sysndir.U):
2410 This variable conditionally defines the I_SYS_NDIR symbol, and indicates
2411 whether a C program should include <sys/ndir.h>.
2413 i_sysparam (i_sysparam.U):
2414 This variable conditionally defines the I_SYS_PARAM symbol, and indicates
2415 whether a C program should include <sys/param.h>.
2417 i_sysresrc (i_sysresrc.U):
2418 This variable conditionally defines the I_SYS_RESOURCE symbol,
2419 and indicates whether a C program should include <sys/resource.h>.
2421 i_syssecrt (i_syssecrt.U):
2422 This variable conditionally defines the I_SYS_SECURITY symbol,
2423 and indicates whether a C program should include <sys/security.h>.
2425 i_sysselct (i_sysselct.U):
2426 This variable conditionally defines I_SYS_SELECT, which indicates
2427 to the C program that it should include <sys/select.h> in order to
2428 get the definition of struct timeval.
2430 i_syssockio (i_sysioctl.U):
2431 This variable conditionally defines I_SYS_SOCKIO to indicate to the
2432 C program that socket ioctl codes may be found in <sys/sockio.h>
2433 instead of <sys/ioctl.h>.
2435 i_sysstat (i_sysstat.U):
2436 This variable conditionally defines the I_SYS_STAT symbol,
2437 and indicates whether a C program should include <sys/stat.h>.
2439 i_sysstatfs (i_sysstatfs.U):
2440 This variable conditionally defines the I_SYSSTATFS symbol,
2441 and indicates whether a C program should include <sys/statfs.h>.
2443 i_sysstatvfs (i_sysstatvfs.U):
2444 This variable conditionally defines the I_SYSSTATVFS symbol,
2445 and indicates whether a C program should include <sys/statvfs.h>.
2447 i_systime (i_time.U):
2448 This variable conditionally defines I_SYS_TIME, which indicates
2449 to the C program that it should include <sys/time.h>.
2451 i_systimek (i_time.U):
2452 This variable conditionally defines I_SYS_TIME_KERNEL, which
2453 indicates to the C program that it should include <sys/time.h>
2454 with KERNEL defined.
2456 i_systimes (i_systimes.U):
2457 This variable conditionally defines the I_SYS_TIMES symbol, and indicates
2458 whether a C program should include <sys/times.h>.
2460 i_systypes (i_systypes.U):
2461 This variable conditionally defines the I_SYS_TYPES symbol,
2462 and indicates whether a C program should include <sys/types.h>.
2464 i_sysuio (i_sysuio.U):
2465 This variable conditionally defines the I_SYSUIO symbol, and indicates
2466 whether a C program should include <sys/uio.h>.
2468 i_sysun (i_sysun.U):
2469 This variable conditionally defines I_SYS_UN, which indicates
2470 to the C program that it should include <sys/un.h> to get UNIX
2471 domain socket definitions.
2473 i_sysutsname (i_sysutsname.U):
2474 This variable conditionally defines the I_SYSUTSNAME symbol,
2475 and indicates whether a C program should include <sys/utsname.h>.
2477 i_sysvfs (i_sysvfs.U):
2478 This variable conditionally defines the I_SYSVFS symbol,
2479 and indicates whether a C program should include <sys/vfs.h>.
2481 i_syswait (i_syswait.U):
2482 This variable conditionally defines I_SYS_WAIT, which indicates
2483 to the C program that it should include <sys/wait.h>.
2485 i_termio (i_termio.U):
2486 This variable conditionally defines the I_TERMIO symbol, which
2487 indicates to the C program that it should include <termio.h> rather
2490 i_termios (i_termio.U):
2491 This variable conditionally defines the I_TERMIOS symbol, which
2492 indicates to the C program that the POSIX <termios.h> file is
2496 This variable conditionally defines I_TIME, which indicates
2497 to the C program that it should include <time.h>.
2499 i_unistd (i_unistd.U):
2500 This variable conditionally defines the I_UNISTD symbol, and indicates
2501 whether a C program should include <unistd.h>.
2503 i_ustat (i_ustat.U):
2504 This variable conditionally defines the I_USTAT symbol, and indicates
2505 whether a C program should include <ustat.h>.
2507 i_utime (i_utime.U):
2508 This variable conditionally defines the I_UTIME symbol, and indicates
2509 whether a C program should include <utime.h>.
2511 i_values (i_values.U):
2512 This variable conditionally defines the I_VALUES symbol, and indicates
2513 whether a C program may include <values.h> to get symbols like MAXLONG
2516 i_varargs (i_varhdr.U):
2517 This variable conditionally defines I_VARARGS, which indicates
2518 to the C program that it should include <varargs.h>.
2520 i_varhdr (i_varhdr.U):
2521 Contains the name of the header to be included to get va_dcl definition.
2522 Typically one of varargs.h or stdarg.h.
2524 i_vfork (i_vfork.U):
2525 This variable conditionally defines the I_VFORK symbol, and indicates
2526 whether a C program should include vfork.h.
2528 ignore_versioned_solibs (libs.U):
2529 This variable should be non-empty if non-versioned shared
2530 libraries (libfoo.so.x.y) are to be ignored (because they
2531 cannot be linked against).
2533 inc_version_list (inc_version_list.U):
2534 This variable specifies the list of subdirectories in over
2535 which perl.c:incpush() and lib/lib.pm will automatically
2536 search when adding directories to @INC. The elements in
2537 the list are separated by spaces. This is only useful
2538 if you have a perl library directory tree structured like the
2539 default one. See INSTALL for how this works. The versioned
2540 site_perl directory was introduced in 5.005, so that is the
2541 lowest possible value.
2543 inc_version_list_init (inc_version_list.U):
2544 This variable holds the same list as inc_version_list, but
2545 each item is enclosed in double quotes and separated by commas,
2546 suitable for use in the PERL_INC_VERSION_LIST initialization.
2549 This variable must preceed the normal include path to get hte
2550 right one, as in "$incpath/usr/include" or "$incpath/usr/lib".
2551 Value can be "" or "/bsd43" on mips.
2554 This variable is defined but not used by Configure.
2555 The value is a plain '' and is not useful.
2557 installarchlib (archlib.U):
2558 This variable is really the same as archlibexp but may differ on
2559 those systems using AFS. For extra portability, only this variable
2560 should be used in makefiles.
2563 This variable is the same as binexp unless AFS is running in which case
2564 the user is explicitely prompted for it. This variable should always
2565 be used in your makefiles for maximum portability.
2567 installman1dir (man1dir.U):
2568 This variable is really the same as man1direxp, unless you are using
2569 AFS in which case it points to the read/write location whereas
2570 man1direxp only points to the read-only access location. For extra
2571 portability, you should only use this variable within your makefiles.
2573 installman3dir (man3dir.U):
2574 This variable is really the same as man3direxp, unless you are using
2575 AFS in which case it points to the read/write location whereas
2576 man3direxp only points to the read-only access location. For extra
2577 portability, you should only use this variable within your makefiles.
2579 installprefix (installprefix.U):
2580 This variable holds the name of the directory below which
2581 "make install" will install the package. For most users, this
2582 is the same as prefix. However, it is useful for
2583 installing the software into a different (usually temporary)
2584 location after which it can be bundled up and moved somehow
2585 to the final location specified by prefix.
2587 installprefixexp (installprefix.U):
2588 This variable holds the full absolute path of installprefix
2589 with all ~-expansion done.
2591 installprivlib (privlib.U):
2592 This variable is really the same as privlibexp but may differ on
2593 those systems using AFS. For extra portability, only this variable
2594 should be used in makefiles.
2596 installscript (scriptdir.U):
2597 This variable is usually the same as scriptdirexp, unless you are on
2598 a system running AFS, in which case they may differ slightly. You
2599 should always use this variable within your makefiles for portability.
2601 installsitearch (sitearch.U):
2602 This variable is really the same as sitearchexp but may differ on
2603 those systems using AFS. For extra portability, only this variable
2604 should be used in makefiles.
2606 installsitebin (sitebin.U):
2607 This variable is usually the same as sitebinexp, unless you are on
2608 a system running AFS, in which case they may differ slightly. You
2609 should always use this variable within your makefiles for portability.
2611 installsitelib (sitelib.U):
2612 This variable is really the same as sitelibexp but may differ on
2613 those systems using AFS. For extra portability, only this variable
2614 should be used in makefiles.
2616 installstyle (installstyle.U):
2617 This variable describes the "style" of the perl installation.
2618 This is intended to be useful for tools that need to
2619 manipulate entire perl distributions. Perl itself doesn't use
2620 this to find its libraries -- the library directories are
2621 stored directly in Config.pm. Currently, there are only two
2622 styles: "lib" and "lib/perl5". The default library locations
2623 (e.g. privlib, sitelib) are either $prefix/lib or
2624 $prefix/lib/perl5. The former is useful if $prefix is a
2625 directory dedicated to perl (e.g. /opt/perl), while the latter
2626 is useful if $prefix is shared by many packages, e.g. if
2628 This may later be extended to include other information, so
2629 be careful with pattern-matching on the results.
2630 For compatibility with perl5.005 and earlier, the default
2631 setting is based on whether or not $prefix contains the string
2634 installusrbinperl (instubperl.U):
2635 This variable tells whether Perl should be installed also as
2636 /usr/bin/perl in addition to
2639 installvendorarch (vendorarch.U):
2640 This variable is really the same as vendorarchexp but may differ on
2641 those systems using AFS. For extra portability, only this variable
2642 should be used in makefiles.
2644 installvendorbin (vendorbin.U):
2645 This variable is really the same as vendorbinexp but may differ on
2646 those systems using AFS. For extra portability, only this variable
2647 should be used in makefiles.
2649 installvendorlib (vendorlib.U):
2650 This variable is really the same as vendorlibexp but may differ on
2651 those systems using AFS. For extra portability, only this variable
2652 should be used in makefiles.
2654 intsize (intsize.U):
2655 This variable contains the value of the INTSIZE symbol, which
2656 indicates to the C program how many bytes there are in an int.
2658 issymlink (issymlink.U):
2659 This variable holds the test command to test for a symbolic link
2660 (if they are supported). Typical values include 'test -h' and
2663 ivdformat (perlxvf.U):
2664 This variable contains the format string used for printing
2665 a Perl IV as a signed decimal integer.
2668 This variable is the size of an IV in bytes.
2671 This variable contains the C type used for Perl's IV.
2673 known_extensions (Extensions.U):
2674 This variable holds a list of all XS extensions included in
2678 This variable is defined but not used by Configure.
2679 The value is a plain '' and is not useful.
2682 This variable indicates the program to be used to link
2683 libraries for dynamic loading. On some systems, it is 'ld'.
2684 On ELF systems, it should be $cc. Mostly, we'll try to respect
2685 the hint file setting.
2687 lddlflags (dlsrc.U):
2688 This variable contains any special flags that might need to be
2689 passed to $ld to create a shared library suitable for dynamic
2690 loading. It is up to the makefile to use it. For hpux, it
2691 should be '-b'. For sunos 4.1, it is empty.
2693 ldflags (ccflags.U):
2694 This variable contains any additional C loader flags desired by
2695 the user. It is up to the Makefile to use this.
2697 ldflags_uselargefiles (uselfs.U):
2698 This variable contains the loader flags needed by large file builds
2699 and added to ldflags by hints files.
2701 ldlibpthname (libperl.U):
2702 This variable holds the name of the shared library
2703 search path, often LD_LIBRARY_PATH. To get an empty
2704 string, the hints file must set this to 'none'.
2707 This variable is used internally by Configure to determine the
2708 full pathname (if any) of the less program. After Configure runs,
2709 the value is reset to a plain "less" and is not useful.
2712 This is an old synonym for _a.
2715 This variable contains the location of the C library.
2717 libperl (libperl.U):
2718 The perl executable is obtained by linking perlmain.c with
2719 libperl, any static extensions (usually just DynaLoader),
2720 and any other libraries needed on this system. libperl
2721 is usually libperl.a, but can also be libperl.so.xxx if
2722 the user wishes to build a perl executable with a shared
2726 This variable holds the general path (space-separated) used to find
2727 libraries. It is intended to be used by other units.
2730 This variable holds the additional libraries we want to use.
2731 It is up to the Makefile to deal with it.
2734 This variable holds the directory names aka dirnames of the libraries
2735 we found and accepted, duplicates are removed.
2738 This variable holds the filenames aka basenames of the libraries
2739 we found and accepted.
2742 This variable holds the full pathnames of the libraries
2743 we found and accepted.
2746 This variable holds the directory names probed for libraries.
2748 libswanted (Myinit.U):
2749 This variable holds a list of all the libraries we want to
2750 search. The order is chosen to pick up the c library
2751 ahead of ucb or bsd libraries for SVR4.
2753 libswanted_uselargefiles (uselfs.U):
2754 This variable contains the libraries needed by large file builds
2755 and added to ldflags by hints files. It is a space separated list
2756 of the library names without the "lib" prefix or any suffix, just
2760 This variable is defined but not used by Configure.
2761 The value is a plain '' and is not useful.
2764 This variable is defined but not used by Configure.
2765 The value is a plain '' and is not useful.
2767 lkflags (ccflags.U):
2768 This variable contains any additional C partial linker flags desired by
2769 the user. It is up to the Makefile to use this.
2772 This variable is used internally by Configure to determine the
2773 full pathname (if any) of the ln program. After Configure runs,
2774 the value is reset to a plain "ln" and is not useful.
2777 This variable holds the name of the command to make
2778 symbolic links (if they are supported). It can be used
2779 in the Makefile. It is either 'ln -s' or 'ln'
2781 locincpth (ccflags.U):
2782 This variable contains a list of additional directories to be
2783 searched by the compiler. The appropriate '-I' directives will
2784 be added to ccflags. This is intended to simplify setting
2785 local directories from the Configure command line.
2786 It's not much, but it parallels the loclibpth stuff in libpth.U.
2788 loclibpth (libpth.U):
2789 This variable holds the paths (space-separated) used to find local
2790 libraries. It is prepended to libpth, and is intended to be easily
2791 set from the command line.
2793 longdblsize (d_longdbl.U):
2794 This variable contains the value of the LONG_DOUBLESIZE symbol, which
2795 indicates to the C program how many bytes there are in a long double,
2796 if this system supports long doubles.
2798 longlongsize (d_longlong.U):
2799 This variable contains the value of the LONGLONGSIZE symbol, which
2800 indicates to the C program how many bytes there are in a long long,
2801 if this system supports long long.
2803 longsize (intsize.U):
2804 This variable contains the value of the LONGSIZE symbol, which
2805 indicates to the C program how many bytes there are in a long.
2808 This variable is defined but not used by Configure.
2809 The value is a plain '' and is not useful.
2812 This variable is defined but not used by Configure.
2813 The value is a plain '' and is not useful.
2816 This variable is used internally by Configure to determine the
2817 full pathname (if any) of the ls program. After Configure runs,
2818 the value is reset to a plain "ls" and is not useful.
2820 lseeksize (lseektype.U):
2821 This variable defines lseektype to be something like off_t, long,
2822 or whatever type is used to declare lseek offset's type in the
2823 kernel (which also appears to be lseek's return type).
2825 lseektype (lseektype.U):
2826 This variable defines lseektype to be something like off_t, long,
2827 or whatever type is used to declare lseek offset's type in the
2828 kernel (which also appears to be lseek's return type).
2831 This variable is defined but not used by Configure.
2832 The value is a plain '' and is not useful.
2835 This variable is defined but not used by Configure.
2836 The value is a plain '' and is not useful.
2839 This variable is used internally by Configure to determine the
2840 full pathname (if any) of the make program. After Configure runs,
2841 the value is reset to a plain "make" and is not useful.
2843 make_set_make (make.U):
2844 Some versions of 'make' set the variable MAKE. Others do not.
2845 This variable contains the string to be included in Makefile.SH
2846 so that MAKE is set if needed, and not if not needed.
2847 Possible values are:
2848 make_set_make='#' # If your make program handles this for you,
2849 make_set_make="MAKE=$make" # if it doesn't.
2850 I used a comment character so that we can distinguish a
2851 'set' value (from a previous config.sh or Configure '-D' option)
2852 from an uncomputed value.
2854 mallocobj (mallocsrc.U):
2855 This variable contains the name of the malloc.o that this package
2856 generates, if that malloc.o is preferred over the system malloc.
2857 Otherwise the value is null. This variable is intended for generating
2858 Makefiles. See mallocsrc.
2860 mallocsrc (mallocsrc.U):
2861 This variable contains the name of the malloc.c that comes with
2862 the package, if that malloc.c is preferred over the system malloc.
2863 Otherwise the value is null. This variable is intended for generating
2866 malloctype (mallocsrc.U):
2867 This variable contains the kind of ptr returned by malloc and realloc.
2869 man1dir (man1dir.U):
2870 This variable contains the name of the directory in which manual
2871 source pages are to be put. It is the responsibility of the
2872 Makefile.SH to get the value of this into the proper command.
2873 You must be prepared to do the ~name expansion yourself.
2875 man1direxp (man1dir.U):
2876 This variable is the same as the man1dir variable, but is filename
2877 expanded at configuration time, for convenient use in makefiles.
2879 man1ext (man1dir.U):
2880 This variable contains the extension that the manual page should
2881 have: one of 'n', 'l', or '1'. The Makefile must supply the '.'.
2884 man3dir (man3dir.U):
2885 This variable contains the name of the directory in which manual
2886 source pages are to be put. It is the responsibility of the
2887 Makefile.SH to get the value of this into the proper command.
2888 You must be prepared to do the ~name expansion yourself.
2890 man3direxp (man3dir.U):
2891 This variable is the same as the man3dir variable, but is filename
2892 expanded at configuration time, for convenient use in makefiles.
2894 man3ext (man3dir.U):
2895 This variable contains the extension that the manual page should
2896 have: one of 'n', 'l', or '3'. The Makefile must supply the '.'.
2900 This variable is used internally by Configure to determine the
2901 full pathname (if any) of the Mcc program. After Configure runs,
2902 the value is reset to a plain "Mcc" and is not useful.
2904 mips_type (usrinc.U):
2905 This variable holds the environment type for the mips system.
2906 Possible values are "BSD 4.3" and "System V".
2909 This variable is used internally by Configure to determine the
2910 full pathname (if any) of the mkdir program. After Configure runs,
2911 the value is reset to a plain "mkdir" and is not useful.
2913 mmaptype (d_mmap.U):
2914 This symbol contains the type of pointer returned by mmap()
2915 (and simultaneously the type of the first argument).
2916 It can be 'void *' or 'caddr_t'.
2918 modetype (modetype.U):
2919 This variable defines modetype to be something like mode_t,
2920 int, unsigned short, or whatever type is used to declare file
2921 modes for system calls.
2924 This variable is used internally by Configure to determine the
2925 full pathname (if any) of the more program. After Configure runs,
2926 the value is reset to a plain "more" and is not useful.
2928 multiarch (multiarch.U):
2929 This variable conditionally defines the MULTIARCH symbol
2930 which signifies the presence of multiplatform files.
2931 This is normally set by hints files.
2934 This variable is defined but not used by Configure.
2935 The value is a plain '' and is not useful.
2937 myarchname (archname.U):
2938 This variable holds the architecture name computed by Configure in
2939 a previous run. It is not intended to be perused by any user and
2940 should never be set in a hint file.
2942 mydomain (myhostname.U):
2943 This variable contains the eventual value of the MYDOMAIN symbol,
2944 which is the domain of the host the program is going to run on.
2945 The domain must be appended to myhostname to form a complete host name.
2946 The dot comes with mydomain, and need not be supplied by the program.
2948 myhostname (myhostname.U):
2949 This variable contains the eventual value of the MYHOSTNAME symbol,
2950 which is the name of the host the program is going to run on.
2951 The domain is not kept with hostname, but must be gotten from mydomain.
2952 The dot comes with mydomain, and need not be supplied by the program.
2954 myuname (Oldconfig.U):
2955 The output of 'uname -a' if available, otherwise the hostname. On Xenix,
2956 pseudo variables assignments in the output are stripped, thank you. The
2957 whole thing is then lower-cased.
2960 This variable contains the '-n' flag if that is what causes the echo
2961 command to suppress newline. Otherwise it is null. Correct usage is
2962 $echo $n "prompt for a question: $c".
2964 need_va_copy (need_va_copy.U):
2965 This symbol, if defined, indicates that the system stores
2966 the variable argument list datatype, va_list, in a format
2967 that cannot be copied by simple assignment, so that some
2968 other means must be used when copying is required.
2969 As such systems vary in their provision (or non-provision)
2970 of copying mechanisms, handy.h defines a platform-
2971 independent macro, Perl_va_copy(src, dst), to do the job.
2973 netdb_hlen_type (netdbtype.U):
2974 This variable holds the type used for the 2nd argument to
2975 gethostbyaddr(). Usually, this is int or size_t or unsigned.
2976 This is only useful if you have gethostbyaddr(), naturally.
2978 netdb_host_type (netdbtype.U):
2979 This variable holds the type used for the 1st argument to
2980 gethostbyaddr(). Usually, this is char * or void *, possibly
2981 with or without a const prefix.
2982 This is only useful if you have gethostbyaddr(), naturally.
2984 netdb_name_type (netdbtype.U):
2985 This variable holds the type used for the argument to
2986 gethostbyname(). Usually, this is char * or const char *.
2987 This is only useful if you have gethostbyname(), naturally.
2989 netdb_net_type (netdbtype.U):
2990 This variable holds the type used for the 1st argument to
2991 getnetbyaddr(). Usually, this is int or long.
2992 This is only useful if you have getnetbyaddr(), naturally.
2995 This variable is used internally by Configure to determine the
2996 full pathname (if any) of the nm program. After Configure runs,
2997 the value is reset to a plain "nm" and is not useful.
3000 This variable holds the options that may be necessary for nm.
3002 nm_so_opt (usenm.U):
3003 This variable holds the options that may be necessary for nm
3004 to work on a shared library but that can not be used on an
3005 archive library. Currently, this is only used by Linux, where
3006 nm --dynamic is *required* to get symbols from an ELF library which
3007 has been stripped, but nm --dynamic is *fatal* on an archive library.
3008 Maybe Linux should just always set usenm=false.
3010 nonxs_ext (Extensions.U):
3011 This variable holds a list of all non-xs extensions included
3012 in the package. All of them will be built.
3015 This variable is used internally by Configure to determine the
3016 full pathname (if any) of the nroff program. After Configure runs,
3017 the value is reset to a plain "nroff" and is not useful.
3019 nveformat (perlxvf.U):
3020 This variable contains the format string used for printing
3021 a Perl NV using %e-ish floating point format.
3023 nvEUformat (perlxvf.U):
3024 This variable contains the format string used for printing
3025 a Perl NV using %E-ish floating point format.
3027 nvfformat (perlxvf.U):
3028 This variable confains the format string used for printing
3029 a Perl NV using %f-ish floating point format.
3031 nvFUformat (perlxvf.U):
3032 This variable confains the format string used for printing
3033 a Perl NV using %F-ish floating point format.
3035 nvgformat (perlxvf.U):
3036 This variable contains the format string used for printing
3037 a Perl NV using %g-ish floating point format.
3039 nvGUformat (perlxvf.U):
3040 This variable contains the format string used for printing
3041 a Perl NV using %G-ish floating point format.
3044 This variable is the size of an NV in bytes.
3047 This variable contains the C type used for Perl's NV.
3049 o_nonblock (nblock_io.U):
3050 This variable bears the symbol value to be used during open() or fcntl()
3051 to turn on non-blocking I/O for a file descriptor. If you wish to switch
3052 between blocking and non-blocking, you may try ioctl(FIOSNBIO) instead,
3053 but that is only supported by some devices.
3056 This is an old synonym for _o.
3058 old_pthread_create_joinable (d_pthrattrj.U):
3059 This variable defines the constant to use for creating joinable
3060 (aka undetached) pthreads. Unused if pthread.h defines
3061 PTHREAD_CREATE_JOINABLE. If used, possible values are
3062 PTHREAD_CREATE_UNDETACHED and __UNDETACHED.
3064 optimize (ccflags.U):
3065 This variable contains any optimizer/debugger flag that should be used.
3066 It is up to the Makefile to use it.
3068 orderlib (orderlib.U):
3069 This variable is "true" if the components of libraries must be ordered
3070 (with `lorder $* | tsort`) before placing them in an archive. Set to
3071 "false" if ranlib or ar can generate random libraries.
3073 osname (Oldconfig.U):
3074 This variable contains the operating system name (e.g. sunos,
3075 solaris, hpux, etc.). It can be useful later on for setting
3076 defaults. Any spaces are replaced with underscores. It is set
3077 to a null string if we can't figure it out.
3079 osvers (Oldconfig.U):
3080 This variable contains the operating system version (e.g.
3081 4.1.3, 5.2, etc.). It is primarily used for helping select
3082 an appropriate hints file, but might be useful elsewhere for
3083 setting defaults. It is set to '' if we can't figure it out.
3084 We try to be flexible about how much of the version number
3085 to keep, e.g. if 4.1.1, 4.1.2, and 4.1.3 are essentially the
3086 same for this package, hints files might just be os_4.0 or
3087 os_4.1, etc., not keeping separate files for each little release.
3089 otherlibdirs (otherlibdirs.U):
3090 This variable contains a colon-separated set of paths for the perl
3091 binary to search for additional library files or modules.
3092 These directories will be tacked to the end of @INC.
3093 Perl will automatically search below each path for version-
3094 and architecture-specific directories. See inc_version_list
3096 A value of ' ' means 'none' and is used to preserve this value
3097 for the next run through Configure.
3099 package (package.U):
3100 This variable contains the name of the package being constructed.
3101 It is primarily intended for the use of later Configure units.
3104 This variable contains the name of the preferred pager on the system.
3105 Usual values are (the full pathnames of) more, less, pg, or cat.
3108 This variable contains a command that produces the text of the
3109 /etc/passwd file. This is normally "cat /etc/passwd", but can be
3110 "ypcat passwd" when NIS is used.
3111 On some systems, such as os390, there may be no equivalent
3112 command, in which case this variable is unset.
3114 patchlevel (patchlevel.U):
3115 The patchlevel level of this package.
3116 The value of patchlevel comes from the patchlevel.h file.
3117 In a version number such as 5.6.1, this is the "6".
3118 In patchlevel.h, this is referred to as "PERL_VERSION".
3121 This is an old synonym for p_ in Head.U, the character
3122 used to separate elements in the command shell search PATH.
3125 This variable contains the full path (if any) to a previously
3126 installed perl5.005 or later suitable for running the script
3127 to determine inc_version_list.
3130 This variable is defined but not used by Configure.
3131 The value is a plain '' and is not useful.
3133 perl_patchlevel (patchlevel.U):
3134 This is the Perl patch level, a numeric change identifier,
3135 as defined by whichever source code maintenance system
3136 is used to maintain the patches; currently Perforce.
3137 It does not correlate with the Perl version numbers or
3138 the maintenance versus development dichotomy except
3139 by also being increasing.
3141 PERL_REVISION (Oldsyms.U):
3142 In a Perl version number such as 5.6.2, this is the 5.
3143 This value is manually set in patchlevel.h
3145 PERL_SUBVERSION (Oldsyms.U):
3146 In a Perl version number such as 5.6.2, this is the 2.
3147 Values greater than 50 represent potentially unstable
3148 development subversions.
3149 This value is manually set in patchlevel.h
3151 PERL_VERSION (Oldsyms.U):
3152 In a Perl version number such as 5.6.2, this is the 6.
3153 This value is manually set in patchlevel.h
3155 perladmin (perladmin.U):
3156 Electronic mail address of the perl5 administrator.
3159 The list of libraries needed by Perl only (any libraries needed
3160 by extensions only will by dropped, if using dynamic loading).
3162 perlpath (perlpath.U):
3163 This variable contains the eventual value of the PERLPATH symbol,
3164 which contains the name of the perl interpreter to be used in
3165 shell scripts and in the "eval 'exec'" idiom.
3168 This variable is used internally by Configure to determine the
3169 full pathname (if any) of the pg program. After Configure runs,
3170 the value is reset to a plain "pg" and is not useful.
3172 phostname (myhostname.U):
3173 This variable contains the eventual value of the PHOSTNAME symbol,
3174 which is a command that can be fed to popen() to get the host name.
3175 The program should probably not presume that the domain is or isn't
3178 pidtype (pidtype.U):
3179 This variable defines PIDTYPE to be something like pid_t, int,
3180 ushort, or whatever type is used to declare process ids in the kernel.
3183 Holds the private path used by Configure to find out the libraries.
3184 Its value is prepend to libpth. This variable takes care of special
3185 machines, like the mips. Usually, it should be empty.
3187 pm_apiversion (xs_apiversion.U):
3188 This variable contains the version of the oldest perl
3189 compatible with the present perl. (That is, pure perl modules
3190 written for $pm_apiversion will still work for the current
3191 version). perl.c:incpush() and lib/lib.pm will automatically
3192 search in $sitelib for older directories across major versions
3193 back to pm_apiversion. This is only useful if you have a perl
3194 library directory tree structured like the default one. The
3195 versioned site_perl library was introduced in 5.005, so that's
3196 the default setting for this variable. It's hard to imagine
3197 it changing before Perl6. It is included here for symmetry
3198 with xs_apiveprsion -- the searching algorithms will
3199 (presumably) be similar.
3200 See the INSTALL file for how this works.
3203 This variable is defined but not used by Configure.
3204 The value is a plain '' and is not useful.
3207 This variable is defined but not used by Configure.
3208 The value is a plain '' and is not useful.
3211 This variable holds the name of the directory below which the
3212 user will install the package. Usually, this is /usr/local, and
3213 executables go in /usr/local/bin, library stuff in /usr/local/lib,
3214 man pages in /usr/local/man, etc. It is only used to set defaults
3215 for things in bin.U, mansrc.U, privlib.U, or scriptdir.U.
3217 prefixexp (prefix.U):
3218 This variable holds the full absolute path of the directory below
3219 which the user will install the package. Derived from prefix.
3221 privlib (privlib.U):
3222 This variable contains the eventual value of the PRIVLIB symbol,
3223 which is the name of the private library for this package. It may
3224 have a ~ on the front. It is up to the makefile to eventually create
3225 this directory while performing installation (with ~ substitution).
3227 privlibexp (privlib.U):
3228 This variable is the ~name expanded version of privlib, so that you
3229 may use it directly in Makefiles or shell scripts.
3231 procselfexe (d_procselfexe.U):
3232 If d_procselfexe is defined, $procselfexe is the filename
3233 of the symbolic link pointing to the absolute pathname of
3234 the executing program.
3236 prototype (prototype.U):
3237 This variable holds the eventual value of CAN_PROTOTYPE, which
3238 indicates the C compiler can handle funciton prototypes.
3240 ptrsize (ptrsize.U):
3241 This variable contains the value of the PTRSIZE symbol, which
3242 indicates to the C program how many bytes there are in a pointer.
3244 quadkind (quadtype.U):
3245 This variable, if defined, encodes the type of a quad:
3246 1 = int, 2 = long, 3 = long long, 4 = int64_t.
3248 quadtype (quadtype.U):
3249 This variable defines Quad_t to be something like long, int,
3250 long long, int64_t, or whatever type is used for 64-bit integers.
3252 randbits (randfunc.U):
3253 Indicates how many bits are produced by the function used to
3254 generate normalized random numbers.
3256 randfunc (randfunc.U):
3257 Indicates the name of the random number function to use.
3258 Values include drand48, random, and rand. In C programs,
3259 the 'Drand01' macro is defined to generate uniformly distributed
3260 random numbers over the range [0., 1.[ (see drand01 and nrand).
3262 randseedtype (randfunc.U):
3263 Indicates the type of the argument of the seedfunc.
3265 ranlib (orderlib.U):
3266 This variable is set to the pathname of the ranlib program, if it is
3267 needed to generate random libraries. Set to ":" if ar can generate
3268 random libraries or if random libraries are not supported
3270 rd_nodata (nblock_io.U):
3271 This variable holds the return code from read() when no data is
3272 present. It should be -1, but some systems return 0 when O_NDELAY is
3273 used, which is a shame because you cannot make the difference between
3274 no data and an EOF.. Sigh!
3276 revision (patchlevel.U):
3277 The value of revision comes from the patchlevel.h file.
3278 In a version number such as 5.6.1, this is the "5".
3279 In patchlevel.h, this is referred to as "PERL_REVISION".
3282 This variable is used internally by Configure to determine the
3283 full pathname (if any) of the rm program. After Configure runs,
3284 the value is reset to a plain "rm" and is not useful.
3287 This variable is defined but not used by Configure.
3288 The value is a plain '' and is not useful.
3291 This variable contains the command used by Configure
3292 to copy and execute a cross-compiled executable in the
3293 target host. Useful and available only during Perl build.
3294 Empty string '' if not cross-compiling.
3297 This variable contains 'true' or 'false' depending whether the
3298 nm extraction should be performed or not, according to the value
3299 of usenm and the flags on the Configure command line.
3301 sched_yield (d_pthread_y.U):
3302 This variable defines the way to yield the execution
3303 of the current thread.
3305 scriptdir (scriptdir.U):
3306 This variable holds the name of the directory in which the user wants
3307 to put publicly scripts for the package in question. It is either
3308 the same directory as for binaries, or a special one that can be
3309 mounted across different architectures, like /usr/share. Programs
3310 must be prepared to deal with ~name expansion.
3312 scriptdirexp (scriptdir.U):
3313 This variable is the same as scriptdir, but is filename expanded
3314 at configuration time, for programs not wanting to bother with it.
3317 This variable is used internally by Configure to determine the
3318 full pathname (if any) of the sed program. After Configure runs,
3319 the value is reset to a plain "sed" and is not useful.
3321 seedfunc (randfunc.U):
3322 Indicates the random number generating seed function.
3323 Values include srand48, srandom, and srand.
3325 selectminbits (selectminbits.U):
3326 This variable holds the minimum number of bits operated by select.
3327 That is, if you do select(n, ...), how many bits at least will be
3328 cleared in the masks if some activity is detected. Usually this
3329 is either n or 32*ceil(n/32), especially many little-endians do
3330 the latter. This is only useful if you have select(), naturally.
3332 selecttype (selecttype.U):
3333 This variable holds the type used for the 2nd, 3rd, and 4th
3334 arguments to select. Usually, this is 'fd_set *', if HAS_FD_SET
3335 is defined, and 'int *' otherwise. This is only useful if you
3336 have select(), naturally.
3339 This variable is defined but not used by Configure.
3340 The value is a plain '' and is not useful.
3343 This variable contains the full pathname of the shell used
3344 on this system to execute Bourne shell scripts. Usually, this will be
3345 /bin/sh, though it's possible that some systems will have /bin/ksh,
3346 /bin/pdksh, /bin/ash, /bin/bash, or even something such as
3348 This unit comes before Options.U, so you can't set sh with a '-D'
3349 option, though you can override this (and startsh)
3350 with '-O -Dsh=/bin/whatever -Dstartsh=whatever'
3353 This variable is defined but not used by Configure.
3354 The value is a plain '' and is not useful.
3356 sharpbang (spitshell.U):
3357 This variable contains the string #! if this system supports that
3360 shmattype (d_shmat.U):
3361 This symbol contains the type of pointer returned by shmat().
3362 It can be 'void *' or 'char *'.
3364 shortsize (intsize.U):
3365 This variable contains the value of the SHORTSIZE symbol which
3366 indicates to the C program how many bytes there are in a short.
3368 shrpenv (libperl.U):
3369 If the user builds a shared libperl.so, then we need to tell the
3370 'perl' executable where it will be able to find the installed libperl.so.
3371 One way to do this on some systems is to set the environment variable
3372 LD_RUN_PATH to the directory that will be the final location of the
3373 shared libperl.so. The makefile can use this with something like
3374 $shrpenv $(CC) -o perl perlmain.o $libperl $libs
3376 shrpenv="env LD_RUN_PATH=$archlibexp/CORE"
3379 See the main perl Makefile.SH for actual working usage.
3380 Alternatively, we might be able to use a command line option such
3381 as -R $archlibexp/CORE (Solaris) or -Wl,-rpath
3382 $archlibexp/CORE (Linux).
3384 shsharp (spitshell.U):
3385 This variable tells further Configure units whether your sh can
3388 sig_count (sig_name.U):
3389 This variable holds a number larger than the largest valid
3390 signal number. This is usually the same as the NSIG macro.
3392 sig_name (sig_name.U):
3393 This variable holds the signal names, space separated. The leading
3394 SIG in signal name is removed. A ZERO is prepended to the
3395 list. This is currently not used.
3397 sig_name_init (sig_name.U):
3398 This variable holds the signal names, enclosed in double quotes and
3399 separated by commas, suitable for use in the SIG_NAME definition
3400 below. A "ZERO" is prepended to the list, and the list is
3401 terminated with a plain 0. The leading SIG in signal names
3402 is removed. See sig_num.
3404 sig_num (sig_name.U):
3405 This variable holds the signal numbers, space separated. A ZERO is
3406 prepended to the list (corresponding to the fake SIGZERO), and
3407 the list is terminated with a 0. Those numbers correspond to
3408 the value of the signal listed in the same place within the
3411 sig_num_init (sig_name.U):
3412 This variable holds the signal numbers, enclosed in double quotes and
3413 separated by commas, suitable for use in the SIG_NUM definition
3414 below. A "ZERO" is prepended to the list, and the list is
3415 terminated with a plain 0.
3417 sig_size (sig_name.U):
3418 This variable contains the number of elements of the sig_name
3419 and sig_num arrays, excluding the final NULL entry.
3421 signal_t (d_voidsig.U):
3422 This variable holds the type of the signal handler (void or int).
3424 sitearch (sitearch.U):
3425 This variable contains the eventual value of the SITEARCH symbol,
3426 which is the name of the private library for this package. It may
3427 have a ~ on the front. It is up to the makefile to eventually create
3428 this directory while performing installation (with ~ substitution).
3429 The standard distribution will put nothing in this directory.
3430 After perl has been installed, users may install their own local
3431 architecture-dependent modules in this directory with
3432 MakeMaker Makefile.PL
3433 or equivalent. See INSTALL for details.
3435 sitearchexp (sitearch.U):
3436 This variable is the ~name expanded version of sitearch, so that you
3437 may use it directly in Makefiles or shell scripts.
3439 sitebin (sitebin.U):
3440 This variable holds the name of the directory in which the user wants
3441 to put add-on publicly executable files for the package in question. It
3442 is most often a local directory such as /usr/local/bin. Programs using
3443 this variable must be prepared to deal with ~name substitution.
3444 The standard distribution will put nothing in this directory.
3445 After perl has been installed, users may install their own local
3446 executables in this directory with
3447 MakeMaker Makefile.PL
3448 or equivalent. See INSTALL for details.
3450 sitebinexp (sitebin.U):
3451 This is the same as the sitebin variable, but is filename expanded at
3452 configuration time, for use in your makefiles.
3454 sitelib (sitelib.U):
3455 This variable contains the eventual value of the SITELIB symbol,
3456 which is the name of the private library for this package. It may
3457 have a ~ on the front. It is up to the makefile to eventually create
3458 this directory while performing installation (with ~ substitution).
3459 The standard distribution will put nothing in this directory.
3460 After perl has been installed, users may install their own local
3461 architecture-independent modules in this directory with
3462 MakeMaker Makefile.PL
3463 or equivalent. See INSTALL for details.
3465 sitelib_stem (sitelib.U):
3466 This variable is $sitelibexp with any trailing version-specific component
3467 removed. The elements in inc_version_list (inc_version_list.U) can
3468 be tacked onto this variable to generate a list of directories to search.
3470 sitelibexp (sitelib.U):
3471 This variable is the ~name expanded version of sitelib, so that you
3472 may use it directly in Makefiles or shell scripts.
3474 siteprefix (siteprefix.U):
3475 This variable holds the full absolute path of the directory below
3476 which the user will install add-on packages.
3477 See INSTALL for usage and examples.
3479 siteprefixexp (siteprefix.U):
3480 This variable holds the full absolute path of the directory below
3481 which the user will install add-on packages. Derived from siteprefix.
3483 sizesize (sizesize.U):
3484 This variable contains the size of a sizetype in bytes.
3486 sizetype (sizetype.U):
3487 This variable defines sizetype to be something like size_t,
3488 unsigned long, or whatever type is used to declare length
3489 parameters for string functions.
3492 This variable is defined but not used by Configure.
3493 The value is a plain '' and is not useful.
3496 This variable is defined but not used by Configure.
3497 The value is a plain '' and is not useful.
3500 This variable holds the extension used to identify shared libraries
3501 (also known as shared objects) on the system. Usually set to 'so'.
3503 sockethdr (d_socket.U):
3504 This variable has any cpp '-I' flags needed for socket support.
3506 socketlib (d_socket.U):
3507 This variable has the names of any libraries needed for socket support.
3509 socksizetype (socksizetype.U):
3510 This variable holds the type used for the size argument
3511 for various socket calls like accept. Usual values include
3512 socklen_t, size_t, and int.
3515 This variable is used internally by Configure to determine the
3516 full pathname (if any) of the sort program. After Configure runs,
3517 the value is reset to a plain "sort" and is not useful.
3519 spackage (package.U):
3520 This variable contains the name of the package being constructed,
3521 with the first letter uppercased, i.e. suitable for starting
3524 spitshell (spitshell.U):
3525 This variable contains the command necessary to spit out a runnable
3526 shell on this system. It is either cat or a grep '-v' for # comments.
3528 sPRId64 (quadfio.U):
3529 This variable, if defined, contains the string used by stdio to
3530 format 64-bit decimal numbers (format 'd') for output.
3532 sPRIeldbl (longdblfio.U):
3533 This variable, if defined, contains the string used by stdio to
3534 format long doubles (format 'e') for output.
3536 sPRIEUldbl (longdblfio.U):
3537 This variable, if defined, contains the string used by stdio to
3538 format long doubles (format 'E') for output.
3539 The 'U' in the name is to separate this from sPRIeldbl so that even
3540 case-blind systems can see the difference.
3542 sPRIfldbl (longdblfio.U):
3543 This variable, if defined, contains the string used by stdio to
3544 format long doubles (format 'f') for output.
3546 sPRIFUldbl (longdblfio.U):
3547 This variable, if defined, contains the string used by stdio to
3548 format long doubles (format 'F') for output.
3549 The 'U' in the name is to separate this from sPRIfldbl so that even
3550 case-blind systems can see the difference.
3552 sPRIgldbl (longdblfio.U):
3553 This variable, if defined, contains the string used by stdio to
3554 format long doubles (format 'g') for output.
3556 sPRIGUldbl (longdblfio.U):
3557 This variable, if defined, contains the string used by stdio to
3558 format long doubles (format 'G') for output.
3559 The 'U' in the name is to separate this from sPRIgldbl so that even
3560 case-blind systems can see the difference.
3562 sPRIi64 (quadfio.U):
3563 This variable, if defined, contains the string used by stdio to
3564 format 64-bit decimal numbers (format 'i') for output.
3566 sPRIo64 (quadfio.U):
3567 This variable, if defined, contains the string used by stdio to
3568 format 64-bit octal numbers (format 'o') for output.
3570 sPRIu64 (quadfio.U):
3571 This variable, if defined, contains the string used by stdio to
3572 format 64-bit unsigned decimal numbers (format 'u') for output.
3574 sPRIx64 (quadfio.U):
3575 This variable, if defined, contains the string used by stdio to
3576 format 64-bit hexadecimal numbers (format 'x') for output.
3578 sPRIXU64 (quadfio.U):
3579 This variable, if defined, contains the string used by stdio to
3580 format 64-bit hExADECimAl numbers (format 'X') for output.
3581 The 'U' in the name is to separate this from sPRIx64 so that even
3582 case-blind systems can see the difference.
3585 This variable holds the path to the package source. It is up to
3586 the Makefile to use this variable and set VPATH accordingly to
3587 find the sources remotely.
3589 sSCNfldbl (longdblfio.U):
3590 This variable, if defined, contains the string used by stdio to
3591 format long doubles (format 'f') for input.
3593 ssizetype (ssizetype.U):
3594 This variable defines ssizetype to be something like ssize_t,
3595 long or int. It is used by functions that return a count
3596 of bytes or an error condition. It must be a signed type.
3597 We will pick a type such that sizeof(SSize_t) == sizeof(Size_t).
3599 startperl (startperl.U):
3600 This variable contains the string to put on the front of a perl
3601 script to make sure (hopefully) that it runs with perl and not some
3602 shell. Of course, that leading line must be followed by the classical
3604 eval 'exec perl -S $0 ${1+"$@"}'
3605 if $running_under_some_shell;
3606 to guarantee perl startup should the shell execute the script. Note
3607 that this magic incatation is not understood by csh.
3609 startsh (startsh.U):
3610 This variable contains the string to put on the front of a shell
3611 script to make sure (hopefully) that it runs with sh and not some
3614 static_ext (Extensions.U):
3615 This variable holds a list of XS extension files we want to
3616 link statically into the package. It is used by Makefile.
3618 stdchar (stdchar.U):
3619 This variable conditionally defines STDCHAR to be the type of char
3620 used in stdio.h. It has the values "unsigned char" or "char".
3622 stdio_base (d_stdstdio.U):
3623 This variable defines how, given a FILE pointer, fp, to access the
3624 _base field (or equivalent) of stdio.h's FILE structure. This will
3625 be used to define the macro FILE_base(fp).
3627 stdio_bufsiz (d_stdstdio.U):
3628 This variable defines how, given a FILE pointer, fp, to determine
3629 the number of bytes store in the I/O buffer pointer to by the
3630 _base field (or equivalent) of stdio.h's FILE structure. This will
3631 be used to define the macro FILE_bufsiz(fp).
3633 stdio_cnt (d_stdstdio.U):
3634 This variable defines how, given a FILE pointer, fp, to access the
3635 _cnt field (or equivalent) of stdio.h's FILE structure. This will
3636 be used to define the macro FILE_cnt(fp).
3638 stdio_filbuf (d_stdstdio.U):
3639 This variable defines how, given a FILE pointer, fp, to tell
3640 stdio to refill its internal buffers (?). This will
3641 be used to define the macro FILE_filbuf(fp).
3643 stdio_ptr (d_stdstdio.U):
3644 This variable defines how, given a FILE pointer, fp, to access the
3645 _ptr field (or equivalent) of stdio.h's FILE structure. This will
3646 be used to define the macro FILE_ptr(fp).
3648 stdio_stream_array (stdio_streams.U):
3649 This variable tells the name of the array holding the stdio streams.
3650 Usual values include _iob, __iob, and __sF.
3652 strings (i_string.U):
3653 This variable holds the full path of the string header that will be
3654 used. Typically /usr/include/string.h or /usr/include/strings.h.
3657 This variable is defined but not used by Configure.
3658 The value is a plain '' and is not useful.
3660 subversion (patchlevel.U):
3661 The subversion level of this package.
3662 The value of subversion comes from the patchlevel.h file.
3663 In a version number such as 5.6.1, this is the "1".
3664 In patchlevel.h, this is referred to as "PERL_SUBVERSION".
3665 This is unique to perl.
3668 This variable holds the place where the manual is located on this
3669 system. It is not the place where the user wants to put his manual
3670 pages. Rather it is the place where Configure may look to find manual
3671 for unix commands (section 1 of the manual usually). See mansrc.
3674 This variable is defined but not used by Configure.
3675 The value is a plain '' and is not useful.
3678 This variable is defined but not used by Configure.
3679 The value is a plain '' and is not useful.
3681 targetarch (Cross.U):
3682 If cross-compiling, this variable contains the target architecture.
3683 If not, this will be empty.
3686 This variable is defined but not used by Configure.
3687 The value is a plain '' and is not useful.
3690 This variable is defined but not used by Configure.
3691 The value is a plain '' and is not useful.
3694 This variable is used internally by Configure to determine the
3695 full pathname (if any) of the test program. After Configure runs,
3696 the value is reset to a plain "test" and is not useful.
3698 timeincl (i_time.U):
3699 This variable holds the full path of the included time header(s).
3701 timetype (d_time.U):
3702 This variable holds the type returned by time(). It can be long,
3703 or time_t on BSD sites (in which case <sys/types.h> should be
3704 included). Anyway, the type Time_t should be used.
3707 This variable contains the command used by Configure
3708 to copy to from the target host. Useful and available
3709 only during Perl build.
3710 The string ':' if not cross-compiling.
3713 This variable is used internally by Configure to determine the
3714 full pathname (if any) of the touch program. After Configure runs,
3715 the value is reset to a plain "touch" and is not useful.
3718 This variable is used internally by Configure to determine the
3719 full pathname (if any) of the tr program. After Configure runs,
3720 the value is reset to a plain "tr" and is not useful.
3723 This variable contains the value to be passed to the tr(1)
3724 command to transliterate a newline. Typical values are
3725 '\012' and '\n'. This is needed for EBCDIC systems where
3726 newline is not necessarily '\012'.
3729 This variable is defined but not used by Configure.
3730 The value is a plain '' and is not useful.
3733 This variable is the size of an U16 in bytes.
3736 This variable contains the C type used for Perl's U16.
3739 This variable is the size of an U32 in bytes.
3742 This variable contains the C type used for Perl's U32.
3745 This variable is the size of an U64 in bytes.
3748 This variable contains the C type used for Perl's U64.
3751 This variable is the size of an U8 in bytes.
3754 This variable contains the C type used for Perl's U8.
3757 This variable contains the format string used for printing a Uid_t.
3759 uidsign (uidsign.U):
3760 This variable contains the signedness of a uidtype.
3761 1 for unsigned, -1 for signed.
3763 uidsize (uidsize.U):
3764 This variable contains the size of a uidtype in bytes.
3766 uidtype (uidtype.U):
3767 This variable defines Uid_t to be something like uid_t, int,
3768 ushort, or whatever type is used to declare user ids in the kernel.
3771 This variable is used internally by Configure to determine the
3772 full pathname (if any) of the uname program. After Configure runs,
3773 the value is reset to a plain "uname" and is not useful.
3776 This variable is used internally by Configure to determine the
3777 full pathname (if any) of the uniq program. After Configure runs,
3778 the value is reset to a plain "uniq" and is not useful.
3780 uquadtype (quadtype.U):
3781 This variable defines Uquad_t to be something like unsigned long,
3782 unsigned int, unsigned long long, uint64_t, or whatever type is
3783 used for 64-bit integers.
3785 use5005threads (usethreads.U):
3786 This variable conditionally defines the USE_5005THREADS symbol,
3787 and indicates that Perl should be built to use the 5.005-based
3788 threading implementation.
3790 use64bitall (use64bits.U):
3791 This variable conditionally defines the USE_64_BIT_ALL symbol,
3792 and indicates that 64-bit integer types should be used
3793 when available. The maximal possible
3794 64-bitness is employed: LP64 or ILP64, meaning that you will
3795 be able to use more than 2 gigabytes of memory. This mode is
3796 even more binary incompatible than USE_64_BIT_INT. You may not
3797 be able to run the resulting executable in a 32-bit CPU at all or
3798 you may need at least to reboot your OS to 64-bit mode.
3800 use64bitint (use64bits.U):
3801 This variable conditionally defines the USE_64_BIT_INT symbol,
3802 and indicates that 64-bit integer types should be used
3803 when available. The minimal possible 64-bitness
3804 is employed, just enough to get 64-bit integers into Perl.
3805 This may mean using for example "long longs", while your memory
3806 may still be limited to 2 gigabytes.
3808 usecrosscompile (Cross.U):
3809 This variable conditionally defines the USE_CROSS_COMPILE symbol,
3810 and indicates that Perl has been cross-compiled.
3813 This variable indicates if the system supports dynamic
3814 loading of some sort. See also dlsrc and dlobj.
3816 useithreads (usethreads.U):
3817 This variable conditionally defines the USE_ITHREADS symbol,
3818 and indicates that Perl should be built to use the interpreter-based
3819 threading implementation.
3821 uselargefiles (uselfs.U):
3822 This variable conditionally defines the USE_LARGE_FILES symbol,
3823 and indicates that large file interfaces should be used when
3826 uselongdouble (uselongdbl.U):
3827 This variable conditionally defines the USE_LONG_DOUBLE symbol,
3828 and indicates that long doubles should be used when available.
3830 usemorebits (usemorebits.U):
3831 This variable conditionally defines the USE_MORE_BITS symbol,
3832 and indicates that explicit 64-bit interfaces and long doubles
3833 should be used when available.
3835 usemultiplicity (usemultiplicity.U):
3836 This variable conditionally defines the MULTIPLICITY symbol,
3837 and indicates that Perl should be built to use multiplicity.
3839 usemymalloc (mallocsrc.U):
3840 This variable contains y if the malloc that comes with this package
3841 is desired over the system's version of malloc. People often include
3842 special versions of malloc for effiency, but such versions are often
3843 less portable. See also mallocsrc and mallocobj.
3844 If this is 'y', then -lmalloc is removed from $libs.
3847 This variable contains 'true' or 'false' depending whether the
3848 nm extraction is wanted or not.
3850 useopcode (Extensions.U):
3851 This variable holds either 'true' or 'false' to indicate
3852 whether the Opcode extension should be used. The sole
3853 use for this currently is to allow an easy mechanism
3854 for users to skip the Opcode extension from the Configure
3857 useperlio (useperlio.U):
3858 This variable conditionally defines the USE_PERLIO symbol,
3859 and indicates that the PerlIO abstraction should be
3862 useposix (Extensions.U):
3863 This variable holds either 'true' or 'false' to indicate
3864 whether the POSIX extension should be used. The sole
3865 use for this currently is to allow an easy mechanism
3866 for hints files to indicate that POSIX will not compile
3867 on a particular system.
3869 usereentrant (usethreads.U):
3870 This variable conditionally defines the USE_REENTRANT_API symbol,
3871 which indicates that the thread code may try to use the various
3872 _r versions of library functions. This is only potentially
3873 meaningful if usethreads is set and is very experimental, it is
3874 not even prompted for.
3877 This variable is set to true when the user agrees to use sfio.
3878 It is set to false when sfio is not available or when the user
3879 explicitely requests not to use sfio. It is here primarily so
3880 that command-line settings can override the auto-detection of
3881 d_sfio without running into a "WHOA THERE".
3883 useshrplib (libperl.U):
3884 This variable is set to 'yes' if the user wishes
3885 to build a shared libperl, and 'no' otherwise.
3887 usesocks (usesocks.U):
3888 This variable conditionally defines the USE_SOCKS symbol,
3889 and indicates that Perl should be built to use SOCKS.
3891 usethreads (usethreads.U):
3892 This variable conditionally defines the USE_THREADS symbol,
3893 and indicates that Perl should be built to use threads.
3895 usevendorprefix (vendorprefix.U):
3896 This variable tells whether the vendorprefix
3897 and consequently other vendor* paths are in use.
3899 usevfork (d_vfork.U):
3900 This variable is set to true when the user accepts to use vfork.
3901 It is set to false when no vfork is available or when the user
3902 explicitely requests not to use vfork.
3905 This variable holds the path of the include files, which is
3906 usually /usr/include. It is mainly used by other Configure units.
3909 This variable is defined but not used by Configure.
3910 The value is a plain '' and is not useful.
3912 uvoformat (perlxvf.U):
3913 This variable contains the format string used for printing
3914 a Perl UV as an unsigned octal integer.
3917 This variable is the size of a UV in bytes.
3920 This variable contains the C type used for Perl's UV.
3922 uvuformat (perlxvf.U):
3923 This variable contains the format string used for printing
3924 a Perl UV as an unsigned decimal integer.
3926 uvxformat (perlxvf.U):
3927 This variable contains the format string used for printing
3928 a Perl UV as an unsigned hexadecimal integer in lowercase abcdef.
3930 uvXUformat (perlxvf.U):
3931 This variable contains the format string used for printing
3932 a Perl UV as an unsigned hexadecimal integer in uppercase ABCDEF.
3934 vendorarch (vendorarch.U):
3935 This variable contains the value of the PERL_VENDORARCH symbol.
3936 It may have a ~ on the front.
3937 The standard distribution will put nothing in this directory.
3938 Vendors who distribute perl may wish to place their own
3939 architecture-dependent modules and extensions in this directory with
3940 MakeMaker Makefile.PL INSTALLDIRS=vendor
3941 or equivalent. See INSTALL for details.
3943 vendorarchexp (vendorarch.U):
3944 This variable is the ~name expanded version of vendorarch, so that you
3945 may use it directly in Makefiles or shell scripts.
3947 vendorbin (vendorbin.U):
3948 This variable contains the eventual value of the VENDORBIN symbol.
3949 It may have a ~ on the front.
3950 The standard distribution will put nothing in this directory.
3951 Vendors who distribute perl may wish to place additional
3952 binaries in this directory with
3953 MakeMaker Makefile.PL INSTALLDIRS=vendor
3954 or equivalent. See INSTALL for details.
3956 vendorbinexp (vendorbin.U):
3957 This variable is the ~name expanded version of vendorbin, so that you
3958 may use it directly in Makefiles or shell scripts.
3960 vendorlib (vendorlib.U):
3961 This variable contains the eventual value of the VENDORLIB symbol,
3962 which is the name of the private library for this package.
3963 The standard distribution will put nothing in this directory.
3964 Vendors who distribute perl may wish to place their own
3965 modules in this directory with
3966 MakeMaker Makefile.PL INSTALLDIRS=vendor
3967 or equivalent. See INSTALL for details.
3969 vendorlib_stem (vendorlib.U):
3970 This variable is $vendorlibexp with any trailing version-specific component
3971 removed. The elements in inc_version_list (inc_version_list.U) can
3972 be tacked onto this variable to generate a list of directories to search.
3974 vendorlibexp (vendorlib.U):
3975 This variable is the ~name expanded version of vendorlib, so that you
3976 may use it directly in Makefiles or shell scripts.
3978 vendorprefix (vendorprefix.U):
3979 This variable holds the full absolute path of the directory below
3980 which the vendor will install add-on packages.
3981 See INSTALL for usage and examples.
3983 vendorprefixexp (vendorprefix.U):
3984 This variable holds the full absolute path of the directory below
3985 which the vendor will install add-on packages. Derived from vendorprefix.
3987 version (patchlevel.U):
3988 The full version number of this package, such as 5.6.1 (or 5_6_1).
3989 This combines revision, patchlevel, and subversion to get the
3990 full version number, including any possible subversions.
3991 This is suitable for use as a directory name, and hence is
3992 filesystem dependent.
3994 version_patchlevel_string (patchlevel.U):
3995 This is a string combining version, subversion and
3996 perl_patchlevel (if perl_patchlevel is non-zero).
3997 It is typically something like
3998 'version 7 subversion 1' or
3999 'version 7 subversion 1 patchlevel 11224'
4000 It is computed here to avoid duplication of code in myconfig.SH
4003 versiononly (versiononly.U):
4004 If set, this symbol indicates that only the version-specific
4005 components of a perl installation should be installed.
4006 This may be useful for making a test installation of a new
4007 version without disturbing the existing installation.
4008 Setting versiononly is equivalent to setting installperl's -v option.
4009 In particular, the non-versioned scripts and programs such as
4010 a2p, c2ph, h2xs, pod2*, and perldoc are not installed
4011 (see INSTALL for a more complete list). Nor are the man
4013 Usually, this is undef.
4016 This variable is defined but not used by Configure.
4017 The value is a plain '' and is not useful.
4019 voidflags (voidflags.U):
4020 This variable contains the eventual value of the VOIDFLAGS symbol,
4021 which indicates how much support of the void type is given by this
4022 compiler. See VOIDFLAGS for more info.
4025 This variable holds extra path (space-separated) used to find
4026 libraries on this platform, for example CPU-specific libraries
4027 (on multi-CPU platforms) may be listed here.
4029 xs_apiversion (xs_apiversion.U):
4030 This variable contains the version of the oldest perl binary
4031 compatible with the present perl. perl.c:incpush() and
4032 lib/lib.pm will automatically search in $sitearch for older
4033 directories across major versions back to xs_apiversion.
4034 This is only useful if you have a perl library directory tree
4035 structured like the default one.
4036 See INSTALL for how this works.
4037 The versioned site_perl directory was introduced in 5.005,
4038 so that is the lowest possible value.
4039 Since this can depend on compile time options (such as
4040 bincompat) it is set by Configure. Other non-default sources
4041 of potential incompatibility, such as multiplicity, threads,
4042 debugging, 64bits, sfio, etc., are not checked for currently,
4043 though in principle we could go snooping around in old
4047 This variable holds the name of the compiler compiler we
4048 want to use in the Makefile. It can be yacc, byacc, or bison -y.
4051 This variable contains any additional yacc flags desired by the
4052 user. It is up to the Makefile to use this.
4055 This variable is defined but not used by Configure.
4056 The value is a plain '' and is not useful.
4059 This variable is used internally by Configure to determine the
4060 full pathname (if any) of the zip program. After Configure runs,
4061 the value is reset to a plain "zip" and is not useful.