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