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