Perl Social Contract
[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
3programs (e.g. I_UNISTD) are already described in config_h.SH.
4
dfe9444c 5_a (Unix.U):
6 This variable defines the extension used for ordinary libraries.
7 For unix, it is '.a'. The '.' is included. Other possible
8 values include '.lib'.
9
10_exe (Unix.U):
11 This variable defines the extension used for executable files.
12 For unix it is empty. Other possible values include '.exe'.
13
14_o (Unix.U):
15 This variable defines the extension used for object files.
16 For unix, it is '.o'. The '.' is included. Other possible
17 values include '.obj'.
18
19afs (afs.U):
20 This variable is set to 'true' if AFS (Andrew File System) is used
21 on the system, 'false' otherwise. It is possible to override this
22 with a hint value or command line option, but you'd better know
23 what you are doing.
24
d7418ba7 25alignbytes (alignbytes.U):
26 This variable holds the number of bytes required to align a
27 double. Usual values are 2, 4 and 8.
28
dfe9444c 29aphostname (d_gethname.U):
30 Thie variable contains the command which can be used to compute the
31 host name. The command is fully qualified by its absolute path, to make
32 it safe when used by a process with super-user privileges.
d7418ba7 33
34archlib (archlib.U):
35 This variable holds the name of the directory in which the user wants
36 to put architecture-dependent public library files for $package.
37 It is most often a local directory such as /usr/local/lib.
38 Programs using this variable must be prepared to deal
39 with filename expansion.
40
41archlibexp (archlib.U):
42 This variable is the same as the archlib variable, but is
43 filename expanded at configuration time, for convenient use.
44
dfe9444c 45archname (archname.U):
46 This variable is a short name to characterize the current
47 architecture. It is used mainly to construct the default archlib.
48
d7418ba7 49archobjs (Unix.U):
50 This variable defines any additional objects that must be linked
51 in with the program on this architecture. On unix, it is usually
52 empty. It is typically used to include emulations of unix calls
53 or other facilities. For perl on OS/2, for example, this would
54 include os2/os2.obj.
55
dfe9444c 56baserev (baserev.U):
57 The base revision level of this package, from the .package file.
58
d7418ba7 59bin (bin.U):
60 This variable holds the name of the directory in which the user wants
61 to put publicly executable images for the package in question. It
62 is most often a local directory such as /usr/local/bin. Programs using
63 this variable must be prepared to deal with ~name substitution.
64
dfe9444c 65binexp (bin.U):
66 This is the same as the bin variable, but is filename expanded at
67 configuration time, for use in your makefiles.
68
d7418ba7 69byteorder (byteorder.U):
70 This variable holds the byte order. In the following, larger digits
71 indicate more significance. The variable byteorder is either 4321
72 on a big-endian machine, or 1234 on a little-endian, or 87654321
73 on a Cray ... or 3412 with weird order !
74
75c (n.U):
76 This variable contains the \c string if that is what causes the echo
77 command to suppress newline. Otherwise it is null. Correct usage is
78 $echo $n "prompt for a question: $c".
79
80castflags (d_castneg.U):
81 This variable contains a flag that precise difficulties the
82 compiler has casting odd floating values to unsigned long:
83 0 = ok
84 1 = couldn't cast < 0
85 2 = couldn't cast >= 0x80000000
86 4 = couldn't cast in argument expression list
87
88cc (cc.U):
89 This variable holds the name of a command to execute a C compiler which
90 can resolve multiple global references that happen to have the same
91 name. Usual values are "cc", "Mcc", "cc -M", and "gcc".
92
93cccdlflags (dlsrc.U):
94 This variable contains any special flags that might need to be
95 passed with cc -c to compile modules to be used to create a shared
96 library that will be used for dynamic loading. For hpux, this
97 should be +z. It is up to the makefile to use it.
98
99ccdlflags (dlsrc.U):
100 This variable contains any special flags that might need to be
101 passed to cc to link with a shared library for dynamic loading.
102 It is up to the makefile to use it. For sunos 4.1, it should
103 be empty.
104
105ccflags (ccflags.U):
106 This variable contains any additional C compiler flags desired by
107 the user. It is up to the Makefile to use this.
108
109cf_by (cf_who.U):
110 Login name of the person who ran the Configure script and answered the
111 questions. This is used to tag both config.sh and config_h.SH.
112
dfe9444c 113cf_email (cf_email.U):
114 Electronic mail address of the person who ran Configure. This can be
115 used by units that require the user's e-mail, like MailList.U.
116
d7418ba7 117cf_time (cf_who.U):
118 Holds the output of the "date" command when the configuration file was
119 produced. This is used to tag both config.sh and config_h.SH.
120
dfe9444c 121clocktype (d_times.U):
122 This variable holds the type returned by times(). It can be long,
123 or clock_t on BSD sites (in which case <sys/types.h> should be
124 included).
125
126contains (contains.U):
127 This variable holds the command to do a grep with a proper return
128 status. On most sane systems it is simply "grep". On insane systems
129 it is a grep followed by a cat followed by a test. This variable
130 is primarily for the use of other Configure units.
131
d7418ba7 132cpp_stuff (cpp_stuff.U):
133 This variable contains an identification of the catenation mechanism
134 used by the C preprocessor.
135
136cppflags (ccflags.U):
137 This variable holds the flags that will be passed to the C pre-
138 processor. It is up to the Makefile to use it.
139
dfe9444c 140cpplast (cppstdin.U):
141 This variable has the same functionality as cppminus, only it applies to
142 cpprun and not cppstdin.
143
d7418ba7 144cppminus (cppstdin.U):
145 This variable contains the second part of the string which will invoke
146 the C preprocessor on the standard input and produce to standard
147 output. This variable will have the value "-" if cppstdin needs a minus
148 to specify standard input, otherwise the value is "".
149
dfe9444c 150cpprun (cppstdin.U):
151 This variable contains the command which will invoke a C preprocessor
152 on standard input and put the output to stdout. It is guaranteed not
153 to be a wrapper and may be a null string if no preprocessor can be
154 made directly available. This preprocessor might be different from the
155 one used by the C compiler. Don't forget to append cpplast after the
156 preprocessor options.
157
d7418ba7 158cppstdin (cppstdin.U):
159 This variable contains the command which will invoke the C
160 preprocessor on standard input and put the output to stdout.
161 It is primarily used by other Configure units that ask about
162 preprocessor symbols.
163
164cryptlib (d_crypt.U):
165 This variable holds -lcrypt or the path to a libcrypt.a archive if
166 the crypt() function is not defined in the standard C library. It is
167 up to the Makefile to use this.
168
169d_Gconvert (d_gconvert.U):
170 This variable holds what Gconvert is defined as to convert
171 floating point numbers into strings. It could be 'gconvert'
172 or a more complex macro emulating gconvert with gcvt() or sprintf.
173
174d_access (d_access.U):
175 This variable conditionally defines HAS_ACCESS if the access() system
176 call is available to check for access permissions using real IDs.
177
178d_alarm (d_alarm.U):
179 This variable conditionally defines the HAS_ALARM symbol, which
180 indicates to the C program that the alarm() routine is available.
181
182d_archlib (archlib.U):
183 This variable conditionally defines ARCHLIB to hold the pathname
184 of architecture-dependent library files for $package. If
185 $archlib is the same as $privlib, then this is set to undef.
186
dc45a647 187d_attribut (d_attribut.U):
188 This variable conditionally defines HASATTRIBUTE, which
189 indicates the C compiler can check for function attributes,
190 such as printf formats.
191
d7418ba7 192d_bcmp (d_bcmp.U):
193 This variable conditionally defines the HAS_BCMP symbol if
194 the bcmp() routine is available to compare strings.
195
196d_bcopy (d_bcopy.U):
197 This variable conditionally defines the HAS_BCOPY symbol if
198 the bcopy() routine is available to copy strings.
199
dfe9444c 200d_bsd (Guess.U):
201 This symbol conditionally defines the symbol BSD when running on a
202 BSD system.
7e1af8bc 203
c43cd16b 204d_bsdgetpgrp (d_getpgrp.U):
205 This variable conditionally defines USE_BSD_GETPGRP if
206 getpgrp needs one arguments whereas USG one needs none.
207
dc45a647 208d_bsdsetpgrp (d_setpgrp.U):
209 This variable conditionally defines USE_BSD_SETPGRP if
210 setpgrp needs two arguments whereas USG one needs none.
211 See also d_setpgid for a POSIX interface.
212
d7418ba7 213d_bzero (d_bzero.U):
214 This variable conditionally defines the HAS_BZERO symbol if
215 the bzero() routine is available to set memory to 0.
216
217d_casti32 (d_casti32.U):
218 This variable conditionally defines CASTI32, which indicates
219 whether the C compiler can cast large floats to 32-bit ints.
220
221d_castneg (d_castneg.U):
222 This variable conditionally defines CASTNEG, which indicates
223 wether the C compiler can cast negative float to unsigned.
224
225d_charvspr (d_vprintf.U):
226 This variable conditionally defines CHARVSPRINTF if this system
227 has vsprintf returning type (char*). The trend seems to be to
228 declare it as "int vsprintf()".
229
230d_chown (d_chown.U):
231 This variable conditionally defines the HAS_CHOWN symbol, which
232 indicates to the C program that the chown() routine is available.
233
234d_chroot (d_chroot.U):
235 This variable conditionally defines the HAS_CHROOT symbol, which
236 indicates to the C program that the chroot() routine is available.
237
238d_chsize (d_chsize.U):
239 This variable conditionally defines the CHSIZE symbol, which
240 indicates to the C program that the chsize() routine is available
241 to truncate files. You might need a -lx to get this routine.
242
dfe9444c 243d_closedir (d_closedir.U):
244 This variable conditionally defines HAS_CLOSEDIR if closedir() is
245 available.
246
d7418ba7 247d_const (d_const.U):
248 This variable conditionally defines the HASCONST symbol, which
249 indicates to the C program that this C compiler knows about the
250 const type.
251
252d_crypt (d_crypt.U):
253 This variable conditionally defines the CRYPT symbol, which
254 indicates to the C program that the crypt() routine is available
255 to encrypt passwords and the like.
256
257d_csh (d_csh.U):
258 This variable conditionally defines the CSH symbol, which
259 indicates to the C program that the C-shell exists.
260
261d_cuserid (d_cuserid.U):
262 This variable conditionally defines the HAS_CUSERID symbol, which
263 indicates to the C program that the cuserid() routine is available
264 to get character login names.
265
266d_dbl_dig (d_dbl_dig.U):
267 This variable conditionally defines d_dbl_dig if this system's
268 header files provide DBL_DIG, which is the number of significant
269 digits in a double precision number.
270
271d_difftime (d_difftime.U):
272 This variable conditionally defines the HAS_DIFFTIME symbol, which
273 indicates to the C program that the difftime() routine is available.
274
275d_dirnamlen (i_dirent.U):
276 This variable conditionally defines DIRNAMLEN, which indicates
277 to the C program that the length of directory entry names is
278 provided by a d_namelen field.
279
280d_dlerror (d_dlerror.U):
281 This variable conditionally defines the HAS_DLERROR symbol, which
282 indicates to the C program that the dlerror() routine is available.
283
dfe9444c 284d_dlopen (d_dlopen.U):
285 This variable conditionally defines the HAS_DLOPEN symbol, which
286 indicates to the C program that the dlopen() routine is available.
287
d7418ba7 288d_dlsymun (d_dlsymun.U):
289 This variable conditionally defines DLSYM_NEEDS_UNDERSCORE, which
290 indicates that we need to prepend an underscore to the symbol
291 name before calling dlsym().
292
293d_dosuid (d_dosuid.U):
294 This variable conditionally defines the symbol DOSUID, which
295 tells the C program that it should insert setuid emulation code
296 on hosts which have setuid #! scripts disabled.
297
298d_dup2 (d_dup2.U):
299 This variable conditionally defines HAS_DUP2 if dup2() is
300 available to duplicate file descriptors.
301
e5c9fcd0 302d_endhent (d_endhent.U):
303 This variable conditionally defines HAS_ENDHOSTENT if endhostent() is
304 available to close whatever was being used for host queries.
305
306d_endnent (d_endnent.U):
307 This variable conditionally defines HAS_ENDNETENT if endnetent() is
308 available to close whatever was being used for network queries.
309
310d_endpent (d_endpent.U):
311 This variable conditionally defines HAS_ENDPROTOENT if endprotoent() is
312 available to close whatever was being used for protocol queries.
313
314d_endsent (d_endsent.U):
315 This variable conditionally defines HAS_ENDSERVENT if endservent() is
316 available to close whatever was being used for service queries.
317
d7418ba7 318d_eofnblk (nblock_io.U):
319 This variable conditionally defines EOF_NONBLOCK if EOF can be seen
320 when reading from a non-blocking I/O source.
321
dfe9444c 322d_eunice (Guess.U):
323 This variable conditionally defines the symbols EUNICE and VAX, which
324 alerts the C program that it must deal with ideosyncracies of VMS.
325
d7418ba7 326d_fchmod (d_fchmod.U):
327 This variable conditionally defines the HAS_FCHMOD symbol, which
328 indicates to the C program that the fchmod() routine is available
329 to change mode of opened files.
330
331d_fchown (d_fchown.U):
332 This variable conditionally defines the HAS_FCHOWN symbol, which
333 indicates to the C program that the fchown() routine is available
334 to change ownership of opened files.
335
336d_fcntl (d_fcntl.U):
337 This variable conditionally defines the HAS_FCNTL symbol, and indicates
338 whether the fcntl() function exists
339
dfe9444c 340d_fd_macros (d_fd_set.U):
341 This variable contains the eventual value of the HAS_FD_MACROS symbol,
342 which indicates if your C compiler knows about the macros which
343 manipulate an fd_set.
344
345d_fd_set (d_fd_set.U):
346 This variable contains the eventual value of the HAS_FD_SET symbol,
347 which indicates if your C compiler knows about the fd_set typedef.
348
349d_fds_bits (d_fd_set.U):
350 This variable contains the eventual value of the HAS_FDS_BITS symbol,
351 which indicates if your fd_set typedef contains the fds_bits member.
352 If you have an fd_set typedef, but the dweebs who installed it did
353 a half-fast job and neglected to provide the macros to manipulate
354 an fd_set, HAS_FDS_BITS will let us know how to fix the gaffe.
355
d7418ba7 356d_fgetpos (d_fgetpos.U):
357 This variable conditionally defines HAS_FGETPOS if fgetpos() is
358 available to get the file position indicator.
359
360d_flexfnam (d_flexfnam.U):
361 This variable conditionally defines the FLEXFILENAMES symbol, which
362 indicates that the system supports filenames longer than 14 characters.
363
364d_flock (d_flock.U):
365 This variable conditionally defines HAS_FLOCK if flock() is
366 available to do file locking.
367
368d_fork (d_fork.U):
369 This variable conditionally defines the HAS_FORK symbol, which
370 indicates to the C program that the fork() routine is available.
371
372d_fpathconf (d_pathconf.U):
373 This variable conditionally defines the HAS_FPATHCONF symbol, which
374 indicates to the C program that the pathconf() routine is available
375 to determine file-system related limits and options associated
376 with a given open file descriptor.
377
378d_fsetpos (d_fsetpos.U):
379 This variable conditionally defines HAS_FSETPOS if fsetpos() is
380 available to set the file position indicator.
381
7e1af8bc 382d_ftime (d_ftime.U):
dfe9444c 383 This variable conditionally defines the HAS_FTIME symbol, which indicates
384 that the ftime() routine exists. The ftime() routine is basically
385 a sub-second accuracy clock.
386
387d_getgrps (d_getgrps.U):
388 This variable conditionally defines the HAS_GETGROUPS symbol, which
389 indicates to the C program that the getgroups() routine is available
390 to get the list of process groups.
391
392d_gethbyaddr (d_gethbyad.U):
393 This variable conditionally defines the HAS_GETHOSTBYADDR symbol, which
394 indicates to the C program that the gethostbyaddr() routine is available
395 to look up hosts by their IP addresses.
7e1af8bc 396
dc45a647 397d_gethbyname (d_gethbynm.U):
398 This variable conditionally defines the HAS_GETHOSTBYNAME symbol, which
399 indicates to the C program that the gethostbyname() routine is available
400 to look up host names in some data base or other.
401
d7418ba7 402d_gethent (d_gethent.U):
403 This variable conditionally defines HAS_GETHOSTENT if gethostent() is
693762b4 404 available to look up host names in some data base or another.
d7418ba7 405
dfe9444c 406d_gethname (d_gethname.U):
407 This variable conditionally defines the HAS_GETHOSTNAME symbol, which
408 indicates to the C program that the gethostname() routine may be
409 used to derive the host name.
7e1af8bc 410
dc45a647 411d_gethostprotos (d_gethostprotos.U):
412 This variable conditionally defines the HAS_GETHOST_PROTOS symbol,
413 which indicates to the C program that <netdb.h> supplies
414 prototypes for the various gethost*() functions.
415 See also netdbtype.U for probing for various netdb types.
416
d7418ba7 417d_getlogin (d_getlogin.U):
418 This variable conditionally defines the HAS_GETLOGIN symbol, which
419 indicates to the C program that the getlogin() routine is available
420 to get the login name.
421
dfe9444c 422d_getnbyaddr (d_getnbyad.U):
423 This variable conditionally defines the HAS_GETNETBYADDR symbol, which
424 indicates to the C program that the getnetbyaddr() routine is available
425 to look up networks by their IP addresses.
426
693762b4 427d_getnbyname (d_getnbynm.U):
428 This variable conditionally defines the HAS_GETNETBYNAME symbol, which
429 indicates to the C program that the getnetbyname() routine is available
430 to look up networks by their names.
431
e5c9fcd0 432d_getnent (d_getnent.U):
433 This variable conditionally defines HAS_GETNETENT if getnetent() is
434 available to look up network names in some data base or another.
435
dc45a647 436d_getnetprotos (d_getnetprotos.U):
437 This variable conditionally defines the HAS_GETNET_PROTOS symbol,
438 which indicates to the C program that <netdb.h> supplies
439 prototypes for the various getnet*() functions.
440 See also netdbtype.U for probing for various netdb types.
441
693762b4 442d_getpbyname (d_getprotby.U):
443 This variable conditionally defines the HAS_GETPROTOBYNAME
444 symbol, which indicates to the C program that the
445 getprotobyname() routine is available to look up protocols
446 by their name.
447
448d_getpbynumber (d_getprotby.U):
449 This variable conditionally defines the HAS_GETPROTOBYNUMBER
450 symbol, which indicates to the C program that the
451 getprotobynumber() routine is available to look up protocols
452 by their number.
453
e5c9fcd0 454d_getpent (d_getpent.U):
455 This variable conditionally defines HAS_GETPROTOENT if getprotoent() is
456 available to look up protocols in some data base or another.
457
c43cd16b 458d_getpgid (d_getpgid.U):
459 This variable conditionally defines the HAS_GETPGID symbol, which
460 indicates to the C program that the getpgid(pid) function
461 is available to get the process group id.
462
d7418ba7 463d_getpgrp2 (d_getpgrp2.U):
464 This variable conditionally defines the HAS_GETPGRP2 symbol, which
465 indicates to the C program that the getpgrp2() (as in DG/UX) routine
466 is available to get the current process group.
467
dfe9444c 468d_getpgrp (d_getpgrp.U):
469 This variable conditionally defines HAS_GETPGRP if getpgrp() is
470 available to get the current process group.
471
d7418ba7 472d_getppid (d_getppid.U):
473 This variable conditionally defines the HAS_GETPPID symbol, which
474 indicates to the C program that the getppid() routine is available
475 to get the parent process ID.
476
477d_getprior (d_getprior.U):
478 This variable conditionally defines HAS_GETPRIORITY if getpriority()
479 is available to get a process's priority.
480
dc45a647 481d_getprotoprotos (d_getprotoprotos.U):
482 This variable conditionally defines the HAS_GETPROTO_PROTOS symbol,
483 which indicates to the C program that <netdb.h> supplies
484 prototypes for the various getproto*() functions.
485 See also netdbtype.U for probing for various netdb types.
486
693762b4 487d_getsbyname (d_getsrvby.U):
488 This variable conditionally defines the HAS_GETSERVBYNAME
489 symbol, which indicates to the C program that the
490 getservbyname() routine is available to look up services
491 by their name.
492
493d_getsbyport (d_getsrvby.U):
494 This variable conditionally defines the HAS_GETSERVBYPORT
495 symbol, which indicates to the C program that the
496 getservbyport() routine is available to look up services
497 by their port.
498
e5c9fcd0 499d_getsent (d_getsent.U):
500 This variable conditionally defines HAS_GETSERVENT if getservent() is
501 available to look up network services in some data base or another.
502
dc45a647 503d_getservprotos (d_getservprotos.U):
504 This variable conditionally defines the HAS_GETSERV_PROTOS symbol,
505 which indicates to the C program that <netdb.h> supplies
506 prototypes for the various getserv*() functions.
507 See also netdbtype.U for probing for various netdb types.
508
dfe9444c 509d_gettimeod (d_ftime.U):
510 This variable conditionally defines the HAS_GETTIMEOFDAY symbol, which
511 indicates that the gettimeofday() system call exists (to obtain a
512 sub-second accuracy clock). You should probably include <sys/resource.h>.
513
514d_gnulibc (d_gnulibc.U):
515 Defined if we're dealing with the GNU C Library.
516
d7418ba7 517d_htonl (d_htonl.U):
518 This variable conditionally defines HAS_HTONL if htonl() and its
519 friends are available to do network order byte swapping.
520
521d_index (d_strchr.U):
522 This variable conditionally defines HAS_INDEX if index() and
523 rindex() are available for string searching.
524
7e1af8bc 525d_inetaton (d_inetaton.U):
526 This variable conditionally defines the HAS_INET_ATON symbol, which
527 indicates to the C program that the inet_aton() function is available
528 to parse IP address "dotted-quad" strings.
529
d7418ba7 530d_isascii (d_isascii.U):
531 This variable conditionally defines the HAS_ISASCII constant,
532 which indicates to the C program that isascii() is available.
533
534d_killpg (d_killpg.U):
535 This variable conditionally defines the HAS_KILLPG symbol, which
536 indicates to the C program that the killpg() routine is available
537 to kill process groups.
538
539d_link (d_link.U):
540 This variable conditionally defines HAS_LINK if link() is
541 available to create hard links.
542
543d_locconv (d_locconv.U):
544 This variable conditionally defines HAS_LOCALECONV if localeconv() is
545 available for numeric and monetary formatting conventions.
546
547d_lockf (d_lockf.U):
548 This variable conditionally defines HAS_LOCKF if lockf() is
549 available to do file locking.
550
e5c9fcd0 551d_longdbl (d_longdbl.U):
552 This variable conditionally defines HAS_LONG_DOUBLE if
553 the long double type is supported.
554
dc45a647 555d_longlong (d_longlong.U):
556 This variable conditionally defines HAS_LONG_LONG if
557 the long long type is supported.
558
d7418ba7 559d_lstat (d_lstat.U):
560 This variable conditionally defines HAS_LSTAT if lstat() is
561 available to do file stats on symbolic links.
562
563d_mblen (d_mblen.U):
564 This variable conditionally defines the HAS_MBLEN symbol, which
565 indicates to the C program that the mblen() routine is available
566 to find the number of bytes in a multibye character.
567
568d_mbstowcs (d_mbstowcs.U):
569 This variable conditionally defines the HAS_MBSTOWCS symbol, which
570 indicates to the C program that the mbstowcs() routine is available
571 to convert a multibyte string into a wide character string.
572
573d_mbtowc (d_mbtowc.U):
574 This variable conditionally defines the HAS_MBTOWC symbol, which
575 indicates to the C program that the mbtowc() routine is available
576 to convert multibyte to a wide character.
577
578d_memcmp (d_memcmp.U):
579 This variable conditionally defines the HAS_MEMCMP symbol, which
580 indicates to the C program that the memcmp() routine is available
581 to compare blocks of memory.
582
583d_memcpy (d_memcpy.U):
584 This variable conditionally defines the HAS_MEMCPY symbol, which
585 indicates to the C program that the memcpy() routine is available
586 to copy blocks of memory.
587
588d_memmove (d_memmove.U):
589 This variable conditionally defines the HAS_MEMMOVE symbol, which
590 indicates to the C program that the memmove() routine is available
591 to copy potentatially overlapping blocks of memory.
592
593d_memset (d_memset.U):
594 This variable conditionally defines the HAS_MEMSET symbol, which
595 indicates to the C program that the memset() routine is available
596 to set blocks of memory.
597
598d_mkdir (d_mkdir.U):
599 This variable conditionally defines the HAS_MKDIR symbol, which
600 indicates to the C program that the mkdir() routine is available
601 to create directories..
602
603d_mkfifo (d_mkfifo.U):
604 This variable conditionally defines the HAS_MKFIFO symbol, which
605 indicates to the C program that the mkfifo() routine is available.
606
e5c9fcd0 607d_mkstemp (d_mkstemp.U):
608 This variable conditionally defines the HAS_MKSTEMP symbol, which
609 indicates to the C program that the mkstemp() routine is available
610 to create and open a unique tempporary file.
611
d7418ba7 612d_mktime (d_mktime.U):
613 This variable conditionally defines the HAS_MKTIME symbol, which
614 indicates to the C program that the mktime() routine is available.
615
616d_msg (d_msg.U):
617 This variable conditionally defines the HAS_MSG symbol, which
618 indicates that the entire msg*(2) library is present.
619
dfe9444c 620d_msgctl (d_msgctl.U):
621 This variable conditionally defines the HAS_MSGCTL symbol, which
622 indicates to the C program that the msgctl() routine is available.
623
624d_msgget (d_msgget.U):
625 This variable conditionally defines the HAS_MSGGET symbol, which
626 indicates to the C program that the msgget() routine is available.
627
628d_msgrcv (d_msgrcv.U):
629 This variable conditionally defines the HAS_MSGRCV symbol, which
630 indicates to the C program that the msgrcv() routine is available.
631
632d_msgsnd (d_msgsnd.U):
633 This variable conditionally defines the HAS_MSGSND symbol, which
634 indicates to the C program that the msgsnd() routine is available.
635
d7418ba7 636d_mymalloc (mallocsrc.U):
637 This variable conditionally defines MYMALLOC in case other parts
638 of the source want to take special action if MYMALLOC is used.
639 This may include different sorts of profiling or error detection.
640
641d_nice (d_nice.U):
642 This variable conditionally defines the HAS_NICE symbol, which
643 indicates to the C program that the nice() routine is available.
644
693762b4 645d_oldpthreads (usethreads.U):
646 This variable conditionally defines the OLD_PTHREADS_API symbol,
647 and indicates that Perl should be built to use the old
648 draft POSIX threads API. This is only potneially meaningful if
649 usethreads is set.
650
dfe9444c 651d_oldsock (d_socket.U):
652 This variable conditionally defines the OLDSOCKET symbol, which
653 indicates that the BSD socket interface is based on 4.1c and not 4.2.
d7418ba7 654
655d_open3 (d_open3.U):
656 This variable conditionally defines the HAS_OPEN3 manifest constant,
657 which indicates to the C program that the 3 argument version of
658 the open(2) function is available.
659
660d_pathconf (d_pathconf.U):
661 This variable conditionally defines the HAS_PATHCONF symbol, which
662 indicates to the C program that the pathconf() routine is available
663 to determine file-system related limits and options associated
664 with a given filename.
665
666d_pause (d_pause.U):
667 This variable conditionally defines the HAS_PAUSE symbol, which
668 indicates to the C program that the pause() routine is available
669 to suspend a process until a signal is received.
670
dfe9444c 671d_phostname (d_gethname.U):
672 This variable conditionally defines the PHOSTNAME symbol, which
673 contains the shell command which, when fed to popen(), may be
674 used to derive the host name.
675
d7418ba7 676d_pipe (d_pipe.U):
677 This variable conditionally defines the HAS_PIPE symbol, which
678 indicates to the C program that the pipe() routine is available
679 to create an inter-process channel.
680
681d_poll (d_poll.U):
682 This variable conditionally defines the HAS_POLL symbol, which
683 indicates to the C program that the poll() routine is available
684 to poll active file descriptors.
685
dfe9444c 686d_portable (d_portable.U):
687 This variable conditionally defines the PORTABLE symbol, which
688 indicates to the C program that it should not assume that it is
689 running on the machine it was compiled on.
690
691d_pthread_yield (d_pthread_y.U):
692 This variable conditionally defines the HAS_PTHREAD_YIELD
693 symbol if the pthread_yield routine is available to yield
694 the execution of the current thread.
695
696d_pthreads_created_joinable (d_pthreadj.U):
697 This variable conditionally defines the PTHREADS_CREATED_JOINABLE
698 symbol if pthreads are created in the joinable (aka undetached)
699 state.
700
d7418ba7 701d_pwage (i_pwd.U):
702 This varaible conditionally defines PWAGE, which indicates
703 that struct passwd contains pw_age.
704
705d_pwchange (i_pwd.U):
706 This varaible conditionally defines PWCHANGE, which indicates
707 that struct passwd contains pw_change.
708
709d_pwclass (i_pwd.U):
710 This varaible conditionally defines PWCLASS, which indicates
711 that struct passwd contains pw_class.
712
713d_pwcomment (i_pwd.U):
714 This varaible conditionally defines PWCOMMENT, which indicates
715 that struct passwd contains pw_comment.
716
717d_pwexpire (i_pwd.U):
718 This varaible conditionally defines PWEXPIRE, which indicates
719 that struct passwd contains pw_expire.
720
721d_pwquota (i_pwd.U):
722 This varaible conditionally defines PWQUOTA, which indicates
723 that struct passwd contains pw_quota.
724
725d_readdir (d_readdir.U):
726 This variable conditionally defines HAS_READDIR if readdir() is
727 available to read directory entries.
728
729d_readlink (d_readlink.U):
730 This variable conditionally defines the HAS_READLINK symbol, which
731 indicates to the C program that the readlink() routine is available
732 to read the value of a symbolic link.
733
734d_rename (d_rename.U):
735 This variable conditionally defines the HAS_RENAME symbol, which
736 indicates to the C program that the rename() routine is available
737 to rename files.
738
739d_rewinddir (d_readdir.U):
740 This variable conditionally defines HAS_REWINDDIR if rewinddir() is
741 available.
742
743d_rmdir (d_rmdir.U):
744 This variable conditionally defines HAS_RMDIR if rmdir() is
745 available to remove directories.
746
747d_safebcpy (d_safebcpy.U):
748 This variable conditionally defines the HAS_SAFE_BCOPY symbol if
749 the bcopy() routine can do overlapping copies.
750
751d_safemcpy (d_safemcpy.U):
752 This variable conditionally defines the HAS_SAFE_MEMCPY symbol if
753 the memcpy() routine can do overlapping copies.
754
7e1af8bc 755d_sanemcmp (d_sanemcmp.U):
756 This variable conditionally defines the HAS_SANE_MEMCMP symbol if
757 the memcpy() routine is available and can be used to compare relative
758 magnitudes of chars with their high bits set.
759
dfe9444c 760d_sched_yield (d_pthread_y.U):
761 This variable conditionally defines the HAS_SCHED_YIELD
762 symbol if the sched_yield routine is available to yield
763 the execution of the current thread.
764
d7418ba7 765d_seekdir (d_readdir.U):
766 This variable conditionally defines HAS_SEEKDIR if seekdir() is
767 available.
768
769d_select (d_select.U):
770 This variable conditionally defines HAS_SELECT if select() is
771 available to select active file descriptors. A <sys/time.h>
772 inclusion may be necessary for the timeout field.
773
774d_sem (d_sem.U):
775 This variable conditionally defines the HAS_SEM symbol, which
776 indicates that the entire sem*(2) library is present.
777
dfe9444c 778d_semctl (d_semctl.U):
779 This variable conditionally defines the HAS_SEMCTL symbol, which
780 indicates to the C program that the semctl() routine is available.
781
782d_semget (d_semget.U):
783 This variable conditionally defines the HAS_SEMGET symbol, which
784 indicates to the C program that the semget() routine is available.
785
786d_semop (d_semop.U):
787 This variable conditionally defines the HAS_SEMOP symbol, which
788 indicates to the C program that the semop() routine is available.
789
d7418ba7 790d_setegid (d_setegid.U):
791 This variable conditionally defines the HAS_SETEGID symbol, which
792 indicates to the C program that the setegid() routine is available
793 to change the effective gid of the current program.
794
795d_seteuid (d_seteuid.U):
796 This variable conditionally defines the HAS_SETEUID symbol, which
797 indicates to the C program that the seteuid() routine is available
798 to change the effective uid of the current program.
799
dfe9444c 800d_setgrps (d_setgrps.U):
801 This variable conditionally defines the HAS_SETGROUPS symbol, which
802 indicates to the C program that the setgroups() routine is available
803 to set the list of process groups.
804
693762b4 805d_sethent (d_sethent.U):
806 This variable conditionally defines HAS_SETHOSTENT if sethostent() is
807 available.
808
d7418ba7 809d_setlinebuf (d_setlnbuf.U):
810 This variable conditionally defines the HAS_SETLINEBUF symbol, which
811 indicates to the C program that the setlinebuf() routine is available
812 to change stderr or stdout from block-buffered or unbuffered to a
813 line-buffered mode.
814
815d_setlocale (d_setlocale.U):
816 This variable conditionally defines HAS_SETLOCALE if setlocale() is
817 available to handle locale-specific ctype implementations.
818
e5c9fcd0 819d_setnent (d_setnent.U):
820 This variable conditionally defines HAS_SETNETENT if setnetent() is
821 available.
822
823d_setpent (d_setpent.U):
824 This variable conditionally defines HAS_SETPROTOENT if setprotoent() is
825 available.
826
d7418ba7 827d_setpgid (d_setpgid.U):
dfe9444c 828 This variable conditionally defines the HAS_SETPGID symbol if the
829 setpgid(pid, gpid) function is available to set process group ID.
d7418ba7 830
831d_setpgrp2 (d_setpgrp2.U):
832 This variable conditionally defines the HAS_SETPGRP2 symbol, which
833 indicates to the C program that the setpgrp2() (as in DG/UX) routine
834 is available to set the current process group.
835
dfe9444c 836d_setpgrp (d_setpgrp.U):
837 This variable conditionally defines HAS_SETPGRP if setpgrp() is
838 available to set the current process group.
839
d7418ba7 840d_setprior (d_setprior.U):
841 This variable conditionally defines HAS_SETPRIORITY if setpriority()
842 is available to set a process's priority.
843
844d_setregid (d_setregid.U):
845 This variable conditionally defines HAS_SETREGID if setregid() is
846 available to change the real and effective gid of the current
847 process.
848
849d_setresgid (d_setregid.U):
850 This variable conditionally defines HAS_SETRESGID if setresgid() is
851 available to change the real, effective and saved gid of the current
852 process.
853
854d_setresuid (d_setreuid.U):
855 This variable conditionally defines HAS_SETREUID if setresuid() is
856 available to change the real, effective and saved uid of the current
857 process.
858
859d_setreuid (d_setreuid.U):
860 This variable conditionally defines HAS_SETREUID if setreuid() is
861 available to change the real and effective uid of the current
862 process.
863
864d_setrgid (d_setrgid.U):
865 This variable conditionally defines the HAS_SETRGID symbol, which
866 indicates to the C program that the setrgid() routine is available
867 to change the real gid of the current program.
868
869d_setruid (d_setruid.U):
870 This variable conditionally defines the HAS_SETRUID symbol, which
871 indicates to the C program that the setruid() routine is available
872 to change the real uid of the current program.
873
e5c9fcd0 874d_setsent (d_setsent.U):
875 This variable conditionally defines HAS_SETSERVENT if setservent() is
876 available.
877
d7418ba7 878d_setsid (d_setsid.U):
879 This variable conditionally defines HAS_SETSID if setsid() is
880 available to set the process group ID.
881
e5c9fcd0 882d_setvbuf (d_setvbuf.U):
883 This variable conditionally defines the HAS_SETVBUF symbol, which
884 indicates to the C program that the setvbuf() routine is available
885 to change buffering on an open stdio stream.
886
d7418ba7 887d_sfio (d_sfio.U):
888 This variable conditionally defines the USE_SFIO symbol,
889 and indicates whether sfio is available (and should be used).
890
891d_shm (d_shm.U):
892 This variable conditionally defines the HAS_SHM symbol, which
893 indicates that the entire shm*(2) library is present.
894
dfe9444c 895d_shmat (d_shmat.U):
896 This variable conditionally defines the HAS_SHMAT symbol, which
897 indicates to the C program that the shmat() routine is available.
898
d7418ba7 899d_shmatprototype (d_shmat.U):
900 This variable conditionally defines the HAS_SHMAT_PROTOTYPE
901 symbol, which indicates that sys/shm.h has a prototype for
902 shmat.
903
dfe9444c 904d_shmctl (d_shmctl.U):
905 This variable conditionally defines the HAS_SHMCTL symbol, which
906 indicates to the C program that the shmctl() routine is available.
907
908d_shmdt (d_shmdt.U):
909 This variable conditionally defines the HAS_SHMDT symbol, which
910 indicates to the C program that the shmdt() routine is available.
911
912d_shmget (d_shmget.U):
913 This variable conditionally defines the HAS_SHMGET symbol, which
914 indicates to the C program that the shmget() routine is available.
915
d7418ba7 916d_sigaction (d_sigaction.U):
917 This variable conditionally defines the HAS_SIGACTION symbol, which
918 indicates that the Vr4 sigaction() routine is available.
919
920d_sigsetjmp (d_sigsetjmp.U):
921 This variable conditionally defines the HAS_SIGSETJMP symbol,
922 which indicates that the sigsetjmp() routine is available to
923 call setjmp() and optionally save the process's signal mask.
924
925d_socket (d_socket.U):
926 This variable conditionally defines HAS_SOCKET, which indicates
927 that the BSD socket interface is supported.
928
929d_sockpair (d_socket.U):
930 This variable conditionally defines the HAS_SOCKETPAIR symbol, which
931 indicates that the BSD socketpair() is supported.
932
933d_statblks (d_statblks.U):
934 This variable conditionally defines USE_STAT_BLOCKS if this system
935 has a stat structure declaring st_blksize and st_blocks.
936
937d_stdio_cnt_lval (d_stdstdio.U):
938 This variable conditionally defines STDIO_CNT_LVALUE if the
939 FILE_cnt macro can be used as an lvalue.
940
941d_stdio_ptr_lval (d_stdstdio.U):
942 This variable conditionally defines STDIO_PTR_LVALUE if the
943 FILE_ptr macro can be used as an lvalue.
944
945d_stdiobase (d_stdstdio.U):
946 This variable conditionally defines USE_STDIO_BASE if this system
947 has a FILE structure declaring a usable _base field (or equivalent)
948 in stdio.h.
949
950d_stdstdio (d_stdstdio.U):
951 This variable conditionally defines USE_STDIO_PTR if this system
952 has a FILE structure declaring usable _ptr and _cnt fields (or
953 equivalent) in stdio.h.
954
955d_strchr (d_strchr.U):
956 This variable conditionally defines HAS_STRCHR if strchr() and
957 strrchr() are available for string searching.
958
959d_strcoll (d_strcoll.U):
960 This variable conditionally defines HAS_STRCOLL if strcoll() is
961 available to compare strings using collating information.
962
963d_strctcpy (d_strctcpy.U):
964 This variable conditionally defines the USE_STRUCT_COPY symbol, which
965 indicates to the C program that this C compiler knows how to copy
966 structures.
967
968d_strerrm (d_strerror.U):
969 This variable holds what Strerrr is defined as to translate an error
970 code condition into an error message string. It could be 'strerror'
971 or a more complex macro emulating strrror with sys_errlist[], or the
972 "unknown" string when both strerror and sys_errlist are missing.
973
974d_strerror (d_strerror.U):
975 This variable conditionally defines HAS_STRERROR if strerror() is
976 available to translate error numbers to strings.
977
7e1af8bc 978d_strtod (d_strtod.U):
979 This variable conditionally defines the HAS_STRTOD symbol, which
980 indicates to the C program that the strtod() routine is available
981 to provide better numeric string conversion than atof().
982
983d_strtol (d_strtol.U):
984 This variable conditionally defines the HAS_STRTOL symbol, which
985 indicates to the C program that the strtol() routine is available
986 to provide better numeric string conversion than atoi() and friends.
987
988d_strtoul (d_strtoul.U):
989 This variable conditionally defines the HAS_STRTOUL symbol, which
990 indicates to the C program that the strtoul() routine is available
991 to provide conversion of strings to unsigned long.
992
d7418ba7 993d_strxfrm (d_strxfrm.U):
994 This variable conditionally defines HAS_STRXFRM if strxfrm() is
995 available to transform strings.
996
997d_suidsafe (d_dosuid.U):
998 This variable conditionally defines SETUID_SCRIPTS_ARE_SECURE_NOW
999 if setuid scripts can be secure. This test looks in /dev/fd/.
1000
1001d_symlink (d_symlink.U):
1002 This variable conditionally defines the HAS_SYMLINK symbol, which
1003 indicates to the C program that the symlink() routine is available
1004 to create symbolic links.
1005
1006d_syscall (d_syscall.U):
1007 This variable conditionally defines HAS_SYSCALL if syscall() is
1008 available call arbitrary system calls.
1009
1010d_sysconf (d_sysconf.U):
1011 This variable conditionally defines the HAS_SYSCONF symbol, which
1012 indicates to the C program that the sysconf() routine is available
1013 to determine system related limits and options.
1014
dfe9444c 1015d_sysernlst (d_strerror.U):
1016 This variable conditionally defines HAS_SYS_ERRNOLIST if sys_errnolist[]
1017 is available to translate error numbers to the symbolic name.
1018
d7418ba7 1019d_syserrlst (d_strerror.U):
1020 This variable conditionally defines HAS_SYS_ERRLIST if sys_errlist[] is
1021 available to translate error numbers to strings.
1022
1023d_system (d_system.U):
1024 This variable conditionally defines HAS_SYSTEM if system() is
1025 available to issue a shell command.
1026
1027d_tcgetpgrp (d_tcgtpgrp.U):
1028 This variable conditionally defines the HAS_TCGETPGRP symbol, which
1029 indicates to the C program that the tcgetpgrp() routine is available.
1030 to get foreground process group ID.
1031
1032d_tcsetpgrp (d_tcstpgrp.U):
1033 This variable conditionally defines the HAS_TCSETPGRP symbol, which
1034 indicates to the C program that the tcsetpgrp() routine is available
1035 to set foreground process group ID.
1036
1037d_telldir (d_readdir.U):
1038 This variable conditionally defines HAS_TELLDIR if telldir() is
1039 available.
1040
dfe9444c 1041d_time (d_time.U):
1042 This variable conditionally defines the HAS_TIME symbol, which indicates
1043 that the time() routine exists. The time() routine is normaly
1044 provided on UNIX systems.
1045
d7418ba7 1046d_times (d_times.U):
1047 This variable conditionally defines the HAS_TIMES symbol, which indicates
1048 that the times() routine exists. The times() routine is normaly
1049 provided on UNIX systems. You may have to include <sys/times.h>.
1050
1051d_truncate (d_truncate.U):
1052 This variable conditionally defines HAS_TRUNCATE if truncate() is
1053 available to truncate files.
1054
1055d_tzname (d_tzname.U):
1056 This variable conditionally defines HAS_TZNAME if tzname[] is
1057 available to access timezone names.
1058
1059d_umask (d_umask.U):
1060 This variable conditionally defines the HAS_UMASK symbol, which
1061 indicates to the C program that the umask() routine is available.
1062 to set and get the value of the file creation mask.
1063
1064d_uname (d_gethname.U):
1065 This variable conditionally defines the HAS_UNAME symbol, which
1066 indicates to the C program that the uname() routine may be
1067 used to derive the host name.
1068
1069d_vfork (d_vfork.U):
1070 This variable conditionally defines the HAS_VFORK symbol, which
1071 indicates the vfork() routine is available.
1072
1073d_void_closedir (d_closedir.U):
1074 This variable conditionally defines VOID_CLOSEDIR if closedir()
1075 does not return a value.
1076
dfe9444c 1077d_voidsig (d_voidsig.U):
1078 This variable conditionally defines VOIDSIG if this system
1079 declares "void (*signal(...))()" in signal.h. The old way was to
1080 declare it as "int (*signal(...))()".
1081
1082d_voidtty (i_sysioctl.U):
1083 This variable conditionally defines USE_IOCNOTTY to indicate that the
1084 ioctl() call with TIOCNOTTY should be used to void tty association.
1085 Otherwise (on USG probably), it is enough to close the standard file
1086 decriptors and do a setpgrp().
1087
d7418ba7 1088d_volatile (d_volatile.U):
1089 This variable conditionally defines the HASVOLATILE symbol, which
1090 indicates to the C program that this C compiler knows about the
1091 volatile declaration.
1092
1093d_vprintf (d_vprintf.U):
1094 This variable conditionally defines the HAS_VPRINTF symbol, which
1095 indicates to the C program that the vprintf() routine is available
1096 to printf with a pointer to an argument list.
1097
1098d_wait4 (d_wait4.U):
1099 This variable conditionally defines the HAS_WAIT4 symbol, which
1100 indicates the wait4() routine is available.
1101
1102d_waitpid (d_waitpid.U):
1103 This variable conditionally defines HAS_WAITPID if waitpid() is
1104 available to wait for child process.
1105
1106d_wcstombs (d_wcstombs.U):
1107 This variable conditionally defines the HAS_WCSTOMBS symbol, which
1108 indicates to the C program that the wcstombs() routine is available
1109 to convert wide character strings to multibyte strings.
1110
1111d_wctomb (d_wctomb.U):
1112 This variable conditionally defines the HAS_WCTOMB symbol, which
1113 indicates to the C program that the wctomb() routine is available
1114 to convert a wide character to a multibyte.
1115
dfe9444c 1116d_xenix (Guess.U):
1117 This variable conditionally defines the symbol XENIX, which alerts
1118 the C program that it runs under Xenix.
1119
d7418ba7 1120db_hashtype (i_db.U):
1121 This variable contains the type of the hash structure element
1122 in the <db.h> header file. In older versions of DB, it was
1123 int, while in newer ones it is u_int32_t.
1124
1125db_prefixtype (i_db.U):
1126 This variable contains the type of the prefix structure element
1127 in the <db.h> header file. In older versions of DB, it was
1128 int, while in newer ones it is size_t.
1129
1130direntrytype (i_dirent.U):
1131 This symbol is set to 'struct direct' or 'struct dirent' depending on
1132 whether dirent is available or not. You should use this pseudo type to
1133 portably declare your directory entries.
1134
1135dlext (dlext.U):
1136 This variable contains the extension that is to be used for the
1137 dynamically loaded modules that perl generaties.
1138
1139dlsrc (dlsrc.U):
1140 This variable contains the name of the dynamic loading file that
1141 will be used with the package.
1142
693762b4 1143doublesize (doublesize.U):
1144 This variable contains the value of the DOUBLESIZE symbol, which
1145 indicates to the C program how many bytes there are in a double.
1146
d7418ba7 1147dynamic_ext (Extensions.U):
1148 This variable holds a list of extension files we want to
1149 link dynamically into the package. It is used by Makefile.
1150
1151eagain (nblock_io.U):
1152 This variable bears the symbolic errno code set by read() when no
1153 data is present on the file and non-blocking I/O was enabled (otherwise,
1154 read() blocks naturally).
1155
1156eunicefix (Init.U):
1157 When running under Eunice this variable contains a command which will
1158 convert a shell script to the proper form of text file for it to be
1159 executable by the shell. On other systems it is a no-op.
1160
1161exe_ext (Unix.U):
dfe9444c 1162 This is an old synonym for _exe.
1163
1164extensions (Extensions.U):
1165 This variable holds a list of all extension files
1166 linked into the package. It is propagated to Config.pm
1167 and is typically used to test whether a particular extesion
1168 is available.
d7418ba7 1169
1170firstmakefile (Unix.U):
1171 This variable defines the first file searched by make. On unix,
1172 it is makefile (then Makefile). On case-insensitive systems,
1173 it might be something else. This is only used to deal with
1174 convoluted make depend tricks.
1175
1176fpostype (fpostype.U):
1177 This variable defines Fpos_t to be something like fpost_t, long,
1178 uint, or whatever type is used to declare file positions in libc.
1179
1180freetype (mallocsrc.U):
1181 This variable contains the return type of free(). It is usually
1182 void, but occasionally int.
1183
1184full_csh (d_csh.U):
1185 This variable contains the full pathname to 'csh', whether or
1186 not the user has specified 'portability'. This is only used
1187 in the compiled C program, and we assume that all systems which
1188 can share this executable will have the same full pathname to
1189 'csh.'
1190
1191full_sed (Loc_sed.U):
1192 This variable contains the full pathname to 'sed', whether or
1193 not the user has specified 'portability'. This is only used
1194 in the compiled C program, and we assume that all systems which
1195 can share this executable will have the same full pathname to
1196 'sed.'
1197
dfe9444c 1198gccversion (cc.U):
1199 If GNU cc (gcc) is used, this variable holds '1' or '2' to
1200 indicate whether the compiler is version 1 or 2. This is used in
1201 setting some of the default cflags. It is set to '' if not gcc.
1202
d7418ba7 1203gidtype (gidtype.U):
1204 This variable defines Gid_t to be something like gid_t, int,
1205 ushort, or whatever type is used to declare the return type
1206 of getgid(). Typically, it is the type of group ids in the kernel.
1207
dfe9444c 1208groupcat (nis.U):
1209 This variable contains a command that produces the text of the
1210 /etc/group file. This is normally "cat /etc/group", but can be
1211 "ypcat group" when NIS is used.
1212
d7418ba7 1213groupstype (groupstype.U):
1214 This variable defines Groups_t to be something like gid_t, int,
1215 ushort, or whatever type is used for the second argument to
dfe9444c 1216 getgroups() and setgroups(). Usually, this is the same as
1217 gidtype (gid_t), but sometimes it isn't.
1218
1219h_fcntl (h_fcntl.U):
1220 This is variable gets set in various places to tell i_fcntl that
1221 <fcntl.h> should be included.
1222
1223h_sysfile (h_sysfile.U):
1224 This is variable gets set in various places to tell i_sys_file that
1225 <sys/file.h> should be included.
1226
1227hint (Oldconfig.U):
1228 Gives the type of hints used for previous answers. May be one of
1229 "default", "recommended" or "previous".
1230
1231hostcat (nis.U):
1232 This variable contains a command that produces the text of the
1233 /etc/hosts file. This is normally "cat /etc/hosts", but can be
1234 "ypcat hosts" when NIS is used.
1235
1236huge (models.U):
1237 This variable contains a flag which will tell the C compiler and loader
1238 to produce a program running with a huge memory model. If the
1239 huge model is not supported, contains the flag to produce large
1240 model programs. It is up to the Makefile to use this.
1241
1242i_bsdioctl (i_sysioctl.U):
1243 This variable conditionally defines the I_SYS_BSDIOCTL symbol, which
1244 indicates to the C program that <sys/bsdioctl.h> exists and should
1245 be included.
1246
1247i_db (i_db.U):
1248 This variable conditionally defines the I_DB symbol, and indicates
1249 whether a C program may include Berkeley's DB include file <db.h>.
d7418ba7 1250
dc45a647 1251i_dbm (i_dbm.U):
1252 This variable conditionally defines the I_DBM symbol, which
1253 indicates to the C program that <dbm.h> exists and should
1254 be included.
1255
d7418ba7 1256i_dirent (i_dirent.U):
1257 This variable conditionally defines I_DIRENT, which indicates
1258 to the C program that it should include <dirent.h>.
1259
dfe9444c 1260i_dld (i_dld.U):
1261 This variable conditionally defines the I_DLD symbol, which
1262 indicates to the C program that <dld.h> (GNU dynamic loading)
1263 exists and should be included.
1264
d7418ba7 1265i_dlfcn (i_dlfcn.U):
1266 This variable conditionally defines the I_DLFCN symbol, which
1267 indicates to the C program that <dlfcn.h> exists and should
1268 be included.
1269
1270i_fcntl (i_fcntl.U):
1271 This variable controls the value of I_FCNTL (which tells
1272 the C program to include <fcntl.h>).
1273
1274i_float (i_float.U):
1275 This variable conditionally defines the I_FLOAT symbol, and indicates
1276 whether a C program may include <float.h> to get symbols like DBL_MAX
1277 or DBL_MIN, i.e. machine dependent floating point values.
1278
dc45a647 1279i_gdbm (i_gdbm.U):
1280 This variable conditionally defines the I_GDBM symbol, which
1281 indicates to the C program that <gdbm.h> exists and should
1282 be included.
1283
d7418ba7 1284i_grp (i_grp.U):
1285 This variable conditionally defines the I_GRP symbol, and indicates
1286 whether a C program should include <grp.h>.
1287
1288i_limits (i_limits.U):
1289 This variable conditionally defines the I_LIMITS symbol, and indicates
1290 whether a C program may include <limits.h> to get symbols like WORD_BIT
1291 and friends.
1292
1293i_locale (i_locale.U):
1294 This variable conditionally defines the I_LOCALE symbol,
1295 and indicates whether a C program should include <locale.h>.
1296
dfe9444c 1297i_malloc (i_malloc.U):
1298 This variable conditionally defines the I_MALLOC symbol, and indicates
1299 whether a C program should include <malloc.h>.
1300
d7418ba7 1301i_math (i_math.U):
1302 This variable conditionally defines the I_MATH symbol, and indicates
1303 whether a C program may include <math.h>.
1304
1305i_memory (i_memory.U):
1306 This variable conditionally defines the I_MEMORY symbol, and indicates
1307 whether a C program should include <memory.h>.
1308
dc45a647 1309i_ndbm (i_ndbm.U):
1310 This variable conditionally defines the I_NDBM symbol, which
1311 indicates to the C program that <ndbm.h> exists and should
1312 be included.
1313
dfe9444c 1314i_netdb (i_netdb.U):
1315 This variable conditionally defines the I_NETDB symbol, and indicates
1316 whether a C program should include <netdb.h>.
1317
d7418ba7 1318i_neterrno (i_neterrno.U):
1319 This variable conditionally defines the I_NET_ERRNO symbol, which
1320 indicates to the C program that <net/errno.h> exists and should
1321 be included.
1322
1323i_niin (i_niin.U):
1324 This variable conditionally defines I_NETINET_IN, which indicates
1325 to the C program that it should include <netinet/in.h>. Otherwise,
1326 you may try <sys/in.h>.
1327
1328i_pwd (i_pwd.U):
1329 This variable conditionally defines I_PWD, which indicates
1330 to the C program that it should include <pwd.h>.
1331
1332i_rpcsvcdbm (i_dbm.U):
1333 This variable conditionally defines the I_RPCSVC_DBM symbol, which
1334 indicates to the C program that <rpcsvc/dbm.h> exists and should
1335 be included. Some System V systems might need this instead of <dbm.h>.
1336
1337i_sfio (i_sfio.U):
1338 This variable conditionally defines the I_SFIO symbol,
1339 and indicates whether a C program should include <sfio.h>.
1340
1341i_sgtty (i_termio.U):
1342 This variable conditionally defines the I_SGTTY symbol, which
1343 indicates to the C program that it should include <sgtty.h> rather
1344 than <termio.h>.
1345
1346i_stdarg (i_varhdr.U):
1347 This variable conditionally defines the I_STDARG symbol, which
1348 indicates to the C program that <stdarg.h> exists and should
1349 be included.
1350
1351i_stddef (i_stddef.U):
1352 This variable conditionally defines the I_STDDEF symbol, which
1353 indicates to the C program that <stddef.h> exists and should
1354 be included.
1355
1356i_stdlib (i_stdlib.U):
1357 This variable conditionally defines the I_STDLIB symbol, which
1358 indicates to the C program that <stdlib.h> exists and should
1359 be included.
1360
1361i_string (i_string.U):
1362 This variable conditionally defines the I_STRING symbol, which
1363 indicates that <string.h> should be included rather than <strings.h>.
1364
1365i_sysdir (i_sysdir.U):
1366 This variable conditionally defines the I_SYS_DIR symbol, and indicates
1367 whether a C program should include <sys/dir.h>.
1368
1369i_sysfile (i_sysfile.U):
1370 This variable conditionally defines the I_SYS_FILE symbol, and indicates
1371 whether a C program should include <sys/file.h> to get R_OK and friends.
1372
dfe9444c 1373i_sysfilio (i_sysioctl.U):
1374 This variable conditionally defines the I_SYS_FILIO symbol, which
1375 indicates to the C program that <sys/filio.h> exists and should
1376 be included in preference to <sys/ioctl.h>.
1377
1378i_sysin (i_niin.U):
1379 This variable conditionally defines I_SYS_IN, which indicates
1380 to the C program that it should include <sys/in.h> instead of
1381 <netinet/in.h>.
1382
d7418ba7 1383i_sysioctl (i_sysioctl.U):
1384 This variable conditionally defines the I_SYS_IOCTL symbol, which
1385 indicates to the C program that <sys/ioctl.h> exists and should
1386 be included.
1387
1388i_sysndir (i_sysndir.U):
1389 This variable conditionally defines the I_SYS_NDIR symbol, and indicates
1390 whether a C program should include <sys/ndir.h>.
1391
1392i_sysparam (i_sysparam.U):
1393 This variable conditionally defines the I_SYS_PARAM symbol, and indicates
1394 whether a C program should include <sys/param.h>.
1395
1396i_sysresrc (i_sysresrc.U):
1397 This variable conditionally defines the I_SYS_RESOURCE symbol,
1398 and indicates whether a C program should include <sys/resource.h>.
1399
1400i_sysselct (i_sysselct.U):
1401 This variable conditionally defines I_SYS_SELECT, which indicates
1402 to the C program that it should include <sys/select.h> in order to
1403 get the definition of struct timeval.
1404
dfe9444c 1405i_syssockio (i_sysioctl.U):
1406 This variable conditionally defines I_SYS_SOCKIO to indicate to the
1407 C program that socket ioctl codes may be found in <sys/sockio.h>
1408 instead of <sys/ioctl.h>.
1409
d7418ba7 1410i_sysstat (i_sysstat.U):
1411 This variable conditionally defines the I_SYS_STAT symbol,
1412 and indicates whether a C program should include <sys/stat.h>.
1413
1414i_systime (i_time.U):
1415 This variable conditionally defines I_SYS_TIME, which indicates
1416 to the C program that it should include <sys/time.h>.
1417
1418i_systimek (i_time.U):
1419 This variable conditionally defines I_SYS_TIME_KERNEL, which
1420 indicates to the C program that it should include <sys/time.h>
1421 with KERNEL defined.
1422
1423i_systimes (i_systimes.U):
1424 This variable conditionally defines the I_SYS_TIMES symbol, and indicates
1425 whether a C program should include <sys/times.h>.
1426
1427i_systypes (i_systypes.U):
1428 This variable conditionally defines the I_SYS_TYPES symbol,
1429 and indicates whether a C program should include <sys/types.h>.
1430
1431i_sysun (i_sysun.U):
1432 This variable conditionally defines I_SYS_UN, which indicates
1433 to the C program that it should include <sys/un.h> to get UNIX
1434 domain socket definitions.
1435
1436i_syswait (i_syswait.U):
1437 This variable conditionally defines I_SYS_WAIT, which indicates
1438 to the C program that it should include <sys/wait.h>.
1439
1440i_termio (i_termio.U):
1441 This variable conditionally defines the I_TERMIO symbol, which
1442 indicates to the C program that it should include <termio.h> rather
1443 than <sgtty.h>.
1444
1445i_termios (i_termio.U):
1446 This variable conditionally defines the I_TERMIOS symbol, which
1447 indicates to the C program that the POSIX <termios.h> file is
1448 to be included.
1449
1450i_time (i_time.U):
1451 This variable conditionally defines I_TIME, which indicates
1452 to the C program that it should include <time.h>.
1453
1454i_unistd (i_unistd.U):
1455 This variable conditionally defines the I_UNISTD symbol, and indicates
1456 whether a C program should include <unistd.h>.
1457
1458i_utime (i_utime.U):
1459 This variable conditionally defines the I_UTIME symbol, and indicates
1460 whether a C program should include <utime.h>.
1461
1462i_values (i_values.U):
1463 This variable conditionally defines the I_VALUES symbol, and indicates
1464 whether a C program may include <values.h> to get symbols like MAXLONG
1465 and friends.
1466
1467i_varargs (i_varhdr.U):
1468 This variable conditionally defines I_VARARGS, which indicates
1469 to the C program that it should include <varargs.h>.
1470
1471i_varhdr (i_varhdr.U):
1472 Contains the name of the header to be included to get va_dcl definition.
1473 Typically one of varargs.h or stdarg.h.
1474
1475i_vfork (i_vfork.U):
1476 This variable conditionally defines the I_VFORK symbol, and indicates
1477 whether a C program should include vfork.h.
1478
dfe9444c 1479incpath (usrinc.U):
1480 This variable must preceed the normal include path to get hte
1481 right one, as in "$incpath/usr/include" or "$incpath/usr/lib".
1482 Value can be "" or "/bsd43" on mips.
1483
1484installarchlib (archlib.U):
1485 This variable is really the same as archlibexp but may differ on
1486 those systems using AFS. For extra portability, only this variable
1487 should be used in makefiles.
1488
d7418ba7 1489installbin (bin.U):
1490 This variable is the same as binexp unless AFS is running in which case
1491 the user is explicitely prompted for it. This variable should always
1492 be used in your makefiles for maximum portability.
1493
dfe9444c 1494installman1dir (man1dir.U):
1495 This variable is really the same as man1direxp, unless you are using
1496 AFS in which case it points to the read/write location whereas
1497 man1direxp only points to the read-only access location. For extra
1498 portability, you should only use this variable within your makefiles.
1499
1500installman3dir (man3dir.U):
1501 This variable is really the same as man3direxp, unless you are using
1502 AFS in which case it points to the read/write location whereas
1503 man3direxp only points to the read-only access location. For extra
1504 portability, you should only use this variable within your makefiles.
1505
d7418ba7 1506installprivlib (privlib.U):
1507 This variable is really the same as privlibexp but may differ on
1508 those systems using AFS. For extra portability, only this variable
1509 should be used in makefiles.
1510
dfe9444c 1511installscript (scriptdir.U):
1512 This variable is usually the same as scriptdirexp, unless you are on
1513 a system running AFS, in which case they may differ slightly. You
1514 should always use this variable within your makefiles for portability.
1515
1516installsitearch (sitearch.U):
1517 This variable is really the same as sitearchexp but may differ on
1518 those systems using AFS. For extra portability, only this variable
1519 should be used in makefiles.
1520
1521installsitelib (sitelib.U):
1522 This variable is really the same as sitelibexp but may differ on
1523 those systems using AFS. For extra portability, only this variable
1524 should be used in makefiles.
1525
d7418ba7 1526intsize (intsize.U):
dfe9444c 1527 This variable contains the value of the INTSIZE symbol, which
1528 indicates to the C program how many bytes there are in an int.
1529
1530known_extensions (Extensions.U):
1531 This variable holds a list of all extensions included in
1532 the package.
d7418ba7 1533
1534large (models.U):
1535 This variable contains a flag which will tell the C compiler and loader
1536 to produce a program running with a large memory model. It is up to
1537 the Makefile to use this.
1538
1539ld (dlsrc.U):
1540 This variable indicates the program to be used to link
1541 libraries for dynamic loading. On some systems, it is 'ld'.
1542 On ELF systems, it should be $cc. Mostly, we'll try to respect
1543 the hint file setting.
1544
1545lddlflags (dlsrc.U):
1546 This variable contains any special flags that might need to be
1547 passed to $ld to create a shared library suitable for dynamic
1548 loading. It is up to the makefile to use it. For hpux, it
1549 should be -b. For sunos 4.1, it is empty.
1550
1551ldflags (ccflags.U):
1552 This variable contains any additional C loader flags desired by
1553 the user. It is up to the Makefile to use this.
1554
1555lib_ext (Unix.U):
dfe9444c 1556 This is an old synonym for _a.
1557
1558libc (libc.U):
1559 This variable contains the location of the C library.
d7418ba7 1560
1561libperl (libperl.U):
1562 The perl executable is obtained by linking perlmain.c with
1563 libperl, any static extensions (usually just DynaLoader),
1564 and any other libraries needed on this system. libperl
1565 is usually libperl.a, but can also be libperl.so.xxx if
1566 the user wishes to build a perl executable with a shared
1567 library.
1568
dfe9444c 1569libpth (libpth.U):
1570 This variable holds the general path used to find libraries. It is
1571 intended to be used by other units.
1572
d7418ba7 1573libs (libs.U):
1574 This variable holds the additional libraries we want to use.
1575 It is up to the Makefile to deal with it.
1576
dfe9444c 1577libswanted (Myinit.U):
1578 This variable holds a list of all the libraries we want to
1579 search. The order is chosen to pick up the c library
1580 ahead of ucb or bsd libraries for SVR4.
1581
1582lkflags (ccflags.U):
1583 This variable contains any additional C partial linker flags desired by
1584 the user. It is up to the Makefile to use this.
1585
d7418ba7 1586lns (lns.U):
1587 This variable holds the name of the command to make
1588 symbolic links (if they are supported). It can be used
1589 in the Makefile. It is either 'ln -s' or 'ln'
1590
dfe9444c 1591locincpth (ccflags.U):
1592 This variable contains a list of additional directories to be
1593 searched by the compiler. The appropriate -I directives will
1594 be added to ccflags. This is intended to simplify setting
1595 local directories from the Configure command line.
1596 It's not much, but it parallels the loclibpth stuff in libpth.U.
1597
1598loclibpth (libpth.U):
1599 This variable holds the paths used to find local libraries. It is
1600 prepended to libpth, and is intended to be easily set from the
1601 command line.
1602
e5c9fcd0 1603longdblsize (d_longdbl.U):
1604 This variable contains the value of the LONG_DOUBLESIZE symbol, which
1605 indicates to the C program how many bytes there are in a long double,
1606 if this system supports long doubles.
1607
dc45a647 1608longlongsize (d_longlong.U):
1609 This variable contains the value of the LONGLONGSIZE symbol, which
1610 indicates to the C program how many bytes there are in a long long,
1611 if this system supports long long.
1612
4fdae800 1613longsize (intsize.U):
dfe9444c 1614 This variable contains the value of the LONGSIZE symbol, which
1615 indicates to the C program how many bytes there are in a long.
4fdae800 1616
d7418ba7 1617lseektype (lseektype.U):
1618 This variable defines lseektype to be something like off_t, long,
1619 or whatever type is used to declare lseek offset's type in the
1620 kernel (which also appears to be lseek's return type).
1621
d7418ba7 1622make_set_make (make.U):
1623 Some versions of 'make' set the variable MAKE. Others do not.
1624 This variable contains the string to be included in Makefile.SH
1625 so that MAKE is set if needed, and not if not needed.
1626 Possible values are:
dfe9444c 1627 make_set_make='#' # If your make program handles this for you,
1628 make_set_make="MAKE=$make" # if it doesn't.
d7418ba7 1629 I used a comment character so that we can distinguish a
1630 'set' value (from a previous config.sh or Configure -D option)
1631 from an uncomputed value.
1632
1633mallocobj (mallocsrc.U):
1634 This variable contains the name of the malloc.o that this package
1635 generates, if that malloc.o is preferred over the system malloc.
1636 Otherwise the value is null. This variable is intended for generating
1637 Makefiles. See mallocsrc.
1638
1639mallocsrc (mallocsrc.U):
1640 This variable contains the name of the malloc.c that comes with
1641 the package, if that malloc.c is preferred over the system malloc.
1642 Otherwise the value is null. This variable is intended for generating
1643 Makefiles.
1644
1645malloctype (mallocsrc.U):
1646 This variable contains the kind of ptr returned by malloc and realloc.
1647
1648man1dir (man1dir.U):
1649 This variable contains the name of the directory in which manual
1650 source pages are to be put. It is the responsibility of the
1651 Makefile.SH to get the value of this into the proper command.
1652 You must be prepared to do the ~name expansion yourself.
1653
dfe9444c 1654man1direxp (man1dir.U):
1655 This variable is the same as the man1dir variable, but is filename
1656 expanded at configuration time, for convenient use in makefiles.
1657
d7418ba7 1658man1ext (man1dir.U):
1659 This variable contains the extension that the manual page should
1660 have: one of 'n', 'l', or '1'. The Makefile must supply the '.'.
1661 See man1dir.
1662
1663man3dir (man3dir.U):
1664 This variable contains the name of the directory in which manual
1665 source pages are to be put. It is the responsibility of the
1666 Makefile.SH to get the value of this into the proper command.
1667 You must be prepared to do the ~name expansion yourself.
1668
dfe9444c 1669man3direxp (man3dir.U):
1670 This variable is the same as the man3dir variable, but is filename
1671 expanded at configuration time, for convenient use in makefiles.
1672
d7418ba7 1673man3ext (man3dir.U):
1674 This variable contains the extension that the manual page should
1675 have: one of 'n', 'l', or '3'. The Makefile must supply the '.'.
1676 See man3dir.
1677
dfe9444c 1678medium (models.U):
1679 This variable contains a flag which will tell the C compiler and loader
1680 to produce a program running with a medium memory model. If the
1681 medium model is not supported, contains the flag to produce large
1682 model programs. It is up to the Makefile to use this.
1683
1684mips_type (usrinc.U):
1685 This variable holds the environment type for the mips system.
1686 Possible values are "BSD 4.3" and "System V".
1687
1688models (models.U):
1689 This variable contains the list of memory models supported by this
1690 system. Possible component values are none, split, unsplit, small,
1691 medium, large, and huge. The component values are space separated.
1692
d7418ba7 1693modetype (modetype.U):
1694 This variable defines modetype to be something like mode_t,
1695 int, unsigned short, or whatever type is used to declare file
1696 modes for system calls.
1697
dfe9444c 1698myarchname (archname.U):
1699 This variable holds the architecture name computed by Configure in
1700 a previous run. It is not intended to be perused by any user and
1701 should never be set in a hint file.
1702
1703mydomain (myhostname.U):
1704 This variable contains the eventual value of the MYDOMAIN symbol,
1705 which is the domain of the host the program is going to run on.
1706 The domain must be appended to myhostname to form a complete host name.
1707 The dot comes with mydomain, and need not be supplied by the program.
1708
dc45a647 1709myhostname (myhostname.U):
1710 This variable contains the eventual value of the MYHOSTNAME symbol,
1711 which is the name of the host the program is going to run on.
1712 The domain is not kept with hostname, but must be gotten from mydomain.
1713 The dot comes with mydomain, and need not be supplied by the program.
1714
dfe9444c 1715myuname (Oldconfig.U):
1716 The output of 'uname -a' if available, otherwise the hostname. On Xenix,
1717 pseudo variables assignments in the output are stripped, thank you. The
1718 whole thing is then lower-cased.
1719
d7418ba7 1720n (n.U):
1721 This variable contains the -n flag if that is what causes the echo
1722 command to suppress newline. Otherwise it is null. Correct usage is
1723 $echo $n "prompt for a question: $c".
1724
dfe9444c 1725netdb_hlen_type (netdbtype.U):
1726 This variable holds the type used for the 2nd argument to
1727 gethostbyaddr(). Usually, this is int or size_t or unsigned.
1728 This is only useful if you have gethostbyaddr(), naturally.
1729
1730netdb_host_type (netdbtype.U):
1731 This variable holds the type used for the 1st argument to
1732 gethostbyaddr(). Usually, this is char * or void *, possibly
1733 with or without a const prefix.
1734 This is only useful if you have gethostbyaddr(), naturally.
1735
1736netdb_name_type (netdbtype.U):
1737 This variable holds the type used for the argument to
1738 gethostbyname(). Usually, this is char * or const char *.
1739 This is only useful if you have gethostbyname(), naturally.
1740
1741netdb_net_type (netdbtype.U):
1742 This variable holds the type used for the 1st argument to
1743 getnetbyaddr(). Usually, this is int or long.
1744 This is only useful if you have getnetbyaddr(), naturally.
1745
1746nm_opt (usenm.U):
1747 This variable holds the options that may be necessary for nm.
1748
1749nm_so_opt (usenm.U):
1750 This variable holds the options that may be necessary for nm
1751 to work on a shared library but that can not be used on an
1752 archive library. Currently, this is only used by Linux, where
1753 nm --dynamic is *required* to get symbols from an ELF library which
1754 has been stripped, but nm --dynamic is *fatal* on an archive library.
1755 Maybe Linux should just always set usenm=false.
1756
d7418ba7 1757o_nonblock (nblock_io.U):
1758 This variable bears the symbol value to be used during open() or fcntl()
1759 to turn on non-blocking I/O for a file descriptor. If you wish to switch
1760 between blocking and non-blocking, you may try ioctl(FIOSNBIO) instead,
1761 but that is only supported by some devices.
1762
dfe9444c 1763obj_ext (Unix.U):
1764 This is an old synonym for _o.
d7418ba7 1765
1766optimize (ccflags.U):
1767 This variable contains any optimizer/debugger flag that should be used.
1768 It is up to the Makefile to use it.
1769
dfe9444c 1770orderlib (orderlib.U):
1771 This variable is "true" if the components of libraries must be ordered
1772 (with `lorder $* | tsort`) before placing them in an archive. Set to
1773 "false" if ranlib or ar can generate random libraries.
1774
d7418ba7 1775osname (Oldconfig.U):
1776 This variable contains the operating system name (e.g. sunos,
1777 solaris, hpux, etc.). It can be useful later on for setting
1778 defaults. Any spaces are replaced with underscores. It is set
1779 to a null string if we can't figure it out.
1780
dfe9444c 1781osvers (Oldconfig.U):
1782 This variable contains the operating system version (e.g.
1783 4.1.3, 5.2, etc.). It is primarily used for helping select
1784 an appropriate hints file, but might be useful elsewhere for
1785 setting defaults. It is set to '' if we can't figure it out.
1786 We try to be flexible about how much of the version number
1787 to keep, e.g. if 4.1.1, 4.1.2, and 4.1.3 are essentially the
1788 same for this package, hints files might just be os_4.0 or
1789 os_4.1, etc., not keeping separate files for each little release.
1790
1791package (package.U):
1792 This variable contains the name of the package being constructed.
1793 It is primarily intended for the use of later Configure units.
1794
d7418ba7 1795pager (pager.U):
1796 This variable contains the name of the preferred pager on the system.
1797 Usual values are (the full pathnames of) more, less, pg, or cat.
1798
dfe9444c 1799passcat (nis.U):
1800 This variable contains a command that produces the text of the
1801 /etc/passwd file. This is normally "cat /etc/passwd", but can be
1802 "ypcat passwd" when NIS is used.
1803
1804patchlevel (patchlevel.U):
1805 The patchlevel level of this package.
1806 The value of patchlevel comes from the patchlevel.h file.
1807
d7418ba7 1808path_sep (Unix.U):
dfe9444c 1809 This is an old synonym for p_ in Head.U, the character
1810 used to separate elements in the command shell search PATH.
d7418ba7 1811
1812perladmin (perladmin.U):
1813 Electronic mail address of the perl5 administrator.
1814
7e1af8bc 1815perlpath (perlpath.U):
1816 This variable contains the eventual value of the PERLPATH symbol,
1817 which contains the name of the perl interpreter to be used in
1818 shell scripts and in the "eval 'exec'" idiom.
1819
dfe9444c 1820phostname (myhostname.U):
1821 This variable contains the eventual value of the PHOSTNAME symbol,
1822 which is a command that can be fed to popen() to get the host name.
1823 The program should probably not presume that the domain is or isn't
1824 there already.
1825
1826pidtype (pidtype.U):
1827 This variable defines PIDTYPE to be something like pid_t, int,
1828 ushort, or whatever type is used to declare process ids in the kernel.
1829
1830plibpth (libpth.U):
1831 Holds the private path used by Configure to find out the libraries.
1832 Its value is prepend to libpth. This variable takes care of special
1833 machines, like the mips. Usually, it should be empty.
1834
d7418ba7 1835prefix (prefix.U):
1836 This variable holds the name of the directory below which the
1837 user will install the package. Usually, this is /usr/local, and
1838 executables go in /usr/local/bin, library stuff in /usr/local/lib,
1839 man pages in /usr/local/man, etc. It is only used to set defaults
1840 for things in bin.U, mansrc.U, privlib.U, or scriptdir.U.
1841
dfe9444c 1842prefixexp (prefix.U):
1843 This variable holds the full absolute path of the directory below
1844 which the user will install the package. Derived from prefix.
1845
d7418ba7 1846privlib (privlib.U):
1847 This variable contains the eventual value of the PRIVLIB symbol,
1848 which is the name of the private library for this package. It may
1849 have a ~ on the front. It is up to the makefile to eventually create
1850 this directory while performing installation (with ~ substitution).
1851
1852privlibexp (privlib.U):
1853 This variable is the ~name expanded version of privlib, so that you
1854 may use it directly in Makefiles or shell scripts.
1855
1856prototype (prototype.U):
1857 This variable holds the eventual value of CAN_PROTOTYPE, which
1858 indicates the C compiler can handle funciton prototypes.
1859
693762b4 1860ptrsize (ptrsize.U):
1861 This variable contains the value of the PTRSIZE symbol, which
1862 indicates to the C program how many bytes there are in a pointer.
1863
d7418ba7 1864randbits (randbits.U):
1865 This variable contains the eventual value of the RANDBITS symbol,
1866 which indicates to the C program how many bits of random number
1867 the rand() function produces.
1868
1869ranlib (orderlib.U):
1870 This variable is set to the pathname of the ranlib program, if it is
1871 needed to generate random libraries. Set to ":" if ar can generate
1872 random libraries or if random libraries are not supported
1873
1874rd_nodata (nblock_io.U):
1875 This variable holds the return code from read() when no data is
1876 present. It should be -1, but some systems return 0 when O_NDELAY is
1877 used, which is a shame because you cannot make the difference between
1878 no data and an EOF.. Sigh!
1879
dfe9444c 1880runnm (usenm.U):
1881 This variable contains 'true' or 'false' depending whether the
1882 nm extraction should be performed or not, according to the value
1883 of usenm and the flags on the Configure command line.
1884
d7418ba7 1885scriptdir (scriptdir.U):
1886 This variable holds the name of the directory in which the user wants
1887 to put publicly scripts for the package in question. It is either
1888 the same directory as for binaries, or a special one that can be
1889 mounted across different architectures, like /usr/share. Programs
1890 must be prepared to deal with ~name expansion.
1891
dfe9444c 1892scriptdirexp (scriptdir.U):
1893 This variable is the same as scriptdir, but is filename expanded
1894 at configuration time, for programs not wanting to bother with it.
1895
d7418ba7 1896selecttype (selecttype.U):
1897 This variable holds the type used for the 2nd, 3rd, and 4th
1898 arguments to select. Usually, this is 'fd_set *', if HAS_FD_SET
1899 is defined, and 'int *' otherwise. This is only useful if you
1900 have select(), naturally.
1901
1902sh (sh.U):
1903 This variable contains the full pathname of the shell used
1904 on this system to execute Bourne shell scripts. Usually, this will be
1905 /bin/sh, though it's possible that some systems will have /bin/ksh,
bb14ff96 1906 /bin/pdksh, /bin/ash, /bin/bash, or even something such as
1907 D:/bin/sh.exe.
d7418ba7 1908 This unit comes before Options.U, so you can't set sh with a -D
1909 option, though you can override this (and startsh)
1910 with -O -Dsh=/bin/whatever -Dstartsh=whatever
1911
dfe9444c 1912sharpbang (spitshell.U):
1913 This variable contains the string #! if this system supports that
1914 construct.
1915
d7418ba7 1916shmattype (d_shmat.U):
1917 This symbol contains the type of pointer returned by shmat().
1918 It can be 'void *' or 'char *'.
1919
4fdae800 1920shortsize (intsize.U):
dfe9444c 1921 This variable contains the value of the SHORTSIZE symbol which
1922 indicates to the C program how many bytes there are in a short.
4fdae800 1923
c43cd16b 1924shrpenv (libperl.U):
1925 If the user builds a shared libperl.so, then we need to tell the
1926 'perl' executable where it will be able to find the installed libperl.so.
1927 One way to do this on some systems is to set the environment variable
1928 LD_RUN_PATH to the directory that will be the final location of the
1929 shared libperl.so. The makefile can use this with something like
1930 $shrpenv $(CC) -o perl perlmain.o $libperl $libs
1931 Typical values are
1932 shrpenv="env LD_RUN_PATH=$archlibexp/CORE"
1933 or
1934 shrpenv=''
1935 See the main perl Makefile.SH for actual working usage.
1936 Alternatively, we might be able to use a command line option such
1937 as -R $archlibexp/CORE (Solaris, NetBSD) or -Wl,-rpath
1938 $archlibexp/CORE (Linux).
1939
dfe9444c 1940shsharp (spitshell.U):
1941 This variable tells further Configure units whether your sh can
1942 handle # comments.
1943
d7418ba7 1944sig_name (sig_name.U):
1945 This variable holds the signal names, space separated. The leading
dfe9444c 1946 SIG in signal name is removed. A ZERO is prepended to the
1947 list. This is currently not used.
1948
1949sig_name_init (sig_name.U):
1950 This variable holds the signal names, enclosed in double quotes and
1951 separated by commas, suitable for use in the SIG_NAME definition
1952 below. A "ZERO" is prepended to the list, and the list is
1953 terminated with a plain 0. The leading SIG in signal names
1954 is removed. See sig_num.
d7418ba7 1955
1956sig_num (sig_name.U):
dfe9444c 1957 This variable holds the signal numbers, comma separated. A 0 is
1958 prepended to the list (corresponding to the fake SIGZERO), and
1959 the list is terminated with a 0. Those numbers correspond to
1960 the value of the signal listed in the same place within the
1961 sig_name list.
d7418ba7 1962
1963signal_t (d_voidsig.U):
1964 This variable holds the type of the signal handler (void or int).
1965
1966sitearch (sitearch.U):
1967 This variable contains the eventual value of the SITEARCH symbol,
1968 which is the name of the private library for this package. It may
1969 have a ~ on the front. It is up to the makefile to eventually create
1970 this directory while performing installation (with ~ substitution).
1971
1972sitearchexp (sitearch.U):
1973 This variable is the ~name expanded version of sitearch, so that you
1974 may use it directly in Makefiles or shell scripts.
1975
1976sitelib (sitelib.U):
1977 This variable contains the eventual value of the SITELIB symbol,
1978 which is the name of the private library for this package. It may
1979 have a ~ on the front. It is up to the makefile to eventually create
1980 this directory while performing installation (with ~ substitution).
1981
1982sitelibexp (sitelib.U):
1983 This variable is the ~name expanded version of sitelib, so that you
1984 may use it directly in Makefiles or shell scripts.
1985
1986sizetype (sizetype.U):
1987 This variable defines sizetype to be something like size_t,
1988 unsigned long, or whatever type is used to declare length
1989 parameters for string functions.
1990
1991small (models.U):
1992 This variable contains a flag which will tell the C compiler and loader
1993 to produce a program running with a small memory model. It is up to
1994 the Makefile to use this.
1995
dfe9444c 1996so (so.U):
1997 This variable holds the extension used to identify shared libraries
1998 (also known as shared objects) on the system. Usually set to 'so'.
1999
2000sockethdr (d_socket.U):
2001 This variable has any cpp -I flags needed for socket support.
2002
2003socketlib (d_socket.U):
2004 This variable has the names of any libraries needed for socket support.
2005
2006spackage (package.U):
2007 This variable contains the name of the package being constructed,
2008 with the first letter uppercased, i.e. suitable for starting
2009 sentences.
2010
d7418ba7 2011spitshell (spitshell.U):
2012 This variable contains the command necessary to spit out a runnable
2013 shell on this system. It is either cat or a grep -v for # comments.
2014
2015split (models.U):
2016 This variable contains a flag which will tell the C compiler and loader
2017 to produce a program that will run in separate I and D space, for those
2018 machines that support separation of instruction and data space. It is
2019 up to the Makefile to use this.
2020
dc45a647 2021src (src.U):
2022 This variable holds the path to the package source. It is up to
2023 the Makefile to use this variable and set VPATH accordingly to
2024 find the sources remotely.
2025
d7418ba7 2026ssizetype (ssizetype.U):
2027 This variable defines ssizetype to be something like ssize_t,
2028 long or int. It is used by functions that return a count
2029 of bytes or an error condition. It must be a signed type.
2030 We will pick a type such that sizeof(SSize_t) == sizeof(Size_t).
2031
2032startperl (startperl.U):
2033 This variable contains the string to put on the front of a perl
2034 script to make sure (hopefully) that it runs with perl and not some
2035 shell. Of course, that leading line must be followed by the classical
2036 perl idiom:
dfe9444c 2037 eval 'exec perl -S $0 ${1+"$@"}'
d7418ba7 2038 if $running_under_some_shell;
2039 to guarantee perl startup should the shell execute the script. Note
2040 that this magic incatation is not understood by csh.
2041
2042startsh (startsh.U):
2043 This variable contains the string to put on the front of a shell
2044 script to make sure (hopefully) that it runs with sh and not some
2045 other shell.
2046
2047static_ext (Extensions.U):
2048 This variable holds a list of extension files we want to
2049 link statically into the package. It is used by Makefile.
2050
2051stdchar (stdchar.U):
2052 This variable conditionally defines STDCHAR to be the type of char
2053 used in stdio.h. It has the values "unsigned char" or "char".
2054
dfe9444c 2055stdio_base (d_stdstdio.U):
2056 This variable defines how, given a FILE pointer, fp, to access the
2057 _base field (or equivalent) of stdio.h's FILE structure. This will
2058 be used to define the macro FILE_base(fp).
2059
2060stdio_bufsiz (d_stdstdio.U):
2061 This variable defines how, given a FILE pointer, fp, to determine
2062 the number of bytes store in the I/O buffer pointer to by the
2063 _base field (or equivalent) of stdio.h's FILE structure. This will
2064 be used to define the macro FILE_bufsiz(fp).
2065
2066stdio_cnt (d_stdstdio.U):
2067 This variable defines how, given a FILE pointer, fp, to access the
2068 _cnt field (or equivalent) of stdio.h's FILE structure. This will
2069 be used to define the macro FILE_cnt(fp).
2070
2071stdio_filbuf (d_stdstdio.U):
2072 This variable defines how, given a FILE pointer, fp, to tell
2073 stdio to refill it's internal buffers (?). This will
2074 be used to define the macro FILE_filbuf(fp).
2075
2076stdio_ptr (d_stdstdio.U):
2077 This variable defines how, given a FILE pointer, fp, to access the
2078 _ptr field (or equivalent) of stdio.h's FILE structure. This will
2079 be used to define the macro FILE_ptr(fp).
2080
2081strings (i_string.U):
2082 This variable holds the full path of the string header that will be
2083 used. Typically /usr/include/string.h or /usr/include/strings.h.
2084
2085subversion (patchlevel.U):
2086 The subversion level of this package.
2087 The value of subversion comes from the patchlevel.h file.
2088 This is unique to perl.
2089
2090sysman (sysman.U):
2091 This variable holds the place where the manual is located on this
2092 system. It is not the place where the user wants to put his manual
2093 pages. Rather it is the place where Configure may look to find manual
2094 for unix commands (section 1 of the manual usually). See mansrc.
2095
2096timeincl (i_time.U):
2097 This variable holds the full path of the included time header(s).
2098
d7418ba7 2099timetype (d_time.U):
2100 This variable holds the type returned by time(). It can be long,
2101 or time_t on BSD sites (in which case <sys/types.h> should be
2102 included). Anyway, the type Time_t should be used.
2103
2104uidtype (uidtype.U):
2105 This variable defines Uid_t to be something like uid_t, int,
2106 ushort, or whatever type is used to declare user ids in the kernel.
2107
dfe9444c 2108usedl (dlsrc.U):
2109 This variable indicates if the the system supports dynamic
2110 loading of some sort. See also dlsrc and dlobj.
2111
2112usemymalloc (mallocsrc.U):
2113 This variable contains y if the malloc that comes with this package
2114 is desired over the system's version of malloc. People often include
2115 special versions of malloc for effiency, but such versions are often
2116 less portable. See also mallocsrc and mallocobj.
2117 If this is 'y', then -lmalloc is removed from $libs.
2118
2119usenm (usenm.U):
2120 This variable contains 'true' or 'false' depending whether the
2121 nm extraction is wanted or not.
2122
2123useopcode (Extensions.U):
2124 This variable holds either 'true' or 'false' to indicate
2125 whether the Opcode extension should be used. The sole
2126 use for this currently is to allow an easy mechanism
2127 for users to skip the Opcode extension from the Configure
2128 command line.
2129
d7418ba7 2130useperlio (useperlio.U):
2131 This variable conditionally defines the USE_PERLIO symbol,
2132 and indicates that the PerlIO abstraction should be
2133 used throughout.
2134
dfe9444c 2135useposix (Extensions.U):
2136 This variable holds either 'true' or 'false' to indicate
2137 whether the POSIX extension should be used. The sole
2138 use for this currently is to allow an easy mechanism
2139 for hints files to indicate that POSIX will not compile
2140 on a particular system.
2141
2142usesfio (d_sfio.U):
2143 This variable is set to true when the user agrees to use sfio.
2144 It is set to false when sfio is not available or when the user
2145 explicitely requests not to use sfio. It is here primarily so
2146 that command-line settings can override the auto-detection of
2147 d_sfio without running into a "WHOA THERE".
2148
d7418ba7 2149useshrplib (libperl.U):
2150 This variable is set to 'yes' if the user wishes
2151 to build a shared libperl, and 'no' otherwise.
2152
dfe9444c 2153usethreads (usethreads.U):
2154 This variable conditionally defines the USE_THREADS symbol,
2155 and indicates that Perl should be built to use threads.
2156
2157usevfork (d_vfork.U):
2158 This variable is set to true when the user accepts to use vfork.
2159 It is set to false when no vfork is available or when the user
2160 explicitely requests not to use vfork.
2161
2162usrinc (usrinc.U):
2163 This variable holds the path of the include files, which is
2164 usually /usr/include. It is mainly used by other Configure units.
2165
d7418ba7 2166voidflags (voidflags.U):
2167 This variable contains the eventual value of the VOIDFLAGS symbol,
2168 which indicates how much support of the void type is given by this
2169 compiler. See VOIDFLAGS for more info.
2170