This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Continue what #4494 started; introduce uid and gid formats.
[perl5.git] / Porting / Glossary
CommitLineData
d7418ba7
PP
1This file contains a description of all the shell variables whose value is
2determined by the Configure script. Variables intended for use in C
ebc74a4b
GS
3programs (e.g. I_UNISTD) are already described in config_h.SH. [`configpm'
4generates pod documentation for Config.pm from this file--please try to keep
5the formatting regular.]
d7418ba7 6
781b178c
JH
7_a (Unix.U):
8 This variable defines the extension used for ordinary libraries.
9 For unix, it is '.a'. The '.' is included. Other possible
10 values include '.lib'.
11
12_exe (Unix.U):
13 This variable defines the extension used for executable files.
14 For unix it is empty. Other possible values include '.exe'.
15
16_o (Unix.U):
17 This variable defines the extension used for object files.
18 For unix, it is '.o'. The '.' is included. Other possible
19 values include '.obj'.
20
21afs (afs.U):
22 This variable is set to 'true' if AFS (Andrew File System) is used
23 on the system, 'false' otherwise. It is possible to override this
24 with a hint value or command line option, but you'd better know
25 what you are doing.
26
27alignbytes (alignbytes.U):
28 This variable holds the number of bytes required to align a
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
JH
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
JH
50
51ar (Loc.U):
5bf26616 52 This variable is used internally by Configure to determine the
781b178c
JH
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
JH
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
JH
99bincompat5005 (bincompat5005.U):
100 This variable contains y if Perl 5.006 should be binary-compatible
101 with Perl 5.005.
102
781b178c
JH
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
JH
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
JH
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
JH
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
JH
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
JH
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
JH
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
JH
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
JH
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
JH
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
JH
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
JH
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
JH
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
JH
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
JH
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
JH
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
JH
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
JH
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
JH
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
JH
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
JH
524d_flock (d_flock.U):
525 This variable conditionally defines HAS_FLOCK if flock() is
526 available to do file locking.
527
781b178c
JH
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
LV
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
JH
542 This variable conditionally defines the HAS_STRUCT_FS_DATA symbol,
543 which indicates that the struct fs_data is supported.
544
781b178c
JH
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
JH
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
JH
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
JH
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
JH
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
JH
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
JH
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
JH
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
JH
759d_int64t (i_inttypes.U):
760 This symbol will be defined if the C compiler supports int64_t.
761
781b178c
JH
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
LV
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
JH
781d_link (d_link.U):
782 This variable conditionally defines HAS_LINK if link() is
783 available to create hard links.
784
781b178c
JH
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
JH
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
JH
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
JH
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
JH
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
JH
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
JH
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
JH
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
JH
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
JH
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
JH
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
JH
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
JH
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
781b178c
JH
1051d_readdir (d_readdir.U):
1052 This variable conditionally defines HAS_READDIR if readdir() is
1053 available to read directory entries.
1054
1055d_readlink (d_readlink.U):
1056 This variable conditionally defines the HAS_READLINK symbol, which
1057 indicates to the C program that the readlink() routine is available
1058 to read the value of a symbolic link.
1059
781b178c
JH
1060d_rename (d_rename.U):
1061 This variable conditionally defines the HAS_RENAME symbol, which
1062 indicates to the C program that the rename() routine is available
1063 to rename files.
1064
1065d_rewinddir (d_readdir.U):
1066 This variable conditionally defines HAS_REWINDDIR if rewinddir() is
1067 available.
1068
1069d_rmdir (d_rmdir.U):
1070 This variable conditionally defines HAS_RMDIR if rmdir() is
1071 available to remove directories.
1072
1073d_safebcpy (d_safebcpy.U):
1074 This variable conditionally defines the HAS_SAFE_BCOPY symbol if
1075 the bcopy() routine can do overlapping copies.
1076
1077d_safemcpy (d_safemcpy.U):
1078 This variable conditionally defines the HAS_SAFE_MEMCPY symbol if
1079 the memcpy() routine can do overlapping copies.
1080
1081d_sanemcmp (d_sanemcmp.U):
1082 This variable conditionally defines the HAS_SANE_MEMCMP symbol if
1083 the memcpy() routine is available and can be used to compare relative
1084 magnitudes of chars with their high bits set.
1085
1086d_sched_yield (d_pthread_y.U):
1087 This variable conditionally defines the HAS_SCHED_YIELD
1088 symbol if the sched_yield routine is available to yield
1089 the execution of the current thread.
1090
1091d_scm_rights (d_socket.U):
1092 This variable conditionally defines the HAS_SCM_RIGHTS symbol,
1093 which indicates that the SCM_RIGHTS is available. #ifdef is
1094 not enough because it may be an enum, glibc has been known to do this.
1095
781b178c
JH
1096d_seekdir (d_readdir.U):
1097 This variable conditionally defines HAS_SEEKDIR if seekdir() is
1098 available.
1099
1100d_select (d_select.U):
1101 This variable conditionally defines HAS_SELECT if select() is
1102 available to select active file descriptors. A <sys/time.h>
1103 inclusion may be necessary for the timeout field.
1104
1105d_sem (d_sem.U):
1106 This variable conditionally defines the HAS_SEM symbol, which
1107 indicates that the entire sem*(2) library is present.
1108
1109d_semctl (d_semctl.U):
1110 This variable conditionally defines the HAS_SEMCTL symbol, which
1111 indicates to the C program that the semctl() routine is available.
1112
1113d_semctl_semid_ds (d_union_semun.U):
1114 This variable conditionally defines USE_SEMCTL_SEMID_DS, which
1115 indicates that struct semid_ds * is to be used for semctl IPC_STAT.
1116
1117d_semctl_semun (d_union_semun.U):
1118 This variable conditionally defines USE_SEMCTL_SEMUN, which
1119 indicates that union semun is to be used for semctl IPC_STAT.
1120
1121d_semget (d_semget.U):
1122 This variable conditionally defines the HAS_SEMGET symbol, which
1123 indicates to the C program that the semget() routine is available.
1124
1125d_semop (d_semop.U):
1126 This variable conditionally defines the HAS_SEMOP symbol, which
1127 indicates to the C program that the semop() routine is available.
1128
781b178c
JH
1129d_setegid (d_setegid.U):
1130 This variable conditionally defines the HAS_SETEGID symbol, which
1131 indicates to the C program that the setegid() routine is available
1132 to change the effective gid of the current program.
1133
1134d_seteuid (d_seteuid.U):
1135 This variable conditionally defines the HAS_SETEUID symbol, which
1136 indicates to the C program that the seteuid() routine is available
1137 to change the effective uid of the current program.
1138
1139d_setgrent (d_setgrent.U):
1140 This variable conditionally defines the HAS_SETGRENT symbol, which
1141 indicates to the C program that the setgrent() routine is available
1142 for initializing sequential access to the group database.
1143
1144d_setgrps (d_setgrps.U):
1145 This variable conditionally defines the HAS_SETGROUPS symbol, which
1146 indicates to the C program that the setgroups() routine is available
1147 to set the list of process groups.
1148
1149d_sethent (d_sethent.U):
1150 This variable conditionally defines HAS_SETHOSTENT if sethostent() is
1151 available.
1152
1153d_setlinebuf (d_setlnbuf.U):
1154 This variable conditionally defines the HAS_SETLINEBUF symbol, which
1155 indicates to the C program that the setlinebuf() routine is available
1156 to change stderr or stdout from block-buffered or unbuffered to a
1157 line-buffered mode.
1158
1159d_setlocale (d_setlocale.U):
1160 This variable conditionally defines HAS_SETLOCALE if setlocale() is
1161 available to handle locale-specific ctype implementations.
1162
1163d_setnent (d_setnent.U):
1164 This variable conditionally defines HAS_SETNETENT if setnetent() is
1165 available.
1166
1167d_setpent (d_setpent.U):
1168 This variable conditionally defines HAS_SETPROTOENT if setprotoent() is
1169 available.
1170
1171d_setpgid (d_setpgid.U):
1172 This variable conditionally defines the HAS_SETPGID symbol if the
1173 setpgid(pid, gpid) function is available to set process group ID.
1174
1175d_setpgrp2 (d_setpgrp2.U):
1176 This variable conditionally defines the HAS_SETPGRP2 symbol, which
1177 indicates to the C program that the setpgrp2() (as in DG/UX) routine
1178 is available to set the current process group.
1179
1180d_setpgrp (d_setpgrp.U):
1181 This variable conditionally defines HAS_SETPGRP if setpgrp() is
1182 available to set the current process group.
1183
1184d_setprior (d_setprior.U):
1185 This variable conditionally defines HAS_SETPRIORITY if setpriority()
1186 is available to set a process's priority.
1187
1188d_setpwent (d_setpwent.U):
1189 This variable conditionally defines the HAS_SETPWENT symbol, which
1190 indicates to the C program that the setpwent() routine is available
1191 for initializing sequential access to the passwd database.
1192
1193d_setregid (d_setregid.U):
1194 This variable conditionally defines HAS_SETREGID if setregid() is
1195 available to change the real and effective gid of the current
1196 process.
1197
1198d_setresgid (d_setregid.U):
1199 This variable conditionally defines HAS_SETRESGID if setresgid() is
1200 available to change the real, effective and saved gid of the current
1201 process.
1202
1203d_setresuid (d_setreuid.U):
1204 This variable conditionally defines HAS_SETREUID if setresuid() is
1205 available to change the real, effective and saved uid of the current
1206 process.
1207
1208d_setreuid (d_setreuid.U):
1209 This variable conditionally defines HAS_SETREUID if setreuid() is
1210 available to change the real and effective uid of the current
1211 process.
1212
1213d_setrgid (d_setrgid.U):
1214 This variable conditionally defines the HAS_SETRGID symbol, which
1215 indicates to the C program that the setrgid() routine is available
1216 to change the real gid of the current program.
1217
1218d_setruid (d_setruid.U):
1219 This variable conditionally defines the HAS_SETRUID symbol, which
1220 indicates to the C program that the setruid() routine is available
1221 to change the real uid of the current program.
1222
1223d_setsent (d_setsent.U):
1224 This variable conditionally defines HAS_SETSERVENT if setservent() is
1225 available.
1226
1227d_setsid (d_setsid.U):
1228 This variable conditionally defines HAS_SETSID if setsid() is
1229 available to set the process group ID.
1230
1231d_setspent (d_setspent.U):
1232 This variable conditionally defines HAS_SETSPENT if setspent() is
1233 available to initialize the scan of SysV shadow password entries.
1234
1235d_setvbuf (d_setvbuf.U):
1236 This variable conditionally defines the HAS_SETVBUF symbol, which
1237 indicates to the C program that the setvbuf() routine is available
1238 to change buffering on an open stdio stream.
1239
1240d_sfio (d_sfio.U):
1241 This variable conditionally defines the USE_SFIO symbol,
1242 and indicates whether sfio is available (and should be used).
1243
1244d_shm (d_shm.U):
1245 This variable conditionally defines the HAS_SHM symbol, which
1246 indicates that the entire shm*(2) library is present.
1247
1248d_shmat (d_shmat.U):
1249 This variable conditionally defines the HAS_SHMAT symbol, which
1250 indicates to the C program that the shmat() routine is available.
1251
1252d_shmatprototype (d_shmat.U):
1253 This variable conditionally defines the HAS_SHMAT_PROTOTYPE
1254 symbol, which indicates that sys/shm.h has a prototype for
1255 shmat.
1256
1257d_shmctl (d_shmctl.U):
1258 This variable conditionally defines the HAS_SHMCTL symbol, which
1259 indicates to the C program that the shmctl() routine is available.
1260
1261d_shmdt (d_shmdt.U):
1262 This variable conditionally defines the HAS_SHMDT symbol, which
1263 indicates to the C program that the shmdt() routine is available.
1264
1265d_shmget (d_shmget.U):
1266 This variable conditionally defines the HAS_SHMGET symbol, which
1267 indicates to the C program that the shmget() routine is available.
1268
1269d_sigaction (d_sigaction.U):
1270 This variable conditionally defines the HAS_SIGACTION symbol, which
1271 indicates that the Vr4 sigaction() routine is available.
1272
1273d_sigsetjmp (d_sigsetjmp.U):
1274 This variable conditionally defines the HAS_SIGSETJMP symbol,
1275 which indicates that the sigsetjmp() routine is available to
1276 call setjmp() and optionally save the process's signal mask.
1277
1278d_socket (d_socket.U):
1279 This variable conditionally defines HAS_SOCKET, which indicates
1280 that the BSD socket interface is supported.
1281
1282d_sockpair (d_socket.U):
1283 This variable conditionally defines the HAS_SOCKETPAIR symbol, which
1284 indicates that the BSD socketpair() is supported.
1285
68d4903c
JH
1286d_sqrtl (d_sqrtl.U):
1287 This variable conditionally defines the HAS_SQRTL symbol, which
1288 indicates to the C program that the sqrtl() routine is available.
1289
781b178c
JH
1290d_statblks (d_statblks.U):
1291 This variable conditionally defines USE_STAT_BLOCKS
1292 if this system has a stat structure declaring
1293 st_blksize and st_blocks.
1294
ad27e871 1295d_statfs_f_flags (d_statfs_f_flags.U):
0545a864 1296 This variable conditionally defines the HAS_STRUCT_STATFS_F_FLAGS
781b178c
JH
1297 symbol, which indicates to struct statfs from has f_flags member.
1298 This kind of struct statfs is coming from sys/mount.h (BSD),
1299 not from sys/statfs.h (SYSV).
1300
ad27e871 1301d_statfs_s (d_statfs_s.U):
0545a864
JH
1302 This variable conditionally defines the HAS_STRUCT_STATFS symbol,
1303 which indicates that the struct statfs is supported.
1304
781b178c
JH
1305d_statvfs (d_statvfs.U):
1306 This variable conditionally defines the HAS_STATVFS symbol, which
1307 indicates to the C program that the statvfs() routine is available.
1308
1309d_stdio_cnt_lval (d_stdstdio.U):
1310 This variable conditionally defines STDIO_CNT_LVALUE if the
1311 FILE_cnt macro can be used as an lvalue.
1312
1313d_stdio_ptr_lval (d_stdstdio.U):
1314 This variable conditionally defines STDIO_PTR_LVALUE if the
1315 FILE_ptr macro can be used as an lvalue.
1316
1317d_stdio_stream_array (stdio_streams.U):
1318 This variable tells whether there is an array holding
1319 the stdio streams.
1320
1321d_stdiobase (d_stdstdio.U):
1322 This variable conditionally defines USE_STDIO_BASE if this system
1323 has a FILE structure declaring a usable _base field (or equivalent)
1324 in stdio.h.
1325
1326d_stdstdio (d_stdstdio.U):
1327 This variable conditionally defines USE_STDIO_PTR if this system
1328 has a FILE structure declaring usable _ptr and _cnt fields (or
1329 equivalent) in stdio.h.
1330
781b178c
JH
1331d_strchr (d_strchr.U):
1332 This variable conditionally defines HAS_STRCHR if strchr() and
1333 strrchr() are available for string searching.
1334
1335d_strcoll (d_strcoll.U):
1336 This variable conditionally defines HAS_STRCOLL if strcoll() is
1337 available to compare strings using collating information.
1338
1339d_strctcpy (d_strctcpy.U):
1340 This variable conditionally defines the USE_STRUCT_COPY symbol, which
1341 indicates to the C program that this C compiler knows how to copy
1342 structures.
1343
1344d_strerrm (d_strerror.U):
1345 This variable holds what Strerrr is defined as to translate an error
1346 code condition into an error message string. It could be 'strerror'
1347 or a more complex macro emulating strrror with sys_errlist[], or the
1348 "unknown" string when both strerror and sys_errlist are missing.
1349
1350d_strerror (d_strerror.U):
1351 This variable conditionally defines HAS_STRERROR if strerror() is
1352 available to translate error numbers to strings.
1353
1354d_strtod (d_strtod.U):
1355 This variable conditionally defines the HAS_STRTOD symbol, which
1356 indicates to the C program that the strtod() routine is available
1357 to provide better numeric string conversion than atof().
1358
1359d_strtol (d_strtol.U):
1360 This variable conditionally defines the HAS_STRTOL symbol, which
1361 indicates to the C program that the strtol() routine is available
1362 to provide better numeric string conversion than atoi() and friends.
1363
1364d_strtoul (d_strtoul.U):
1365 This variable conditionally defines the HAS_STRTOUL symbol, which
1366 indicates to the C program that the strtoul() routine is available
1367 to provide conversion of strings to unsigned long.
1368
11dc3f68
JH
1369d_strtoull (strtoull.U):
1370 This variable conditionally defines the HAS_STRTOULL symbol, which
1371 indicates to the C program that the strtoull() routine is available.
1372
781b178c
JH
1373d_strxfrm (d_strxfrm.U):
1374 This variable conditionally defines HAS_STRXFRM if strxfrm() is
1375 available to transform strings.
1376
1377d_suidsafe (d_dosuid.U):
1378 This variable conditionally defines SETUID_SCRIPTS_ARE_SECURE_NOW
1379 if setuid scripts can be secure. This test looks in /dev/fd/.
1380
1381d_symlink (d_symlink.U):
1382 This variable conditionally defines the HAS_SYMLINK symbol, which
1383 indicates to the C program that the symlink() routine is available
1384 to create symbolic links.
1385
1386d_syscall (d_syscall.U):
1387 This variable conditionally defines HAS_SYSCALL if syscall() is
1388 available call arbitrary system calls.
1389
1390d_sysconf (d_sysconf.U):
1391 This variable conditionally defines the HAS_SYSCONF symbol, which
1392 indicates to the C program that the sysconf() routine is available
1393 to determine system related limits and options.
1394
1395d_sysernlst (d_strerror.U):
1396 This variable conditionally defines HAS_SYS_ERRNOLIST if sys_errnolist[]
1397 is available to translate error numbers to the symbolic name.
1398
1399d_syserrlst (d_strerror.U):
1400 This variable conditionally defines HAS_SYS_ERRLIST if sys_errlist[] is
1401 available to translate error numbers to strings.
1402
1403d_system (d_system.U):
1404 This variable conditionally defines HAS_SYSTEM if system() is
1405 available to issue a shell command.
1406
1407d_tcgetpgrp (d_tcgtpgrp.U):
1408 This variable conditionally defines the HAS_TCGETPGRP symbol, which
1409 indicates to the C program that the tcgetpgrp() routine is available.
1410 to get foreground process group ID.
1411
1412d_tcsetpgrp (d_tcstpgrp.U):
1413 This variable conditionally defines the HAS_TCSETPGRP symbol, which
1414 indicates to the C program that the tcsetpgrp() routine is available
1415 to set foreground process group ID.
1416
781b178c
JH
1417d_telldir (d_readdir.U):
1418 This variable conditionally defines HAS_TELLDIR if telldir() is
1419 available.
1420
1421d_telldirproto (d_telldirproto.U):
1422 This variable conditionally defines the HAS_TELLDIR_PROTO symbol,
1423 which indicates to the C program that the system provides
1424 a prototype for the telldir() function. Otherwise, it is
1425 up to the program to supply one.
1426
1427d_time (d_time.U):
1428 This variable conditionally defines the HAS_TIME symbol, which indicates
1429 that the time() routine exists. The time() routine is normaly
1430 provided on UNIX systems.
1431
1432d_times (d_times.U):
1433 This variable conditionally defines the HAS_TIMES symbol, which indicates
1434 that the times() routine exists. The times() routine is normaly
1435 provided on UNIX systems. You may have to include <sys/times.h>.
1436
781b178c
JH
1437d_truncate (d_truncate.U):
1438 This variable conditionally defines HAS_TRUNCATE if truncate() is
1439 available to truncate files.
1440
1441d_tzname (d_tzname.U):
1442 This variable conditionally defines HAS_TZNAME if tzname[] is
1443 available to access timezone names.
1444
1445d_umask (d_umask.U):
1446 This variable conditionally defines the HAS_UMASK symbol, which
1447 indicates to the C program that the umask() routine is available.
1448 to set and get the value of the file creation mask.
1449
1450d_uname (d_gethname.U):
1451 This variable conditionally defines the HAS_UNAME symbol, which
1452 indicates to the C program that the uname() routine may be
1453 used to derive the host name.
1454
1455d_union_semun (d_union_semun.U):
1456 This variable conditionally defines HAS_UNION_SEMUN if the
1457 union semun is defined by including <sys/sem.h>.
1458
0545a864
JH
1459d_ustat (d_ustat.U):
1460 This variable conditionally defines HAS_USTAT if ustat() is
1461 available to query file system statistics by dev_t.
1462
0617aed7
JH
1463d_vendorbin (vendorbin.U):
1464 This variable conditionally defines PERL_VENDORBIN.
1465
a3635516
JH
1466d_vendorlib (vendorlib.U):
1467 This variable conditionally defines PERL_VENDORLIB.
1468
781b178c
JH
1469d_vfork (d_vfork.U):
1470 This variable conditionally defines the HAS_VFORK symbol, which
1471 indicates the vfork() routine is available.
1472
1473d_void_closedir (d_closedir.U):
1474 This variable conditionally defines VOID_CLOSEDIR if closedir()
1475 does not return a value.
1476
1477d_voidsig (d_voidsig.U):
1478 This variable conditionally defines VOIDSIG if this system
1479 declares "void (*signal(...))()" in signal.h. The old way was to
1480 declare it as "int (*signal(...))()".
1481
1482d_voidtty (i_sysioctl.U):
1483 This variable conditionally defines USE_IOCNOTTY to indicate that the
1484 ioctl() call with TIOCNOTTY should be used to void tty association.
1485 Otherwise (on USG probably), it is enough to close the standard file
1486 decriptors and do a setpgrp().
1487
1488d_volatile (d_volatile.U):
1489 This variable conditionally defines the HASVOLATILE symbol, which
1490 indicates to the C program that this C compiler knows about the
1491 volatile declaration.
1492
1493d_vprintf (d_vprintf.U):
1494 This variable conditionally defines the HAS_VPRINTF symbol, which
1495 indicates to the C program that the vprintf() routine is available
1496 to printf with a pointer to an argument list.
1497
1498d_wait4 (d_wait4.U):
1499 This variable conditionally defines the HAS_WAIT4 symbol, which
1500 indicates the wait4() routine is available.
1501
1502d_waitpid (d_waitpid.U):
1503 This variable conditionally defines HAS_WAITPID if waitpid() is
1504 available to wait for child process.
1505
1506d_wcstombs (d_wcstombs.U):
1507 This variable conditionally defines the HAS_WCSTOMBS symbol, which
1508 indicates to the C program that the wcstombs() routine is available
1509 to convert wide character strings to multibyte strings.
1510
1511d_wctomb (d_wctomb.U):
1512 This variable conditionally defines the HAS_WCTOMB symbol, which
1513 indicates to the C program that the wctomb() routine is available
1514 to convert a wide character to a multibyte.
1515
781b178c
JH
1516d_xenix (Guess.U):
1517 This variable conditionally defines the symbol XENIX, which alerts
1518 the C program that it runs under Xenix.
1519
1520date (Loc.U):
5bf26616 1521 This variable is used internally by Configure to determine the
781b178c
JH
1522 full pathname (if any) of the date program. After Configure runs,
1523 the value is reset to a plain "date" and is not useful.
1524
1525db_hashtype (i_db.U):
1526 This variable contains the type of the hash structure element
1527 in the <db.h> header file. In older versions of DB, it was
1528 int, while in newer ones it is u_int32_t.
1529
1530db_prefixtype (i_db.U):
1531 This variable contains the type of the prefix structure element
1532 in the <db.h> header file. In older versions of DB, it was
1533 int, while in newer ones it is size_t.
1534
1535defvoidused (voidflags.U):
1536 This variable contains the default value of the VOIDUSED symbol (15).
1537
1538direntrytype (i_dirent.U):
1539 This symbol is set to 'struct direct' or 'struct dirent' depending on
1540 whether dirent is available or not. You should use this pseudo type to
1541 portably declare your directory entries.
1542
1543dlext (dlext.U):
1544 This variable contains the extension that is to be used for the
1545 dynamically loaded modules that perl generaties.
1546
1547dlsrc (dlsrc.U):
1548 This variable contains the name of the dynamic loading file that
1549 will be used with the package.
1550
1551doublesize (doublesize.U):
1552 This variable contains the value of the DOUBLESIZE symbol, which
1553 indicates to the C program how many bytes there are in a double.
1554
1555drand01 (randfunc.U):
1556 Indicates the macro to be used to generate normalized
1557 random numbers. Uses randfunc, often divided by
1558 (double) (((unsigned long) 1 << randbits)) in order to
1559 normalize the result.
1560 In C programs, the macro 'Drand01' is mapped to drand01.
1561
1562dynamic_ext (Extensions.U):
1563 This variable holds a list of XS extension files we want to
1564 link dynamically into the package. It is used by Makefile.
1565
1566eagain (nblock_io.U):
1567 This variable bears the symbolic errno code set by read() when no
1568 data is present on the file and non-blocking I/O was enabled (otherwise,
1569 read() blocks naturally).
1570
1571ebcdic (ebcdic.U):
1572 This variable conditionally defines EBCDIC if this
1573 system uses EBCDIC encoding. Among other things, this
1574 means that the character ranges are not contiguous.
1575 See trnl.U
1576
1577echo (Loc.U):
5bf26616 1578 This variable is used internally by Configure to determine the
781b178c
JH
1579 full pathname (if any) of the echo program. After Configure runs,
1580 the value is reset to a plain "echo" and is not useful.
1581
1582egrep (Loc.U):
5bf26616 1583 This variable is used internally by Configure to determine the
781b178c
JH
1584 full pathname (if any) of the egrep program. After Configure runs,
1585 the value is reset to a plain "egrep" and is not useful.
1586
1587emacs (Loc.U):
1588 This variable is defined but not used by Configure.
1589 The value is a plain '' and is not useful.
1590
1591eunicefix (Init.U):
1592 When running under Eunice this variable contains a command which will
1593 convert a shell script to the proper form of text file for it to be
1594 executable by the shell. On other systems it is a no-op.
1595
1596exe_ext (Unix.U):
1597 This is an old synonym for _exe.
1598
1599expr (Loc.U):
5bf26616 1600 This variable is used internally by Configure to determine the
781b178c
JH
1601 full pathname (if any) of the expr program. After Configure runs,
1602 the value is reset to a plain "expr" and is not useful.
1603
1604extensions (Extensions.U):
1605 This variable holds a list of all extension files (both XS and
1606 non-xs linked into the package. It is propagated to Config.pm
1607 and is typically used to test whether a particular extesion
1608 is available.
1609
1610fflushall (fflushall.U):
1611 This symbol, if defined, tells that to flush
1612 all pending stdio output one must loop through all
1613 the stdio file handles stored in an array and fflush them.
1614 Note that if fflushNULL is defined, fflushall will not
1615 even be probed for and will be left undefined.
1616
1617fflushNULL (fflushall.U):
1618 This symbol, if defined, tells that fflush(NULL) does flush
1619 all pending stdio output.
1620
1621find (Loc.U):
1622 This variable is defined but not used by Configure.
1623 The value is a plain '' and is not useful.
1624
1625firstmakefile (Unix.U):
1626 This variable defines the first file searched by make. On unix,
1627 it is makefile (then Makefile). On case-insensitive systems,
1628 it might be something else. This is only used to deal with
1629 convoluted make depend tricks.
1630
1631flex (Loc.U):
1632 This variable is defined but not used by Configure.
1633 The value is a plain '' and is not useful.
1634
a22e52b9
JH
1635fpossize (fpossize.U):
1636 This variable contains the size of a fpostype in bytes.
1637
781b178c 1638fpostype (fpostype.U):
a22e52b9 1639 This variable defines Fpos_t to be something like fpos_t, long,
781b178c
JH
1640 uint, or whatever type is used to declare file positions in libc.
1641
1642freetype (mallocsrc.U):
1643 This variable contains the return type of free(). It is usually
1644 void, but occasionally int.
1645
1646full_ar (Loc_ar.U):
1647 This variable contains the full pathname to 'ar', whether or
1648 not the user has specified 'portability'. This is only used
1649 in the Makefile.SH.
1650
1651full_csh (d_csh.U):
1652 This variable contains the full pathname to 'csh', whether or
1653 not the user has specified 'portability'. This is only used
1654 in the compiled C program, and we assume that all systems which
1655 can share this executable will have the same full pathname to
1656 'csh.'
1657
1658full_sed (Loc_sed.U):
1659 This variable contains the full pathname to 'sed', whether or
1660 not the user has specified 'portability'. This is only used
1661 in the compiled C program, and we assume that all systems which
1662 can share this executable will have the same full pathname to
1663 'sed.'
1664
1665gccversion (cc.U):
1666 If GNU cc (gcc) is used, this variable holds '1' or '2' to
1667 indicate whether the compiler is version 1 or 2. This is used in
1668 setting some of the default cflags. It is set to '' if not gcc.
1669
a22e52b9
JH
1670gidformat (gidf.U):
1671 This variable contains the format string used for printing a Gid_t.
1672
785fb66b
JH
1673gidsign (gidsign.U):
1674 This variable contains the signedness of a gidtype.
1675 1 for unsigned, -1 for signed.
1676
1677gidsize (gidsize.U):
1678 This variable contains the size of a gidtype in bytes.
1679
781b178c
JH
1680gidtype (gidtype.U):
1681 This variable defines Gid_t to be something like gid_t, int,
1682 ushort, or whatever type is used to declare the return type
1683 of getgid(). Typically, it is the type of group ids in the kernel.
1684
1685glibpth (libpth.U):
1686 This variable holds the general path (space-separated) used to
1687 find libraries. It may contain directories that do not exist on
1688 this platform, libpth is the cleaned-up version.
1689
1690grep (Loc.U):
5bf26616 1691 This variable is used internally by Configure to determine the
781b178c
JH
1692 full pathname (if any) of the grep program. After Configure runs,
1693 the value is reset to a plain "grep" and is not useful.
1694
1695groupcat (nis.U):
1696 This variable contains a command that produces the text of the
1697 /etc/group file. This is normally "cat /etc/group", but can be
1698 "ypcat group" when NIS is used.
1699
1700groupstype (groupstype.U):
1701 This variable defines Groups_t to be something like gid_t, int,
1702 ushort, or whatever type is used for the second argument to
1703 getgroups() and setgroups(). Usually, this is the same as
1704 gidtype (gid_t), but sometimes it isn't.
1705
1706gzip (Loc.U):
5bf26616 1707 This variable is used internally by Configure to determine the
781b178c
JH
1708 full pathname (if any) of the gzip program. After Configure runs,
1709 the value is reset to a plain "gzip" and is not useful.
1710
1711h_fcntl (h_fcntl.U):
1712 This is variable gets set in various places to tell i_fcntl that
1713 <fcntl.h> should be included.
1714
1715h_sysfile (h_sysfile.U):
1716 This is variable gets set in various places to tell i_sys_file that
1717 <sys/file.h> should be included.
1718
1719hint (Oldconfig.U):
1720 Gives the type of hints used for previous answers. May be one of
1721 "default", "recommended" or "previous".
1722
1723hostcat (nis.U):
1724 This variable contains a command that produces the text of the
1725 /etc/hosts file. This is normally "cat /etc/hosts", but can be
1726 "ypcat hosts" when NIS is used.
1727
1728huge (models.U):
1729 This variable contains a flag which will tell the C compiler and loader
1730 to produce a program running with a huge memory model. If the
1731 huge model is not supported, contains the flag to produce large
1732 model programs. It is up to the Makefile to use this.
1733
a22e52b9
JH
1734i16size (perlxv.U):
1735 This variable is the size of an I16 in bytes.
1736
1737i16type (perlxv.U):
1738 This variable contains the C type used for Perl's I16.
1739
1740i32size (perlxv.U):
1741 This variable is the size of an I32 in bytes.
1742
1743i32type (perlxv.U):
1744 This variable contains the C type used for Perl's I32.
1745
1746i64size (perlxv.U):
1747 This variable is the size of an I64 in bytes.
1748
1749i64type (perlxv.U):
1750 This variable contains the C type used for Perl's I64.
1751
1752i8size (perlxv.U):
1753 This variable is the size of an I8 in bytes.
1754
1755i8type (perlxv.U):
1756 This variable contains the C type used for Perl's I8.
1757
781b178c
JH
1758i_arpainet (i_arpainet.U):
1759 This variable conditionally defines the I_ARPA_INET symbol,
1760 and indicates whether a C program should include <arpa/inet.h>.
1761
1762i_bsdioctl (i_sysioctl.U):
1763 This variable conditionally defines the I_SYS_BSDIOCTL symbol, which
1764 indicates to the C program that <sys/bsdioctl.h> exists and should
1765 be included.
1766
1767i_db (i_db.U):
1768 This variable conditionally defines the I_DB symbol, and indicates
1769 whether a C program may include Berkeley's DB include file <db.h>.
1770
1771i_dbm (i_dbm.U):
1772 This variable conditionally defines the I_DBM symbol, which
1773 indicates to the C program that <dbm.h> exists and should
1774 be included.
1775
1776i_dirent (i_dirent.U):
1777 This variable conditionally defines I_DIRENT, which indicates
1778 to the C program that it should include <dirent.h>.
1779
1780i_dld (i_dld.U):
1781 This variable conditionally defines the I_DLD symbol, which
1782 indicates to the C program that <dld.h> (GNU dynamic loading)
1783 exists and should be included.
1784
1785i_dlfcn (i_dlfcn.U):
1786 This variable conditionally defines the I_DLFCN symbol, which
1787 indicates to the C program that <dlfcn.h> exists and should
1788 be included.
1789
1790i_fcntl (i_fcntl.U):
1791 This variable controls the value of I_FCNTL (which tells
1792 the C program to include <fcntl.h>).
1793
1794i_float (i_float.U):
1795 This variable conditionally defines the I_FLOAT symbol, and indicates
1796 whether a C program may include <float.h> to get symbols like DBL_MAX
1797 or DBL_MIN, i.e. machine dependent floating point values.
1798
1799i_gdbm (i_gdbm.U):
1800 This variable conditionally defines the I_GDBM symbol, which
1801 indicates to the C program that <gdbm.h> exists and should
1802 be included.
1803
1804i_grp (i_grp.U):
1805 This variable conditionally defines the I_GRP symbol, and indicates
1806 whether a C program should include <grp.h>.
1807
1808i_inttypes (i_inttypes.U):
1809 This variable conditionally defines the I_INTTYPES symbol,
1810 and indicates whether a C program should include <inttypes.h>.
1811
1812i_limits (i_limits.U):
1813 This variable conditionally defines the I_LIMITS symbol, and indicates
1814 whether a C program may include <limits.h> to get symbols like WORD_BIT
1815 and friends.
1816
1817i_locale (i_locale.U):
1818 This variable conditionally defines the I_LOCALE symbol,
1819 and indicates whether a C program should include <locale.h>.
1820
1821i_machcthr (i_machcthr.U):
1822 This variable conditionally defines the I_MACH_CTHREADS symbol,
1823 and indicates whether a C program should include <mach/cthreads.h>.
1824
1825i_malloc (i_malloc.U):
1826 This variable conditionally defines the I_MALLOC symbol, and indicates
1827 whether a C program should include <malloc.h>.
1828
1829i_math (i_math.U):
1830 This variable conditionally defines the I_MATH symbol, and indicates
1831 whether a C program may include <math.h>.
1832
1833i_memory (i_memory.U):
1834 This variable conditionally defines the I_MEMORY symbol, and indicates
1835 whether a C program should include <memory.h>.
1836
1837i_mntent (i_mntent.U):
1838 This variable conditionally defines the I_MNTENT symbol, and indicates
1839 whether a C program should include <mntent.h>.
1840
1841i_ndbm (i_ndbm.U):
1842 This variable conditionally defines the I_NDBM symbol, which
1843 indicates to the C program that <ndbm.h> exists and should
1844 be included.
1845
1846i_netdb (i_netdb.U):
1847 This variable conditionally defines the I_NETDB symbol, and indicates
1848 whether a C program should include <netdb.h>.
1849
1850i_neterrno (i_neterrno.U):
1851 This variable conditionally defines the I_NET_ERRNO symbol, which
1852 indicates to the C program that <net/errno.h> exists and should
1853 be included.
1854
1855i_netinettcp (i_netinettcp.U):
1856 This variable conditionally defines the I_NETINET_TCP symbol,
1857 and indicates whether a C program should include <netinet/tcp.h>.
1858
1859i_niin (i_niin.U):
1860 This variable conditionally defines I_NETINET_IN, which indicates
1861 to the C program that it should include <netinet/in.h>. Otherwise,
1862 you may try <sys/in.h>.
1863
1864i_poll (i_poll.U):
1865 This variable conditionally defines the I_POLL symbol, and indicates
1866 whether a C program should include <poll.h>.
1867
1868i_pthread (i_pthread.U):
190b66db 1869 This variable conditionally defines the I_PTHREAD symbol,
781b178c
JH
1870 and indicates whether a C program should include <pthread.h>.
1871
1872i_pwd (i_pwd.U):
1873 This variable conditionally defines I_PWD, which indicates
1874 to the C program that it should include <pwd.h>.
1875
1876i_rpcsvcdbm (i_dbm.U):
1877 This variable conditionally defines the I_RPCSVC_DBM symbol, which
1878 indicates to the C program that <rpcsvc/dbm.h> exists and should
1879 be included. Some System V systems might need this instead of <dbm.h>.
1880
1881i_sfio (i_sfio.U):
1882 This variable conditionally defines the I_SFIO symbol,
1883 and indicates whether a C program should include <sfio.h>.
1884
1885i_sgtty (i_termio.U):
1886 This variable conditionally defines the I_SGTTY symbol, which
1887 indicates to the C program that it should include <sgtty.h> rather
1888 than <termio.h>.
1889
1890i_shadow (i_shadow.U):
1891 This variable conditionally defines the I_SHADOW symbol, and indicates
1892 whether a C program should include <shadow.h>.
1893
1894i_socks (i_socks.U):
1895 This variable conditionally defines the I_SOCKS symbol, and indicates
1896 whether a C program should include <socks.h>.
1897
1898i_stdarg (i_varhdr.U):
1899 This variable conditionally defines the I_STDARG symbol, which
1900 indicates to the C program that <stdarg.h> exists and should
1901 be included.
1902
1903i_stddef (i_stddef.U):
1904 This variable conditionally defines the I_STDDEF symbol, which
1905 indicates to the C program that <stddef.h> exists and should
1906 be included.
1907
1908i_stdlib (i_stdlib.U):
1909 This variable conditionally defines the I_STDLIB symbol, which
1910 indicates to the C program that <stdlib.h> exists and should
1911 be included.
1912
1913i_string (i_string.U):
1914 This variable conditionally defines the I_STRING symbol, which
1915 indicates that <string.h> should be included rather than <strings.h>.
1916
1917i_sysaccess (i_sysaccess.U):
1918 This variable conditionally defines the I_SYS_ACCESS symbol,
1919 and indicates whether a C program should include <sys/access.h>.
1920
1921i_sysdir (i_sysdir.U):
1922 This variable conditionally defines the I_SYS_DIR symbol, and indicates
1923 whether a C program should include <sys/dir.h>.
1924
1925i_sysfile (i_sysfile.U):
1926 This variable conditionally defines the I_SYS_FILE symbol, and indicates
1927 whether a C program should include <sys/file.h> to get R_OK and friends.
1928
1929i_sysfilio (i_sysioctl.U):
1930 This variable conditionally defines the I_SYS_FILIO symbol, which
1931 indicates to the C program that <sys/filio.h> exists and should
1932 be included in preference to <sys/ioctl.h>.
1933
1934i_sysin (i_niin.U):
1935 This variable conditionally defines I_SYS_IN, which indicates
1936 to the C program that it should include <sys/in.h> instead of
1937 <netinet/in.h>.
1938
1939i_sysioctl (i_sysioctl.U):
1940 This variable conditionally defines the I_SYS_IOCTL symbol, which
1941 indicates to the C program that <sys/ioctl.h> exists and should
1942 be included.
1943
781b178c
JH
1944i_sysmount (i_sysmount.U):
1945 This variable conditionally defines the I_SYSMOUNT symbol,
1946 and indicates whether a C program should include <sys/mount.h>.
1947
1948i_sysndir (i_sysndir.U):
1949 This variable conditionally defines the I_SYS_NDIR symbol, and indicates
1950 whether a C program should include <sys/ndir.h>.
1951
1952i_sysparam (i_sysparam.U):
1953 This variable conditionally defines the I_SYS_PARAM symbol, and indicates
1954 whether a C program should include <sys/param.h>.
1955
1956i_sysresrc (i_sysresrc.U):
1957 This variable conditionally defines the I_SYS_RESOURCE symbol,
1958 and indicates whether a C program should include <sys/resource.h>.
1959
1960i_syssecrt (i_syssecrt.U):
1961 This variable conditionally defines the I_SYS_SECURITY symbol,
1962 and indicates whether a C program should include <sys/security.h>.
1963
1964i_sysselct (i_sysselct.U):
1965 This variable conditionally defines I_SYS_SELECT, which indicates
1966 to the C program that it should include <sys/select.h> in order to
1967 get the definition of struct timeval.
1968
1969i_syssockio (i_sysioctl.U):
1970 This variable conditionally defines I_SYS_SOCKIO to indicate to the
1971 C program that socket ioctl codes may be found in <sys/sockio.h>
1972 instead of <sys/ioctl.h>.
1973
1974i_sysstat (i_sysstat.U):
1975 This variable conditionally defines the I_SYS_STAT symbol,
1976 and indicates whether a C program should include <sys/stat.h>.
1977
0545a864
JH
1978i_sysstatfs (i_sysstatfs.U):
1979 This variable conditionally defines the I_SYSSTATFS symbol,
1980 and indicates whether a C program should include <sys/statfs.h>.
1981
781b178c
JH
1982i_sysstatvfs (i_sysstatvfs.U):
1983 This variable conditionally defines the I_SYSSTATVFS symbol,
1984 and indicates whether a C program should include <sys/statvfs.h>.
1985
1986i_systime (i_time.U):
1987 This variable conditionally defines I_SYS_TIME, which indicates
1988 to the C program that it should include <sys/time.h>.
1989
1990i_systimek (i_time.U):
1991 This variable conditionally defines I_SYS_TIME_KERNEL, which
1992 indicates to the C program that it should include <sys/time.h>
1993 with KERNEL defined.
1994
1995i_systimes (i_systimes.U):
1996 This variable conditionally defines the I_SYS_TIMES symbol, and indicates
1997 whether a C program should include <sys/times.h>.
1998
1999i_systypes (i_systypes.U):
2000 This variable conditionally defines the I_SYS_TYPES symbol,
2001 and indicates whether a C program should include <sys/types.h>.
2002
2003i_sysuio (i_sysuio.U):
2004 This variable conditionally defines the I_SYSUIO symbol, and indicates
2005 whether a C program should include <sys/uio.h>.
2006
2007i_sysun (i_sysun.U):
2008 This variable conditionally defines I_SYS_UN, which indicates
2009 to the C program that it should include <sys/un.h> to get UNIX
2010 domain socket definitions.
2011
0545a864
JH
2012i_sysvfs (i_sysvfs.U):
2013 This variable conditionally defines the I_SYSVFS symbol,
2014 and indicates whether a C program should include <sys/vfs.h>.
2015
781b178c
JH
2016i_syswait (i_syswait.U):
2017 This variable conditionally defines I_SYS_WAIT, which indicates
2018 to the C program that it should include <sys/wait.h>.
2019
2020i_termio (i_termio.U):
2021 This variable conditionally defines the I_TERMIO symbol, which
2022 indicates to the C program that it should include <termio.h> rather
2023 than <sgtty.h>.
2024
2025i_termios (i_termio.U):
2026 This variable conditionally defines the I_TERMIOS symbol, which
2027 indicates to the C program that the POSIX <termios.h> file is
2028 to be included.
2029
2030i_time (i_time.U):
2031 This variable conditionally defines I_TIME, which indicates
2032 to the C program that it should include <time.h>.
2033
2034i_unistd (i_unistd.U):
2035 This variable conditionally defines the I_UNISTD symbol, and indicates
2036 whether a C program should include <unistd.h>.
2037
0545a864
JH
2038i_ustat (i_ustat.U):
2039 This variable conditionally defines the I_USTAT symbol, and indicates
2040 whether a C program should include <ustat.h>.
2041
781b178c
JH
2042i_utime (i_utime.U):
2043 This variable conditionally defines the I_UTIME symbol, and indicates
2044 whether a C program should include <utime.h>.
2045
2046i_values (i_values.U):
2047 This variable conditionally defines the I_VALUES symbol, and indicates
2048 whether a C program may include <values.h> to get symbols like MAXLONG
2049 and friends.
2050
2051i_varargs (i_varhdr.U):
2052 This variable conditionally defines I_VARARGS, which indicates
2053 to the C program that it should include <varargs.h>.
2054
2055i_varhdr (i_varhdr.U):
2056 Contains the name of the header to be included to get va_dcl definition.
2057 Typically one of varargs.h or stdarg.h.
2058
2059i_vfork (i_vfork.U):
2060 This variable conditionally defines the I_VFORK symbol, and indicates
2061 whether a C program should include vfork.h.
2062
2063ignore_versioned_solibs (libs.U):
2064 This variable should be non-empty if non-versioned shared
2065 libraries (libfoo.so.x.y) are to be ignored (because they
2066 cannot be linked against).
2067
2068incpath (usrinc.U):
2069 This variable must preceed the normal include path to get hte
2070 right one, as in "$incpath/usr/include" or "$incpath/usr/lib".
2071 Value can be "" or "/bsd43" on mips.
2072
2073inews (Loc.U):
2074 This variable is defined but not used by Configure.
2075 The value is a plain '' and is not useful.
2076
2077installarchlib (archlib.U):
2078 This variable is really the same as archlibexp but may differ on
2079 those systems using AFS. For extra portability, only this variable
2080 should be used in makefiles.
2081
2082installbin (bin.U):
2083 This variable is the same as binexp unless AFS is running in which case
2084 the user is explicitely prompted for it. This variable should always
2085 be used in your makefiles for maximum portability.
2086
2087installman1dir (man1dir.U):
2088 This variable is really the same as man1direxp, unless you are using
2089 AFS in which case it points to the read/write location whereas
2090 man1direxp only points to the read-only access location. For extra
2091 portability, you should only use this variable within your makefiles.
2092
2093installman3dir (man3dir.U):
2094 This variable is really the same as man3direxp, unless you are using
2095 AFS in which case it points to the read/write location whereas
2096 man3direxp only points to the read-only access location. For extra
2097 portability, you should only use this variable within your makefiles.
2098
2099installprefix (installprefix.U):
2100 This variable holds the name of the directory below which
2101 "make install" will install the package. For most users, this
2102 is the same as prefix. However, it is useful for
2103 installing the software into a different (usually temporary)
2104 location after which it can be bundled up and moved somehow
2105 to the final location specified by prefix.
2106
2107installprefixexp (installprefix.U):
2108 This variable holds the full absolute path of installprefix
2109 with all ~-expansion done.
2110
2111installprivlib (privlib.U):
2112 This variable is really the same as privlibexp but may differ on
2113 those systems using AFS. For extra portability, only this variable
2114 should be used in makefiles.
2115
2116installscript (scriptdir.U):
2117 This variable is usually the same as scriptdirexp, unless you are on
2118 a system running AFS, in which case they may differ slightly. You
2119 should always use this variable within your makefiles for portability.
2120
2121installsitearch (sitearch.U):
2122 This variable is really the same as sitearchexp but may differ on
2123 those systems using AFS. For extra portability, only this variable
2124 should be used in makefiles.
2125
0617aed7
JH
2126installsitebin (sitebin.U):
2127 This variable is usually the same as sitebinexp, unless you are on
2128 a system running AFS, in which case they may differ slightly. You
2129 should always use this variable within your makefiles for portability.
2130
781b178c
JH
2131installsitelib (sitelib.U):
2132 This variable is really the same as sitelibexp but may differ on
2133 those systems using AFS. For extra portability, only this variable
2134 should be used in makefiles.
2135
2136installstyle (installstyle.U):
2137 This variable describes the "style" of the perl installation.
2138 This is intended to be useful for tools that need to
2139 manipulate entire perl distributions. Perl itself doesn't use
2140 this to find its libraries -- the library directories are
2141 stored directly in Config.pm. Currently, there are only two
2142 styles: "lib" and "lib/perl5". The default library locations
2143 (e.g. privlib, sitelib) are either $prefix/lib or
2144 $prefix/lib/perl5. The former is useful if $prefix is a
2145 directory dedicated to perl (e.g. /opt/perl), while the latter
2146 is useful if $prefix is shared by many packages, e.g. if
2147 $prefix=/usr/local.
2148 This may later be extended to include other information, so
2149 be careful with pattern-matching on the results.
2150 For compatibility with perl5.005 and earlier, the default
2151 setting is based on whether or not $prefix contains the string
2152 "perl".
2153
2154installusrbinperl (instubperl.U):
2155 This variable tells whether Perl should be installed also as
2156 /usr/bin/perl in addition to
2157 $installbin/perl
2158
0617aed7
JH
2159installvendorbin (vendorbin.U):
2160 This variable is really the same as vendorbinexp but may differ on
2161 those systems using AFS. For extra portability, only this variable
2162 should be used in makefiles.
2163
a3635516
JH
2164installvendorlib (vendorlib.U):
2165 This variable is really the same as vendorlibexp but may differ on
2166 those systems using AFS. For extra portability, only this variable
2167 should be used in makefiles.
2168
781b178c
JH
2169intsize (intsize.U):
2170 This variable contains the value of the INTSIZE symbol, which
2171 indicates to the C program how many bytes there are in an int.
2172
a22e52b9
JH
2173ivdformat (perlxvf.U):
2174 This variable contains the format string used for printing
2175 a Perl IV as a signed decimal integer.
2176
2177ivsize (perlxv.U):
2178 This variable is the size of an IV in bytes.
2179
2180ivtype (perlxv.U):
2181 This variable contains the C type used for Perl's IV.
2182
781b178c
JH
2183known_extensions (Extensions.U):
2184 This variable holds a list of all XS extensions included in
2185 the package.
2186
2187ksh (Loc.U):
2188 This variable is defined but not used by Configure.
2189 The value is a plain '' and is not useful.
2190
2191large (models.U):
2192 This variable contains a flag which will tell the C compiler and loader
2193 to produce a program running with a large memory model. It is up to
2194 the Makefile to use this.
2195
2196ld (dlsrc.U):
2197 This variable indicates the program to be used to link
2198 libraries for dynamic loading. On some systems, it is 'ld'.
2199 On ELF systems, it should be $cc. Mostly, we'll try to respect
2200 the hint file setting.
2201
2202lddlflags (dlsrc.U):
2203 This variable contains any special flags that might need to be
2204 passed to $ld to create a shared library suitable for dynamic
2205 loading. It is up to the makefile to use it. For hpux, it
2206 should be '-b'. For sunos 4.1, it is empty.
2207
2208ldflags (ccflags.U):
2209 This variable contains any additional C loader flags desired by
2210 the user. It is up to the Makefile to use this.
2211
2212ldlibpthname (libperl.U):
2213 This variable holds the name of the shared library
2214 search path, often LD_LIBRARY_PATH. To get an empty
2215 string, the hints file must set this to 'none'.
2216
2217less (Loc.U):
5bf26616 2218 This variable is used internally by Configure to determine the
781b178c
JH
2219 full pathname (if any) of the less program. After Configure runs,
2220 the value is reset to a plain "less" and is not useful.
2221
2222lib_ext (Unix.U):
2223 This is an old synonym for _a.
2224
2225libc (libc.U):
2226 This variable contains the location of the C library.
2227
2228libperl (libperl.U):
2229 The perl executable is obtained by linking perlmain.c with
2230 libperl, any static extensions (usually just DynaLoader),
2231 and any other libraries needed on this system. libperl
2232 is usually libperl.a, but can also be libperl.so.xxx if
2233 the user wishes to build a perl executable with a shared
2234 library.
2235
2236libpth (libpth.U):
2237 This variable holds the general path (space-separated) used to find
2238 libraries. It is intended to be used by other units.
2239
2240libs (libs.U):
2241 This variable holds the additional libraries we want to use.
2242 It is up to the Makefile to deal with it.
2243
2244libswanted (Myinit.U):
2245 This variable holds a list of all the libraries we want to
2246 search. The order is chosen to pick up the c library
2247 ahead of ucb or bsd libraries for SVR4.
2248
2249line (Loc.U):
2250 This variable is defined but not used by Configure.
2251 The value is a plain '' and is not useful.
2252
2253lint (Loc.U):
2254 This variable is defined but not used by Configure.
2255 The value is a plain '' and is not useful.
2256
2257lkflags (ccflags.U):
2258 This variable contains any additional C partial linker flags desired by
2259 the user. It is up to the Makefile to use this.
2260
2261ln (Loc.U):
5bf26616 2262 This variable is used internally by Configure to determine the
781b178c
JH
2263 full pathname (if any) of the ln program. After Configure runs,
2264 the value is reset to a plain "ln" and is not useful.
2265
2266lns (lns.U):
2267 This variable holds the name of the command to make
2268 symbolic links (if they are supported). It can be used
2269 in the Makefile. It is either 'ln -s' or 'ln'
2270
2271locincpth (ccflags.U):
2272 This variable contains a list of additional directories to be
2273 searched by the compiler. The appropriate '-I' directives will
2274 be added to ccflags. This is intended to simplify setting
2275 local directories from the Configure command line.
2276 It's not much, but it parallels the loclibpth stuff in libpth.U.
2277
2278loclibpth (libpth.U):
2279 This variable holds the paths (space-separated) used to find local
2280 libraries. It is prepended to libpth, and is intended to be easily
2281 set from the command line.
2282
2283longdblsize (d_longdbl.U):
2284 This variable contains the value of the LONG_DOUBLESIZE symbol, which
2285 indicates to the C program how many bytes there are in a long double,
2286 if this system supports long doubles.
2287
2288longlongsize (d_longlong.U):
2289 This variable contains the value of the LONGLONGSIZE symbol, which
2290 indicates to the C program how many bytes there are in a long long,
2291 if this system supports long long.
2292
2293longsize (intsize.U):
2294 This variable contains the value of the LONGSIZE symbol, which
2295 indicates to the C program how many bytes there are in a long.
2296
2297lp (Loc.U):
2298 This variable is defined but not used by Configure.
2299 The value is a plain '' and is not useful.
2300
2301lpr (Loc.U):
2302 This variable is defined but not used by Configure.
2303 The value is a plain '' and is not useful.
2304
2305ls (Loc.U):
5bf26616 2306 This variable is used internally by Configure to determine the
781b178c
JH
2307 full pathname (if any) of the ls program. After Configure runs,
2308 the value is reset to a plain "ls" and is not useful.
2309
2310lseeksize (lseektype.U):
2311 This variable defines lseektype to be something like off_t, long,
2312 or whatever type is used to declare lseek offset's type in the
2313 kernel (which also appears to be lseek's return type).
2314
2315lseektype (lseektype.U):
2316 This variable defines lseektype to be something like off_t, long,
2317 or whatever type is used to declare lseek offset's type in the
2318 kernel (which also appears to be lseek's return type).
2319
2320mail (Loc.U):
2321 This variable is defined but not used by Configure.
2322 The value is a plain '' and is not useful.
2323
2324mailx (Loc.U):
2325 This variable is defined but not used by Configure.
2326 The value is a plain '' and is not useful.
2327
2328make (Loc.U):
5bf26616 2329 This variable is used internally by Configure to determine the
781b178c
JH
2330 full pathname (if any) of the make program. After Configure runs,
2331 the value is reset to a plain "make" and is not useful.
2332
2333make_set_make (make.U):
2334 Some versions of 'make' set the variable MAKE. Others do not.
2335 This variable contains the string to be included in Makefile.SH
2336 so that MAKE is set if needed, and not if not needed.
2337 Possible values are:
2338 make_set_make='#' # If your make program handles this for you,
2339 make_set_make="MAKE=$make" # if it doesn't.
2340 I used a comment character so that we can distinguish a
2341 'set' value (from a previous config.sh or Configure '-D' option)
2342 from an uncomputed value.
2343
2344mallocobj (mallocsrc.U):
2345 This variable contains the name of the malloc.o that this package
2346 generates, if that malloc.o is preferred over the system malloc.
2347 Otherwise the value is null. This variable is intended for generating
2348 Makefiles. See mallocsrc.
2349
2350mallocsrc (mallocsrc.U):
2351 This variable contains the name of the malloc.c that comes with
2352 the package, if that malloc.c is preferred over the system malloc.
2353 Otherwise the value is null. This variable is intended for generating
2354 Makefiles.
2355
2356malloctype (mallocsrc.U):
2357 This variable contains the kind of ptr returned by malloc and realloc.
2358
2359man1dir (man1dir.U):
2360 This variable contains the name of the directory in which manual
2361 source pages are to be put. It is the responsibility of the
2362 Makefile.SH to get the value of this into the proper command.
2363 You must be prepared to do the ~name expansion yourself.
2364
2365man1direxp (man1dir.U):
2366 This variable is the same as the man1dir variable, but is filename
2367 expanded at configuration time, for convenient use in makefiles.
2368
2369man1ext (man1dir.U):
2370 This variable contains the extension that the manual page should
2371 have: one of 'n', 'l', or '1'. The Makefile must supply the '.'.
2372 See man1dir.
2373
2374man3dir (man3dir.U):
2375 This variable contains the name of the directory in which manual
2376 source pages are to be put. It is the responsibility of the
2377 Makefile.SH to get the value of this into the proper command.
2378 You must be prepared to do the ~name expansion yourself.
2379
2380man3direxp (man3dir.U):
2381 This variable is the same as the man3dir variable, but is filename
2382 expanded at configuration time, for convenient use in makefiles.
2383
2384man3ext (man3dir.U):
2385 This variable contains the extension that the manual page should
2386 have: one of 'n', 'l', or '3'. The Makefile must supply the '.'.
2387 See man3dir.
2388
2389Mcc (Loc.U):
5bf26616 2390 This variable is used internally by Configure to determine the
781b178c
JH
2391 full pathname (if any) of the Mcc program. After Configure runs,
2392 the value is reset to a plain "Mcc" and is not useful.
2393
2394medium (models.U):
2395 This variable contains a flag which will tell the C compiler and loader
2396 to produce a program running with a medium memory model. If the
2397 medium model is not supported, contains the flag to produce large
2398 model programs. It is up to the Makefile to use this.
2399
2400mips_type (usrinc.U):
2401 This variable holds the environment type for the mips system.
2402 Possible values are "BSD 4.3" and "System V".
2403
2404mkdir (Loc.U):
5bf26616 2405 This variable is used internally by Configure to determine the
781b178c
JH
2406 full pathname (if any) of the mkdir program. After Configure runs,
2407 the value is reset to a plain "mkdir" and is not useful.
2408
781b178c
JH
2409models (models.U):
2410 This variable contains the list of memory models supported by this
2411 system. Possible component values are none, split, unsplit, small,
2412 medium, large, and huge. The component values are space separated.
2413
2414modetype (modetype.U):
2415 This variable defines modetype to be something like mode_t,
2416 int, unsigned short, or whatever type is used to declare file
2417 modes for system calls.
2418
2419more (Loc.U):
5bf26616 2420 This variable is used internally by Configure to determine the
781b178c
JH
2421 full pathname (if any) of the more program. After Configure runs,
2422 the value is reset to a plain "more" and is not useful.
2423
2424multiarch (multiarch.U):
2425 This variable conditionally defines the MULTIARCH symbol
2426 which signifies the presence of multiplatform files.
2427 This is normally set by hints files.
2428
2429mv (Loc.U):
2430 This variable is defined but not used by Configure.
2431 The value is a plain '' and is not useful.
2432
2433myarchname (archname.U):
2434 This variable holds the architecture name computed by Configure in
2435 a previous run. It is not intended to be perused by any user and
2436 should never be set in a hint file.
2437
2438mydomain (myhostname.U):
2439 This variable contains the eventual value of the MYDOMAIN symbol,
2440 which is the domain of the host the program is going to run on.
2441 The domain must be appended to myhostname to form a complete host name.
2442 The dot comes with mydomain, and need not be supplied by the program.
2443
2444myhostname (myhostname.U):
2445 This variable contains the eventual value of the MYHOSTNAME symbol,
2446 which is the name of the host the program is going to run on.
2447 The domain is not kept with hostname, but must be gotten from mydomain.
2448 The dot comes with mydomain, and need not be supplied by the program.
2449
2450myuname (Oldconfig.U):
2451 The output of 'uname -a' if available, otherwise the hostname. On Xenix,
2452 pseudo variables assignments in the output are stripped, thank you. The
2453 whole thing is then lower-cased.
2454
2455n (n.U):
2456 This variable contains the '-n' flag if that is what causes the echo
2457 command to suppress newline. Otherwise it is null. Correct usage is
2458 $echo $n "prompt for a question: $c".
2459
2460netdb_hlen_type (netdbtype.U):
2461 This variable holds the type used for the 2nd argument to
2462 gethostbyaddr(). Usually, this is int or size_t or unsigned.
2463 This is only useful if you have gethostbyaddr(), naturally.
2464
2465netdb_host_type (netdbtype.U):
2466 This variable holds the type used for the 1st argument to
2467 gethostbyaddr(). Usually, this is char * or void *, possibly
2468 with or without a const prefix.
2469 This is only useful if you have gethostbyaddr(), naturally.
2470
2471netdb_name_type (netdbtype.U):
2472 This variable holds the type used for the argument to
2473 gethostbyname(). Usually, this is char * or const char *.
2474 This is only useful if you have gethostbyname(), naturally.
2475
2476netdb_net_type (netdbtype.U):
2477 This variable holds the type used for the 1st argument to
2478 getnetbyaddr(). Usually, this is int or long.
2479 This is only useful if you have getnetbyaddr(), naturally.
2480
2481nm (Loc.U):
5bf26616 2482 This variable is used internally by Configure to determine the
781b178c
JH
2483 full pathname (if any) of the nm program. After Configure runs,
2484 the value is reset to a plain "nm" and is not useful.
2485
2486nm_opt (usenm.U):
2487 This variable holds the options that may be necessary for nm.
2488
2489nm_so_opt (usenm.U):
2490 This variable holds the options that may be necessary for nm
2491 to work on a shared library but that can not be used on an
2492 archive library. Currently, this is only used by Linux, where
2493 nm --dynamic is *required* to get symbols from an ELF library which
2494 has been stripped, but nm --dynamic is *fatal* on an archive library.
2495 Maybe Linux should just always set usenm=false.
2496
2497nonxs_ext (Extensions.U):
2498 This variable holds a list of all non-xs extensions included
2499 in the package. All of them will be built.
2500
2501nroff (Loc.U):
5bf26616 2502 This variable is used internally by Configure to determine the
781b178c
JH
2503 full pathname (if any) of the nroff program. After Configure runs,
2504 the value is reset to a plain "nroff" and is not useful.
2505
a22e52b9
JH
2506nvsize (perlxv.U):
2507 This variable is the size of an NV in bytes.
2508
2509nvtype (perlxv.U):
2510 This variable contains the C type used for Perl's NV.
2511
781b178c
JH
2512o_nonblock (nblock_io.U):
2513 This variable bears the symbol value to be used during open() or fcntl()
2514 to turn on non-blocking I/O for a file descriptor. If you wish to switch
2515 between blocking and non-blocking, you may try ioctl(FIOSNBIO) instead,
2516 but that is only supported by some devices.
2517
2518obj_ext (Unix.U):
2519 This is an old synonym for _o.
2520
2521old_pthread_create_joinable (d_pthrattrj.U):
2522 This variable defines the constant to use for creating joinable
2523 (aka undetached) pthreads. Unused if pthread.h defines
2524 PTHREAD_CREATE_JOINABLE. If used, possible values are
2525 PTHREAD_CREATE_UNDETACHED and __UNDETACHED.
2526
2527optimize (ccflags.U):
2528 This variable contains any optimizer/debugger flag that should be used.
2529 It is up to the Makefile to use it.
2530
2531orderlib (orderlib.U):
2532 This variable is "true" if the components of libraries must be ordered
2533 (with `lorder $* | tsort`) before placing them in an archive. Set to
2534 "false" if ranlib or ar can generate random libraries.
2535
2536osname (Oldconfig.U):
2537 This variable contains the operating system name (e.g. sunos,
2538 solaris, hpux, etc.). It can be useful later on for setting
2539 defaults. Any spaces are replaced with underscores. It is set
2540 to a null string if we can't figure it out.
2541
2542osvers (Oldconfig.U):
2543 This variable contains the operating system version (e.g.
2544 4.1.3, 5.2, etc.). It is primarily used for helping select
2545 an appropriate hints file, but might be useful elsewhere for
2546 setting defaults. It is set to '' if we can't figure it out.
2547 We try to be flexible about how much of the version number
2548 to keep, e.g. if 4.1.1, 4.1.2, and 4.1.3 are essentially the
2549 same for this package, hints files might just be os_4.0 or
2550 os_4.1, etc., not keeping separate files for each little release.
2551
2552package (package.U):
2553 This variable contains the name of the package being constructed.
2554 It is primarily intended for the use of later Configure units.
2555
2556pager (pager.U):
2557 This variable contains the name of the preferred pager on the system.
2558 Usual values are (the full pathnames of) more, less, pg, or cat.
2559
2560passcat (nis.U):
2561 This variable contains a command that produces the text of the
2562 /etc/passwd file. This is normally "cat /etc/passwd", but can be
2563 "ypcat passwd" when NIS is used.
2564
2565patchlevel (patchlevel.U):
2566 The patchlevel level of this package.
2567 The value of patchlevel comes from the patchlevel.h file.
2568
2569path_sep (Unix.U):
2570 This is an old synonym for p_ in Head.U, the character
2571 used to separate elements in the command shell search PATH.
2572
2573perl (Loc.U):
2574 This variable is defined but not used by Configure.
2575 The value is a plain '' and is not useful.
2576
10a67519
JH
2577PERL_APIVERSION (Oldsyms.U):
2578 This value is manually set in patchlevel.h and is used
2579 to set the Configure apiversion variable.
2580
2581PERL_REVISION (Oldsyms.U):
2582 In a Perl version number such as 5.6.2, this is the 5.
2583 This value is manually set in patchlevel.h
2584
2585PERL_SUBVERSION (Oldsyms.U):
2586 In a Perl version number such as 5.6.2, this is the 2.
2587 Values greater than 50 represent potentially unstable
2588 development subversions.
2589 This value is manually set in patchlevel.h
2590
2591PERL_VERSION (Oldsyms.U):
2592 In a Perl version number such as 5.6.2, this is the 6.
2593 This value is manually set in patchlevel.h
2594
781b178c
JH
2595perladmin (perladmin.U):
2596 Electronic mail address of the perl5 administrator.
2597
2598perlpath (perlpath.U):
2599 This variable contains the eventual value of the PERLPATH symbol,
2600 which contains the name of the perl interpreter to be used in
2601 shell scripts and in the "eval 'exec'" idiom.
2602
2603pg (Loc.U):
5bf26616 2604 This variable is used internally by Configure to determine the
781b178c
JH
2605 full pathname (if any) of the pg program. After Configure runs,
2606 the value is reset to a plain "pg" and is not useful.
2607
2608phostname (myhostname.U):
2609 This variable contains the eventual value of the PHOSTNAME symbol,
2610 which is a command that can be fed to popen() to get the host name.
2611 The program should probably not presume that the domain is or isn't
2612 there already.
2613
2614pidtype (pidtype.U):
2615 This variable defines PIDTYPE to be something like pid_t, int,
2616 ushort, or whatever type is used to declare process ids in the kernel.
2617
2618plibpth (libpth.U):
2619 Holds the private path used by Configure to find out the libraries.
2620 Its value is prepend to libpth. This variable takes care of special
2621 machines, like the mips. Usually, it should be empty.
2622
75347591
JH
2623pm_apiversion (xs_apiversion.U):
2624 This variable contains the version of the oldest perl
2625 compatible with the present perl. (That is, pure perl modules
2626 written for $pm_apiversion will still work for the current
2627 version). perl.c:incpush() and lib/lib.pm will automatically
2628 search in $sitelib for older directories across major versions
2629 back to pm_apiversion. This is only useful if you have a perl
2630 library directory tree structured like the default one. The
2631 versioned site_perl library was introduced in 5.005, so that's
2632 the default setting for this variable. It's hard to imagine
2633 it changing before Perl6. It is included here for symmetry
2634 with xs_apiveprsion -- the searching algorithms will
2635 (presumably) be similar.
2636 See the INSTALL file for how this works.
2637
781b178c
JH
2638pmake (Loc.U):
2639 This variable is defined but not used by Configure.
2640 The value is a plain '' and is not useful.
2641
2642pr (Loc.U):
2643 This variable is defined but not used by Configure.
2644 The value is a plain '' and is not useful.
2645
2646prefix (prefix.U):
2647 This variable holds the name of the directory below which the
2648 user will install the package. Usually, this is /usr/local, and
2649 executables go in /usr/local/bin, library stuff in /usr/local/lib,
2650 man pages in /usr/local/man, etc. It is only used to set defaults
2651 for things in bin.U, mansrc.U, privlib.U, or scriptdir.U.
2652
2653prefixexp (prefix.U):
2654 This variable holds the full absolute path of the directory below
2655 which the user will install the package. Derived from prefix.
2656
2657privlib (privlib.U):
2658 This variable contains the eventual value of the PRIVLIB symbol,
2659 which is the name of the private library for this package. It may
2660 have a ~ on the front. It is up to the makefile to eventually create
2661 this directory while performing installation (with ~ substitution).
2662
2663privlibexp (privlib.U):
2664 This variable is the ~name expanded version of privlib, so that you
2665 may use it directly in Makefiles or shell scripts.
2666
2667prototype (prototype.U):
2668 This variable holds the eventual value of CAN_PROTOTYPE, which
2669 indicates the C compiler can handle funciton prototypes.
2670
2671ptrsize (ptrsize.U):
2672 This variable contains the value of the PTRSIZE symbol, which
2673 indicates to the C program how many bytes there are in a pointer.
2674
0befd8de
JH
2675quadcase (quadtype.U):
2676 This variable, if defined, encodes the type of a quad:
2677 1 = int, 2 = long, 3 = long long, 4 = int64_t.
2678
2679quadtype (quadtype.U):
2680 This variable defines Quad_t to be something like long, int,
2681 long long, int64_t, or whatever type is used for 64-bit integers.
2682
781b178c
JH
2683randbits (randfunc.U):
2684 Indicates how many bits are produced by the function used to
2685 generate normalized random numbers.
2686
2687randfunc (randfunc.U):
2688 Indicates the name of the random number function to use.
2689 Values include drand48, random, and rand. In C programs,
2690 the 'Drand01' macro is defined to generate uniformly distributed
2691 random numbers over the range [0., 1.[ (see drand01 and nrand).
2692
2693randseedtype (randfunc.U):
2694 Indicates the type of the argument of the seedfunc.
2695
2696ranlib (orderlib.U):
2697 This variable is set to the pathname of the ranlib program, if it is
2698 needed to generate random libraries. Set to ":" if ar can generate
2699 random libraries or if random libraries are not supported
2700
2701rd_nodata (nblock_io.U):
2702 This variable holds the return code from read() when no data is
2703 present. It should be -1, but some systems return 0 when O_NDELAY is
2704 used, which is a shame because you cannot make the difference between
2705 no data and an EOF.. Sigh!
2706
2707rm (Loc.U):
5bf26616 2708 This variable is used internally by Configure to determine the
781b178c
JH
2709 full pathname (if any) of the rm program. After Configure runs,
2710 the value is reset to a plain "rm" and is not useful.
2711
2712rmail (Loc.U):
2713 This variable is defined but not used by Configure.
2714 The value is a plain '' and is not useful.
2715
2716runnm (usenm.U):
2717 This variable contains 'true' or 'false' depending whether the
2718 nm extraction should be performed or not, according to the value
2719 of usenm and the flags on the Configure command line.
2720
2721sched_yield (d_pthread_y.U):
2722 This variable defines the way to yield the execution
2723 of the current thread.
2724
2725scriptdir (scriptdir.U):
2726 This variable holds the name of the directory in which the user wants
2727 to put publicly scripts for the package in question. It is either
2728 the same directory as for binaries, or a special one that can be
2729 mounted across different architectures, like /usr/share. Programs
2730 must be prepared to deal with ~name expansion.
2731
2732scriptdirexp (scriptdir.U):
2733 This variable is the same as scriptdir, but is filename expanded
2734 at configuration time, for programs not wanting to bother with it.
2735
2736sed (Loc.U):
5bf26616 2737 This variable is used internally by Configure to determine the
781b178c
JH
2738 full pathname (if any) of the sed program. After Configure runs,
2739 the value is reset to a plain "sed" and is not useful.
2740
2741seedfunc (randfunc.U):
2742 Indicates the random number generating seed function.
2743 Values include srand48, srandom, and srand.
2744
2745selectminbits (selectminbits.U):
2746 This variable holds the minimum number of bits operated by select.
2747 That is, if you do select(n, ...), how many bits at least will be
2748 cleared in the masks if some activity is detected. Usually this
2749 is either n or 32*ceil(n/32), especially many little-endians do
2750 the latter. This is only useful if you have select(), naturally.
2751
2752selecttype (selecttype.U):
2753 This variable holds the type used for the 2nd, 3rd, and 4th
2754 arguments to select. Usually, this is 'fd_set *', if HAS_FD_SET
2755 is defined, and 'int *' otherwise. This is only useful if you
2756 have select(), naturally.
2757
2758sendmail (Loc.U):
2759 This variable is defined but not used by Configure.
2760 The value is a plain '' and is not useful.
2761
2762sh (sh.U):
2763 This variable contains the full pathname of the shell used
2764 on this system to execute Bourne shell scripts. Usually, this will be
2765 /bin/sh, though it's possible that some systems will have /bin/ksh,
2766 /bin/pdksh, /bin/ash, /bin/bash, or even something such as
2767 D:/bin/sh.exe.
2768 This unit comes before Options.U, so you can't set sh with a '-D'
2769 option, though you can override this (and startsh)
2770 with '-O -Dsh=/bin/whatever -Dstartsh=whatever'
2771
2772shar (Loc.U):
2773 This variable is defined but not used by Configure.
2774 The value is a plain '' and is not useful.
2775
2776sharpbang (spitshell.U):
2777 This variable contains the string #! if this system supports that
2778 construct.
2779
2780shmattype (d_shmat.U):
2781 This symbol contains the type of pointer returned by shmat().
2782 It can be 'void *' or 'char *'.
2783
2784shortsize (intsize.U):
2785 This variable contains the value of the SHORTSIZE symbol which
2786 indicates to the C program how many bytes there are in a short.
2787
2788shrpenv (libperl.U):
2789 If the user builds a shared libperl.so, then we need to tell the
2790 'perl' executable where it will be able to find the installed libperl.so.
2791 One way to do this on some systems is to set the environment variable
2792 LD_RUN_PATH to the directory that will be the final location of the
2793 shared libperl.so. The makefile can use this with something like
2794 $shrpenv $(CC) -o perl perlmain.o $libperl $libs
2795 Typical values are
2796 shrpenv="env LD_RUN_PATH=$archlibexp/CORE"
2797 or
2798 shrpenv=''
2799 See the main perl Makefile.SH for actual working usage.
2800 Alternatively, we might be able to use a command line option such
2801 as -R $archlibexp/CORE (Solaris, NetBSD) or -Wl,-rpath
2802 $archlibexp/CORE (Linux).
2803
2804shsharp (spitshell.U):
2805 This variable tells further Configure units whether your sh can
2806 handle # comments.
2807
2808sig_count (sig_name.U):
2809 This variable holds a number larger than the largest valid
2810 signal number. This is usually the same as the NSIG macro.
2811
2812sig_name (sig_name.U):
2813 This variable holds the signal names, space separated. The leading
2814 SIG in signal name is removed. A ZERO is prepended to the
2815 list. This is currently not used.
2816
2817sig_name_init (sig_name.U):
2818 This variable holds the signal names, enclosed in double quotes and
2819 separated by commas, suitable for use in the SIG_NAME definition
2820 below. A "ZERO" is prepended to the list, and the list is
2821 terminated with a plain 0. The leading SIG in signal names
2822 is removed. See sig_num.
2823
2824sig_num (sig_name.U):
2825 This variable holds the signal numbers, space separated. A ZERO is
2826 prepended to the list (corresponding to the fake SIGZERO), and
2827 the list is terminated with a 0. Those numbers correspond to
2828 the value of the signal listed in the same place within the
2829 sig_name list.
2830
2831sig_num_init (sig_name.U):
2832 This variable holds the signal numbers, enclosed in double quotes and
2833 separated by commas, suitable for use in the SIG_NUM definition
2834 below. A "ZERO" is prepended to the list, and the list is
2835 terminated with a plain 0.
2836
2837signal_t (d_voidsig.U):
2838 This variable holds the type of the signal handler (void or int).
2839
2840sitearch (sitearch.U):
2841 This variable contains the eventual value of the SITEARCH symbol,
2842 which is the name of the private library for this package. It may
2843 have a ~ on the front. It is up to the makefile to eventually create
2844 this directory while performing installation (with ~ substitution).
f868067f
JH
2845 The standard distribution will put nothing in this directory.
2846 After perl has been installed, users may install their own local
2847 architecture-dependent modules in this directory with
2848 MakeMaker Makefile.PL
2849 or equivalent. See INSTALL for details.
781b178c
JH
2850
2851sitearchexp (sitearch.U):
2852 This variable is the ~name expanded version of sitearch, so that you
2853 may use it directly in Makefiles or shell scripts.
2854
0617aed7
JH
2855sitebin (sitebin.U):
2856 This variable holds the name of the directory in which the user wants
2857 to put add-on publicly executable files for the package in question. It
2858 is most often a local directory such as /usr/local/bin. Programs using
2859 this variable must be prepared to deal with ~name substitution.
f868067f
JH
2860 The standard distribution will put nothing in this directory.
2861 After perl has been installed, users may install their own local
2862 executables in this directory with
2863 MakeMaker Makefile.PL
2864 or equivalent. See INSTALL for details.
0617aed7
JH
2865
2866sitebinexp (sitebin.U):
2867 This is the same as the sitebin variable, but is filename expanded at
2868 configuration time, for use in your makefiles.
2869
781b178c
JH
2870sitelib (sitelib.U):
2871 This variable contains the eventual value of the SITELIB symbol,
2872 which is the name of the private library for this package. It may
2873 have a ~ on the front. It is up to the makefile to eventually create
2874 this directory while performing installation (with ~ substitution).
f868067f
JH
2875 The standard distribution will put nothing in this directory.
2876 After perl has been installed, users may install their own local
2877 architecture-independent modules in this directory with
2878 MakeMaker Makefile.PL
2879 or equivalent. See INSTALL for details.
781b178c
JH
2880
2881sitelibexp (sitelib.U):
2882 This variable is the ~name expanded version of sitelib, so that you
2883 may use it directly in Makefiles or shell scripts.
2884
2885siteprefix (siteprefix.U):
2886 This variable holds the full absolute path of the directory below
2887 which the user will install add-on packages.
f868067f 2888 See INSTALL for usage and examples.
781b178c
JH
2889
2890siteprefixexp (siteprefix.U):
2891 This variable holds the full absolute path of the directory below
2892 which the user will install add-on packages. Derived from siteprefix.
2893
2894sizetype (sizetype.U):
2895 This variable defines sizetype to be something like size_t,
2896 unsigned long, or whatever type is used to declare length
2897 parameters for string functions.
2898
2899sleep (Loc.U):
2900 This variable is defined but not used by Configure.
2901 The value is a plain '' and is not useful.
2902
2903smail (Loc.U):
2904 This variable is defined but not used by Configure.
2905 The value is a plain '' and is not useful.
2906
2907small (models.U):
2908 This variable contains a flag which will tell the C compiler and loader
2909 to produce a program running with a small memory model. It is up to
2910 the Makefile to use this.
2911
2912so (so.U):
2913 This variable holds the extension used to identify shared libraries
2914 (also known as shared objects) on the system. Usually set to 'so'.
2915
2916sockethdr (d_socket.U):
2917 This variable has any cpp '-I' flags needed for socket support.
2918
2919socketlib (d_socket.U):
2920 This variable has the names of any libraries needed for socket support.
2921
2922sort (Loc.U):
5bf26616 2923 This variable is used internally by Configure to determine the
781b178c
JH
2924 full pathname (if any) of the sort program. After Configure runs,
2925 the value is reset to a plain "sort" and is not useful.
2926
2927spackage (package.U):
2928 This variable contains the name of the package being constructed,
2929 with the first letter uppercased, i.e. suitable for starting
2930 sentences.
2931
2932spitshell (spitshell.U):
2933 This variable contains the command necessary to spit out a runnable
2934 shell on this system. It is either cat or a grep '-v' for # comments.
2935
2936split (models.U):
2937 This variable contains a flag which will tell the C compiler and loader
2938 to produce a program that will run in separate I and D space, for those
2939 machines that support separation of instruction and data space. It is
2940 up to the Makefile to use this.
2941
11dc3f68
JH
2942sPRId64 (quadfio.U):
2943 This variable, if defined, contains the string used by stdio to
2944 format 64-bit decimal numbers (format 'd') for output.
2945
2946sPRIeldbl (longdblfio.U):
2947 This variable, if defined, contains the string used by stdio to
2948 format long doubles (format 'e') 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
2954sPRIfldbl (longdblfio.U):
2955 This variable, if defined, contains the string used by stdio to
2956 format long doubles (format 'f') 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
2962sPRIgldbl (longdblfio.U):
2963 This variable, if defined, contains the string used by stdio to
2964 format long doubles (format 'g') 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
2970sPRIi64 (quadfio.U):
2971 This variable, if defined, contains the string used by stdio to
2972 format 64-bit decimal numbers (format 'i') for output.
2973
2974sPRIo64 (quadfio.U):
2975 This variable, if defined, contains the string used by stdio to
2976 format 64-bit octal numbers (format 'o') for output.
2977
2978sPRIu64 (quadfio.U):
2979 This variable, if defined, contains the string used by stdio to
2980 format 64-bit unsigned decimal numbers (format 'u') for output.
2981
2982sPRIx64 (quadfio.U):
2983 This variable, if defined, contains the string used by stdio to
2984 format 64-bit hexadecimal numbers (format 'x') 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
781b178c
JH
2990src (src.U):
2991 This variable holds the path to the package source. It is up to
2992 the Makefile to use this variable and set VPATH accordingly to
2993 find the sources remotely.
2994
2995ssizetype (ssizetype.U):
2996 This variable defines ssizetype to be something like ssize_t,
2997 long or int. It is used by functions that return a count
2998 of bytes or an error condition. It must be a signed type.
2999 We will pick a type such that sizeof(SSize_t) == sizeof(Size_t).
3000
3001startperl (startperl.U):
3002 This variable contains the string to put on the front of a perl
3003 script to make sure (hopefully) that it runs with perl and not some
3004 shell. Of course, that leading line must be followed by the classical
3005 perl idiom:
3006 eval 'exec perl -S $0 ${1+"$@"}'
3007 if $running_under_some_shell;
3008 to guarantee perl startup should the shell execute the script. Note
3009 that this magic incatation is not understood by csh.
3010
3011startsh (startsh.U):
3012 This variable contains the string to put on the front of a shell
3013 script to make sure (hopefully) that it runs with sh and not some
3014 other shell.
3015
3016static_ext (Extensions.U):
3017 This variable holds a list of XS extension files we want to
3018 link statically into the package. It is used by Makefile.
3019
3020stdchar (stdchar.U):
3021 This variable conditionally defines STDCHAR to be the type of char
3022 used in stdio.h. It has the values "unsigned char" or "char".
3023
3024stdio_base (d_stdstdio.U):
3025 This variable defines how, given a FILE pointer, fp, to access the
3026 _base field (or equivalent) of stdio.h's FILE structure. This will
3027 be used to define the macro FILE_base(fp).
3028
3029stdio_bufsiz (d_stdstdio.U):
3030 This variable defines how, given a FILE pointer, fp, to determine
3031 the number of bytes store in the I/O buffer pointer to by the
3032 _base field (or equivalent) of stdio.h's FILE structure. This will
3033 be used to define the macro FILE_bufsiz(fp).
3034
3035stdio_cnt (d_stdstdio.U):
3036 This variable defines how, given a FILE pointer, fp, to access the
3037 _cnt field (or equivalent) of stdio.h's FILE structure. This will
3038 be used to define the macro FILE_cnt(fp).
3039
3040stdio_filbuf (d_stdstdio.U):
3041 This variable defines how, given a FILE pointer, fp, to tell
3042 stdio to refill it's internal buffers (?). This will
3043 be used to define the macro FILE_filbuf(fp).
3044
3045stdio_ptr (d_stdstdio.U):
3046 This variable defines how, given a FILE pointer, fp, to access the
3047 _ptr field (or equivalent) of stdio.h's FILE structure. This will
3048 be used to define the macro FILE_ptr(fp).
3049
3050stdio_stream_array (stdio_streams.U):
3051 This variable tells the name of the array holding the stdio streams.
3052 Usual values include _iob, __iob, and __sF.
3053
3054strings (i_string.U):
3055 This variable holds the full path of the string header that will be
3056 used. Typically /usr/include/string.h or /usr/include/strings.h.
3057
3058submit (Loc.U):
3059 This variable is defined but not used by Configure.
3060 The value is a plain '' and is not useful.
3061
3062subversion (patchlevel.U):
3063 The subversion level of this package.
3064 The value of subversion comes from the patchlevel.h file.
3065 This is unique to perl.
3066
3067sysman (sysman.U):
3068 This variable holds the place where the manual is located on this
3069 system. It is not the place where the user wants to put his manual
3070 pages. Rather it is the place where Configure may look to find manual
3071 for unix commands (section 1 of the manual usually). See mansrc.
3072
3073tail (Loc.U):
3074 This variable is defined but not used by Configure.
3075 The value is a plain '' and is not useful.
3076
3077tar (Loc.U):
3078 This variable is defined but not used by Configure.
3079 The value is a plain '' and is not useful.
3080
3081tbl (Loc.U):
3082 This variable is defined but not used by Configure.
3083 The value is a plain '' and is not useful.
3084
3085tee (Loc.U):
3086 This variable is defined but not used by Configure.
3087 The value is a plain '' and is not useful.
3088
3089test (Loc.U):
5bf26616 3090 This variable is used internally by Configure to determine the
781b178c
JH
3091 full pathname (if any) of the test program. After Configure runs,
3092 the value is reset to a plain "test" and is not useful.
3093
3094timeincl (i_time.U):
3095 This variable holds the full path of the included time header(s).
3096
3097timetype (d_time.U):
3098 This variable holds the type returned by time(). It can be long,
3099 or time_t on BSD sites (in which case <sys/types.h> should be
3100 included). Anyway, the type Time_t should be used.
3101
3102touch (Loc.U):
5bf26616 3103 This variable is used internally by Configure to determine the
781b178c
JH
3104 full pathname (if any) of the touch program. After Configure runs,
3105 the value is reset to a plain "touch" and is not useful.
3106
3107tr (Loc.U):
5bf26616 3108 This variable is used internally by Configure to determine the
781b178c
JH
3109 full pathname (if any) of the tr program. After Configure runs,
3110 the value is reset to a plain "tr" and is not useful.
3111
3112trnl (trnl.U):
3113 This variable contains the value to be passed to the tr(1)
3114 command to transliterate a newline. Typical values are
3115 '\012' and '\n'. This is needed for EBCDIC systems where
3116 newline is not necessarily '\012'.
3117
3118troff (Loc.U):
3119 This variable is defined but not used by Configure.
3120 The value is a plain '' and is not useful.
3121
a22e52b9
JH
3122u16size (perlxv.U):
3123 This variable is the size of an U16 in bytes.
3124
3125u16type (perlxv.U):
3126 This variable contains the C type used for Perl's U16.
3127
3128u32size (perlxv.U):
3129 This variable is the size of an U32 in bytes.
3130
3131u32type (perlxv.U):
3132 This variable contains the C type used for Perl's U32.
3133
3134u64size (perlxv.U):
3135 This variable is the size of an U64 in bytes.
3136
3137u64type (perlxv.U):
3138 This variable contains the C type used for Perl's U64.
3139
3140u8size (perlxv.U):
3141 This variable is the size of an U8 in bytes.
3142
3143u8type (perlxv.U):
3144 This variable contains the C type used for Perl's U8.
3145
3146uidformat (uidf.U):
3147 This variable contains the format string used for printing a Uid_t.
3148
2d228ff3
JH
3149uidsign (uidsign.U):
3150 This variable contains the signedness of a uidtype.
3151 1 for unsigned, -1 for signed.
3152
785fb66b
JH
3153uidsize (uidsize.U):
3154 This variable contains the size of a uidtype in bytes.
3155
781b178c
JH
3156uidtype (uidtype.U):
3157 This variable defines Uid_t to be something like uid_t, int,
3158 ushort, or whatever type is used to declare user ids in the kernel.
3159
3160uname (Loc.U):
5bf26616 3161 This variable is used internally by Configure to determine the
781b178c
JH
3162 full pathname (if any) of the uname program. After Configure runs,
3163 the value is reset to a plain "uname" and is not useful.
3164
3165uniq (Loc.U):
5bf26616 3166 This variable is used internally by Configure to determine the
781b178c
JH
3167 full pathname (if any) of the uniq program. After Configure runs,
3168 the value is reset to a plain "uniq" and is not useful.
3169
0befd8de
JH
3170uquadtype (quadtype.U):
3171 This variable defines Uquad_t to be something like unsigned long,
3172 unsigned int, unsigned long long, uint64_t, or whatever type is
3173 used for 64-bit integers.
3174
781b178c
JH
3175use64bits (use64bits.U):
3176 This variable conditionally defines the USE_64_BITS symbol,
3177 and indicates that explicit 64-bit interfaces should be used
3178 when available.
3179
3180usedl (dlsrc.U):
3181 This variable indicates if the the system supports dynamic
3182 loading of some sort. See also dlsrc and dlobj.
3183
5bf26616 3184uselargefiles (uselfs.U):
1baac590
JH
3185 This variable conditionally defines the USE_LARGE_FILES symbol,
3186 and indicates that large file interfaces should be used when
3187 available. The use64bits symbol will also be turned on if necessary.
3188
ca24dfc6
LV
3189uselongdouble (uselongdbl.U):
3190 This variable conditionally defines the USE_LONG_DOUBLE symbol,
3191 and indicates that long doubles should be used when available.
3192
0befd8de
JH
3193uselonglong (uselonglong.U):
3194 This variable conditionally defines the USE_LONG_LONG symbol,
3195 and indicates that long longs should be used when available.
3196
1baac590
JH
3197usemorebits (usemorebits.U):
3198 This variable conditionally defines the USE_MORE_BITS symbol,
3199 and indicates that explicit 64-bit interfaces and long doubles
3200 should be used when available.
3201
781b178c
JH
3202usemultiplicity (usemultiplicity.U):
3203 This variable conditionally defines the MULTIPLICITY symbol,
3204 and indicates that Perl should be built to use multiplicity.
3205
3206usemymalloc (mallocsrc.U):
3207 This variable contains y if the malloc that comes with this package
3208 is desired over the system's version of malloc. People often include
3209 special versions of malloc for effiency, but such versions are often
3210 less portable. See also mallocsrc and mallocobj.
3211 If this is 'y', then -lmalloc is removed from $libs.
3212
3213usenm (usenm.U):
3214 This variable contains 'true' or 'false' depending whether the
3215 nm extraction is wanted or not.
3216
3217useopcode (Extensions.U):
3218 This variable holds either 'true' or 'false' to indicate
3219 whether the Opcode extension should be used. The sole
3220 use for this currently is to allow an easy mechanism
3221 for users to skip the Opcode extension from the Configure
3222 command line.
3223
3224useperlio (useperlio.U):
3225 This variable conditionally defines the USE_PERLIO symbol,
3226 and indicates that the PerlIO abstraction should be
3227 used throughout.
3228
3229useposix (Extensions.U):
3230 This variable holds either 'true' or 'false' to indicate
3231 whether the POSIX extension should be used. The sole
3232 use for this currently is to allow an easy mechanism
3233 for hints files to indicate that POSIX will not compile
3234 on a particular system.
3235
3236usesfio (d_sfio.U):
3237 This variable is set to true when the user agrees to use sfio.
3238 It is set to false when sfio is not available or when the user
3239 explicitely requests not to use sfio. It is here primarily so
3240 that command-line settings can override the auto-detection of
3241 d_sfio without running into a "WHOA THERE".
3242
3243useshrplib (libperl.U):
3244 This variable is set to 'yes' if the user wishes
3245 to build a shared libperl, and 'no' otherwise.
3246
3247usesocks (usesocks.U):
3248 This variable conditionally defines the USE_SOCKS symbol,
3249 and indicates that Perl should be built to use SOCKS.
3250
3251usethreads (usethreads.U):
3252 This variable conditionally defines the USE_THREADS symbol,
3253 and indicates that Perl should be built to use threads.
3254
9f50e519
NA
3255usevendorprefix (vendorprefix.U):
3256 This variable tells whether the vendorprefix
3257 and consequently other vendor* paths are in use.
3258
781b178c
JH
3259usevfork (d_vfork.U):
3260 This variable is set to true when the user accepts to use vfork.
3261 It is set to false when no vfork is available or when the user
3262 explicitely requests not to use vfork.
3263
3264usrinc (usrinc.U):
3265 This variable holds the path of the include files, which is
3266 usually /usr/include. It is mainly used by other Configure units.
3267
3268uuname (Loc.U):
3269 This variable is defined but not used by Configure.
3270 The value is a plain '' and is not useful.
3271
a22e52b9
JH
3272uvoformat (perlxvf.U):
3273 This variable contains the format string used for printing
3274 a Perl UV as an unsigned octal integer.
3275
3276uvsize (perlxv.U):
3277 This variable is the size of a UV in bytes.
3278
3279uvtype (perlxv.U):
3280 This variable contains the C type used for Perl's UV.
3281
3282uvuformat (perlxvf.U):
3283 This variable contains the format string used for printing
3284 a Perl UV as an unsigned decimal integer.
3285
3286uvxformat (perlxvf.U):
3287 This variable contains the format string used for printing
3288 a Perl UV as an unsigned hexadecimal integer.
3289
0617aed7 3290vendorbin (vendorbin.U):
f868067f
JH
3291 This variable contains the eventual value of the VENDORBIN symbol.
3292 It may have a ~ on the front.
3293 The standard distribution will put nothing in this directory.
3294 Vendors who distribute perl may wish to place additional
3295 binaries in this directory with
3296 MakeMaker Makefile.PL INSTALLDIRS=vendor
3297 or equivalent. See INSTALL for details.
0617aed7
JH
3298
3299vendorbinexp (vendorbin.U):
3300 This variable is the ~name expanded version of vendorbin, so that you
3301 may use it directly in Makefiles or shell scripts.
3302
a3635516
JH
3303vendorlib (vendorlib.U):
3304 This variable contains the eventual value of the VENDORLIB symbol,
f868067f
JH
3305 which is the name of the private library for this package.
3306 The standard distribution will put nothing in this directory.
3307 Vendors who distribute perl may wish to place their own
3308 modules in this directory with
3309 MakeMaker Makefile.PL INSTALLDIRS=vendor
3310 or equivalent. See INSTALL for details.
a3635516
JH
3311
3312vendorlibexp (vendorlib.U):
3313 This variable is the ~name expanded version of vendorlib, so that you
3314 may use it directly in Makefiles or shell scripts.
3315
3316vendorprefix (vendorprefix.U):
3317 This variable holds the full absolute path of the directory below
3318 which the vendor will install add-on packages.
f868067f 3319 See INSTALL for usage and examples.
a3635516
JH
3320
3321vendorprefixexp (vendorprefix.U):
3322 This variable holds the full absolute path of the directory below
3323 which the vendor will install add-on packages. Derived from vendorprefix.
3324
781b178c
JH
3325version (patchlevel.U):
3326 The full version number of this package. This combines
3327 baserev, patchlevel, and subversion to get the full
3328 version number, including any possible subversions. Care
3329 is taken to use the C locale in order to get something
3330 like 5.004 instead of 5,004. This is unique to perl.
3331
3332vi (Loc.U):
3333 This variable is defined but not used by Configure.
3334 The value is a plain '' and is not useful.
3335
3336voidflags (voidflags.U):
3337 This variable contains the eventual value of the VOIDFLAGS symbol,
3338 which indicates how much support of the void type is given by this
3339 compiler. See VOIDFLAGS for more info.
3340
3341xlibpth (libpth.U):
3342 This variable holds extra path (space-separated) used to find
3343 libraries on this platform, for example CPU-specific libraries
3344 (on multi-CPU platforms) may be listed here.
3345
75347591
JH
3346xs_apiversion (xs_apiversion.U):
3347 This variable contains the version of the oldest perl binary
3348 compatible with the present perl. perl.c:incpush() and
3349 lib/lib.pm will automatically search in $sitearch for older
3350 directories across major versions back to xs_apiversion.
3351 This is only useful if you have a perl library directory tree
3352 structured like the default one.
3353 See INSTALL for how this works.
3354 The versioned site_perl directory was introduced in 5.005,
3355 so that is the lowest possible value.
3356 Since this can depend on compile time options (such as
3357 bincompat) it is set by Configure. Other non-default sources
3358 of potential incompatibility, such as multiplicity, threads,
3359 debugging, 64bits, sfio, etc., are not checked for currently,
3360 though in principle we could go snooping around in old
3361 Config.pm files.
3362
781b178c
JH
3363zcat (Loc.U):
3364 This variable is defined but not used by Configure.
3365 The value is a plain '' and is not useful.
3366
3367zip (Loc.U):
5bf26616 3368 This variable is used internally by Configure to determine the
781b178c
JH
3369 full pathname (if any) of the zip program. After Configure runs,
3370 the value is reset to a plain "zip" and is not useful.
3371