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