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