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