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