This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Automatically call srand() before rand() if user didn't
[perl5.git] / Porting / Glossary
CommitLineData
d7418ba7 1This file contains a description of all the shell variables whose value is
2determined by the Configure script. Variables intended for use in C
3programs (e.g. I_UNISTD) are already described in config_h.SH.
4
5alignbytes (alignbytes.U):
6 This variable holds the number of bytes required to align a
7 double. Usual values are 2, 4 and 8.
8
9ar (Unix.U):
10 This variable defines the command to use to create an archive
11 library. For unix, it is 'ar'.
12
13archlib (archlib.U):
14 This variable holds the name of the directory in which the user wants
15 to put architecture-dependent public library files for $package.
16 It is most often a local directory such as /usr/local/lib.
17 Programs using this variable must be prepared to deal
18 with filename expansion.
19
20archlibexp (archlib.U):
21 This variable is the same as the archlib variable, but is
22 filename expanded at configuration time, for convenient use.
23
24archobjs (Unix.U):
25 This variable defines any additional objects that must be linked
26 in with the program on this architecture. On unix, it is usually
27 empty. It is typically used to include emulations of unix calls
28 or other facilities. For perl on OS/2, for example, this would
29 include os2/os2.obj.
30
31bin (bin.U):
32 This variable holds the name of the directory in which the user wants
33 to put publicly executable images for the package in question. It
34 is most often a local directory such as /usr/local/bin. Programs using
35 this variable must be prepared to deal with ~name substitution.
36
7e1af8bc 37bincompat3 (bincompat3.U):
38 This variable contains y if Perl 5.004 should be binary-compatible
39 with Perl 5.003.
40
d7418ba7 41byteorder (byteorder.U):
42 This variable holds the byte order. In the following, larger digits
43 indicate more significance. The variable byteorder is either 4321
44 on a big-endian machine, or 1234 on a little-endian, or 87654321
45 on a Cray ... or 3412 with weird order !
46
47c (n.U):
48 This variable contains the \c string if that is what causes the echo
49 command to suppress newline. Otherwise it is null. Correct usage is
50 $echo $n "prompt for a question: $c".
51
52castflags (d_castneg.U):
53 This variable contains a flag that precise difficulties the
54 compiler has casting odd floating values to unsigned long:
55 0 = ok
56 1 = couldn't cast < 0
57 2 = couldn't cast >= 0x80000000
58 4 = couldn't cast in argument expression list
59
60cc (cc.U):
61 This variable holds the name of a command to execute a C compiler which
62 can resolve multiple global references that happen to have the same
63 name. Usual values are "cc", "Mcc", "cc -M", and "gcc".
64
65cccdlflags (dlsrc.U):
66 This variable contains any special flags that might need to be
67 passed with cc -c to compile modules to be used to create a shared
68 library that will be used for dynamic loading. For hpux, this
69 should be +z. It is up to the makefile to use it.
70
71ccdlflags (dlsrc.U):
72 This variable contains any special flags that might need to be
73 passed to cc to link with a shared library for dynamic loading.
74 It is up to the makefile to use it. For sunos 4.1, it should
75 be empty.
76
77ccflags (ccflags.U):
78 This variable contains any additional C compiler flags desired by
79 the user. It is up to the Makefile to use this.
80
81cf_by (cf_who.U):
82 Login name of the person who ran the Configure script and answered the
83 questions. This is used to tag both config.sh and config_h.SH.
84
85cf_time (cf_who.U):
86 Holds the output of the "date" command when the configuration file was
87 produced. This is used to tag both config.sh and config_h.SH.
88
89cpp_stuff (cpp_stuff.U):
90 This variable contains an identification of the catenation mechanism
91 used by the C preprocessor.
92
93cppflags (ccflags.U):
94 This variable holds the flags that will be passed to the C pre-
95 processor. It is up to the Makefile to use it.
96
97cppminus (cppstdin.U):
98 This variable contains the second part of the string which will invoke
99 the C preprocessor on the standard input and produce to standard
100 output. This variable will have the value "-" if cppstdin needs a minus
101 to specify standard input, otherwise the value is "".
102
103cppstdin (cppstdin.U):
104 This variable contains the command which will invoke the C
105 preprocessor on standard input and put the output to stdout.
106 It is primarily used by other Configure units that ask about
107 preprocessor symbols.
108
109cryptlib (d_crypt.U):
110 This variable holds -lcrypt or the path to a libcrypt.a archive if
111 the crypt() function is not defined in the standard C library. It is
112 up to the Makefile to use this.
113
114d_Gconvert (d_gconvert.U):
115 This variable holds what Gconvert is defined as to convert
116 floating point numbers into strings. It could be 'gconvert'
117 or a more complex macro emulating gconvert with gcvt() or sprintf.
118
119d_access (d_access.U):
120 This variable conditionally defines HAS_ACCESS if the access() system
121 call is available to check for access permissions using real IDs.
122
123d_alarm (d_alarm.U):
124 This variable conditionally defines the HAS_ALARM symbol, which
125 indicates to the C program that the alarm() routine is available.
126
127d_archlib (archlib.U):
128 This variable conditionally defines ARCHLIB to hold the pathname
129 of architecture-dependent library files for $package. If
130 $archlib is the same as $privlib, then this is set to undef.
131
132d_bcmp (d_bcmp.U):
133 This variable conditionally defines the HAS_BCMP symbol if
134 the bcmp() routine is available to compare strings.
135
136d_bcopy (d_bcopy.U):
137 This variable conditionally defines the HAS_BCOPY symbol if
138 the bcopy() routine is available to copy strings.
139
7e1af8bc 140d_bincompat3 (bincompat3.U):
141 This variable conditionally defines BINCOMPAT3 so that embed.h
142 can take special action if Perl 5.004 should be binary-compatible
143 with Perl 5.003.
144
c43cd16b 145d_bsdgetpgrp (d_getpgrp.U):
146 This variable conditionally defines USE_BSD_GETPGRP if
147 getpgrp needs one arguments whereas USG one needs none.
148
d7418ba7 149d_bsdpgrp (d_setpgrp.U):
150 This variable conditionally defines USE_BSDPGRP if the notion of
151 process group is the BSD one. This means setpgrp needs two arguments
152 whereas USG one needs none.
153
c43cd16b 154d_bsdsetpgrp (d_setpgrp.U):
155 This variable conditionally defines USE_BSD_SETPGRP if
156 setpgrp needs two arguments whereas USG one needs none.
157 See also d_setpgid for a POSIX interface.
158
d7418ba7 159d_bzero (d_bzero.U):
160 This variable conditionally defines the HAS_BZERO symbol if
161 the bzero() routine is available to set memory to 0.
162
163d_casti32 (d_casti32.U):
164 This variable conditionally defines CASTI32, which indicates
165 whether the C compiler can cast large floats to 32-bit ints.
166
167d_castneg (d_castneg.U):
168 This variable conditionally defines CASTNEG, which indicates
169 wether the C compiler can cast negative float to unsigned.
170
171d_charvspr (d_vprintf.U):
172 This variable conditionally defines CHARVSPRINTF if this system
173 has vsprintf returning type (char*). The trend seems to be to
174 declare it as "int vsprintf()".
175
176d_chown (d_chown.U):
177 This variable conditionally defines the HAS_CHOWN symbol, which
178 indicates to the C program that the chown() routine is available.
179
180d_chroot (d_chroot.U):
181 This variable conditionally defines the HAS_CHROOT symbol, which
182 indicates to the C program that the chroot() routine is available.
183
184d_chsize (d_chsize.U):
185 This variable conditionally defines the CHSIZE symbol, which
186 indicates to the C program that the chsize() routine is available
187 to truncate files. You might need a -lx to get this routine.
188
189d_const (d_const.U):
190 This variable conditionally defines the HASCONST symbol, which
191 indicates to the C program that this C compiler knows about the
192 const type.
193
194d_crypt (d_crypt.U):
195 This variable conditionally defines the CRYPT symbol, which
196 indicates to the C program that the crypt() routine is available
197 to encrypt passwords and the like.
198
199d_csh (d_csh.U):
200 This variable conditionally defines the CSH symbol, which
201 indicates to the C program that the C-shell exists.
202
203d_cuserid (d_cuserid.U):
204 This variable conditionally defines the HAS_CUSERID symbol, which
205 indicates to the C program that the cuserid() routine is available
206 to get character login names.
207
208d_dbl_dig (d_dbl_dig.U):
209 This variable conditionally defines d_dbl_dig if this system's
210 header files provide DBL_DIG, which is the number of significant
211 digits in a double precision number.
212
213d_difftime (d_difftime.U):
214 This variable conditionally defines the HAS_DIFFTIME symbol, which
215 indicates to the C program that the difftime() routine is available.
216
217d_dirnamlen (i_dirent.U):
218 This variable conditionally defines DIRNAMLEN, which indicates
219 to the C program that the length of directory entry names is
220 provided by a d_namelen field.
221
222d_dlerror (d_dlerror.U):
223 This variable conditionally defines the HAS_DLERROR symbol, which
224 indicates to the C program that the dlerror() routine is available.
225
226d_dlsymun (d_dlsymun.U):
227 This variable conditionally defines DLSYM_NEEDS_UNDERSCORE, which
228 indicates that we need to prepend an underscore to the symbol
229 name before calling dlsym().
230
231d_dosuid (d_dosuid.U):
232 This variable conditionally defines the symbol DOSUID, which
233 tells the C program that it should insert setuid emulation code
234 on hosts which have setuid #! scripts disabled.
235
236d_dup2 (d_dup2.U):
237 This variable conditionally defines HAS_DUP2 if dup2() is
238 available to duplicate file descriptors.
239
240d_eofnblk (nblock_io.U):
241 This variable conditionally defines EOF_NONBLOCK if EOF can be seen
242 when reading from a non-blocking I/O source.
243
244d_fchmod (d_fchmod.U):
245 This variable conditionally defines the HAS_FCHMOD symbol, which
246 indicates to the C program that the fchmod() routine is available
247 to change mode of opened files.
248
249d_fchown (d_fchown.U):
250 This variable conditionally defines the HAS_FCHOWN symbol, which
251 indicates to the C program that the fchown() routine is available
252 to change ownership of opened files.
253
254d_fcntl (d_fcntl.U):
255 This variable conditionally defines the HAS_FCNTL symbol, and indicates
256 whether the fcntl() function exists
257
258d_fgetpos (d_fgetpos.U):
259 This variable conditionally defines HAS_FGETPOS if fgetpos() is
260 available to get the file position indicator.
261
262d_flexfnam (d_flexfnam.U):
263 This variable conditionally defines the FLEXFILENAMES symbol, which
264 indicates that the system supports filenames longer than 14 characters.
265
266d_flock (d_flock.U):
267 This variable conditionally defines HAS_FLOCK if flock() is
268 available to do file locking.
269
270d_fork (d_fork.U):
271 This variable conditionally defines the HAS_FORK symbol, which
272 indicates to the C program that the fork() routine is available.
273
274d_fpathconf (d_pathconf.U):
275 This variable conditionally defines the HAS_FPATHCONF symbol, which
276 indicates to the C program that the pathconf() routine is available
277 to determine file-system related limits and options associated
278 with a given open file descriptor.
279
280d_fsetpos (d_fsetpos.U):
281 This variable conditionally defines HAS_FSETPOS if fsetpos() is
282 available to set the file position indicator.
283
7e1af8bc 284d_ftime (d_ftime.U):
285 This variable conditionally defines the HAS_FTIME symbol, which
286 indicates that the ftime() routine exists. The ftime() routine is
287 basically a sub-second accuracy clock.
288
d7418ba7 289d_gethent (d_gethent.U):
290 This variable conditionally defines HAS_GETHOSTENT if gethostent() is
291 available to dup file descriptors.
292
7e1af8bc 293d_gettimeod (d_ftime.U):
294 This variable conditionally defines the HAS_GETTIMEOFDAY symbol, which
295 indicates that the gettimeofday() system call exists (to obtain a
296 sub-second accuracy clock).
297
d7418ba7 298d_getlogin (d_getlogin.U):
299 This variable conditionally defines the HAS_GETLOGIN symbol, which
300 indicates to the C program that the getlogin() routine is available
301 to get the login name.
302
c43cd16b 303d_getpgid (d_getpgid.U):
304 This variable conditionally defines the HAS_GETPGID symbol, which
305 indicates to the C program that the getpgid(pid) function
306 is available to get the process group id.
307
d7418ba7 308d_getpgrp (d_getpgrp.U):
309 This variable conditionally defines HAS_GETPGRP if getpgrp() is
310 available to get the current process group.
311
312d_getpgrp2 (d_getpgrp2.U):
313 This variable conditionally defines the HAS_GETPGRP2 symbol, which
314 indicates to the C program that the getpgrp2() (as in DG/UX) routine
315 is available to get the current process group.
316
317d_getppid (d_getppid.U):
318 This variable conditionally defines the HAS_GETPPID symbol, which
319 indicates to the C program that the getppid() routine is available
320 to get the parent process ID.
321
322d_getprior (d_getprior.U):
323 This variable conditionally defines HAS_GETPRIORITY if getpriority()
324 is available to get a process's priority.
325
326d_htonl (d_htonl.U):
327 This variable conditionally defines HAS_HTONL if htonl() and its
328 friends are available to do network order byte swapping.
329
330d_index (d_strchr.U):
331 This variable conditionally defines HAS_INDEX if index() and
332 rindex() are available for string searching.
333
7e1af8bc 334d_inetaton (d_inetaton.U):
335 This variable conditionally defines the HAS_INET_ATON symbol, which
336 indicates to the C program that the inet_aton() function is available
337 to parse IP address "dotted-quad" strings.
338
d7418ba7 339d_isascii (d_isascii.U):
340 This variable conditionally defines the HAS_ISASCII constant,
341 which indicates to the C program that isascii() is available.
342
343d_killpg (d_killpg.U):
344 This variable conditionally defines the HAS_KILLPG symbol, which
345 indicates to the C program that the killpg() routine is available
346 to kill process groups.
347
348d_link (d_link.U):
349 This variable conditionally defines HAS_LINK if link() is
350 available to create hard links.
351
352d_locconv (d_locconv.U):
353 This variable conditionally defines HAS_LOCALECONV if localeconv() is
354 available for numeric and monetary formatting conventions.
355
356d_lockf (d_lockf.U):
357 This variable conditionally defines HAS_LOCKF if lockf() is
358 available to do file locking.
359
360d_lstat (d_lstat.U):
361 This variable conditionally defines HAS_LSTAT if lstat() is
362 available to do file stats on symbolic links.
363
364d_mblen (d_mblen.U):
365 This variable conditionally defines the HAS_MBLEN symbol, which
366 indicates to the C program that the mblen() routine is available
367 to find the number of bytes in a multibye character.
368
369d_mbstowcs (d_mbstowcs.U):
370 This variable conditionally defines the HAS_MBSTOWCS symbol, which
371 indicates to the C program that the mbstowcs() routine is available
372 to convert a multibyte string into a wide character string.
373
374d_mbtowc (d_mbtowc.U):
375 This variable conditionally defines the HAS_MBTOWC symbol, which
376 indicates to the C program that the mbtowc() routine is available
377 to convert multibyte to a wide character.
378
379d_memcmp (d_memcmp.U):
380 This variable conditionally defines the HAS_MEMCMP symbol, which
381 indicates to the C program that the memcmp() routine is available
382 to compare blocks of memory.
383
384d_memcpy (d_memcpy.U):
385 This variable conditionally defines the HAS_MEMCPY symbol, which
386 indicates to the C program that the memcpy() routine is available
387 to copy blocks of memory.
388
389d_memmove (d_memmove.U):
390 This variable conditionally defines the HAS_MEMMOVE symbol, which
391 indicates to the C program that the memmove() routine is available
392 to copy potentatially overlapping blocks of memory.
393
394d_memset (d_memset.U):
395 This variable conditionally defines the HAS_MEMSET symbol, which
396 indicates to the C program that the memset() routine is available
397 to set blocks of memory.
398
399d_mkdir (d_mkdir.U):
400 This variable conditionally defines the HAS_MKDIR symbol, which
401 indicates to the C program that the mkdir() routine is available
402 to create directories..
403
404d_mkfifo (d_mkfifo.U):
405 This variable conditionally defines the HAS_MKFIFO symbol, which
406 indicates to the C program that the mkfifo() routine is available.
407
408d_mktime (d_mktime.U):
409 This variable conditionally defines the HAS_MKTIME symbol, which
410 indicates to the C program that the mktime() routine is available.
411
412d_msg (d_msg.U):
413 This variable conditionally defines the HAS_MSG symbol, which
414 indicates that the entire msg*(2) library is present.
415
416d_mymalloc (mallocsrc.U):
417 This variable conditionally defines MYMALLOC in case other parts
418 of the source want to take special action if MYMALLOC is used.
419 This may include different sorts of profiling or error detection.
420
421d_nice (d_nice.U):
422 This variable conditionally defines the HAS_NICE symbol, which
423 indicates to the C program that the nice() routine is available.
424
425d_oldarchlib (oldarchlib.U):
426 This variable conditionally defines OLDARCHLIB to hold the pathname
427 of architecture-dependent library files for a previous
428 version of $package.
429
430d_open3 (d_open3.U):
431 This variable conditionally defines the HAS_OPEN3 manifest constant,
432 which indicates to the C program that the 3 argument version of
433 the open(2) function is available.
434
435d_pathconf (d_pathconf.U):
436 This variable conditionally defines the HAS_PATHCONF symbol, which
437 indicates to the C program that the pathconf() routine is available
438 to determine file-system related limits and options associated
439 with a given filename.
440
441d_pause (d_pause.U):
442 This variable conditionally defines the HAS_PAUSE symbol, which
443 indicates to the C program that the pause() routine is available
444 to suspend a process until a signal is received.
445
446d_pipe (d_pipe.U):
447 This variable conditionally defines the HAS_PIPE symbol, which
448 indicates to the C program that the pipe() routine is available
449 to create an inter-process channel.
450
451d_poll (d_poll.U):
452 This variable conditionally defines the HAS_POLL symbol, which
453 indicates to the C program that the poll() routine is available
454 to poll active file descriptors.
455
456d_pwage (i_pwd.U):
457 This varaible conditionally defines PWAGE, which indicates
458 that struct passwd contains pw_age.
459
460d_pwchange (i_pwd.U):
461 This varaible conditionally defines PWCHANGE, which indicates
462 that struct passwd contains pw_change.
463
464d_pwclass (i_pwd.U):
465 This varaible conditionally defines PWCLASS, which indicates
466 that struct passwd contains pw_class.
467
468d_pwcomment (i_pwd.U):
469 This varaible conditionally defines PWCOMMENT, which indicates
470 that struct passwd contains pw_comment.
471
472d_pwexpire (i_pwd.U):
473 This varaible conditionally defines PWEXPIRE, which indicates
474 that struct passwd contains pw_expire.
475
476d_pwquota (i_pwd.U):
477 This varaible conditionally defines PWQUOTA, which indicates
478 that struct passwd contains pw_quota.
479
480d_readdir (d_readdir.U):
481 This variable conditionally defines HAS_READDIR if readdir() is
482 available to read directory entries.
483
484d_readlink (d_readlink.U):
485 This variable conditionally defines the HAS_READLINK symbol, which
486 indicates to the C program that the readlink() routine is available
487 to read the value of a symbolic link.
488
489d_rename (d_rename.U):
490 This variable conditionally defines the HAS_RENAME symbol, which
491 indicates to the C program that the rename() routine is available
492 to rename files.
493
494d_rewinddir (d_readdir.U):
495 This variable conditionally defines HAS_REWINDDIR if rewinddir() is
496 available.
497
498d_rmdir (d_rmdir.U):
499 This variable conditionally defines HAS_RMDIR if rmdir() is
500 available to remove directories.
501
502d_safebcpy (d_safebcpy.U):
503 This variable conditionally defines the HAS_SAFE_BCOPY symbol if
504 the bcopy() routine can do overlapping copies.
505
506d_safemcpy (d_safemcpy.U):
507 This variable conditionally defines the HAS_SAFE_MEMCPY symbol if
508 the memcpy() routine can do overlapping copies.
509
7e1af8bc 510d_sanemcmp (d_sanemcmp.U):
511 This variable conditionally defines the HAS_SANE_MEMCMP symbol if
512 the memcpy() routine is available and can be used to compare relative
513 magnitudes of chars with their high bits set.
514
d7418ba7 515d_seekdir (d_readdir.U):
516 This variable conditionally defines HAS_SEEKDIR if seekdir() is
517 available.
518
519d_select (d_select.U):
520 This variable conditionally defines HAS_SELECT if select() is
521 available to select active file descriptors. A <sys/time.h>
522 inclusion may be necessary for the timeout field.
523
524d_sem (d_sem.U):
525 This variable conditionally defines the HAS_SEM symbol, which
526 indicates that the entire sem*(2) library is present.
527
528d_setegid (d_setegid.U):
529 This variable conditionally defines the HAS_SETEGID symbol, which
530 indicates to the C program that the setegid() routine is available
531 to change the effective gid of the current program.
532
533d_seteuid (d_seteuid.U):
534 This variable conditionally defines the HAS_SETEUID symbol, which
535 indicates to the C program that the seteuid() routine is available
536 to change the effective uid of the current program.
537
538d_setlinebuf (d_setlnbuf.U):
539 This variable conditionally defines the HAS_SETLINEBUF symbol, which
540 indicates to the C program that the setlinebuf() routine is available
541 to change stderr or stdout from block-buffered or unbuffered to a
542 line-buffered mode.
543
544d_setlocale (d_setlocale.U):
545 This variable conditionally defines HAS_SETLOCALE if setlocale() is
546 available to handle locale-specific ctype implementations.
547
548d_setpgid (d_setpgid.U):
c43cd16b 549 This variable conditionally defines the HAS_SETPGID symbol, which
550 indicates to the C program that the setpgid(pid, gpid) function
551 is available to set the process group id.
d7418ba7 552
553d_setpgrp (d_setpgrp.U):
554 This variable conditionally defines HAS_SETPGRP if setpgrp() is
555 available to set the current process group.
556
557d_setpgrp2 (d_setpgrp2.U):
558 This variable conditionally defines the HAS_SETPGRP2 symbol, which
559 indicates to the C program that the setpgrp2() (as in DG/UX) routine
560 is available to set the current process group.
561
562d_setprior (d_setprior.U):
563 This variable conditionally defines HAS_SETPRIORITY if setpriority()
564 is available to set a process's priority.
565
566d_setregid (d_setregid.U):
567 This variable conditionally defines HAS_SETREGID if setregid() is
568 available to change the real and effective gid of the current
569 process.
570
571d_setresgid (d_setregid.U):
572 This variable conditionally defines HAS_SETRESGID if setresgid() is
573 available to change the real, effective and saved gid of the current
574 process.
575
576d_setresuid (d_setreuid.U):
577 This variable conditionally defines HAS_SETREUID if setresuid() is
578 available to change the real, effective and saved uid of the current
579 process.
580
581d_setreuid (d_setreuid.U):
582 This variable conditionally defines HAS_SETREUID if setreuid() is
583 available to change the real and effective uid of the current
584 process.
585
586d_setrgid (d_setrgid.U):
587 This variable conditionally defines the HAS_SETRGID symbol, which
588 indicates to the C program that the setrgid() routine is available
589 to change the real gid of the current program.
590
591d_setruid (d_setruid.U):
592 This variable conditionally defines the HAS_SETRUID symbol, which
593 indicates to the C program that the setruid() routine is available
594 to change the real uid of the current program.
595
596d_setsid (d_setsid.U):
597 This variable conditionally defines HAS_SETSID if setsid() is
598 available to set the process group ID.
599
600d_sfio (d_sfio.U):
601 This variable conditionally defines the USE_SFIO symbol,
602 and indicates whether sfio is available (and should be used).
603
604d_shm (d_shm.U):
605 This variable conditionally defines the HAS_SHM symbol, which
606 indicates that the entire shm*(2) library is present.
607
608d_shmatprototype (d_shmat.U):
609 This variable conditionally defines the HAS_SHMAT_PROTOTYPE
610 symbol, which indicates that sys/shm.h has a prototype for
611 shmat.
612
613d_sigaction (d_sigaction.U):
614 This variable conditionally defines the HAS_SIGACTION symbol, which
615 indicates that the Vr4 sigaction() routine is available.
616
617d_sigsetjmp (d_sigsetjmp.U):
618 This variable conditionally defines the HAS_SIGSETJMP symbol,
619 which indicates that the sigsetjmp() routine is available to
620 call setjmp() and optionally save the process's signal mask.
621
622d_socket (d_socket.U):
623 This variable conditionally defines HAS_SOCKET, which indicates
624 that the BSD socket interface is supported.
625
626d_sockpair (d_socket.U):
627 This variable conditionally defines the HAS_SOCKETPAIR symbol, which
628 indicates that the BSD socketpair() is supported.
629
630d_statblks (d_statblks.U):
631 This variable conditionally defines USE_STAT_BLOCKS if this system
632 has a stat structure declaring st_blksize and st_blocks.
633
634d_stdio_cnt_lval (d_stdstdio.U):
635 This variable conditionally defines STDIO_CNT_LVALUE if the
636 FILE_cnt macro can be used as an lvalue.
637
638d_stdio_ptr_lval (d_stdstdio.U):
639 This variable conditionally defines STDIO_PTR_LVALUE if the
640 FILE_ptr macro can be used as an lvalue.
641
642d_stdiobase (d_stdstdio.U):
643 This variable conditionally defines USE_STDIO_BASE if this system
644 has a FILE structure declaring a usable _base field (or equivalent)
645 in stdio.h.
646
647d_stdstdio (d_stdstdio.U):
648 This variable conditionally defines USE_STDIO_PTR if this system
649 has a FILE structure declaring usable _ptr and _cnt fields (or
650 equivalent) in stdio.h.
651
652d_strchr (d_strchr.U):
653 This variable conditionally defines HAS_STRCHR if strchr() and
654 strrchr() are available for string searching.
655
656d_strcoll (d_strcoll.U):
657 This variable conditionally defines HAS_STRCOLL if strcoll() is
658 available to compare strings using collating information.
659
660d_strctcpy (d_strctcpy.U):
661 This variable conditionally defines the USE_STRUCT_COPY symbol, which
662 indicates to the C program that this C compiler knows how to copy
663 structures.
664
665d_strerrm (d_strerror.U):
666 This variable holds what Strerrr is defined as to translate an error
667 code condition into an error message string. It could be 'strerror'
668 or a more complex macro emulating strrror with sys_errlist[], or the
669 "unknown" string when both strerror and sys_errlist are missing.
670
671d_strerror (d_strerror.U):
672 This variable conditionally defines HAS_STRERROR if strerror() is
673 available to translate error numbers to strings.
674
7e1af8bc 675d_strtod (d_strtod.U):
676 This variable conditionally defines the HAS_STRTOD symbol, which
677 indicates to the C program that the strtod() routine is available
678 to provide better numeric string conversion than atof().
679
680d_strtol (d_strtol.U):
681 This variable conditionally defines the HAS_STRTOL symbol, which
682 indicates to the C program that the strtol() routine is available
683 to provide better numeric string conversion than atoi() and friends.
684
685d_strtoul (d_strtoul.U):
686 This variable conditionally defines the HAS_STRTOUL symbol, which
687 indicates to the C program that the strtoul() routine is available
688 to provide conversion of strings to unsigned long.
689
d7418ba7 690d_strxfrm (d_strxfrm.U):
691 This variable conditionally defines HAS_STRXFRM if strxfrm() is
692 available to transform strings.
693
694d_suidsafe (d_dosuid.U):
695 This variable conditionally defines SETUID_SCRIPTS_ARE_SECURE_NOW
696 if setuid scripts can be secure. This test looks in /dev/fd/.
697
698d_symlink (d_symlink.U):
699 This variable conditionally defines the HAS_SYMLINK symbol, which
700 indicates to the C program that the symlink() routine is available
701 to create symbolic links.
702
703d_syscall (d_syscall.U):
704 This variable conditionally defines HAS_SYSCALL if syscall() is
705 available call arbitrary system calls.
706
707d_sysconf (d_sysconf.U):
708 This variable conditionally defines the HAS_SYSCONF symbol, which
709 indicates to the C program that the sysconf() routine is available
710 to determine system related limits and options.
711
712d_syserrlst (d_strerror.U):
713 This variable conditionally defines HAS_SYS_ERRLIST if sys_errlist[] is
714 available to translate error numbers to strings.
715
716d_system (d_system.U):
717 This variable conditionally defines HAS_SYSTEM if system() is
718 available to issue a shell command.
719
720d_tcgetpgrp (d_tcgtpgrp.U):
721 This variable conditionally defines the HAS_TCGETPGRP symbol, which
722 indicates to the C program that the tcgetpgrp() routine is available.
723 to get foreground process group ID.
724
725d_tcsetpgrp (d_tcstpgrp.U):
726 This variable conditionally defines the HAS_TCSETPGRP symbol, which
727 indicates to the C program that the tcsetpgrp() routine is available
728 to set foreground process group ID.
729
730d_telldir (d_readdir.U):
731 This variable conditionally defines HAS_TELLDIR if telldir() is
732 available.
733
734d_times (d_times.U):
735 This variable conditionally defines the HAS_TIMES symbol, which indicates
736 that the times() routine exists. The times() routine is normaly
737 provided on UNIX systems. You may have to include <sys/times.h>.
738
739d_truncate (d_truncate.U):
740 This variable conditionally defines HAS_TRUNCATE if truncate() is
741 available to truncate files.
742
743d_tzname (d_tzname.U):
744 This variable conditionally defines HAS_TZNAME if tzname[] is
745 available to access timezone names.
746
747d_umask (d_umask.U):
748 This variable conditionally defines the HAS_UMASK symbol, which
749 indicates to the C program that the umask() routine is available.
750 to set and get the value of the file creation mask.
751
752d_uname (d_gethname.U):
753 This variable conditionally defines the HAS_UNAME symbol, which
754 indicates to the C program that the uname() routine may be
755 used to derive the host name.
756
757d_vfork (d_vfork.U):
758 This variable conditionally defines the HAS_VFORK symbol, which
759 indicates the vfork() routine is available.
760
761d_void_closedir (d_closedir.U):
762 This variable conditionally defines VOID_CLOSEDIR if closedir()
763 does not return a value.
764
765d_volatile (d_volatile.U):
766 This variable conditionally defines the HASVOLATILE symbol, which
767 indicates to the C program that this C compiler knows about the
768 volatile declaration.
769
770d_vprintf (d_vprintf.U):
771 This variable conditionally defines the HAS_VPRINTF symbol, which
772 indicates to the C program that the vprintf() routine is available
773 to printf with a pointer to an argument list.
774
775d_wait4 (d_wait4.U):
776 This variable conditionally defines the HAS_WAIT4 symbol, which
777 indicates the wait4() routine is available.
778
779d_waitpid (d_waitpid.U):
780 This variable conditionally defines HAS_WAITPID if waitpid() is
781 available to wait for child process.
782
783d_wcstombs (d_wcstombs.U):
784 This variable conditionally defines the HAS_WCSTOMBS symbol, which
785 indicates to the C program that the wcstombs() routine is available
786 to convert wide character strings to multibyte strings.
787
788d_wctomb (d_wctomb.U):
789 This variable conditionally defines the HAS_WCTOMB symbol, which
790 indicates to the C program that the wctomb() routine is available
791 to convert a wide character to a multibyte.
792
793db_hashtype (i_db.U):
794 This variable contains the type of the hash structure element
795 in the <db.h> header file. In older versions of DB, it was
796 int, while in newer ones it is u_int32_t.
797
798db_prefixtype (i_db.U):
799 This variable contains the type of the prefix structure element
800 in the <db.h> header file. In older versions of DB, it was
801 int, while in newer ones it is size_t.
802
803direntrytype (i_dirent.U):
804 This symbol is set to 'struct direct' or 'struct dirent' depending on
805 whether dirent is available or not. You should use this pseudo type to
806 portably declare your directory entries.
807
808dlext (dlext.U):
809 This variable contains the extension that is to be used for the
810 dynamically loaded modules that perl generaties.
811
812dlsrc (dlsrc.U):
813 This variable contains the name of the dynamic loading file that
814 will be used with the package.
815
816dynamic_ext (Extensions.U):
817 This variable holds a list of extension files we want to
818 link dynamically into the package. It is used by Makefile.
819
820eagain (nblock_io.U):
821 This variable bears the symbolic errno code set by read() when no
822 data is present on the file and non-blocking I/O was enabled (otherwise,
823 read() blocks naturally).
824
825eunicefix (Init.U):
826 When running under Eunice this variable contains a command which will
827 convert a shell script to the proper form of text file for it to be
828 executable by the shell. On other systems it is a no-op.
829
830exe_ext (Unix.U):
831 This variable defines the extension used for executable files.
832 For unix it is empty. Other possible values include '.exe'.
833
834firstmakefile (Unix.U):
835 This variable defines the first file searched by make. On unix,
836 it is makefile (then Makefile). On case-insensitive systems,
837 it might be something else. This is only used to deal with
838 convoluted make depend tricks.
839
840fpostype (fpostype.U):
841 This variable defines Fpos_t to be something like fpost_t, long,
842 uint, or whatever type is used to declare file positions in libc.
843
844freetype (mallocsrc.U):
845 This variable contains the return type of free(). It is usually
846 void, but occasionally int.
847
848full_csh (d_csh.U):
849 This variable contains the full pathname to 'csh', whether or
850 not the user has specified 'portability'. This is only used
851 in the compiled C program, and we assume that all systems which
852 can share this executable will have the same full pathname to
853 'csh.'
854
855full_sed (Loc_sed.U):
856 This variable contains the full pathname to 'sed', whether or
857 not the user has specified 'portability'. This is only used
858 in the compiled C program, and we assume that all systems which
859 can share this executable will have the same full pathname to
860 'sed.'
861
862gidtype (gidtype.U):
863 This variable defines Gid_t to be something like gid_t, int,
864 ushort, or whatever type is used to declare the return type
865 of getgid(). Typically, it is the type of group ids in the kernel.
866
867groupstype (groupstype.U):
868 This variable defines Groups_t to be something like gid_t, int,
869 ushort, or whatever type is used for the second argument to
870 getgroups(). Usually, this is the same of gidtype, but
871 sometimes it isn't.
872
873i_dirent (i_dirent.U):
874 This variable conditionally defines I_DIRENT, which indicates
875 to the C program that it should include <dirent.h>.
876
877i_dlfcn (i_dlfcn.U):
878 This variable conditionally defines the I_DLFCN symbol, which
879 indicates to the C program that <dlfcn.h> exists and should
880 be included.
881
882i_fcntl (i_fcntl.U):
883 This variable controls the value of I_FCNTL (which tells
884 the C program to include <fcntl.h>).
885
886i_float (i_float.U):
887 This variable conditionally defines the I_FLOAT symbol, and indicates
888 whether a C program may include <float.h> to get symbols like DBL_MAX
889 or DBL_MIN, i.e. machine dependent floating point values.
890
891i_grp (i_grp.U):
892 This variable conditionally defines the I_GRP symbol, and indicates
893 whether a C program should include <grp.h>.
894
895i_limits (i_limits.U):
896 This variable conditionally defines the I_LIMITS symbol, and indicates
897 whether a C program may include <limits.h> to get symbols like WORD_BIT
898 and friends.
899
900i_locale (i_locale.U):
901 This variable conditionally defines the I_LOCALE symbol,
902 and indicates whether a C program should include <locale.h>.
903
904i_math (i_math.U):
905 This variable conditionally defines the I_MATH symbol, and indicates
906 whether a C program may include <math.h>.
907
908i_memory (i_memory.U):
909 This variable conditionally defines the I_MEMORY symbol, and indicates
910 whether a C program should include <memory.h>.
911
912i_neterrno (i_neterrno.U):
913 This variable conditionally defines the I_NET_ERRNO symbol, which
914 indicates to the C program that <net/errno.h> exists and should
915 be included.
916
917i_niin (i_niin.U):
918 This variable conditionally defines I_NETINET_IN, which indicates
919 to the C program that it should include <netinet/in.h>. Otherwise,
920 you may try <sys/in.h>.
921
922i_pwd (i_pwd.U):
923 This variable conditionally defines I_PWD, which indicates
924 to the C program that it should include <pwd.h>.
925
926i_rpcsvcdbm (i_dbm.U):
927 This variable conditionally defines the I_RPCSVC_DBM symbol, which
928 indicates to the C program that <rpcsvc/dbm.h> exists and should
929 be included. Some System V systems might need this instead of <dbm.h>.
930
931i_sfio (i_sfio.U):
932 This variable conditionally defines the I_SFIO symbol,
933 and indicates whether a C program should include <sfio.h>.
934
935i_sgtty (i_termio.U):
936 This variable conditionally defines the I_SGTTY symbol, which
937 indicates to the C program that it should include <sgtty.h> rather
938 than <termio.h>.
939
940i_stdarg (i_varhdr.U):
941 This variable conditionally defines the I_STDARG symbol, which
942 indicates to the C program that <stdarg.h> exists and should
943 be included.
944
945i_stddef (i_stddef.U):
946 This variable conditionally defines the I_STDDEF symbol, which
947 indicates to the C program that <stddef.h> exists and should
948 be included.
949
950i_stdlib (i_stdlib.U):
951 This variable conditionally defines the I_STDLIB symbol, which
952 indicates to the C program that <stdlib.h> exists and should
953 be included.
954
955i_string (i_string.U):
956 This variable conditionally defines the I_STRING symbol, which
957 indicates that <string.h> should be included rather than <strings.h>.
958
959i_sysdir (i_sysdir.U):
960 This variable conditionally defines the I_SYS_DIR symbol, and indicates
961 whether a C program should include <sys/dir.h>.
962
963i_sysfile (i_sysfile.U):
964 This variable conditionally defines the I_SYS_FILE symbol, and indicates
965 whether a C program should include <sys/file.h> to get R_OK and friends.
966
967i_sysioctl (i_sysioctl.U):
968 This variable conditionally defines the I_SYS_IOCTL symbol, which
969 indicates to the C program that <sys/ioctl.h> exists and should
970 be included.
971
972i_sysndir (i_sysndir.U):
973 This variable conditionally defines the I_SYS_NDIR symbol, and indicates
974 whether a C program should include <sys/ndir.h>.
975
976i_sysparam (i_sysparam.U):
977 This variable conditionally defines the I_SYS_PARAM symbol, and indicates
978 whether a C program should include <sys/param.h>.
979
980i_sysresrc (i_sysresrc.U):
981 This variable conditionally defines the I_SYS_RESOURCE symbol,
982 and indicates whether a C program should include <sys/resource.h>.
983
984i_sysselct (i_sysselct.U):
985 This variable conditionally defines I_SYS_SELECT, which indicates
986 to the C program that it should include <sys/select.h> in order to
987 get the definition of struct timeval.
988
989i_sysstat (i_sysstat.U):
990 This variable conditionally defines the I_SYS_STAT symbol,
991 and indicates whether a C program should include <sys/stat.h>.
992
993i_systime (i_time.U):
994 This variable conditionally defines I_SYS_TIME, which indicates
995 to the C program that it should include <sys/time.h>.
996
997i_systimek (i_time.U):
998 This variable conditionally defines I_SYS_TIME_KERNEL, which
999 indicates to the C program that it should include <sys/time.h>
1000 with KERNEL defined.
1001
1002i_systimes (i_systimes.U):
1003 This variable conditionally defines the I_SYS_TIMES symbol, and indicates
1004 whether a C program should include <sys/times.h>.
1005
1006i_systypes (i_systypes.U):
1007 This variable conditionally defines the I_SYS_TYPES symbol,
1008 and indicates whether a C program should include <sys/types.h>.
1009
1010i_sysun (i_sysun.U):
1011 This variable conditionally defines I_SYS_UN, which indicates
1012 to the C program that it should include <sys/un.h> to get UNIX
1013 domain socket definitions.
1014
1015i_syswait (i_syswait.U):
1016 This variable conditionally defines I_SYS_WAIT, which indicates
1017 to the C program that it should include <sys/wait.h>.
1018
1019i_termio (i_termio.U):
1020 This variable conditionally defines the I_TERMIO symbol, which
1021 indicates to the C program that it should include <termio.h> rather
1022 than <sgtty.h>.
1023
1024i_termios (i_termio.U):
1025 This variable conditionally defines the I_TERMIOS symbol, which
1026 indicates to the C program that the POSIX <termios.h> file is
1027 to be included.
1028
1029i_time (i_time.U):
1030 This variable conditionally defines I_TIME, which indicates
1031 to the C program that it should include <time.h>.
1032
1033i_unistd (i_unistd.U):
1034 This variable conditionally defines the I_UNISTD symbol, and indicates
1035 whether a C program should include <unistd.h>.
1036
1037i_utime (i_utime.U):
1038 This variable conditionally defines the I_UTIME symbol, and indicates
1039 whether a C program should include <utime.h>.
1040
1041i_values (i_values.U):
1042 This variable conditionally defines the I_VALUES symbol, and indicates
1043 whether a C program may include <values.h> to get symbols like MAXLONG
1044 and friends.
1045
1046i_varargs (i_varhdr.U):
1047 This variable conditionally defines I_VARARGS, which indicates
1048 to the C program that it should include <varargs.h>.
1049
1050i_varhdr (i_varhdr.U):
1051 Contains the name of the header to be included to get va_dcl definition.
1052 Typically one of varargs.h or stdarg.h.
1053
1054i_vfork (i_vfork.U):
1055 This variable conditionally defines the I_VFORK symbol, and indicates
1056 whether a C program should include vfork.h.
1057
1058installbin (bin.U):
1059 This variable is the same as binexp unless AFS is running in which case
1060 the user is explicitely prompted for it. This variable should always
1061 be used in your makefiles for maximum portability.
1062
1063installprivlib (privlib.U):
1064 This variable is really the same as privlibexp but may differ on
1065 those systems using AFS. For extra portability, only this variable
1066 should be used in makefiles.
1067
1068intsize (intsize.U):
1069 This variable contains the value of the INTSIZE symbol,
1070 which indicates to the C program how many bytes there are
1071 in an integer.
1072
1073large (models.U):
1074 This variable contains a flag which will tell the C compiler and loader
1075 to produce a program running with a large memory model. It is up to
1076 the Makefile to use this.
1077
1078ld (dlsrc.U):
1079 This variable indicates the program to be used to link
1080 libraries for dynamic loading. On some systems, it is 'ld'.
1081 On ELF systems, it should be $cc. Mostly, we'll try to respect
1082 the hint file setting.
1083
1084lddlflags (dlsrc.U):
1085 This variable contains any special flags that might need to be
1086 passed to $ld to create a shared library suitable for dynamic
1087 loading. It is up to the makefile to use it. For hpux, it
1088 should be -b. For sunos 4.1, it is empty.
1089
1090ldflags (ccflags.U):
1091 This variable contains any additional C loader flags desired by
1092 the user. It is up to the Makefile to use this.
1093
1094lib_ext (Unix.U):
1095 This variable defines the extension used for ordinary libraries.
1096 For unix, it is '.a'. The '.' is included. Other possible
1097 values include '.lib'.
1098
1099libperl (libperl.U):
1100 The perl executable is obtained by linking perlmain.c with
1101 libperl, any static extensions (usually just DynaLoader),
1102 and any other libraries needed on this system. libperl
1103 is usually libperl.a, but can also be libperl.so.xxx if
1104 the user wishes to build a perl executable with a shared
1105 library.
1106
1107libs (libs.U):
1108 This variable holds the additional libraries we want to use.
1109 It is up to the Makefile to deal with it.
1110
1111lns (lns.U):
1112 This variable holds the name of the command to make
1113 symbolic links (if they are supported). It can be used
1114 in the Makefile. It is either 'ln -s' or 'ln'
1115
4fdae800 1116longsize (intsize.U):
1117 This variable contains the value of the LONGSIZE symbol,
1118 which indicates to the C program how many bytes there are
1119 in a long integer.
1120
d7418ba7 1121lseektype (lseektype.U):
1122 This variable defines lseektype to be something like off_t, long,
1123 or whatever type is used to declare lseek offset's type in the
1124 kernel (which also appears to be lseek's return type).
1125
1126make (make.U):
1127 This variable sets the path to the 'make' command. It is
1128 here rather than in Loc.U so that users can override it
1129 with Configure -Dmake=pmake, or equivalent.
1130
1131make_set_make (make.U):
1132 Some versions of 'make' set the variable MAKE. Others do not.
1133 This variable contains the string to be included in Makefile.SH
1134 so that MAKE is set if needed, and not if not needed.
1135 Possible values are:
1136 make_set_make='#' # If your make program handles this for you,
1137 make_set_make=$make # if it doesn't.
1138 I used a comment character so that we can distinguish a
1139 'set' value (from a previous config.sh or Configure -D option)
1140 from an uncomputed value.
1141
1142mallocobj (mallocsrc.U):
1143 This variable contains the name of the malloc.o that this package
1144 generates, if that malloc.o is preferred over the system malloc.
1145 Otherwise the value is null. This variable is intended for generating
1146 Makefiles. See mallocsrc.
1147
1148mallocsrc (mallocsrc.U):
1149 This variable contains the name of the malloc.c that comes with
1150 the package, if that malloc.c is preferred over the system malloc.
1151 Otherwise the value is null. This variable is intended for generating
1152 Makefiles.
1153
1154malloctype (mallocsrc.U):
1155 This variable contains the kind of ptr returned by malloc and realloc.
1156
1157man1dir (man1dir.U):
1158 This variable contains the name of the directory in which manual
1159 source pages are to be put. It is the responsibility of the
1160 Makefile.SH to get the value of this into the proper command.
1161 You must be prepared to do the ~name expansion yourself.
1162
1163man1ext (man1dir.U):
1164 This variable contains the extension that the manual page should
1165 have: one of 'n', 'l', or '1'. The Makefile must supply the '.'.
1166 See man1dir.
1167
1168man3dir (man3dir.U):
1169 This variable contains the name of the directory in which manual
1170 source pages are to be put. It is the responsibility of the
1171 Makefile.SH to get the value of this into the proper command.
1172 You must be prepared to do the ~name expansion yourself.
1173
1174man3ext (man3dir.U):
1175 This variable contains the extension that the manual page should
1176 have: one of 'n', 'l', or '3'. The Makefile must supply the '.'.
1177 See man3dir.
1178
1179modetype (modetype.U):
1180 This variable defines modetype to be something like mode_t,
1181 int, unsigned short, or whatever type is used to declare file
1182 modes for system calls.
1183
1184n (n.U):
1185 This variable contains the -n flag if that is what causes the echo
1186 command to suppress newline. Otherwise it is null. Correct usage is
1187 $echo $n "prompt for a question: $c".
1188
1189o_nonblock (nblock_io.U):
1190 This variable bears the symbol value to be used during open() or fcntl()
1191 to turn on non-blocking I/O for a file descriptor. If you wish to switch
1192 between blocking and non-blocking, you may try ioctl(FIOSNBIO) instead,
1193 but that is only supported by some devices.
1194
1195oldarchlib (oldarchlib.U):
1196 This variable holds the name of the directory in which perl5.000
1197 and perl5.001 stored
1198 architecture-dependent public library files.
1199
1200oldarchlibexp (oldarchlib.U):
1201 This variable is the same as the oldarchlib variable, but is
1202 filename expanded at configuration time, for convenient use.
1203
1204optimize (ccflags.U):
1205 This variable contains any optimizer/debugger flag that should be used.
1206 It is up to the Makefile to use it.
1207
1208osname (Oldconfig.U):
1209 This variable contains the operating system name (e.g. sunos,
1210 solaris, hpux, etc.). It can be useful later on for setting
1211 defaults. Any spaces are replaced with underscores. It is set
1212 to a null string if we can't figure it out.
1213
1214pager (pager.U):
1215 This variable contains the name of the preferred pager on the system.
1216 Usual values are (the full pathnames of) more, less, pg, or cat.
1217
1218path_sep (Unix.U):
1219 This variable defines the character used to separate elements in
1220 the shell's PATH environment variable. On Unix, it is ':'.
1221 This is probably identical to Head.U's p_ variable and can
1222 probably be dropped.
1223
1224perladmin (perladmin.U):
1225 Electronic mail address of the perl5 administrator.
1226
7e1af8bc 1227perlpath (perlpath.U):
1228 This variable contains the eventual value of the PERLPATH symbol,
1229 which contains the name of the perl interpreter to be used in
1230 shell scripts and in the "eval 'exec'" idiom.
1231
d7418ba7 1232prefix (prefix.U):
1233 This variable holds the name of the directory below which the
1234 user will install the package. Usually, this is /usr/local, and
1235 executables go in /usr/local/bin, library stuff in /usr/local/lib,
1236 man pages in /usr/local/man, etc. It is only used to set defaults
1237 for things in bin.U, mansrc.U, privlib.U, or scriptdir.U.
1238
1239privlib (privlib.U):
1240 This variable contains the eventual value of the PRIVLIB symbol,
1241 which is the name of the private library for this package. It may
1242 have a ~ on the front. It is up to the makefile to eventually create
1243 this directory while performing installation (with ~ substitution).
1244
1245privlibexp (privlib.U):
1246 This variable is the ~name expanded version of privlib, so that you
1247 may use it directly in Makefiles or shell scripts.
1248
1249prototype (prototype.U):
1250 This variable holds the eventual value of CAN_PROTOTYPE, which
1251 indicates the C compiler can handle funciton prototypes.
1252
1253randbits (randbits.U):
1254 This variable contains the eventual value of the RANDBITS symbol,
1255 which indicates to the C program how many bits of random number
1256 the rand() function produces.
1257
1258ranlib (orderlib.U):
1259 This variable is set to the pathname of the ranlib program, if it is
1260 needed to generate random libraries. Set to ":" if ar can generate
1261 random libraries or if random libraries are not supported
1262
1263rd_nodata (nblock_io.U):
1264 This variable holds the return code from read() when no data is
1265 present. It should be -1, but some systems return 0 when O_NDELAY is
1266 used, which is a shame because you cannot make the difference between
1267 no data and an EOF.. Sigh!
1268
1269scriptdir (scriptdir.U):
1270 This variable holds the name of the directory in which the user wants
1271 to put publicly scripts for the package in question. It is either
1272 the same directory as for binaries, or a special one that can be
1273 mounted across different architectures, like /usr/share. Programs
1274 must be prepared to deal with ~name expansion.
1275
1276selecttype (selecttype.U):
1277 This variable holds the type used for the 2nd, 3rd, and 4th
1278 arguments to select. Usually, this is 'fd_set *', if HAS_FD_SET
1279 is defined, and 'int *' otherwise. This is only useful if you
1280 have select(), naturally.
1281
1282sh (sh.U):
1283 This variable contains the full pathname of the shell used
1284 on this system to execute Bourne shell scripts. Usually, this will be
1285 /bin/sh, though it's possible that some systems will have /bin/ksh,
bb14ff96 1286 /bin/pdksh, /bin/ash, /bin/bash, or even something such as
1287 D:/bin/sh.exe.
d7418ba7 1288 This unit comes before Options.U, so you can't set sh with a -D
1289 option, though you can override this (and startsh)
1290 with -O -Dsh=/bin/whatever -Dstartsh=whatever
1291
1292shmattype (d_shmat.U):
1293 This symbol contains the type of pointer returned by shmat().
1294 It can be 'void *' or 'char *'.
1295
4fdae800 1296shortsize (intsize.U):
1297 This variable contains the value of the SHORTSIZE symbol,
1298 which indicates to the C program how many bytes there are
1299 in a short integer.
1300
c43cd16b 1301shrpenv (libperl.U):
1302 If the user builds a shared libperl.so, then we need to tell the
1303 'perl' executable where it will be able to find the installed libperl.so.
1304 One way to do this on some systems is to set the environment variable
1305 LD_RUN_PATH to the directory that will be the final location of the
1306 shared libperl.so. The makefile can use this with something like
1307 $shrpenv $(CC) -o perl perlmain.o $libperl $libs
1308 Typical values are
1309 shrpenv="env LD_RUN_PATH=$archlibexp/CORE"
1310 or
1311 shrpenv=''
1312 See the main perl Makefile.SH for actual working usage.
1313 Alternatively, we might be able to use a command line option such
1314 as -R $archlibexp/CORE (Solaris, NetBSD) or -Wl,-rpath
1315 $archlibexp/CORE (Linux).
1316
d7418ba7 1317sig_name (sig_name.U):
1318 This variable holds the signal names, space separated. The leading
1319 SIG in signals name is removed. See sig_num.
1320
1321sig_num (sig_name.U):
1322 This variable holds the signal numbers, space separated. Those numbers
1323 correspond to the value of the signal listed in the same place within
1324 the sig_name list.
1325
1326signal_t (d_voidsig.U):
1327 This variable holds the type of the signal handler (void or int).
1328
1329sitearch (sitearch.U):
1330 This variable contains the eventual value of the SITEARCH symbol,
1331 which is the name of the private library for this package. It may
1332 have a ~ on the front. It is up to the makefile to eventually create
1333 this directory while performing installation (with ~ substitution).
1334
1335sitearchexp (sitearch.U):
1336 This variable is the ~name expanded version of sitearch, so that you
1337 may use it directly in Makefiles or shell scripts.
1338
1339sitelib (sitelib.U):
1340 This variable contains the eventual value of the SITELIB symbol,
1341 which is the name of the private library for this package. It may
1342 have a ~ on the front. It is up to the makefile to eventually create
1343 this directory while performing installation (with ~ substitution).
1344
1345sitelibexp (sitelib.U):
1346 This variable is the ~name expanded version of sitelib, so that you
1347 may use it directly in Makefiles or shell scripts.
1348
1349sizetype (sizetype.U):
1350 This variable defines sizetype to be something like size_t,
1351 unsigned long, or whatever type is used to declare length
1352 parameters for string functions.
1353
1354small (models.U):
1355 This variable contains a flag which will tell the C compiler and loader
1356 to produce a program running with a small memory model. It is up to
1357 the Makefile to use this.
1358
1359spitshell (spitshell.U):
1360 This variable contains the command necessary to spit out a runnable
1361 shell on this system. It is either cat or a grep -v for # comments.
1362
1363split (models.U):
1364 This variable contains a flag which will tell the C compiler and loader
1365 to produce a program that will run in separate I and D space, for those
1366 machines that support separation of instruction and data space. It is
1367 up to the Makefile to use this.
1368
1369ssizetype (ssizetype.U):
1370 This variable defines ssizetype to be something like ssize_t,
1371 long or int. It is used by functions that return a count
1372 of bytes or an error condition. It must be a signed type.
1373 We will pick a type such that sizeof(SSize_t) == sizeof(Size_t).
1374
1375startperl (startperl.U):
1376 This variable contains the string to put on the front of a perl
1377 script to make sure (hopefully) that it runs with perl and not some
1378 shell. Of course, that leading line must be followed by the classical
1379 perl idiom:
5f05dabc 1380 eval 'exec /usr/bin/perl -S $0 ${1+"$@"}'
d7418ba7 1381 if $running_under_some_shell;
1382 to guarantee perl startup should the shell execute the script. Note
1383 that this magic incatation is not understood by csh.
1384
1385startsh (startsh.U):
1386 This variable contains the string to put on the front of a shell
1387 script to make sure (hopefully) that it runs with sh and not some
1388 other shell.
1389
1390static_ext (Extensions.U):
1391 This variable holds a list of extension files we want to
1392 link statically into the package. It is used by Makefile.
1393
1394stdchar (stdchar.U):
1395 This variable conditionally defines STDCHAR to be the type of char
1396 used in stdio.h. It has the values "unsigned char" or "char".
1397
1398timetype (d_time.U):
1399 This variable holds the type returned by time(). It can be long,
1400 or time_t on BSD sites (in which case <sys/types.h> should be
1401 included). Anyway, the type Time_t should be used.
1402
1403uidtype (uidtype.U):
1404 This variable defines Uid_t to be something like uid_t, int,
1405 ushort, or whatever type is used to declare user ids in the kernel.
1406
1407useperlio (useperlio.U):
1408 This variable conditionally defines the USE_PERLIO symbol,
1409 and indicates that the PerlIO abstraction should be
1410 used throughout.
1411
1412useshrplib (libperl.U):
1413 This variable is set to 'yes' if the user wishes
1414 to build a shared libperl, and 'no' otherwise.
1415
1416voidflags (voidflags.U):
1417 This variable contains the eventual value of the VOIDFLAGS symbol,
1418 which indicates how much support of the void type is given by this
1419 compiler. See VOIDFLAGS for more info.
1420