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