Commit | Line | Data |
d7418ba7 |
1 | This file contains a description of all the shell variables whose value is |
2 | determined by the Configure script. Variables intended for use in C |
ebc74a4b |
3 | programs (e.g. I_UNISTD) are already described in config_h.SH. [`configpm' |
4 | generates pod documentation for Config.pm from this file--please try to keep |
5 | the formatting regular.] |
d7418ba7 |
6 | |
781b178c |
7 | _a (Unix.U): |
8 | This variable defines the extension used for ordinary libraries. |
9 | For unix, it is '.a'. The '.' is included. Other possible |
10 | values include '.lib'. |
11 | |
12 | _exe (Unix.U): |
13 | This variable defines the extension used for executable files. |
14 | For unix it is empty. Other possible values include '.exe'. |
15 | |
16 | _o (Unix.U): |
17 | This variable defines the extension used for object files. |
18 | For unix, it is '.o'. The '.' is included. Other possible |
19 | values include '.obj'. |
20 | |
21 | afs (afs.U): |
22 | This variable is set to 'true' if AFS (Andrew File System) is used |
23 | on the system, 'false' otherwise. It is possible to override this |
24 | with a hint value or command line option, but you'd better know |
25 | what you are doing. |
26 | |
27 | alignbytes (alignbytes.U): |
28 | This variable holds the number of bytes required to align a |
87b71857 |
29 | double-- or a long double when applicable. Usual values are |
30 | 2, 4 and 8. The default is eight, for safety. |
781b178c |
31 | |
32 | ansi2knr (ansi2knr.U): |
33 | This variable is set if the user needs to run ansi2knr. |
34 | Currently, this is not supported, so we just abort. |
35 | |
36 | aphostname (d_gethname.U): |
37 | This variable contains the command which can be used to compute the |
38 | host name. The command is fully qualified by its absolute path, to make |
39 | it safe when used by a process with super-user privileges. |
40 | |
ff935051 |
41 | api_revision (patchlevel.U): |
42 | The three variables, api_revision, api_version, and |
43 | api_subversion, specify the version of the oldest perl binary |
44 | compatible with the present perl. In a full version string |
45 | such as '5.6.1', api_revision is the '5'. |
46 | Prior to 5.5.640, the format was a floating point number, |
47 | like 5.00563. |
48 | perl.c:incpush() and lib/lib.pm will automatically search in |
49 | $sitelib/.. for older directories back to the limit specified |
50 | by these api_ variables. This is only useful if you have a |
51 | perl library directory tree structured like the default one. |
52 | See INSTALL for how this works. The versioned site_perl |
53 | directory was introduced in 5.005, so that is the lowest |
54 | possible value. The version list appropriate for the current |
55 | system is determined in inc_version_list.U. |
56 | XXX To do: Since compatibility can depend on compile time |
57 | options (such as bincompat, longlong, etc.) it should |
58 | (perhaps) be set by Configure, but currently it isn't. |
59 | Currently, we read a hard-wired value from patchlevel.h. |
60 | Perhaps what we ought to do is take the hard-wired value from |
61 | patchlevel.h but then modify it if the current Configure |
62 | options warrant. patchlevel.h then would use an #ifdef guard. |
63 | |
64 | api_subversion (patchlevel.U): |
65 | The three variables, api_revision, api_version, and |
66 | api_subversion, specify the version of the oldest perl binary |
67 | compatible with the present perl. In a full version string |
68 | such as '5.6.1', api_subversion is the '1'. See api_revision for |
69 | full details. |
70 | |
71 | api_version (patchlevel.U): |
72 | The three variables, api_revision, api_version, and |
73 | api_subversion, specify the version of the oldest perl binary |
74 | compatible with the present perl. In a full version string |
75 | such as '5.6.1', api_version is the '6'. See api_revision for |
76 | full details. As a special case, 5.5.0 is rendered in the |
77 | old-style as 5.005. (In the 5.005_0x maintenance series, |
78 | this was the only versioned directory in $sitelib.) |
79 | |
80 | api_versionstring (patchlevel.U): |
81 | This variable combines api_revision, api_version, and |
82 | api_subversion in a format such as 5.6.1 (or 5_6_1) suitable |
83 | for use as a directory name. This is filesystem dependent. |
781b178c |
84 | |
85 | ar (Loc.U): |
5bf26616 |
86 | This variable is used internally by Configure to determine the |
781b178c |
87 | full pathname (if any) of the ar program. After Configure runs, |
88 | the value is reset to a plain "ar" and is not useful. |
89 | |
90 | archlib (archlib.U): |
91 | This variable holds the name of the directory in which the user wants |
92 | to put architecture-dependent public library files for $package. |
93 | It is most often a local directory such as /usr/local/lib. |
94 | Programs using this variable must be prepared to deal |
95 | with filename expansion. |
96 | |
97 | archlibexp (archlib.U): |
98 | This variable is the same as the archlib variable, but is |
99 | filename expanded at configuration time, for convenient use. |
100 | |
101 | archname64 (use64bits.U): |
102 | This variable is used for the 64-bitness part of $archname. |
103 | |
104 | archname (archname.U): |
105 | This variable is a short name to characterize the current |
106 | architecture. It is used mainly to construct the default archlib. |
107 | |
108 | archobjs (Unix.U): |
109 | This variable defines any additional objects that must be linked |
110 | in with the program on this architecture. On unix, it is usually |
111 | empty. It is typically used to include emulations of unix calls |
112 | or other facilities. For perl on OS/2, for example, this would |
113 | include os2/os2.obj. |
114 | |
115 | awk (Loc.U): |
5bf26616 |
116 | This variable is used internally by Configure to determine the |
781b178c |
117 | full pathname (if any) of the awk program. After Configure runs, |
118 | the value is reset to a plain "awk" and is not useful. |
119 | |
120 | baserev (baserev.U): |
121 | The base revision level of this package, from the .package file. |
122 | |
123 | bash (Loc.U): |
124 | This variable is defined but not used by Configure. |
125 | The value is a plain '' and is not useful. |
126 | |
127 | bin (bin.U): |
128 | This variable holds the name of the directory in which the user wants |
129 | to put publicly executable images for the package in question. It |
130 | is most often a local directory such as /usr/local/bin. Programs using |
131 | this variable must be prepared to deal with ~name substitution. |
132 | |
d71b2b6b |
133 | bincompat5005 (bincompat5005.U): |
f78bfc9c |
134 | This variable contains y if this version of Perl should be |
135 | binary-compatible with Perl 5.005. |
d71b2b6b |
136 | |
781b178c |
137 | binexp (bin.U): |
138 | This is the same as the bin variable, but is filename expanded at |
139 | configuration time, for use in your makefiles. |
140 | |
141 | bison (Loc.U): |
142 | This variable is defined but not used by Configure. |
143 | The value is a plain '' and is not useful. |
144 | |
145 | byacc (Loc.U): |
5bf26616 |
146 | This variable is used internally by Configure to determine the |
781b178c |
147 | full pathname (if any) of the byacc program. After Configure runs, |
148 | the value is reset to a plain "byacc" and is not useful. |
149 | |
150 | byteorder (byteorder.U): |
151 | This variable holds the byte order. In the following, larger digits |
152 | indicate more significance. The variable byteorder is either 4321 |
153 | on a big-endian machine, or 1234 on a little-endian, or 87654321 |
154 | on a Cray ... or 3412 with weird order ! |
155 | |
156 | c (n.U): |
157 | This variable contains the \c string if that is what causes the echo |
158 | command to suppress newline. Otherwise it is null. Correct usage is |
159 | $echo $n "prompt for a question: $c". |
160 | |
161 | castflags (d_castneg.U): |
162 | This variable contains a flag that precise difficulties the |
163 | compiler has casting odd floating values to unsigned long: |
164 | 0 = ok |
165 | 1 = couldn't cast < 0 |
166 | 2 = couldn't cast >= 0x80000000 |
167 | 4 = couldn't cast in argument expression list |
168 | |
169 | cat (Loc.U): |
5bf26616 |
170 | This variable is used internally by Configure to determine the |
781b178c |
171 | full pathname (if any) of the cat program. After Configure runs, |
172 | the value is reset to a plain "cat" and is not useful. |
173 | |
174 | cc (cc.U): |
175 | This variable holds the name of a command to execute a C compiler which |
176 | can resolve multiple global references that happen to have the same |
177 | name. Usual values are 'cc', 'Mcc', 'cc -M', and 'gcc'. |
178 | |
179 | cccdlflags (dlsrc.U): |
180 | This variable contains any special flags that might need to be |
181 | passed with 'cc -c' to compile modules to be used to create a shared |
182 | library that will be used for dynamic loading. For hpux, this |
183 | should be +z. It is up to the makefile to use it. |
184 | |
185 | ccdlflags (dlsrc.U): |
186 | This variable contains any special flags that might need to be |
187 | passed to cc to link with a shared library for dynamic loading. |
188 | It is up to the makefile to use it. For sunos 4.1, it should |
189 | be empty. |
190 | |
191 | ccflags (ccflags.U): |
192 | This variable contains any additional C compiler flags desired by |
193 | the user. It is up to the Makefile to use this. |
194 | |
195 | ccsymbols (Cppsym.U): |
196 | The variable contains the symbols defined by the C compiler alone. |
52c7d5b6 |
197 | The symbols defined by cpp or by cc when it calls cpp are not in |
198 | this list, see cppsymbols and cppccsymbols. |
781b178c |
199 | The list is a space-separated list of symbol=value tokens. |
200 | |
201 | cf_by (cf_who.U): |
202 | Login name of the person who ran the Configure script and answered the |
203 | questions. This is used to tag both config.sh and config_h.SH. |
204 | |
205 | cf_email (cf_email.U): |
206 | Electronic mail address of the person who ran Configure. This can be |
207 | used by units that require the user's e-mail, like MailList.U. |
208 | |
209 | cf_time (cf_who.U): |
210 | Holds the output of the "date" command when the configuration file was |
211 | produced. This is used to tag both config.sh and config_h.SH. |
212 | |
a22e52b9 |
213 | charsize (charsize.U): |
214 | This variable contains the value of the CHARSIZE symbol, which |
215 | indicates to the C program how many bytes there are in a character. |
216 | |
781b178c |
217 | chgrp (Loc.U): |
218 | This variable is defined but not used by Configure. |
219 | The value is a plain '' and is not useful. |
220 | |
221 | chmod (Loc.U): |
222 | This variable is defined but not used by Configure. |
223 | The value is a plain '' and is not useful. |
224 | |
225 | chown (Loc.U): |
226 | This variable is defined but not used by Configure. |
227 | The value is a plain '' and is not useful. |
228 | |
229 | clocktype (d_times.U): |
230 | This variable holds the type returned by times(). It can be long, |
231 | or clock_t on BSD sites (in which case <sys/types.h> should be |
232 | included). |
233 | |
234 | comm (Loc.U): |
5bf26616 |
235 | This variable is used internally by Configure to determine the |
781b178c |
236 | full pathname (if any) of the comm program. After Configure runs, |
237 | the value is reset to a plain "comm" and is not useful. |
238 | |
239 | compress (Loc.U): |
240 | This variable is defined but not used by Configure. |
241 | The value is a plain '' and is not useful. |
242 | |
ff935051 |
243 | CONFIGDOTSH (Oldsyms.U): |
244 | This is set to 'true' in config.sh so that a shell script |
245 | sourcing config.sh can tell if it has been sourced already. |
246 | |
781b178c |
247 | contains (contains.U): |
248 | This variable holds the command to do a grep with a proper return |
249 | status. On most sane systems it is simply "grep". On insane systems |
250 | it is a grep followed by a cat followed by a test. This variable |
251 | is primarily for the use of other Configure units. |
252 | |
253 | cp (Loc.U): |
5bf26616 |
254 | This variable is used internally by Configure to determine the |
781b178c |
255 | full pathname (if any) of the cp program. After Configure runs, |
256 | the value is reset to a plain "cp" and is not useful. |
257 | |
258 | cpio (Loc.U): |
259 | This variable is defined but not used by Configure. |
260 | The value is a plain '' and is not useful. |
261 | |
262 | cpp (Loc.U): |
5bf26616 |
263 | This variable is used internally by Configure to determine the |
781b178c |
264 | full pathname (if any) of the cpp program. After Configure runs, |
265 | the value is reset to a plain "cpp" and is not useful. |
266 | |
267 | cpp_stuff (cpp_stuff.U): |
268 | This variable contains an identification of the catenation mechanism |
269 | used by the C preprocessor. |
270 | |
271 | cppccsymbols (Cppsym.U): |
52c7d5b6 |
272 | The variable contains the symbols defined by the C compiler |
273 | when it calls cpp. The symbols defined by the cc alone or cpp |
274 | alone are not in this list, see ccsymbols and cppsymbols. |
781b178c |
275 | The list is a space-separated list of symbol=value tokens. |
276 | |
277 | cppflags (ccflags.U): |
278 | This variable holds the flags that will be passed to the C pre- |
279 | processor. It is up to the Makefile to use it. |
280 | |
281 | cpplast (cppstdin.U): |
282 | This variable has the same functionality as cppminus, only it applies |
283 | to cpprun and not cppstdin. |
284 | |
285 | cppminus (cppstdin.U): |
286 | This variable contains the second part of the string which will invoke |
287 | the C preprocessor on the standard input and produce to standard |
288 | output. This variable will have the value "-" if cppstdin needs |
289 | a minus to specify standard input, otherwise the value is "". |
290 | |
291 | cpprun (cppstdin.U): |
292 | This variable contains the command which will invoke a C preprocessor |
293 | on standard input and put the output to stdout. It is guaranteed not |
294 | to be a wrapper and may be a null string if no preprocessor can be |
295 | made directly available. This preprocessor might be different from the |
296 | one used by the C compiler. Don't forget to append cpplast after the |
297 | preprocessor options. |
298 | |
299 | cppstdin (cppstdin.U): |
300 | This variable contains the command which will invoke the C |
301 | preprocessor on standard input and put the output to stdout. |
302 | It is primarily used by other Configure units that ask about |
303 | preprocessor symbols. |
304 | |
305 | cppsymbols (Cppsym.U): |
52c7d5b6 |
306 | The variable contains the symbols defined by the C preprocessor |
307 | alone. The symbols defined by cc or by cc when it calls cpp are |
308 | not in this list, see ccsymbols and cppccsymbols. |
781b178c |
309 | The list is a space-separated list of symbol=value tokens. |
310 | |
311 | crosscompile (crosscompile.U): |
312 | This variable conditionally defines the CROSSCOMPILE symbol |
313 | which signifies that the build process is be a cross-compilation. |
314 | This is normally set by hints files or from Configure command line. |
315 | |
316 | cryptlib (d_crypt.U): |
317 | This variable holds -lcrypt or the path to a libcrypt.a archive if |
318 | the crypt() function is not defined in the standard C library. It is |
319 | up to the Makefile to use this. |
320 | |
321 | csh (Loc.U): |
5bf26616 |
322 | This variable is used internally by Configure to determine the |
781b178c |
323 | full pathname (if any) of the csh program. After Configure runs, |
324 | the value is reset to a plain "csh" and is not useful. |
325 | |
326 | d_access (d_access.U): |
327 | This variable conditionally defines HAS_ACCESS if the access() system |
328 | call is available to check for access permissions using real IDs. |
329 | |
330 | d_accessx (d_accessx.U): |
331 | This variable conditionally defines the HAS_ACCESSX symbol, which |
332 | indicates to the C program that the accessx() routine is available. |
333 | |
334 | d_alarm (d_alarm.U): |
335 | This variable conditionally defines the HAS_ALARM symbol, which |
336 | indicates to the C program that the alarm() routine is available. |
337 | |
338 | d_archlib (archlib.U): |
339 | This variable conditionally defines ARCHLIB to hold the pathname |
340 | of architecture-dependent library files for $package. If |
341 | $archlib is the same as $privlib, then this is set to undef. |
342 | |
11dc3f68 |
343 | d_atolf (atolf.U): |
344 | This variable conditionally defines the HAS_ATOLF symbol, which |
345 | indicates to the C program that the atolf() routine is available. |
346 | |
347 | d_atoll (atoll.U): |
348 | This variable conditionally defines the HAS_ATOLL symbol, which |
349 | indicates to the C program that the atoll() routine is available. |
350 | |
781b178c |
351 | d_attribut (d_attribut.U): |
352 | This variable conditionally defines HASATTRIBUTE, which |
353 | indicates the C compiler can check for function attributes, |
354 | such as printf formats. |
355 | |
356 | d_bcmp (d_bcmp.U): |
357 | This variable conditionally defines the HAS_BCMP symbol if |
358 | the bcmp() routine is available to compare strings. |
359 | |
360 | d_bcopy (d_bcopy.U): |
361 | This variable conditionally defines the HAS_BCOPY symbol if |
362 | the bcopy() routine is available to copy strings. |
363 | |
d71b2b6b |
364 | d_bincompat5005 (bincompat5005.U): |
365 | This variable conditionally defines BINCOMPAT5005 so that embed.h |
f78bfc9c |
366 | can take special action if this version of Perl should be |
367 | binary-compatible with Perl 5.005. This is impossible for builds |
368 | that use features like threads and multiplicity it is always $undef |
369 | for those versions. |
d71b2b6b |
370 | |
781b178c |
371 | d_bsd (Guess.U): |
372 | This symbol conditionally defines the symbol BSD when running on a |
373 | BSD system. |
374 | |
375 | d_bsdgetpgrp (d_getpgrp.U): |
376 | This variable conditionally defines USE_BSD_GETPGRP if |
377 | getpgrp needs one arguments whereas USG one needs none. |
378 | |
379 | d_bsdsetpgrp (d_setpgrp.U): |
380 | This variable conditionally defines USE_BSD_SETPGRP if |
381 | setpgrp needs two arguments whereas USG one needs none. |
382 | See also d_setpgid for a POSIX interface. |
383 | |
384 | d_bzero (d_bzero.U): |
385 | This variable conditionally defines the HAS_BZERO symbol if |
386 | the bzero() routine is available to set memory to 0. |
387 | |
388 | d_casti32 (d_casti32.U): |
389 | This variable conditionally defines CASTI32, which indicates |
390 | whether the C compiler can cast large floats to 32-bit ints. |
391 | |
392 | d_castneg (d_castneg.U): |
393 | This variable conditionally defines CASTNEG, which indicates |
394 | wether the C compiler can cast negative float to unsigned. |
395 | |
396 | d_charvspr (d_vprintf.U): |
397 | This variable conditionally defines CHARVSPRINTF if this system |
398 | has vsprintf returning type (char*). The trend seems to be to |
399 | declare it as "int vsprintf()". |
400 | |
401 | d_chown (d_chown.U): |
402 | This variable conditionally defines the HAS_CHOWN symbol, which |
403 | indicates to the C program that the chown() routine is available. |
404 | |
405 | d_chroot (d_chroot.U): |
406 | This variable conditionally defines the HAS_CHROOT symbol, which |
407 | indicates to the C program that the chroot() routine is available. |
408 | |
409 | d_chsize (d_chsize.U): |
410 | This variable conditionally defines the CHSIZE symbol, which |
411 | indicates to the C program that the chsize() routine is available |
412 | to truncate files. You might need a -lx to get this routine. |
413 | |
414 | d_closedir (d_closedir.U): |
415 | This variable conditionally defines HAS_CLOSEDIR if closedir() is |
416 | available. |
417 | |
781b178c |
418 | d_const (d_const.U): |
419 | This variable conditionally defines the HASCONST symbol, which |
420 | indicates to the C program that this C compiler knows about the |
421 | const type. |
422 | |
423 | d_crypt (d_crypt.U): |
424 | This variable conditionally defines the CRYPT symbol, which |
425 | indicates to the C program that the crypt() routine is available |
426 | to encrypt passwords and the like. |
427 | |
428 | d_csh (d_csh.U): |
429 | This variable conditionally defines the CSH symbol, which |
430 | indicates to the C program that the C-shell exists. |
431 | |
432 | d_cuserid (d_cuserid.U): |
433 | This variable conditionally defines the HAS_CUSERID symbol, which |
434 | indicates to the C program that the cuserid() routine is available |
435 | to get character login names. |
436 | |
437 | d_dbl_dig (d_dbl_dig.U): |
438 | This variable conditionally defines d_dbl_dig if this system's |
439 | header files provide DBL_DIG, which is the number of significant |
440 | digits in a double precision number. |
441 | |
781b178c |
442 | d_difftime (d_difftime.U): |
443 | This variable conditionally defines the HAS_DIFFTIME symbol, which |
444 | indicates to the C program that the difftime() routine is available. |
445 | |
781b178c |
446 | d_dirnamlen (i_dirent.U): |
447 | This variable conditionally defines DIRNAMLEN, which indicates |
448 | to the C program that the length of directory entry names is |
449 | provided by a d_namelen field. |
450 | |
451 | d_dlerror (d_dlerror.U): |
452 | This variable conditionally defines the HAS_DLERROR symbol, which |
453 | indicates to the C program that the dlerror() routine is available. |
454 | |
455 | d_dlopen (d_dlopen.U): |
456 | This variable conditionally defines the HAS_DLOPEN symbol, which |
457 | indicates to the C program that the dlopen() routine is available. |
458 | |
459 | d_dlsymun (d_dlsymun.U): |
460 | This variable conditionally defines DLSYM_NEEDS_UNDERSCORE, which |
461 | indicates that we need to prepend an underscore to the symbol |
462 | name before calling dlsym(). |
463 | |
464 | d_dosuid (d_dosuid.U): |
465 | This variable conditionally defines the symbol DOSUID, which |
466 | tells the C program that it should insert setuid emulation code |
467 | on hosts which have setuid #! scripts disabled. |
468 | |
469 | d_drand48proto (d_drand48proto.U): |
470 | This variable conditionally defines the HAS_DRAND48_PROTO symbol, |
471 | which indicates to the C program that the system provides |
472 | a prototype for the drand48() function. Otherwise, it is |
473 | up to the program to supply one. |
474 | |
475 | d_dup2 (d_dup2.U): |
476 | This variable conditionally defines HAS_DUP2 if dup2() is |
477 | available to duplicate file descriptors. |
478 | |
479 | d_eaccess (d_eaccess.U): |
480 | This variable conditionally defines the HAS_EACCESS symbol, which |
481 | indicates to the C program that the eaccess() routine is available. |
482 | |
483 | d_endgrent (d_endgrent.U): |
484 | This variable conditionally defines the HAS_ENDGRENT symbol, which |
485 | indicates to the C program that the endgrent() routine is available |
486 | for sequential access of the group database. |
487 | |
488 | d_endhent (d_endhent.U): |
489 | This variable conditionally defines HAS_ENDHOSTENT if endhostent() is |
490 | available to close whatever was being used for host queries. |
491 | |
492 | d_endnent (d_endnent.U): |
493 | This variable conditionally defines HAS_ENDNETENT if endnetent() is |
494 | available to close whatever was being used for network queries. |
495 | |
496 | d_endpent (d_endpent.U): |
497 | This variable conditionally defines HAS_ENDPROTOENT if endprotoent() is |
498 | available to close whatever was being used for protocol queries. |
499 | |
500 | d_endpwent (d_endpwent.U): |
501 | This variable conditionally defines the HAS_ENDPWENT symbol, which |
502 | indicates to the C program that the endpwent() routine is available |
503 | for sequential access of the passwd database. |
504 | |
505 | d_endsent (d_endsent.U): |
506 | This variable conditionally defines HAS_ENDSERVENT if endservent() is |
507 | available to close whatever was being used for service queries. |
508 | |
509 | d_endspent (d_endspent.U): |
510 | This variable conditionally defines HAS_ENDSPENT if endspent() is |
511 | available to finalize the scan of SysV shadow password entries. |
512 | |
513 | d_eofnblk (nblock_io.U): |
514 | This variable conditionally defines EOF_NONBLOCK if EOF can be seen |
515 | when reading from a non-blocking I/O source. |
516 | |
517 | d_eunice (Guess.U): |
518 | This variable conditionally defines the symbols EUNICE and VAX, which |
519 | alerts the C program that it must deal with ideosyncracies of VMS. |
520 | |
521 | d_fchmod (d_fchmod.U): |
522 | This variable conditionally defines the HAS_FCHMOD symbol, which |
523 | indicates to the C program that the fchmod() routine is available |
524 | to change mode of opened files. |
525 | |
526 | d_fchown (d_fchown.U): |
527 | This variable conditionally defines the HAS_FCHOWN symbol, which |
528 | indicates to the C program that the fchown() routine is available |
529 | to change ownership of opened files. |
530 | |
531 | d_fcntl (d_fcntl.U): |
532 | This variable conditionally defines the HAS_FCNTL symbol, and indicates |
533 | whether the fcntl() function exists |
534 | |
535 | d_fd_macros (d_fd_set.U): |
536 | This variable contains the eventual value of the HAS_FD_MACROS symbol, |
537 | which indicates if your C compiler knows about the macros which |
538 | manipulate an fd_set. |
539 | |
540 | d_fd_set (d_fd_set.U): |
541 | This variable contains the eventual value of the HAS_FD_SET symbol, |
542 | which indicates if your C compiler knows about the fd_set typedef. |
543 | |
544 | d_fds_bits (d_fd_set.U): |
545 | This variable contains the eventual value of the HAS_FDS_BITS symbol, |
546 | which indicates if your fd_set typedef contains the fds_bits member. |
547 | If you have an fd_set typedef, but the dweebs who installed it did |
548 | a half-fast job and neglected to provide the macros to manipulate |
549 | an fd_set, HAS_FDS_BITS will let us know how to fix the gaffe. |
550 | |
781b178c |
551 | d_fgetpos (d_fgetpos.U): |
552 | This variable conditionally defines HAS_FGETPOS if fgetpos() is |
553 | available to get the file position indicator. |
554 | |
781b178c |
555 | d_flexfnam (d_flexfnam.U): |
556 | This variable conditionally defines the FLEXFILENAMES symbol, which |
557 | indicates that the system supports filenames longer than 14 characters. |
558 | |
781b178c |
559 | d_flock (d_flock.U): |
560 | This variable conditionally defines HAS_FLOCK if flock() is |
561 | available to do file locking. |
562 | |
781b178c |
563 | d_fork (d_fork.U): |
564 | This variable conditionally defines the HAS_FORK symbol, which |
565 | indicates to the C program that the fork() routine is available. |
566 | |
567 | d_fpathconf (d_pathconf.U): |
568 | This variable conditionally defines the HAS_FPATHCONF symbol, which |
569 | indicates to the C program that the pathconf() routine is available |
570 | to determine file-system related limits and options associated |
571 | with a given open file descriptor. |
572 | |
c890dc6c |
573 | d_fpos64_t (d_fpos64_t.U): |
ca24dfc6 |
574 | This symbol will be defined if the C compiler supports fpos64_t. |
781b178c |
575 | |
ad27e871 |
576 | d_fs_data_s (d_fs_data_s.U): |
0545a864 |
577 | This variable conditionally defines the HAS_STRUCT_FS_DATA symbol, |
578 | which indicates that the struct fs_data is supported. |
579 | |
781b178c |
580 | d_fseeko (d_fseeko.U): |
581 | This variable conditionally defines the HAS_FSEEKO symbol, which |
582 | indicates to the C program that the fseeko() routine is available. |
583 | |
781b178c |
584 | d_fsetpos (d_fsetpos.U): |
585 | This variable conditionally defines HAS_FSETPOS if fsetpos() is |
586 | available to set the file position indicator. |
587 | |
0545a864 |
588 | d_fstatfs (d_fstatfs.U): |
781b178c |
589 | This variable conditionally defines the HAS_FSTATFS symbol, which |
590 | indicates to the C program that the fstatfs() routine is available. |
591 | |
592 | d_fstatvfs (d_statvfs.U): |
593 | This variable conditionally defines the HAS_FSTATVFS symbol, which |
594 | indicates to the C program that the fstatvfs() routine is available. |
595 | |
781b178c |
596 | d_ftello (d_ftello.U): |
597 | This variable conditionally defines the HAS_FTELLO symbol, which |
598 | indicates to the C program that the ftello() routine is available. |
599 | |
600 | d_ftime (d_ftime.U): |
601 | This variable conditionally defines the HAS_FTIME symbol, which indicates |
602 | that the ftime() routine exists. The ftime() routine is basically |
603 | a sub-second accuracy clock. |
604 | |
ff935051 |
605 | d_Gconvert (d_gconvert.U): |
606 | This variable holds what Gconvert is defined as to convert |
607 | floating point numbers into strings. It could be 'gconvert' |
608 | or a more complex macro emulating gconvert with gcvt() or sprintf. |
609 | Possible values are: |
610 | d_Gconvert='gconvert((x),(n),(t),(b))' |
611 | d_Gconvert='gcvt((x),(n),(b))' |
612 | d_Gconvert='sprintf((b),"%.*g",(n),(x))' |
613 | |
49dabb45 |
614 | d_getcwd (d_getcwd.U): |
615 | This variable conditionally defines the HAS_GETCWD symbol, which |
616 | indicates to the C program that the getcwd() routine is available |
617 | to get the current working directory. |
618 | |
c890dc6c |
619 | d_getfsstat (d_getfsstat.U): |
620 | This variable conditionally defines the HAS_GETFSSTAT symbol, which |
621 | indicates to the C program that the getfsstat() routine is available. |
622 | |
781b178c |
623 | d_getgrent (d_getgrent.U): |
624 | This variable conditionally defines the HAS_GETGRENT symbol, which |
625 | indicates to the C program that the getgrent() routine is available |
626 | for sequential access of the group database. |
627 | |
628 | d_getgrps (d_getgrps.U): |
629 | This variable conditionally defines the HAS_GETGROUPS symbol, which |
630 | indicates to the C program that the getgroups() routine is available |
631 | to get the list of process groups. |
632 | |
633 | d_gethbyaddr (d_gethbyad.U): |
634 | This variable conditionally defines the HAS_GETHOSTBYADDR symbol, which |
635 | indicates to the C program that the gethostbyaddr() routine is available |
636 | to look up hosts by their IP addresses. |
637 | |
638 | d_gethbyname (d_gethbynm.U): |
639 | This variable conditionally defines the HAS_GETHOSTBYNAME symbol, which |
640 | indicates to the C program that the gethostbyname() routine is available |
641 | to look up host names in some data base or other. |
642 | |
643 | d_gethent (d_gethent.U): |
644 | This variable conditionally defines HAS_GETHOSTENT if gethostent() is |
645 | available to look up host names in some data base or another. |
646 | |
647 | d_gethname (d_gethname.U): |
648 | This variable conditionally defines the HAS_GETHOSTNAME symbol, which |
649 | indicates to the C program that the gethostname() routine may be |
650 | used to derive the host name. |
651 | |
652 | d_gethostprotos (d_gethostprotos.U): |
653 | This variable conditionally defines the HAS_GETHOST_PROTOS symbol, |
654 | which indicates to the C program that <netdb.h> supplies |
655 | prototypes for the various gethost*() functions. |
656 | See also netdbtype.U for probing for various netdb types. |
657 | |
658 | d_getlogin (d_getlogin.U): |
659 | This variable conditionally defines the HAS_GETLOGIN symbol, which |
660 | indicates to the C program that the getlogin() routine is available |
661 | to get the login name. |
662 | |
ad27e871 |
663 | d_getmnt (d_getmnt.U): |
664 | This variable conditionally defines the HAS_GETMNT symbol, which |
665 | indicates to the C program that the getmnt() routine is available |
666 | to retrieve one or more mount info blocks by filename. |
667 | |
781b178c |
668 | d_getmntent (d_getmntent.U): |
669 | This variable conditionally defines the HAS_GETMNTENT symbol, which |
670 | indicates to the C program that the getmntent() routine is available |
0617aed7 |
671 | to iterate through mounted files to get their mount info. |
781b178c |
672 | |
673 | d_getnbyaddr (d_getnbyad.U): |
674 | This variable conditionally defines the HAS_GETNETBYADDR symbol, which |
675 | indicates to the C program that the getnetbyaddr() routine is available |
676 | to look up networks by their IP addresses. |
677 | |
678 | d_getnbyname (d_getnbynm.U): |
679 | This variable conditionally defines the HAS_GETNETBYNAME symbol, which |
680 | indicates to the C program that the getnetbyname() routine is available |
681 | to look up networks by their names. |
682 | |
683 | d_getnent (d_getnent.U): |
684 | This variable conditionally defines HAS_GETNETENT if getnetent() is |
685 | available to look up network names in some data base or another. |
686 | |
687 | d_getnetprotos (d_getnetprotos.U): |
688 | This variable conditionally defines the HAS_GETNET_PROTOS symbol, |
689 | which indicates to the C program that <netdb.h> supplies |
690 | prototypes for the various getnet*() functions. |
691 | See also netdbtype.U for probing for various netdb types. |
692 | |
693 | d_getpbyname (d_getprotby.U): |
694 | This variable conditionally defines the HAS_GETPROTOBYNAME |
695 | symbol, which indicates to the C program that the |
696 | getprotobyname() routine is available to look up protocols |
697 | by their name. |
698 | |
699 | d_getpbynumber (d_getprotby.U): |
700 | This variable conditionally defines the HAS_GETPROTOBYNUMBER |
701 | symbol, which indicates to the C program that the |
702 | getprotobynumber() routine is available to look up protocols |
703 | by their number. |
704 | |
705 | d_getpent (d_getpent.U): |
706 | This variable conditionally defines HAS_GETPROTOENT if getprotoent() is |
707 | available to look up protocols in some data base or another. |
708 | |
709 | d_getpgid (d_getpgid.U): |
710 | This variable conditionally defines the HAS_GETPGID symbol, which |
711 | indicates to the C program that the getpgid(pid) function |
712 | is available to get the process group id. |
713 | |
714 | d_getpgrp2 (d_getpgrp2.U): |
715 | This variable conditionally defines the HAS_GETPGRP2 symbol, which |
716 | indicates to the C program that the getpgrp2() (as in DG/UX) routine |
717 | is available to get the current process group. |
718 | |
719 | d_getpgrp (d_getpgrp.U): |
720 | This variable conditionally defines HAS_GETPGRP if getpgrp() is |
721 | available to get the current process group. |
722 | |
723 | d_getppid (d_getppid.U): |
724 | This variable conditionally defines the HAS_GETPPID symbol, which |
725 | indicates to the C program that the getppid() routine is available |
726 | to get the parent process ID. |
727 | |
728 | d_getprior (d_getprior.U): |
729 | This variable conditionally defines HAS_GETPRIORITY if getpriority() |
730 | is available to get a process's priority. |
731 | |
732 | d_getprotoprotos (d_getprotoprotos.U): |
733 | This variable conditionally defines the HAS_GETPROTO_PROTOS symbol, |
734 | which indicates to the C program that <netdb.h> supplies |
735 | prototypes for the various getproto*() functions. |
736 | See also netdbtype.U for probing for various netdb types. |
737 | |
738 | d_getpwent (d_getpwent.U): |
739 | This variable conditionally defines the HAS_GETPWENT symbol, which |
740 | indicates to the C program that the getpwent() routine is available |
741 | for sequential access of the passwd database. |
742 | |
743 | d_getsbyname (d_getsrvby.U): |
744 | This variable conditionally defines the HAS_GETSERVBYNAME |
745 | symbol, which indicates to the C program that the |
746 | getservbyname() routine is available to look up services |
747 | by their name. |
748 | |
749 | d_getsbyport (d_getsrvby.U): |
750 | This variable conditionally defines the HAS_GETSERVBYPORT |
751 | symbol, which indicates to the C program that the |
752 | getservbyport() routine is available to look up services |
753 | by their port. |
754 | |
755 | d_getsent (d_getsent.U): |
756 | This variable conditionally defines HAS_GETSERVENT if getservent() is |
757 | available to look up network services in some data base or another. |
758 | |
759 | d_getservprotos (d_getservprotos.U): |
760 | This variable conditionally defines the HAS_GETSERV_PROTOS symbol, |
761 | which indicates to the C program that <netdb.h> supplies |
762 | prototypes for the various getserv*() functions. |
763 | See also netdbtype.U for probing for various netdb types. |
764 | |
765 | d_getspent (d_getspent.U): |
766 | This variable conditionally defines HAS_GETSPENT if getspent() is |
767 | available to retrieve SysV shadow password entries sequentially. |
768 | |
769 | d_getspnam (d_getspnam.U): |
770 | This variable conditionally defines HAS_GETSPNAM if getspnam() is |
771 | available to retrieve SysV shadow password entries by name. |
772 | |
773 | d_gettimeod (d_ftime.U): |
774 | This variable conditionally defines the HAS_GETTIMEOFDAY symbol, which |
775 | indicates that the gettimeofday() system call exists (to obtain a |
776 | sub-second accuracy clock). You should probably include <sys/resource.h>. |
777 | |
778 | d_gnulibc (d_gnulibc.U): |
779 | Defined if we're dealing with the GNU C Library. |
780 | |
781 | d_grpasswd (i_grp.U): |
782 | This variable conditionally defines GRPASSWD, which indicates |
783 | that struct group in <grp.h> contains gr_passwd. |
784 | |
785 | d_hasmntopt (d_hasmntopt.U): |
786 | This variable conditionally defines the HAS_HASMNTOPT symbol, which |
787 | indicates to the C program that the hasmntopt() routine is available |
788 | to query the mount options of file systems. |
789 | |
790 | d_htonl (d_htonl.U): |
791 | This variable conditionally defines HAS_HTONL if htonl() and its |
792 | friends are available to do network order byte swapping. |
793 | |
fe749a9f |
794 | d_iconv (d_iconv.U): |
795 | This variable conditionally defines the HAS_ICONV symbol, which |
796 | indicates to the C program that the iconv() routine is available. |
797 | |
781b178c |
798 | d_index (d_strchr.U): |
799 | This variable conditionally defines HAS_INDEX if index() and |
800 | rindex() are available for string searching. |
801 | |
802 | d_inetaton (d_inetaton.U): |
803 | This variable conditionally defines the HAS_INET_ATON symbol, which |
804 | indicates to the C program that the inet_aton() function is available |
805 | to parse IP address "dotted-quad" strings. |
806 | |
13b3f787 |
807 | d_int64_t (d_int64_t.U): |
781b178c |
808 | This symbol will be defined if the C compiler supports int64_t. |
809 | |
781b178c |
810 | d_isascii (d_isascii.U): |
811 | This variable conditionally defines the HAS_ISASCII constant, |
812 | which indicates to the C program that isascii() is available. |
813 | |
814 | d_killpg (d_killpg.U): |
815 | This variable conditionally defines the HAS_KILLPG symbol, which |
816 | indicates to the C program that the killpg() routine is available |
817 | to kill process groups. |
818 | |
819 | d_lchown (d_lchown.U): |
820 | This variable conditionally defines the HAS_LCHOWN symbol, which |
821 | indicates to the C program that the lchown() routine is available |
822 | to operate on a symbolic link (instead of following the link). |
823 | |
ca24dfc6 |
824 | d_ldbl_dig (d_ldbl_dig.U): |
825 | This variable conditionally defines d_ldbl_dig if this system's |
826 | header files provide LDBL_DIG, which is the number of significant |
827 | digits in a long double precision number. |
828 | |
781b178c |
829 | d_link (d_link.U): |
830 | This variable conditionally defines HAS_LINK if link() is |
831 | available to create hard links. |
832 | |
781b178c |
833 | d_locconv (d_locconv.U): |
834 | This variable conditionally defines HAS_LOCALECONV if localeconv() is |
835 | available for numeric and monetary formatting conventions. |
836 | |
781b178c |
837 | d_lockf (d_lockf.U): |
838 | This variable conditionally defines HAS_LOCKF if lockf() is |
839 | available to do file locking. |
840 | |
841 | d_longdbl (d_longdbl.U): |
842 | This variable conditionally defines HAS_LONG_DOUBLE if |
843 | the long double type is supported. |
844 | |
845 | d_longlong (d_longlong.U): |
846 | This variable conditionally defines HAS_LONG_LONG if |
847 | the long long type is supported. |
848 | |
c890dc6c |
849 | d_lseekproto (d_lseekproto.U): |
850 | This variable conditionally defines the HAS_LSEEK_PROTO symbol, |
851 | which indicates to the C program that the system provides |
852 | a prototype for the lseek() function. Otherwise, it is |
853 | up to the program to supply one. |
854 | |
781b178c |
855 | d_lstat (d_lstat.U): |
856 | This variable conditionally defines HAS_LSTAT if lstat() is |
857 | available to do file stats on symbolic links. |
858 | |
792d8dab |
859 | d_madvise (d_madvise.U): |
860 | This variable conditionally defines HAS_MADVISE if madvise() is |
861 | available to map a file into memory. |
862 | |
781b178c |
863 | d_mblen (d_mblen.U): |
864 | This variable conditionally defines the HAS_MBLEN symbol, which |
865 | indicates to the C program that the mblen() routine is available |
866 | to find the number of bytes in a multibye character. |
867 | |
868 | d_mbstowcs (d_mbstowcs.U): |
869 | This variable conditionally defines the HAS_MBSTOWCS symbol, which |
870 | indicates to the C program that the mbstowcs() routine is available |
871 | to convert a multibyte string into a wide character string. |
872 | |
873 | d_mbtowc (d_mbtowc.U): |
874 | This variable conditionally defines the HAS_MBTOWC symbol, which |
875 | indicates to the C program that the mbtowc() routine is available |
876 | to convert multibyte to a wide character. |
877 | |
878 | d_memchr (d_memchr.U): |
879 | This variable conditionally defines the HAS_MEMCHR symbol, which |
880 | indicates to the C program that the memchr() routine is available |
881 | to locate characters within a C string. |
882 | |
883 | d_memcmp (d_memcmp.U): |
884 | This variable conditionally defines the HAS_MEMCMP symbol, which |
885 | indicates to the C program that the memcmp() routine is available |
886 | to compare blocks of memory. |
887 | |
888 | d_memcpy (d_memcpy.U): |
889 | This variable conditionally defines the HAS_MEMCPY symbol, which |
890 | indicates to the C program that the memcpy() routine is available |
891 | to copy blocks of memory. |
892 | |
893 | d_memmove (d_memmove.U): |
894 | This variable conditionally defines the HAS_MEMMOVE symbol, which |
895 | indicates to the C program that the memmove() routine is available |
896 | to copy potentatially overlapping blocks of memory. |
897 | |
898 | d_memset (d_memset.U): |
899 | This variable conditionally defines the HAS_MEMSET symbol, which |
900 | indicates to the C program that the memset() routine is available |
901 | to set blocks of memory. |
902 | |
903 | d_mkdir (d_mkdir.U): |
904 | This variable conditionally defines the HAS_MKDIR symbol, which |
905 | indicates to the C program that the mkdir() routine is available |
906 | to create directories.. |
907 | |
fe749a9f |
908 | d_mkdtemp (d_mkdtemp.U): |
909 | This variable conditionally defines the HAS_MKDTEMP symbol, which |
910 | indicates to the C program that the mkdtemp() routine is available |
911 | to exclusively create a uniquely named temporary directory. |
912 | |
781b178c |
913 | d_mkfifo (d_mkfifo.U): |
914 | This variable conditionally defines the HAS_MKFIFO symbol, which |
915 | indicates to the C program that the mkfifo() routine is available. |
916 | |
fe749a9f |
917 | d_mkstemp (d_mkstemp.U): |
918 | This variable conditionally defines the HAS_MKSTEMP symbol, which |
919 | indicates to the C program that the mkstemp() routine is available |
920 | to exclusively create and open a uniquely named temporary file. |
921 | |
922 | d_mkstemps (d_mkstemps.U): |
923 | This variable conditionally defines the HAS_MKSTEMPS symbol, which |
924 | indicates to the C program that the mkstemps() routine is available |
925 | to exclusively create and open a uniquely named (with a suffix) |
926 | temporary file. |
927 | |
781b178c |
928 | d_mktime (d_mktime.U): |
929 | This variable conditionally defines the HAS_MKTIME symbol, which |
930 | indicates to the C program that the mktime() routine is available. |
931 | |
fe749a9f |
932 | d_mmap (d_mmap.U): |
933 | This variable conditionally defines HAS_MMAP if mmap() is |
934 | available to map a file into memory. |
935 | |
936 | d_mprotect (d_mprotect.U): |
937 | This variable conditionally defines HAS_MPROTECT if mprotect() is |
938 | available to modify the access protection of a memory mapped file. |
939 | |
781b178c |
940 | d_msg (d_msg.U): |
941 | This variable conditionally defines the HAS_MSG symbol, which |
942 | indicates that the entire msg*(2) library is present. |
943 | |
944 | d_msg_ctrunc (d_socket.U): |
945 | This variable conditionally defines the HAS_MSG_CTRUNC symbol, |
946 | which indicates that the MSG_CTRUNC is available. #ifdef is |
947 | not enough because it may be an enum, glibc has been known to do this. |
948 | |
949 | d_msg_dontroute (d_socket.U): |
950 | This variable conditionally defines the HAS_MSG_DONTROUTE symbol, |
951 | which indicates that the MSG_DONTROUTE is available. #ifdef is |
952 | not enough because it may be an enum, glibc has been known to do this. |
953 | |
954 | d_msg_oob (d_socket.U): |
955 | This variable conditionally defines the HAS_MSG_OOB symbol, |
956 | which indicates that the MSG_OOB is available. #ifdef is |
957 | not enough because it may be an enum, glibc has been known to do this. |
958 | |
959 | d_msg_peek (d_socket.U): |
960 | This variable conditionally defines the HAS_MSG_PEEK symbol, |
961 | which indicates that the MSG_PEEK is available. #ifdef is |
962 | not enough because it may be an enum, glibc has been known to do this. |
963 | |
964 | d_msg_proxy (d_socket.U): |
965 | This variable conditionally defines the HAS_MSG_PROXY symbol, |
966 | which indicates that the MSG_PROXY is available. #ifdef is |
967 | not enough because it may be an enum, glibc has been known to do this. |
968 | |
969 | d_msgctl (d_msgctl.U): |
970 | This variable conditionally defines the HAS_MSGCTL symbol, which |
971 | indicates to the C program that the msgctl() routine is available. |
972 | |
973 | d_msgget (d_msgget.U): |
974 | This variable conditionally defines the HAS_MSGGET symbol, which |
975 | indicates to the C program that the msgget() routine is available. |
976 | |
781b178c |
977 | d_msgrcv (d_msgrcv.U): |
978 | This variable conditionally defines the HAS_MSGRCV symbol, which |
979 | indicates to the C program that the msgrcv() routine is available. |
980 | |
981 | d_msgsnd (d_msgsnd.U): |
982 | This variable conditionally defines the HAS_MSGSND symbol, which |
983 | indicates to the C program that the msgsnd() routine is available. |
984 | |
fe749a9f |
985 | d_msync (d_msync.U): |
986 | This variable conditionally defines HAS_MSYNC if msync() is |
987 | available to synchronize a mapped file. |
988 | |
989 | d_munmap (d_munmap.U): |
990 | This variable conditionally defines HAS_MUNMAP if munmap() is |
991 | available to unmap a region mapped by mmap(). |
992 | |
781b178c |
993 | d_mymalloc (mallocsrc.U): |
994 | This variable conditionally defines MYMALLOC in case other parts |
995 | of the source want to take special action if MYMALLOC is used. |
996 | This may include different sorts of profiling or error detection. |
997 | |
781b178c |
998 | d_nice (d_nice.U): |
999 | This variable conditionally defines the HAS_NICE symbol, which |
1000 | indicates to the C program that the nice() routine is available. |
1001 | |
78691af5 |
1002 | d_nv_preserves_uv (perlxv.U): |
cce08f5b |
1003 | This variable indicates whether a variable of type nvtype |
1004 | can preserve all the bits a variable of type uvtype. |
1005 | |
c890dc6c |
1006 | d_off64_t (d_off64_t.U): |
781b178c |
1007 | This symbol will be defined if the C compiler supports off64_t. |
1008 | |
781b178c |
1009 | d_old_pthread_create_joinable (d_pthrattrj.U): |
1010 | This variable conditionally defines pthread_create_joinable. |
1011 | undef if pthread.h defines PTHREAD_CREATE_JOINABLE. |
1012 | |
1013 | d_oldpthreads (usethreads.U): |
1014 | This variable conditionally defines the OLD_PTHREADS_API symbol, |
1015 | and indicates that Perl should be built to use the old |
8c09e4ca |
1016 | draft POSIX threads API. This is only potentially meaningful if |
781b178c |
1017 | usethreads is set. |
1018 | |
1019 | d_oldsock (d_socket.U): |
1020 | This variable conditionally defines the OLDSOCKET symbol, which |
1021 | indicates that the BSD socket interface is based on 4.1c and not 4.2. |
1022 | |
1023 | d_open3 (d_open3.U): |
1024 | This variable conditionally defines the HAS_OPEN3 manifest constant, |
1025 | which indicates to the C program that the 3 argument version of |
1026 | the open(2) function is available. |
1027 | |
781b178c |
1028 | d_pathconf (d_pathconf.U): |
1029 | This variable conditionally defines the HAS_PATHCONF symbol, which |
1030 | indicates to the C program that the pathconf() routine is available |
1031 | to determine file-system related limits and options associated |
1032 | with a given filename. |
1033 | |
1034 | d_pause (d_pause.U): |
1035 | This variable conditionally defines the HAS_PAUSE symbol, which |
1036 | indicates to the C program that the pause() routine is available |
1037 | to suspend a process until a signal is received. |
1038 | |
1039 | d_phostname (d_gethname.U): |
1040 | This variable conditionally defines the HAS_PHOSTNAME symbol, which |
1041 | contains the shell command which, when fed to popen(), may be |
1042 | used to derive the host name. |
1043 | |
1044 | d_pipe (d_pipe.U): |
1045 | This variable conditionally defines the HAS_PIPE symbol, which |
1046 | indicates to the C program that the pipe() routine is available |
1047 | to create an inter-process channel. |
1048 | |
1049 | d_poll (d_poll.U): |
1050 | This variable conditionally defines the HAS_POLL symbol, which |
1051 | indicates to the C program that the poll() routine is available |
1052 | to poll active file descriptors. |
1053 | |
1054 | d_portable (d_portable.U): |
1055 | This variable conditionally defines the PORTABLE symbol, which |
1056 | indicates to the C program that it should not assume that it is |
1057 | running on the machine it was compiled on. |
1058 | |
ff935051 |
1059 | d_PRId64 (quadfio.U): |
1060 | This variable conditionally defines the PERL_PRId64 symbol, which |
1061 | indiciates that stdio has a symbol to print 64-bit decimal numbers. |
1062 | |
1063 | d_PRIeldbl (longdblfio.U): |
1064 | This variable conditionally defines the PERL_PRIfldlbl symbol, which |
1065 | indiciates that stdio has a symbol to print long doubles. |
1066 | |
1067 | d_PRIEldbl (longdblfio.U): |
1068 | This variable conditionally defines the PERL_PRIfldlbl symbol, which |
1069 | indiciates that stdio has a symbol to print long doubles. |
1070 | |
1071 | d_PRIfldbl (longdblfio.U): |
1072 | This variable conditionally defines the PERL_PRIfldlbl symbol, which |
1073 | indiciates that stdio has a symbol to print long doubles. |
1074 | |
1075 | d_PRIFldbl (longdblfio.U): |
1076 | This variable conditionally defines the PERL_PRIfldlbl symbol, which |
1077 | indiciates that stdio has a symbol to print long doubles. |
1078 | |
1079 | d_PRIgldbl (longdblfio.U): |
1080 | This variable conditionally defines the PERL_PRIfldlbl symbol, which |
1081 | indiciates that stdio has a symbol to print long doubles. |
1082 | |
1083 | d_PRIGldbl (longdblfio.U): |
1084 | This variable conditionally defines the PERL_PRIfldlbl symbol, which |
1085 | indiciates that stdio has a symbol to print long doubles. |
1086 | |
1087 | d_PRIi64 (quadfio.U): |
1088 | This variable conditionally defines the PERL_PRIi64 symbol, which |
1089 | indiciates that stdio has a symbol to print 64-bit decimal numbers. |
1090 | |
1091 | d_PRIo64 (quadfio.U): |
1092 | This variable conditionally defines the PERL_PRIo64 symbol, which |
1093 | indiciates that stdio has a symbol to print 64-bit octal numbers. |
1094 | |
1095 | d_PRIu64 (quadfio.U): |
1096 | This variable conditionally defines the PERL_PRIu64 symbol, which |
1097 | indiciates that stdio has a symbol to print 64-bit unsigned decimal |
1098 | numbers. |
1099 | |
1100 | d_PRIx64 (quadfio.U): |
1101 | This variable conditionally defines the PERL_PRIx64 symbol, which |
1102 | indiciates that stdio has a symbol to print 64-bit hexadecimal numbers. |
1103 | |
1104 | d_PRIX64 (quadfio.U): |
1105 | This variable conditionally defines the PERL_PRIX64 symbol, which |
1106 | indiciates that stdio has a symbol to print 64-bit hExADECimAl numbers. |
1107 | |
781b178c |
1108 | d_pthread_yield (d_pthread_y.U): |
1109 | This variable conditionally defines the HAS_PTHREAD_YIELD |
1110 | symbol if the pthread_yield routine is available to yield |
1111 | the execution of the current thread. |
1112 | |
1113 | d_pwage (i_pwd.U): |
1114 | This variable conditionally defines PWAGE, which indicates |
1115 | that struct passwd contains pw_age. |
1116 | |
1117 | d_pwchange (i_pwd.U): |
1118 | This variable conditionally defines PWCHANGE, which indicates |
1119 | that struct passwd contains pw_change. |
1120 | |
1121 | d_pwclass (i_pwd.U): |
1122 | This variable conditionally defines PWCLASS, which indicates |
1123 | that struct passwd contains pw_class. |
1124 | |
1125 | d_pwcomment (i_pwd.U): |
1126 | This variable conditionally defines PWCOMMENT, which indicates |
1127 | that struct passwd contains pw_comment. |
1128 | |
1129 | d_pwexpire (i_pwd.U): |
1130 | This variable conditionally defines PWEXPIRE, which indicates |
1131 | that struct passwd contains pw_expire. |
1132 | |
1133 | d_pwgecos (i_pwd.U): |
1134 | This variable conditionally defines PWGECOS, which indicates |
1135 | that struct passwd contains pw_gecos. |
1136 | |
1137 | d_pwpasswd (i_pwd.U): |
1138 | This variable conditionally defines PWPASSWD, which indicates |
1139 | that struct passwd contains pw_passwd. |
1140 | |
1141 | d_pwquota (i_pwd.U): |
1142 | This variable conditionally defines PWQUOTA, which indicates |
1143 | that struct passwd contains pw_quota. |
1144 | |
792d8dab |
1145 | d_qgcvt (d_qgcvt.U): |
1146 | This variable conditionally defines the HAS_QGCVT symbol, which |
1147 | indicates to the C program that the qgcvt() routine is available. |
1148 | |
de1c2614 |
1149 | d_quad (quadtype.U): |
1150 | This variable, if defined, tells that there's a 64-bit integer type, |
1151 | quadtype. |
1152 | |
781b178c |
1153 | d_readdir (d_readdir.U): |
1154 | This variable conditionally defines HAS_READDIR if readdir() is |
1155 | available to read directory entries. |
1156 | |
1157 | d_readlink (d_readlink.U): |
1158 | This variable conditionally defines the HAS_READLINK symbol, which |
1159 | indicates to the C program that the readlink() routine is available |
1160 | to read the value of a symbolic link. |
1161 | |
781b178c |
1162 | d_rename (d_rename.U): |
1163 | This variable conditionally defines the HAS_RENAME symbol, which |
1164 | indicates to the C program that the rename() routine is available |
1165 | to rename files. |
1166 | |
1167 | d_rewinddir (d_readdir.U): |
1168 | This variable conditionally defines HAS_REWINDDIR if rewinddir() is |
1169 | available. |
1170 | |
1171 | d_rmdir (d_rmdir.U): |
1172 | This variable conditionally defines HAS_RMDIR if rmdir() is |
1173 | available to remove directories. |
1174 | |
1175 | d_safebcpy (d_safebcpy.U): |
1176 | This variable conditionally defines the HAS_SAFE_BCOPY symbol if |
1177 | the bcopy() routine can do overlapping copies. |
1178 | |
1179 | d_safemcpy (d_safemcpy.U): |
1180 | This variable conditionally defines the HAS_SAFE_MEMCPY symbol if |
1181 | the memcpy() routine can do overlapping copies. |
1182 | |
1183 | d_sanemcmp (d_sanemcmp.U): |
1184 | This variable conditionally defines the HAS_SANE_MEMCMP symbol if |
1185 | the memcpy() routine is available and can be used to compare relative |
1186 | magnitudes of chars with their high bits set. |
1187 | |
1188 | d_sched_yield (d_pthread_y.U): |
1189 | This variable conditionally defines the HAS_SCHED_YIELD |
1190 | symbol if the sched_yield routine is available to yield |
1191 | the execution of the current thread. |
1192 | |
1193 | d_scm_rights (d_socket.U): |
1194 | This variable conditionally defines the HAS_SCM_RIGHTS symbol, |
1195 | which indicates that the SCM_RIGHTS is available. #ifdef is |
1196 | not enough because it may be an enum, glibc has been known to do this. |
1197 | |
781b178c |
1198 | d_seekdir (d_readdir.U): |
1199 | This variable conditionally defines HAS_SEEKDIR if seekdir() is |
1200 | available. |
1201 | |
1202 | d_select (d_select.U): |
1203 | This variable conditionally defines HAS_SELECT if select() is |
1204 | available to select active file descriptors. A <sys/time.h> |
1205 | inclusion may be necessary for the timeout field. |
1206 | |
1207 | d_sem (d_sem.U): |
1208 | This variable conditionally defines the HAS_SEM symbol, which |
1209 | indicates that the entire sem*(2) library is present. |
1210 | |
1211 | d_semctl (d_semctl.U): |
1212 | This variable conditionally defines the HAS_SEMCTL symbol, which |
1213 | indicates to the C program that the semctl() routine is available. |
1214 | |
1215 | d_semctl_semid_ds (d_union_semun.U): |
1216 | This variable conditionally defines USE_SEMCTL_SEMID_DS, which |
1217 | indicates that struct semid_ds * is to be used for semctl IPC_STAT. |
1218 | |
1219 | d_semctl_semun (d_union_semun.U): |
1220 | This variable conditionally defines USE_SEMCTL_SEMUN, which |
1221 | indicates that union semun is to be used for semctl IPC_STAT. |
1222 | |
1223 | d_semget (d_semget.U): |
1224 | This variable conditionally defines the HAS_SEMGET symbol, which |
1225 | indicates to the C program that the semget() routine is available. |
1226 | |
1227 | d_semop (d_semop.U): |
1228 | This variable conditionally defines the HAS_SEMOP symbol, which |
1229 | indicates to the C program that the semop() routine is available. |
1230 | |
781b178c |
1231 | d_setegid (d_setegid.U): |
1232 | This variable conditionally defines the HAS_SETEGID symbol, which |
1233 | indicates to the C program that the setegid() routine is available |
1234 | to change the effective gid of the current program. |
1235 | |
1236 | d_seteuid (d_seteuid.U): |
1237 | This variable conditionally defines the HAS_SETEUID symbol, which |
1238 | indicates to the C program that the seteuid() routine is available |
1239 | to change the effective uid of the current program. |
1240 | |
1241 | d_setgrent (d_setgrent.U): |
1242 | This variable conditionally defines the HAS_SETGRENT symbol, which |
1243 | indicates to the C program that the setgrent() routine is available |
1244 | for initializing sequential access to the group database. |
1245 | |
1246 | d_setgrps (d_setgrps.U): |
1247 | This variable conditionally defines the HAS_SETGROUPS symbol, which |
1248 | indicates to the C program that the setgroups() routine is available |
1249 | to set the list of process groups. |
1250 | |
1251 | d_sethent (d_sethent.U): |
1252 | This variable conditionally defines HAS_SETHOSTENT if sethostent() is |
1253 | available. |
1254 | |
1255 | d_setlinebuf (d_setlnbuf.U): |
1256 | This variable conditionally defines the HAS_SETLINEBUF symbol, which |
1257 | indicates to the C program that the setlinebuf() routine is available |
1258 | to change stderr or stdout from block-buffered or unbuffered to a |
1259 | line-buffered mode. |
1260 | |
1261 | d_setlocale (d_setlocale.U): |
1262 | This variable conditionally defines HAS_SETLOCALE if setlocale() is |
1263 | available to handle locale-specific ctype implementations. |
1264 | |
1265 | d_setnent (d_setnent.U): |
1266 | This variable conditionally defines HAS_SETNETENT if setnetent() is |
1267 | available. |
1268 | |
1269 | d_setpent (d_setpent.U): |
1270 | This variable conditionally defines HAS_SETPROTOENT if setprotoent() is |
1271 | available. |
1272 | |
1273 | d_setpgid (d_setpgid.U): |
1274 | This variable conditionally defines the HAS_SETPGID symbol if the |
1275 | setpgid(pid, gpid) function is available to set process group ID. |
1276 | |
1277 | d_setpgrp2 (d_setpgrp2.U): |
1278 | This variable conditionally defines the HAS_SETPGRP2 symbol, which |
1279 | indicates to the C program that the setpgrp2() (as in DG/UX) routine |
1280 | is available to set the current process group. |
1281 | |
1282 | d_setpgrp (d_setpgrp.U): |
1283 | This variable conditionally defines HAS_SETPGRP if setpgrp() is |
1284 | available to set the current process group. |
1285 | |
1286 | d_setprior (d_setprior.U): |
1287 | This variable conditionally defines HAS_SETPRIORITY if setpriority() |
1288 | is available to set a process's priority. |
1289 | |
1290 | d_setpwent (d_setpwent.U): |
1291 | This variable conditionally defines the HAS_SETPWENT symbol, which |
1292 | indicates to the C program that the setpwent() routine is available |
1293 | for initializing sequential access to the passwd database. |
1294 | |
1295 | d_setregid (d_setregid.U): |
1296 | This variable conditionally defines HAS_SETREGID if setregid() is |
1297 | available to change the real and effective gid of the current |
1298 | process. |
1299 | |
1300 | d_setresgid (d_setregid.U): |
1301 | This variable conditionally defines HAS_SETRESGID if setresgid() is |
1302 | available to change the real, effective and saved gid of the current |
1303 | process. |
1304 | |
1305 | d_setresuid (d_setreuid.U): |
1306 | This variable conditionally defines HAS_SETREUID if setresuid() is |
1307 | available to change the real, effective and saved uid of the current |
1308 | process. |
1309 | |
1310 | d_setreuid (d_setreuid.U): |
1311 | This variable conditionally defines HAS_SETREUID if setreuid() is |
1312 | available to change the real and effective uid of the current |
1313 | process. |
1314 | |
1315 | d_setrgid (d_setrgid.U): |
1316 | This variable conditionally defines the HAS_SETRGID symbol, which |
1317 | indicates to the C program that the setrgid() routine is available |
1318 | to change the real gid of the current program. |
1319 | |
1320 | d_setruid (d_setruid.U): |
1321 | This variable conditionally defines the HAS_SETRUID symbol, which |
1322 | indicates to the C program that the setruid() routine is available |
1323 | to change the real uid of the current program. |
1324 | |
1325 | d_setsent (d_setsent.U): |
1326 | This variable conditionally defines HAS_SETSERVENT if setservent() is |
1327 | available. |
1328 | |
1329 | d_setsid (d_setsid.U): |
1330 | This variable conditionally defines HAS_SETSID if setsid() is |
1331 | available to set the process group ID. |
1332 | |
1333 | d_setspent (d_setspent.U): |
1334 | This variable conditionally defines HAS_SETSPENT if setspent() is |
1335 | available to initialize the scan of SysV shadow password entries. |
1336 | |
1337 | d_setvbuf (d_setvbuf.U): |
1338 | This variable conditionally defines the HAS_SETVBUF symbol, which |
1339 | indicates to the C program that the setvbuf() routine is available |
1340 | to change buffering on an open stdio stream. |
1341 | |
1342 | d_sfio (d_sfio.U): |
1343 | This variable conditionally defines the USE_SFIO symbol, |
1344 | and indicates whether sfio is available (and should be used). |
1345 | |
1346 | d_shm (d_shm.U): |
1347 | This variable conditionally defines the HAS_SHM symbol, which |
1348 | indicates that the entire shm*(2) library is present. |
1349 | |
1350 | d_shmat (d_shmat.U): |
1351 | This variable conditionally defines the HAS_SHMAT symbol, which |
1352 | indicates to the C program that the shmat() routine is available. |
1353 | |
1354 | d_shmatprototype (d_shmat.U): |
1355 | This variable conditionally defines the HAS_SHMAT_PROTOTYPE |
1356 | symbol, which indicates that sys/shm.h has a prototype for |
1357 | shmat. |
1358 | |
1359 | d_shmctl (d_shmctl.U): |
1360 | This variable conditionally defines the HAS_SHMCTL symbol, which |
1361 | indicates to the C program that the shmctl() routine is available. |
1362 | |
1363 | d_shmdt (d_shmdt.U): |
1364 | This variable conditionally defines the HAS_SHMDT symbol, which |
1365 | indicates to the C program that the shmdt() routine is available. |
1366 | |
1367 | d_shmget (d_shmget.U): |
1368 | This variable conditionally defines the HAS_SHMGET symbol, which |
1369 | indicates to the C program that the shmget() routine is available. |
1370 | |
1371 | d_sigaction (d_sigaction.U): |
1372 | This variable conditionally defines the HAS_SIGACTION symbol, which |
1373 | indicates that the Vr4 sigaction() routine is available. |
1374 | |
1375 | d_sigsetjmp (d_sigsetjmp.U): |
1376 | This variable conditionally defines the HAS_SIGSETJMP symbol, |
1377 | which indicates that the sigsetjmp() routine is available to |
1378 | call setjmp() and optionally save the process's signal mask. |
1379 | |
1380 | d_socket (d_socket.U): |
1381 | This variable conditionally defines HAS_SOCKET, which indicates |
1382 | that the BSD socket interface is supported. |
1383 | |
13b3f787 |
1384 | d_socklen_t (d_socklen_t.U): |
1385 | This symbol will be defined if the C compiler supports socklen_t. |
1386 | |
781b178c |
1387 | d_sockpair (d_socket.U): |
1388 | This variable conditionally defines the HAS_SOCKETPAIR symbol, which |
1389 | indicates that the BSD socketpair() is supported. |
1390 | |
68d4903c |
1391 | d_sqrtl (d_sqrtl.U): |
1392 | This variable conditionally defines the HAS_SQRTL symbol, which |
1393 | indicates to the C program that the sqrtl() routine is available. |
1394 | |
781b178c |
1395 | d_statblks (d_statblks.U): |
1396 | This variable conditionally defines USE_STAT_BLOCKS |
1397 | if this system has a stat structure declaring |
1398 | st_blksize and st_blocks. |
1399 | |
ad27e871 |
1400 | d_statfs_f_flags (d_statfs_f_flags.U): |
0545a864 |
1401 | This variable conditionally defines the HAS_STRUCT_STATFS_F_FLAGS |
781b178c |
1402 | symbol, which indicates to struct statfs from has f_flags member. |
1403 | This kind of struct statfs is coming from sys/mount.h (BSD), |
1404 | not from sys/statfs.h (SYSV). |
1405 | |
ad27e871 |
1406 | d_statfs_s (d_statfs_s.U): |
0545a864 |
1407 | This variable conditionally defines the HAS_STRUCT_STATFS symbol, |
1408 | which indicates that the struct statfs is supported. |
1409 | |
781b178c |
1410 | d_statvfs (d_statvfs.U): |
1411 | This variable conditionally defines the HAS_STATVFS symbol, which |
1412 | indicates to the C program that the statvfs() routine is available. |
1413 | |
1414 | d_stdio_cnt_lval (d_stdstdio.U): |
1415 | This variable conditionally defines STDIO_CNT_LVALUE if the |
1416 | FILE_cnt macro can be used as an lvalue. |
1417 | |
1418 | d_stdio_ptr_lval (d_stdstdio.U): |
1419 | This variable conditionally defines STDIO_PTR_LVALUE if the |
1420 | FILE_ptr macro can be used as an lvalue. |
1421 | |
1422 | d_stdio_stream_array (stdio_streams.U): |
1423 | This variable tells whether there is an array holding |
1424 | the stdio streams. |
1425 | |
1426 | d_stdiobase (d_stdstdio.U): |
1427 | This variable conditionally defines USE_STDIO_BASE if this system |
1428 | has a FILE structure declaring a usable _base field (or equivalent) |
1429 | in stdio.h. |
1430 | |
1431 | d_stdstdio (d_stdstdio.U): |
1432 | This variable conditionally defines USE_STDIO_PTR if this system |
1433 | has a FILE structure declaring usable _ptr and _cnt fields (or |
1434 | equivalent) in stdio.h. |
1435 | |
781b178c |
1436 | d_strchr (d_strchr.U): |
1437 | This variable conditionally defines HAS_STRCHR if strchr() and |
1438 | strrchr() are available for string searching. |
1439 | |
1440 | d_strcoll (d_strcoll.U): |
1441 | This variable conditionally defines HAS_STRCOLL if strcoll() is |
1442 | available to compare strings using collating information. |
1443 | |
1444 | d_strctcpy (d_strctcpy.U): |
1445 | This variable conditionally defines the USE_STRUCT_COPY symbol, which |
1446 | indicates to the C program that this C compiler knows how to copy |
1447 | structures. |
1448 | |
1449 | d_strerrm (d_strerror.U): |
1450 | This variable holds what Strerrr is defined as to translate an error |
1451 | code condition into an error message string. It could be 'strerror' |
1452 | or a more complex macro emulating strrror with sys_errlist[], or the |
1453 | "unknown" string when both strerror and sys_errlist are missing. |
1454 | |
1455 | d_strerror (d_strerror.U): |
1456 | This variable conditionally defines HAS_STRERROR if strerror() is |
1457 | available to translate error numbers to strings. |
1458 | |
1459 | d_strtod (d_strtod.U): |
1460 | This variable conditionally defines the HAS_STRTOD symbol, which |
1461 | indicates to the C program that the strtod() routine is available |
1462 | to provide better numeric string conversion than atof(). |
1463 | |
1464 | d_strtol (d_strtol.U): |
1465 | This variable conditionally defines the HAS_STRTOL symbol, which |
1466 | indicates to the C program that the strtol() routine is available |
1467 | to provide better numeric string conversion than atoi() and friends. |
1468 | |
ff935051 |
1469 | d_strtold (d_strtold.U): |
1470 | This variable conditionally defines the HAS_STRTOLD symbol, which |
1471 | indicates to the C program that the strtold() routine is available. |
1472 | |
76d49b1c |
1473 | d_strtoll (d_strtoll.U): |
1474 | This variable conditionally defines the HAS_STRTOLL symbol, which |
1475 | indicates to the C program that the strtoll() routine is available. |
1476 | |
781b178c |
1477 | d_strtoul (d_strtoul.U): |
1478 | This variable conditionally defines the HAS_STRTOUL symbol, which |
1479 | indicates to the C program that the strtoul() routine is available |
1480 | to provide conversion of strings to unsigned long. |
1481 | |
ff935051 |
1482 | d_strtoull (d_strtoull.U): |
11dc3f68 |
1483 | This variable conditionally defines the HAS_STRTOULL symbol, which |
1484 | indicates to the C program that the strtoull() routine is available. |
1485 | |
ff935051 |
1486 | d_strtouq (d_strtouq.U): |
1487 | This variable conditionally defines the HAS_STRTOUQ symbol, which |
1488 | indicates to the C program that the strtouq() routine is available. |
1489 | |
781b178c |
1490 | d_strxfrm (d_strxfrm.U): |
1491 | This variable conditionally defines HAS_STRXFRM if strxfrm() is |
1492 | available to transform strings. |
1493 | |
1494 | d_suidsafe (d_dosuid.U): |
1495 | This variable conditionally defines SETUID_SCRIPTS_ARE_SECURE_NOW |
1496 | if setuid scripts can be secure. This test looks in /dev/fd/. |
1497 | |
1498 | d_symlink (d_symlink.U): |
1499 | This variable conditionally defines the HAS_SYMLINK symbol, which |
1500 | indicates to the C program that the symlink() routine is available |
1501 | to create symbolic links. |
1502 | |
1503 | d_syscall (d_syscall.U): |
1504 | This variable conditionally defines HAS_SYSCALL if syscall() is |
1505 | available call arbitrary system calls. |
1506 | |
1507 | d_sysconf (d_sysconf.U): |
1508 | This variable conditionally defines the HAS_SYSCONF symbol, which |
1509 | indicates to the C program that the sysconf() routine is available |
1510 | to determine system related limits and options. |
1511 | |
1512 | d_sysernlst (d_strerror.U): |
1513 | This variable conditionally defines HAS_SYS_ERRNOLIST if sys_errnolist[] |
1514 | is available to translate error numbers to the symbolic name. |
1515 | |
1516 | d_syserrlst (d_strerror.U): |
1517 | This variable conditionally defines HAS_SYS_ERRLIST if sys_errlist[] is |
1518 | available to translate error numbers to strings. |
1519 | |
1520 | d_system (d_system.U): |
1521 | This variable conditionally defines HAS_SYSTEM if system() is |
1522 | available to issue a shell command. |
1523 | |
1524 | d_tcgetpgrp (d_tcgtpgrp.U): |
1525 | This variable conditionally defines the HAS_TCGETPGRP symbol, which |
1526 | indicates to the C program that the tcgetpgrp() routine is available. |
1527 | to get foreground process group ID. |
1528 | |
1529 | d_tcsetpgrp (d_tcstpgrp.U): |
1530 | This variable conditionally defines the HAS_TCSETPGRP symbol, which |
1531 | indicates to the C program that the tcsetpgrp() routine is available |
1532 | to set foreground process group ID. |
1533 | |
781b178c |
1534 | d_telldir (d_readdir.U): |
1535 | This variable conditionally defines HAS_TELLDIR if telldir() is |
1536 | available. |
1537 | |
1538 | d_telldirproto (d_telldirproto.U): |
1539 | This variable conditionally defines the HAS_TELLDIR_PROTO symbol, |
1540 | which indicates to the C program that the system provides |
1541 | a prototype for the telldir() function. Otherwise, it is |
1542 | up to the program to supply one. |
1543 | |
1544 | d_time (d_time.U): |
1545 | This variable conditionally defines the HAS_TIME symbol, which indicates |
1546 | that the time() routine exists. The time() routine is normaly |
1547 | provided on UNIX systems. |
1548 | |
1549 | d_times (d_times.U): |
1550 | This variable conditionally defines the HAS_TIMES symbol, which indicates |
1551 | that the times() routine exists. The times() routine is normaly |
1552 | provided on UNIX systems. You may have to include <sys/times.h>. |
1553 | |
781b178c |
1554 | d_truncate (d_truncate.U): |
1555 | This variable conditionally defines HAS_TRUNCATE if truncate() is |
1556 | available to truncate files. |
1557 | |
1558 | d_tzname (d_tzname.U): |
1559 | This variable conditionally defines HAS_TZNAME if tzname[] is |
1560 | available to access timezone names. |
1561 | |
1562 | d_umask (d_umask.U): |
1563 | This variable conditionally defines the HAS_UMASK symbol, which |
1564 | indicates to the C program that the umask() routine is available. |
1565 | to set and get the value of the file creation mask. |
1566 | |
1567 | d_uname (d_gethname.U): |
1568 | This variable conditionally defines the HAS_UNAME symbol, which |
1569 | indicates to the C program that the uname() routine may be |
1570 | used to derive the host name. |
1571 | |
1572 | d_union_semun (d_union_semun.U): |
1573 | This variable conditionally defines HAS_UNION_SEMUN if the |
1574 | union semun is defined by including <sys/sem.h>. |
1575 | |
0545a864 |
1576 | d_ustat (d_ustat.U): |
1577 | This variable conditionally defines HAS_USTAT if ustat() is |
1578 | available to query file system statistics by dev_t. |
1579 | |
526fdc24 |
1580 | d_vendorarch (vendorarch.U): |
1581 | This variable conditionally defined PERL_VENDORARCH. |
1582 | |
0617aed7 |
1583 | d_vendorbin (vendorbin.U): |
1584 | This variable conditionally defines PERL_VENDORBIN. |
1585 | |
a3635516 |
1586 | d_vendorlib (vendorlib.U): |
1587 | This variable conditionally defines PERL_VENDORLIB. |
1588 | |
781b178c |
1589 | d_vfork (d_vfork.U): |
1590 | This variable conditionally defines the HAS_VFORK symbol, which |
1591 | indicates the vfork() routine is available. |
1592 | |
1593 | d_void_closedir (d_closedir.U): |
1594 | This variable conditionally defines VOID_CLOSEDIR if closedir() |
1595 | does not return a value. |
1596 | |
1597 | d_voidsig (d_voidsig.U): |
1598 | This variable conditionally defines VOIDSIG if this system |
1599 | declares "void (*signal(...))()" in signal.h. The old way was to |
1600 | declare it as "int (*signal(...))()". |
1601 | |
1602 | d_voidtty (i_sysioctl.U): |
1603 | This variable conditionally defines USE_IOCNOTTY to indicate that the |
1604 | ioctl() call with TIOCNOTTY should be used to void tty association. |
1605 | Otherwise (on USG probably), it is enough to close the standard file |
1606 | decriptors and do a setpgrp(). |
1607 | |
1608 | d_volatile (d_volatile.U): |
1609 | This variable conditionally defines the HASVOLATILE symbol, which |
1610 | indicates to the C program that this C compiler knows about the |
1611 | volatile declaration. |
1612 | |
1613 | d_vprintf (d_vprintf.U): |
1614 | This variable conditionally defines the HAS_VPRINTF symbol, which |
1615 | indicates to the C program that the vprintf() routine is available |
1616 | to printf with a pointer to an argument list. |
1617 | |
1618 | d_wait4 (d_wait4.U): |
1619 | This variable conditionally defines the HAS_WAIT4 symbol, which |
1620 | indicates the wait4() routine is available. |
1621 | |
1622 | d_waitpid (d_waitpid.U): |
1623 | This variable conditionally defines HAS_WAITPID if waitpid() is |
1624 | available to wait for child process. |
1625 | |
1626 | d_wcstombs (d_wcstombs.U): |
1627 | This variable conditionally defines the HAS_WCSTOMBS symbol, which |
1628 | indicates to the C program that the wcstombs() routine is available |
1629 | to convert wide character strings to multibyte strings. |
1630 | |
1631 | d_wctomb (d_wctomb.U): |
1632 | This variable conditionally defines the HAS_WCTOMB symbol, which |
1633 | indicates to the C program that the wctomb() routine is available |
1634 | to convert a wide character to a multibyte. |
1635 | |
781b178c |
1636 | d_xenix (Guess.U): |
1637 | This variable conditionally defines the symbol XENIX, which alerts |
1638 | the C program that it runs under Xenix. |
1639 | |
1640 | date (Loc.U): |
5bf26616 |
1641 | This variable is used internally by Configure to determine the |
781b178c |
1642 | full pathname (if any) of the date program. After Configure runs, |
1643 | the value is reset to a plain "date" and is not useful. |
1644 | |
1645 | db_hashtype (i_db.U): |
1646 | This variable contains the type of the hash structure element |
1647 | in the <db.h> header file. In older versions of DB, it was |
1648 | int, while in newer ones it is u_int32_t. |
1649 | |
1650 | db_prefixtype (i_db.U): |
1651 | This variable contains the type of the prefix structure element |
1652 | in the <db.h> header file. In older versions of DB, it was |
1653 | int, while in newer ones it is size_t. |
1654 | |
1655 | defvoidused (voidflags.U): |
1656 | This variable contains the default value of the VOIDUSED symbol (15). |
1657 | |
1658 | direntrytype (i_dirent.U): |
1659 | This symbol is set to 'struct direct' or 'struct dirent' depending on |
1660 | whether dirent is available or not. You should use this pseudo type to |
1661 | portably declare your directory entries. |
1662 | |
1663 | dlext (dlext.U): |
1664 | This variable contains the extension that is to be used for the |
1665 | dynamically loaded modules that perl generaties. |
1666 | |
1667 | dlsrc (dlsrc.U): |
1668 | This variable contains the name of the dynamic loading file that |
1669 | will be used with the package. |
1670 | |
1671 | doublesize (doublesize.U): |
1672 | This variable contains the value of the DOUBLESIZE symbol, which |
1673 | indicates to the C program how many bytes there are in a double. |
1674 | |
1675 | drand01 (randfunc.U): |
1676 | Indicates the macro to be used to generate normalized |
1677 | random numbers. Uses randfunc, often divided by |
1678 | (double) (((unsigned long) 1 << randbits)) in order to |
1679 | normalize the result. |
1680 | In C programs, the macro 'Drand01' is mapped to drand01. |
1681 | |
1682 | dynamic_ext (Extensions.U): |
1683 | This variable holds a list of XS extension files we want to |
1684 | link dynamically into the package. It is used by Makefile. |
1685 | |
1686 | eagain (nblock_io.U): |
1687 | This variable bears the symbolic errno code set by read() when no |
1688 | data is present on the file and non-blocking I/O was enabled (otherwise, |
1689 | read() blocks naturally). |
1690 | |
1691 | ebcdic (ebcdic.U): |
1692 | This variable conditionally defines EBCDIC if this |
1693 | system uses EBCDIC encoding. Among other things, this |
1694 | means that the character ranges are not contiguous. |
1695 | See trnl.U |
1696 | |
1697 | echo (Loc.U): |
5bf26616 |
1698 | This variable is used internally by Configure to determine the |
781b178c |
1699 | full pathname (if any) of the echo program. After Configure runs, |
1700 | the value is reset to a plain "echo" and is not useful. |
1701 | |
1702 | egrep (Loc.U): |
5bf26616 |
1703 | This variable is used internally by Configure to determine the |
781b178c |
1704 | full pathname (if any) of the egrep program. After Configure runs, |
1705 | the value is reset to a plain "egrep" and is not useful. |
1706 | |
1707 | emacs (Loc.U): |
1708 | This variable is defined but not used by Configure. |
1709 | The value is a plain '' and is not useful. |
1710 | |
1711 | eunicefix (Init.U): |
1712 | When running under Eunice this variable contains a command which will |
1713 | convert a shell script to the proper form of text file for it to be |
1714 | executable by the shell. On other systems it is a no-op. |
1715 | |
1716 | exe_ext (Unix.U): |
1717 | This is an old synonym for _exe. |
1718 | |
1719 | expr (Loc.U): |
5bf26616 |
1720 | This variable is used internally by Configure to determine the |
781b178c |
1721 | full pathname (if any) of the expr program. After Configure runs, |
1722 | the value is reset to a plain "expr" and is not useful. |
1723 | |
1724 | extensions (Extensions.U): |
1725 | This variable holds a list of all extension files (both XS and |
1726 | non-xs linked into the package. It is propagated to Config.pm |
1727 | and is typically used to test whether a particular extesion |
1728 | is available. |
1729 | |
1730 | fflushall (fflushall.U): |
1731 | This symbol, if defined, tells that to flush |
1732 | all pending stdio output one must loop through all |
1733 | the stdio file handles stored in an array and fflush them. |
1734 | Note that if fflushNULL is defined, fflushall will not |
1735 | even be probed for and will be left undefined. |
1736 | |
ff935051 |
1737 | fflushNULL (fflushall.U): |
1738 | This symbol, if defined, tells that fflush(NULL) does flush |
1739 | all pending stdio output. |
1740 | |
781b178c |
1741 | find (Loc.U): |
ff935051 |
1742 | This variable is defined but not used by Configure. |
1743 | The value is a plain '' and is not useful. |
781b178c |
1744 | |
1745 | firstmakefile (Unix.U): |
1746 | This variable defines the first file searched by make. On unix, |
1747 | it is makefile (then Makefile). On case-insensitive systems, |
1748 | it might be something else. This is only used to deal with |
1749 | convoluted make depend tricks. |
1750 | |
1751 | flex (Loc.U): |
1752 | This variable is defined but not used by Configure. |
1753 | The value is a plain '' and is not useful. |
1754 | |
a22e52b9 |
1755 | fpossize (fpossize.U): |
1756 | This variable contains the size of a fpostype in bytes. |
1757 | |
781b178c |
1758 | fpostype (fpostype.U): |
a22e52b9 |
1759 | This variable defines Fpos_t to be something like fpos_t, long, |
781b178c |
1760 | uint, or whatever type is used to declare file positions in libc. |
1761 | |
1762 | freetype (mallocsrc.U): |
1763 | This variable contains the return type of free(). It is usually |
1764 | void, but occasionally int. |
1765 | |
1766 | full_ar (Loc_ar.U): |
1767 | This variable contains the full pathname to 'ar', whether or |
1768 | not the user has specified 'portability'. This is only used |
1769 | in the Makefile.SH. |
1770 | |
1771 | full_csh (d_csh.U): |
1772 | This variable contains the full pathname to 'csh', whether or |
1773 | not the user has specified 'portability'. This is only used |
1774 | in the compiled C program, and we assume that all systems which |
1775 | can share this executable will have the same full pathname to |
1776 | 'csh.' |
1777 | |
1778 | full_sed (Loc_sed.U): |
1779 | This variable contains the full pathname to 'sed', whether or |
1780 | not the user has specified 'portability'. This is only used |
1781 | in the compiled C program, and we assume that all systems which |
1782 | can share this executable will have the same full pathname to |
1783 | 'sed.' |
1784 | |
1785 | gccversion (cc.U): |
1786 | If GNU cc (gcc) is used, this variable holds '1' or '2' to |
1787 | indicate whether the compiler is version 1 or 2. This is used in |
1788 | setting some of the default cflags. It is set to '' if not gcc. |
1789 | |
a22e52b9 |
1790 | gidformat (gidf.U): |
1791 | This variable contains the format string used for printing a Gid_t. |
1792 | |
785fb66b |
1793 | gidsign (gidsign.U): |
1794 | This variable contains the signedness of a gidtype. |
1795 | 1 for unsigned, -1 for signed. |
1796 | |
1797 | gidsize (gidsize.U): |
1798 | This variable contains the size of a gidtype in bytes. |
1799 | |
781b178c |
1800 | gidtype (gidtype.U): |
1801 | This variable defines Gid_t to be something like gid_t, int, |
1802 | ushort, or whatever type is used to declare the return type |
1803 | of getgid(). Typically, it is the type of group ids in the kernel. |
1804 | |
1805 | glibpth (libpth.U): |
1806 | This variable holds the general path (space-separated) used to |
1807 | find libraries. It may contain directories that do not exist on |
1808 | this platform, libpth is the cleaned-up version. |
1809 | |
1810 | grep (Loc.U): |
5bf26616 |
1811 | This variable is used internally by Configure to determine the |
781b178c |
1812 | full pathname (if any) of the grep program. After Configure runs, |
1813 | the value is reset to a plain "grep" and is not useful. |
1814 | |
1815 | groupcat (nis.U): |
1816 | This variable contains a command that produces the text of the |
1817 | /etc/group file. This is normally "cat /etc/group", but can be |
1818 | "ypcat group" when NIS is used. |
aaacdc8b |
1819 | On some systems, such as os390, there may be no equivalent |
1820 | command, in which case this variable is unset. |
781b178c |
1821 | |
1822 | groupstype (groupstype.U): |
1823 | This variable defines Groups_t to be something like gid_t, int, |
1824 | ushort, or whatever type is used for the second argument to |
1825 | getgroups() and setgroups(). Usually, this is the same as |
1826 | gidtype (gid_t), but sometimes it isn't. |
1827 | |
1828 | gzip (Loc.U): |
5bf26616 |
1829 | This variable is used internally by Configure to determine the |
781b178c |
1830 | full pathname (if any) of the gzip program. After Configure runs, |
1831 | the value is reset to a plain "gzip" and is not useful. |
1832 | |
1833 | h_fcntl (h_fcntl.U): |
1834 | This is variable gets set in various places to tell i_fcntl that |
1835 | <fcntl.h> should be included. |
1836 | |
1837 | h_sysfile (h_sysfile.U): |
1838 | This is variable gets set in various places to tell i_sys_file that |
1839 | <sys/file.h> should be included. |
1840 | |
1841 | hint (Oldconfig.U): |
1842 | Gives the type of hints used for previous answers. May be one of |
1843 | "default", "recommended" or "previous". |
1844 | |
1845 | hostcat (nis.U): |
1846 | This variable contains a command that produces the text of the |
1847 | /etc/hosts file. This is normally "cat /etc/hosts", but can be |
1848 | "ypcat hosts" when NIS is used. |
aaacdc8b |
1849 | On some systems, such as os390, there may be no equivalent |
1850 | command, in which case this variable is unset. |
781b178c |
1851 | |
1852 | huge (models.U): |
1853 | This variable contains a flag which will tell the C compiler and loader |
1854 | to produce a program running with a huge memory model. If the |
1855 | huge model is not supported, contains the flag to produce large |
1856 | model programs. It is up to the Makefile to use this. |
1857 | |
a22e52b9 |
1858 | i16size (perlxv.U): |
1859 | This variable is the size of an I16 in bytes. |
1860 | |
1861 | i16type (perlxv.U): |
1862 | This variable contains the C type used for Perl's I16. |
1863 | |
1864 | i32size (perlxv.U): |
1865 | This variable is the size of an I32 in bytes. |
1866 | |
1867 | i32type (perlxv.U): |
1868 | This variable contains the C type used for Perl's I32. |
1869 | |
1870 | i64size (perlxv.U): |
1871 | This variable is the size of an I64 in bytes. |
1872 | |
1873 | i64type (perlxv.U): |
1874 | This variable contains the C type used for Perl's I64. |
1875 | |
1876 | i8size (perlxv.U): |
1877 | This variable is the size of an I8 in bytes. |
1878 | |
1879 | i8type (perlxv.U): |
1880 | This variable contains the C type used for Perl's I8. |
1881 | |
781b178c |
1882 | i_arpainet (i_arpainet.U): |
1883 | This variable conditionally defines the I_ARPA_INET symbol, |
1884 | and indicates whether a C program should include <arpa/inet.h>. |
1885 | |
1886 | i_bsdioctl (i_sysioctl.U): |
1887 | This variable conditionally defines the I_SYS_BSDIOCTL symbol, which |
1888 | indicates to the C program that <sys/bsdioctl.h> exists and should |
1889 | be included. |
1890 | |
1891 | i_db (i_db.U): |
1892 | This variable conditionally defines the I_DB symbol, and indicates |
1893 | whether a C program may include Berkeley's DB include file <db.h>. |
1894 | |
1895 | i_dbm (i_dbm.U): |
1896 | This variable conditionally defines the I_DBM symbol, which |
1897 | indicates to the C program that <dbm.h> exists and should |
1898 | be included. |
1899 | |
1900 | i_dirent (i_dirent.U): |
1901 | This variable conditionally defines I_DIRENT, which indicates |
1902 | to the C program that it should include <dirent.h>. |
1903 | |
1904 | i_dld (i_dld.U): |
1905 | This variable conditionally defines the I_DLD symbol, which |
1906 | indicates to the C program that <dld.h> (GNU dynamic loading) |
1907 | exists and should be included. |
1908 | |
1909 | i_dlfcn (i_dlfcn.U): |
1910 | This variable conditionally defines the I_DLFCN symbol, which |
1911 | indicates to the C program that <dlfcn.h> exists and should |
1912 | be included. |
1913 | |
1914 | i_fcntl (i_fcntl.U): |
1915 | This variable controls the value of I_FCNTL (which tells |
1916 | the C program to include <fcntl.h>). |
1917 | |
1918 | i_float (i_float.U): |
1919 | This variable conditionally defines the I_FLOAT symbol, and indicates |
1920 | whether a C program may include <float.h> to get symbols like DBL_MAX |
1921 | or DBL_MIN, i.e. machine dependent floating point values. |
1922 | |
1923 | i_gdbm (i_gdbm.U): |
1924 | This variable conditionally defines the I_GDBM symbol, which |
1925 | indicates to the C program that <gdbm.h> exists and should |
1926 | be included. |
1927 | |
1928 | i_grp (i_grp.U): |
1929 | This variable conditionally defines the I_GRP symbol, and indicates |
1930 | whether a C program should include <grp.h>. |
1931 | |
fe749a9f |
1932 | i_iconv (i_iconv.U): |
1933 | This variable conditionally defines the I_ICONV symbol, and indicates |
1934 | whether a C program should include <iconv.h>. |
1935 | |
792d8dab |
1936 | i_ieeefp (i_ieeefp.U): |
1937 | This variable conditionally defines the I_IEEEFP symbol, and indicates |
1938 | whether a C program should include <ieeefp.h>. |
1939 | |
781b178c |
1940 | i_inttypes (i_inttypes.U): |
1941 | This variable conditionally defines the I_INTTYPES symbol, |
1942 | and indicates whether a C program should include <inttypes.h>. |
1943 | |
1944 | i_limits (i_limits.U): |
1945 | This variable conditionally defines the I_LIMITS symbol, and indicates |
1946 | whether a C program may include <limits.h> to get symbols like WORD_BIT |
1947 | and friends. |
1948 | |
1949 | i_locale (i_locale.U): |
1950 | This variable conditionally defines the I_LOCALE symbol, |
1951 | and indicates whether a C program should include <locale.h>. |
1952 | |
1953 | i_machcthr (i_machcthr.U): |
1954 | This variable conditionally defines the I_MACH_CTHREADS symbol, |
1955 | and indicates whether a C program should include <mach/cthreads.h>. |
1956 | |
1957 | i_malloc (i_malloc.U): |
1958 | This variable conditionally defines the I_MALLOC symbol, and indicates |
1959 | whether a C program should include <malloc.h>. |
1960 | |
1961 | i_math (i_math.U): |
1962 | This variable conditionally defines the I_MATH symbol, and indicates |
1963 | whether a C program may include <math.h>. |
1964 | |
1965 | i_memory (i_memory.U): |
1966 | This variable conditionally defines the I_MEMORY symbol, and indicates |
1967 | whether a C program should include <memory.h>. |
1968 | |
1969 | i_mntent (i_mntent.U): |
1970 | This variable conditionally defines the I_MNTENT symbol, and indicates |
1971 | whether a C program should include <mntent.h>. |
1972 | |
1973 | i_ndbm (i_ndbm.U): |
1974 | This variable conditionally defines the I_NDBM symbol, which |
1975 | indicates to the C program that <ndbm.h> exists and should |
1976 | be included. |
1977 | |
1978 | i_netdb (i_netdb.U): |
1979 | This variable conditionally defines the I_NETDB symbol, and indicates |
1980 | whether a C program should include <netdb.h>. |
1981 | |
1982 | i_neterrno (i_neterrno.U): |
1983 | This variable conditionally defines the I_NET_ERRNO symbol, which |
1984 | indicates to the C program that <net/errno.h> exists and should |
1985 | be included. |
1986 | |
1987 | i_netinettcp (i_netinettcp.U): |
1988 | This variable conditionally defines the I_NETINET_TCP symbol, |
1989 | and indicates whether a C program should include <netinet/tcp.h>. |
1990 | |
1991 | i_niin (i_niin.U): |
1992 | This variable conditionally defines I_NETINET_IN, which indicates |
1993 | to the C program that it should include <netinet/in.h>. Otherwise, |
1994 | you may try <sys/in.h>. |
1995 | |
1996 | i_poll (i_poll.U): |
1997 | This variable conditionally defines the I_POLL symbol, and indicates |
1998 | whether a C program should include <poll.h>. |
1999 | |
2000 | i_pthread (i_pthread.U): |
190b66db |
2001 | This variable conditionally defines the I_PTHREAD symbol, |
781b178c |
2002 | and indicates whether a C program should include <pthread.h>. |
2003 | |
2004 | i_pwd (i_pwd.U): |
2005 | This variable conditionally defines I_PWD, which indicates |
2006 | to the C program that it should include <pwd.h>. |
2007 | |
2008 | i_rpcsvcdbm (i_dbm.U): |
2009 | This variable conditionally defines the I_RPCSVC_DBM symbol, which |
2010 | indicates to the C program that <rpcsvc/dbm.h> exists and should |
2011 | be included. Some System V systems might need this instead of <dbm.h>. |
2012 | |
2013 | i_sfio (i_sfio.U): |
2014 | This variable conditionally defines the I_SFIO symbol, |
2015 | and indicates whether a C program should include <sfio.h>. |
2016 | |
2017 | i_sgtty (i_termio.U): |
2018 | This variable conditionally defines the I_SGTTY symbol, which |
2019 | indicates to the C program that it should include <sgtty.h> rather |
2020 | than <termio.h>. |
2021 | |
2022 | i_shadow (i_shadow.U): |
2023 | This variable conditionally defines the I_SHADOW symbol, and indicates |
2024 | whether a C program should include <shadow.h>. |
2025 | |
2026 | i_socks (i_socks.U): |
2027 | This variable conditionally defines the I_SOCKS symbol, and indicates |
2028 | whether a C program should include <socks.h>. |
2029 | |
2030 | i_stdarg (i_varhdr.U): |
2031 | This variable conditionally defines the I_STDARG symbol, which |
2032 | indicates to the C program that <stdarg.h> exists and should |
2033 | be included. |
2034 | |
2035 | i_stddef (i_stddef.U): |
2036 | This variable conditionally defines the I_STDDEF symbol, which |
2037 | indicates to the C program that <stddef.h> exists and should |
2038 | be included. |
2039 | |
2040 | i_stdlib (i_stdlib.U): |
2041 | This variable conditionally defines the I_STDLIB symbol, which |
2042 | indicates to the C program that <stdlib.h> exists and should |
2043 | be included. |
2044 | |
2045 | i_string (i_string.U): |
2046 | This variable conditionally defines the I_STRING symbol, which |
2047 | indicates that <string.h> should be included rather than <strings.h>. |
2048 | |
792d8dab |
2049 | i_sunmath (i_sunmath.U): |
2050 | This variable conditionally defines the I_SUNMATH symbol, and indicates |
2051 | whether a C program should include <sunmath.h>. |
2052 | |
781b178c |
2053 | i_sysaccess (i_sysaccess.U): |
2054 | This variable conditionally defines the I_SYS_ACCESS symbol, |
2055 | and indicates whether a C program should include <sys/access.h>. |
2056 | |
2057 | i_sysdir (i_sysdir.U): |
2058 | This variable conditionally defines the I_SYS_DIR symbol, and indicates |
2059 | whether a C program should include <sys/dir.h>. |
2060 | |
2061 | i_sysfile (i_sysfile.U): |
2062 | This variable conditionally defines the I_SYS_FILE symbol, and indicates |
2063 | whether a C program should include <sys/file.h> to get R_OK and friends. |
2064 | |
2065 | i_sysfilio (i_sysioctl.U): |
2066 | This variable conditionally defines the I_SYS_FILIO symbol, which |
2067 | indicates to the C program that <sys/filio.h> exists and should |
2068 | be included in preference to <sys/ioctl.h>. |
2069 | |
2070 | i_sysin (i_niin.U): |
2071 | This variable conditionally defines I_SYS_IN, which indicates |
2072 | to the C program that it should include <sys/in.h> instead of |
2073 | <netinet/in.h>. |
2074 | |
2075 | i_sysioctl (i_sysioctl.U): |
2076 | This variable conditionally defines the I_SYS_IOCTL symbol, which |
2077 | indicates to the C program that <sys/ioctl.h> exists and should |
2078 | be included. |
2079 | |
ca52efda |
2080 | i_syslog (i_syslog.U): |
2081 | This variable conditionally defines the I_SYSLOG symbol, |
2082 | and indicates whether a C program should include <syslog.h>. |
2083 | |
fe749a9f |
2084 | i_sysmman (i_sysmman.U): |
2085 | This variable conditionally defines the I_SYS_MMAN symbol, and |
2086 | indicates whether a C program should include <sys/mman.h>. |
2087 | |
87b71857 |
2088 | i_sysmode (i_sysmode.U): |
2089 | This variable conditionally defines the I_SYSMODE symbol, |
2090 | and indicates whether a C program should include <sys/mode.h>. |
2091 | |
781b178c |
2092 | i_sysmount (i_sysmount.U): |
2093 | This variable conditionally defines the I_SYSMOUNT symbol, |
2094 | and indicates whether a C program should include <sys/mount.h>. |
2095 | |
2096 | i_sysndir (i_sysndir.U): |
2097 | This variable conditionally defines the I_SYS_NDIR symbol, and indicates |
2098 | whether a C program should include <sys/ndir.h>. |
2099 | |
2100 | i_sysparam (i_sysparam.U): |
2101 | This variable conditionally defines the I_SYS_PARAM symbol, and indicates |
2102 | whether a C program should include <sys/param.h>. |
2103 | |
2104 | i_sysresrc (i_sysresrc.U): |
2105 | This variable conditionally defines the I_SYS_RESOURCE symbol, |
2106 | and indicates whether a C program should include <sys/resource.h>. |
2107 | |
2108 | i_syssecrt (i_syssecrt.U): |
2109 | This variable conditionally defines the I_SYS_SECURITY symbol, |
2110 | and indicates whether a C program should include <sys/security.h>. |
2111 | |
2112 | i_sysselct (i_sysselct.U): |
2113 | This variable conditionally defines I_SYS_SELECT, which indicates |
2114 | to the C program that it should include <sys/select.h> in order to |
2115 | get the definition of struct timeval. |
2116 | |
2117 | i_syssockio (i_sysioctl.U): |
2118 | This variable conditionally defines I_SYS_SOCKIO to indicate to the |
2119 | C program that socket ioctl codes may be found in <sys/sockio.h> |
2120 | instead of <sys/ioctl.h>. |
2121 | |
2122 | i_sysstat (i_sysstat.U): |
2123 | This variable conditionally defines the I_SYS_STAT symbol, |
2124 | and indicates whether a C program should include <sys/stat.h>. |
2125 | |
0545a864 |
2126 | i_sysstatfs (i_sysstatfs.U): |
2127 | This variable conditionally defines the I_SYSSTATFS symbol, |
2128 | and indicates whether a C program should include <sys/statfs.h>. |
2129 | |
781b178c |
2130 | i_sysstatvfs (i_sysstatvfs.U): |
2131 | This variable conditionally defines the I_SYSSTATVFS symbol, |
2132 | and indicates whether a C program should include <sys/statvfs.h>. |
2133 | |
2134 | i_systime (i_time.U): |
2135 | This variable conditionally defines I_SYS_TIME, which indicates |
2136 | to the C program that it should include <sys/time.h>. |
2137 | |
2138 | i_systimek (i_time.U): |
2139 | This variable conditionally defines I_SYS_TIME_KERNEL, which |
2140 | indicates to the C program that it should include <sys/time.h> |
2141 | with KERNEL defined. |
2142 | |
2143 | i_systimes (i_systimes.U): |
2144 | This variable conditionally defines the I_SYS_TIMES symbol, and indicates |
2145 | whether a C program should include <sys/times.h>. |
2146 | |
2147 | i_systypes (i_systypes.U): |
2148 | This variable conditionally defines the I_SYS_TYPES symbol, |
2149 | and indicates whether a C program should include <sys/types.h>. |
2150 | |
2151 | i_sysuio (i_sysuio.U): |
2152 | This variable conditionally defines the I_SYSUIO symbol, and indicates |
2153 | whether a C program should include <sys/uio.h>. |
2154 | |
2155 | i_sysun (i_sysun.U): |
2156 | This variable conditionally defines I_SYS_UN, which indicates |
2157 | to the C program that it should include <sys/un.h> to get UNIX |
2158 | domain socket definitions. |
2159 | |
d4935d7f |
2160 | i_sysutsname (i_sysutsname.U): |
2161 | This variable conditionally defines the I_SYSUTSNAME symbol, |
2162 | and indicates whether a C program should include <sys/utsname.h>. |
2163 | |
0545a864 |
2164 | i_sysvfs (i_sysvfs.U): |
2165 | This variable conditionally defines the I_SYSVFS symbol, |
2166 | and indicates whether a C program should include <sys/vfs.h>. |
2167 | |
781b178c |
2168 | i_syswait (i_syswait.U): |
2169 | This variable conditionally defines I_SYS_WAIT, which indicates |
2170 | to the C program that it should include <sys/wait.h>. |
2171 | |
2172 | i_termio (i_termio.U): |
2173 | This variable conditionally defines the I_TERMIO symbol, which |
2174 | indicates to the C program that it should include <termio.h> rather |
2175 | than <sgtty.h>. |
2176 | |
2177 | i_termios (i_termio.U): |
2178 | This variable conditionally defines the I_TERMIOS symbol, which |
2179 | indicates to the C program that the POSIX <termios.h> file is |
2180 | to be included. |
2181 | |
2182 | i_time (i_time.U): |
2183 | This variable conditionally defines I_TIME, which indicates |
2184 | to the C program that it should include <time.h>. |
2185 | |
2186 | i_unistd (i_unistd.U): |
2187 | This variable conditionally defines the I_UNISTD symbol, and indicates |
2188 | whether a C program should include <unistd.h>. |
2189 | |
0545a864 |
2190 | i_ustat (i_ustat.U): |
2191 | This variable conditionally defines the I_USTAT symbol, and indicates |
2192 | whether a C program should include <ustat.h>. |
2193 | |
781b178c |
2194 | i_utime (i_utime.U): |
2195 | This variable conditionally defines the I_UTIME symbol, and indicates |
2196 | whether a C program should include <utime.h>. |
2197 | |
2198 | i_values (i_values.U): |
2199 | This variable conditionally defines the I_VALUES symbol, and indicates |
2200 | whether a C program may include <values.h> to get symbols like MAXLONG |
2201 | and friends. |
2202 | |
2203 | i_varargs (i_varhdr.U): |
2204 | This variable conditionally defines I_VARARGS, which indicates |
2205 | to the C program that it should include <varargs.h>. |
2206 | |
2207 | i_varhdr (i_varhdr.U): |
2208 | Contains the name of the header to be included to get va_dcl definition. |
2209 | Typically one of varargs.h or stdarg.h. |
2210 | |
2211 | i_vfork (i_vfork.U): |
2212 | This variable conditionally defines the I_VFORK symbol, and indicates |
2213 | whether a C program should include vfork.h. |
2214 | |
2215 | ignore_versioned_solibs (libs.U): |
2216 | This variable should be non-empty if non-versioned shared |
2217 | libraries (libfoo.so.x.y) are to be ignored (because they |
2218 | cannot be linked against). |
2219 | |
ff935051 |
2220 | inc_version_list (inc_version_list.U): |
2221 | This variable specifies the list of subdirectories in over |
2222 | which perl.c:incpush() and lib/lib.pm will automatically |
3a096bf3 |
2223 | search when adding directories to @INC. The elements in |
2224 | the list are separated by spaces. This is only useful |
ff935051 |
2225 | if you have a perl library directory tree structured like the |
2226 | default one. See INSTALL for how this works. The versioned |
2227 | site_perl directory was introduced in 5.005, so that is the |
2228 | lowest possible value. |
2229 | |
3a096bf3 |
2230 | inc_version_list_init (inc_version_list.U): |
2231 | This variable holds the same list as inc_version_list, but |
2232 | each item is enclosed in double quotes and separated by commas, |
2233 | suitable for use in the PERL_INC_VERSION_LIST initialization. |
2234 | |
781b178c |
2235 | incpath (usrinc.U): |
2236 | This variable must preceed the normal include path to get hte |
2237 | right one, as in "$incpath/usr/include" or "$incpath/usr/lib". |
2238 | Value can be "" or "/bsd43" on mips. |
2239 | |
2240 | inews (Loc.U): |
2241 | This variable is defined but not used by Configure. |
2242 | The value is a plain '' and is not useful. |
2243 | |
2244 | installarchlib (archlib.U): |
2245 | This variable is really the same as archlibexp but may differ on |
2246 | those systems using AFS. For extra portability, only this variable |
2247 | should be used in makefiles. |
2248 | |
2249 | installbin (bin.U): |
2250 | This variable is the same as binexp unless AFS is running in which case |
2251 | the user is explicitely prompted for it. This variable should always |
2252 | be used in your makefiles for maximum portability. |
2253 | |
2254 | installman1dir (man1dir.U): |
2255 | This variable is really the same as man1direxp, unless you are using |
2256 | AFS in which case it points to the read/write location whereas |
2257 | man1direxp only points to the read-only access location. For extra |
2258 | portability, you should only use this variable within your makefiles. |
2259 | |
2260 | installman3dir (man3dir.U): |
2261 | This variable is really the same as man3direxp, unless you are using |
2262 | AFS in which case it points to the read/write location whereas |
2263 | man3direxp only points to the read-only access location. For extra |
2264 | portability, you should only use this variable within your makefiles. |
2265 | |
2266 | installprefix (installprefix.U): |
2267 | This variable holds the name of the directory below which |
2268 | "make install" will install the package. For most users, this |
2269 | is the same as prefix. However, it is useful for |
2270 | installing the software into a different (usually temporary) |
2271 | location after which it can be bundled up and moved somehow |
2272 | to the final location specified by prefix. |
2273 | |
2274 | installprefixexp (installprefix.U): |
2275 | This variable holds the full absolute path of installprefix |
2276 | with all ~-expansion done. |
2277 | |
2278 | installprivlib (privlib.U): |
2279 | This variable is really the same as privlibexp but may differ on |
2280 | those systems using AFS. For extra portability, only this variable |
2281 | should be used in makefiles. |
2282 | |
2283 | installscript (scriptdir.U): |
2284 | This variable is usually the same as scriptdirexp, unless you are on |
2285 | a system running AFS, in which case they may differ slightly. You |
2286 | should always use this variable within your makefiles for portability. |
2287 | |
2288 | installsitearch (sitearch.U): |
2289 | This variable is really the same as sitearchexp but may differ on |
2290 | those systems using AFS. For extra portability, only this variable |
2291 | should be used in makefiles. |
2292 | |
0617aed7 |
2293 | installsitebin (sitebin.U): |
2294 | This variable is usually the same as sitebinexp, unless you are on |
2295 | a system running AFS, in which case they may differ slightly. You |
2296 | should always use this variable within your makefiles for portability. |
2297 | |
781b178c |
2298 | installsitelib (sitelib.U): |
2299 | This variable is really the same as sitelibexp but may differ on |
2300 | those systems using AFS. For extra portability, only this variable |
2301 | should be used in makefiles. |
2302 | |
2303 | installstyle (installstyle.U): |
2304 | This variable describes the "style" of the perl installation. |
2305 | This is intended to be useful for tools that need to |
2306 | manipulate entire perl distributions. Perl itself doesn't use |
2307 | this to find its libraries -- the library directories are |
2308 | stored directly in Config.pm. Currently, there are only two |
2309 | styles: "lib" and "lib/perl5". The default library locations |
2310 | (e.g. privlib, sitelib) are either $prefix/lib or |
2311 | $prefix/lib/perl5. The former is useful if $prefix is a |
2312 | directory dedicated to perl (e.g. /opt/perl), while the latter |
2313 | is useful if $prefix is shared by many packages, e.g. if |
2314 | $prefix=/usr/local. |
2315 | This may later be extended to include other information, so |
2316 | be careful with pattern-matching on the results. |
2317 | For compatibility with perl5.005 and earlier, the default |
2318 | setting is based on whether or not $prefix contains the string |
2319 | "perl". |
2320 | |
2321 | installusrbinperl (instubperl.U): |
2322 | This variable tells whether Perl should be installed also as |
2323 | /usr/bin/perl in addition to |
2324 | $installbin/perl |
2325 | |
526fdc24 |
2326 | installvendorarch (vendorarch.U): |
2327 | This variable is really the same as vendorarchexp but may differ on |
2328 | those systems using AFS. For extra portability, only this variable |
2329 | should be used in makefiles. |
2330 | |
0617aed7 |
2331 | installvendorbin (vendorbin.U): |
2332 | This variable is really the same as vendorbinexp but may differ on |
2333 | those systems using AFS. For extra portability, only this variable |
2334 | should be used in makefiles. |
2335 | |
a3635516 |
2336 | installvendorlib (vendorlib.U): |
2337 | This variable is really the same as vendorlibexp but may differ on |
2338 | those systems using AFS. For extra portability, only this variable |
2339 | should be used in makefiles. |
2340 | |
781b178c |
2341 | intsize (intsize.U): |
2342 | This variable contains the value of the INTSIZE symbol, which |
2343 | indicates to the C program how many bytes there are in an int. |
2344 | |
a22e52b9 |
2345 | ivdformat (perlxvf.U): |
2346 | This variable contains the format string used for printing |
2347 | a Perl IV as a signed decimal integer. |
2348 | |
2349 | ivsize (perlxv.U): |
2350 | This variable is the size of an IV in bytes. |
2351 | |
2352 | ivtype (perlxv.U): |
2353 | This variable contains the C type used for Perl's IV. |
2354 | |
781b178c |
2355 | known_extensions (Extensions.U): |
2356 | This variable holds a list of all XS extensions included in |
2357 | the package. |
2358 | |
2359 | ksh (Loc.U): |
2360 | This variable is defined but not used by Configure. |
2361 | The value is a plain '' and is not useful. |
2362 | |
2363 | large (models.U): |
2364 | This variable contains a flag which will tell the C compiler and loader |
2365 | to produce a program running with a large memory model. It is up to |
2366 | the Makefile to use this. |
2367 | |
2368 | ld (dlsrc.U): |
2369 | This variable indicates the program to be used to link |
2370 | libraries for dynamic loading. On some systems, it is 'ld'. |
2371 | On ELF systems, it should be $cc. Mostly, we'll try to respect |
2372 | the hint file setting. |
2373 | |
2374 | lddlflags (dlsrc.U): |
2375 | This variable contains any special flags that might need to be |
2376 | passed to $ld to create a shared library suitable for dynamic |
2377 | loading. It is up to the makefile to use it. For hpux, it |
2378 | should be '-b'. For sunos 4.1, it is empty. |
2379 | |
2380 | ldflags (ccflags.U): |
2381 | This variable contains any additional C loader flags desired by |
2382 | the user. It is up to the Makefile to use this. |
2383 | |
2384 | ldlibpthname (libperl.U): |
2385 | This variable holds the name of the shared library |
2386 | search path, often LD_LIBRARY_PATH. To get an empty |
2387 | string, the hints file must set this to 'none'. |
2388 | |
2389 | less (Loc.U): |
5bf26616 |
2390 | This variable is used internally by Configure to determine the |
781b178c |
2391 | full pathname (if any) of the less program. After Configure runs, |
2392 | the value is reset to a plain "less" and is not useful. |
2393 | |
2394 | lib_ext (Unix.U): |
2395 | This is an old synonym for _a. |
2396 | |
2397 | libc (libc.U): |
2398 | This variable contains the location of the C library. |
2399 | |
2400 | libperl (libperl.U): |
2401 | The perl executable is obtained by linking perlmain.c with |
2402 | libperl, any static extensions (usually just DynaLoader), |
2403 | and any other libraries needed on this system. libperl |
2404 | is usually libperl.a, but can also be libperl.so.xxx if |
2405 | the user wishes to build a perl executable with a shared |
2406 | library. |
2407 | |
2408 | libpth (libpth.U): |
2409 | This variable holds the general path (space-separated) used to find |
2410 | libraries. It is intended to be used by other units. |
2411 | |
2412 | libs (libs.U): |
2413 | This variable holds the additional libraries we want to use. |
2414 | It is up to the Makefile to deal with it. |
2415 | |
fe749a9f |
2416 | libsdirs (libs.U): |
2417 | This variable holds the directory names aka dirnames of the libraries |
2418 | we found and accepted, duplicates are removed. |
2419 | |
2420 | libsfiles (libs.U): |
2421 | This variable holds the filenames aka basenames of the libraries |
2422 | we found and accepted. |
2423 | |
2424 | libsfound (libs.U): |
2425 | This variable holds the full pathnames of the libraries |
2426 | we found and accepted. |
2427 | |
13b3f787 |
2428 | libspath (libs.U): |
2429 | This variable holds the directory names probed for libraries. |
2430 | |
781b178c |
2431 | libswanted (Myinit.U): |
2432 | This variable holds a list of all the libraries we want to |
2433 | search. The order is chosen to pick up the c library |
2434 | ahead of ucb or bsd libraries for SVR4. |
2435 | |
2436 | line (Loc.U): |
ff935051 |
2437 | This variable is defined but not used by Configure. |
2438 | The value is a plain '' and is not useful. |
781b178c |
2439 | |
2440 | lint (Loc.U): |
2441 | This variable is defined but not used by Configure. |
2442 | The value is a plain '' and is not useful. |
2443 | |
2444 | lkflags (ccflags.U): |
2445 | This variable contains any additional C partial linker flags desired by |
2446 | the user. It is up to the Makefile to use this. |
2447 | |
2448 | ln (Loc.U): |
5bf26616 |
2449 | This variable is used internally by Configure to determine the |
781b178c |
2450 | full pathname (if any) of the ln program. After Configure runs, |
2451 | the value is reset to a plain "ln" and is not useful. |
2452 | |
2453 | lns (lns.U): |
2454 | This variable holds the name of the command to make |
2455 | symbolic links (if they are supported). It can be used |
2456 | in the Makefile. It is either 'ln -s' or 'ln' |
2457 | |
2458 | locincpth (ccflags.U): |
2459 | This variable contains a list of additional directories to be |
2460 | searched by the compiler. The appropriate '-I' directives will |
2461 | be added to ccflags. This is intended to simplify setting |
2462 | local directories from the Configure command line. |
2463 | It's not much, but it parallels the loclibpth stuff in libpth.U. |
2464 | |
2465 | loclibpth (libpth.U): |
2466 | This variable holds the paths (space-separated) used to find local |
2467 | libraries. It is prepended to libpth, and is intended to be easily |
2468 | set from the command line. |
2469 | |
2470 | longdblsize (d_longdbl.U): |
2471 | This variable contains the value of the LONG_DOUBLESIZE symbol, which |
2472 | indicates to the C program how many bytes there are in a long double, |
2473 | if this system supports long doubles. |
2474 | |
2475 | longlongsize (d_longlong.U): |
2476 | This variable contains the value of the LONGLONGSIZE symbol, which |
2477 | indicates to the C program how many bytes there are in a long long, |
2478 | if this system supports long long. |
2479 | |
2480 | longsize (intsize.U): |
2481 | This variable contains the value of the LONGSIZE symbol, which |
2482 | indicates to the C program how many bytes there are in a long. |
2483 | |
2484 | lp (Loc.U): |
2485 | This variable is defined but not used by Configure. |
2486 | The value is a plain '' and is not useful. |
2487 | |
2488 | lpr (Loc.U): |
2489 | This variable is defined but not used by Configure. |
2490 | The value is a plain '' and is not useful. |
2491 | |
2492 | ls (Loc.U): |
5bf26616 |
2493 | This variable is used internally by Configure to determine the |
781b178c |
2494 | full pathname (if any) of the ls program. After Configure runs, |
2495 | the value is reset to a plain "ls" and is not useful. |
2496 | |
2497 | lseeksize (lseektype.U): |
2498 | This variable defines lseektype to be something like off_t, long, |
2499 | or whatever type is used to declare lseek offset's type in the |
2500 | kernel (which also appears to be lseek's return type). |
2501 | |
2502 | lseektype (lseektype.U): |
2503 | This variable defines lseektype to be something like off_t, long, |
2504 | or whatever type is used to declare lseek offset's type in the |
2505 | kernel (which also appears to be lseek's return type). |
2506 | |
2507 | mail (Loc.U): |
2508 | This variable is defined but not used by Configure. |
2509 | The value is a plain '' and is not useful. |
2510 | |
2511 | mailx (Loc.U): |
2512 | This variable is defined but not used by Configure. |
2513 | The value is a plain '' and is not useful. |
2514 | |
2515 | make (Loc.U): |
5bf26616 |
2516 | This variable is used internally by Configure to determine the |
781b178c |
2517 | full pathname (if any) of the make program. After Configure runs, |
2518 | the value is reset to a plain "make" and is not useful. |
2519 | |
2520 | make_set_make (make.U): |
2521 | Some versions of 'make' set the variable MAKE. Others do not. |
2522 | This variable contains the string to be included in Makefile.SH |
2523 | so that MAKE is set if needed, and not if not needed. |
2524 | Possible values are: |
2525 | make_set_make='#' # If your make program handles this for you, |
2526 | make_set_make="MAKE=$make" # if it doesn't. |
2527 | I used a comment character so that we can distinguish a |
2528 | 'set' value (from a previous config.sh or Configure '-D' option) |
2529 | from an uncomputed value. |
2530 | |
2531 | mallocobj (mallocsrc.U): |
2532 | This variable contains the name of the malloc.o that this package |
2533 | generates, if that malloc.o is preferred over the system malloc. |
2534 | Otherwise the value is null. This variable is intended for generating |
2535 | Makefiles. See mallocsrc. |
2536 | |
2537 | mallocsrc (mallocsrc.U): |
2538 | This variable contains the name of the malloc.c that comes with |
2539 | the package, if that malloc.c is preferred over the system malloc. |
2540 | Otherwise the value is null. This variable is intended for generating |
2541 | Makefiles. |
2542 | |
2543 | malloctype (mallocsrc.U): |
2544 | This variable contains the kind of ptr returned by malloc and realloc. |
2545 | |
2546 | man1dir (man1dir.U): |
2547 | This variable contains the name of the directory in which manual |
2548 | source pages are to be put. It is the responsibility of the |
2549 | Makefile.SH to get the value of this into the proper command. |
2550 | You must be prepared to do the ~name expansion yourself. |
2551 | |
2552 | man1direxp (man1dir.U): |
2553 | This variable is the same as the man1dir variable, but is filename |
2554 | expanded at configuration time, for convenient use in makefiles. |
2555 | |
2556 | man1ext (man1dir.U): |
2557 | This variable contains the extension that the manual page should |
2558 | have: one of 'n', 'l', or '1'. The Makefile must supply the '.'. |
2559 | See man1dir. |
2560 | |
2561 | man3dir (man3dir.U): |
2562 | This variable contains the name of the directory in which manual |
2563 | source pages are to be put. It is the responsibility of the |
2564 | Makefile.SH to get the value of this into the proper command. |
2565 | You must be prepared to do the ~name expansion yourself. |
2566 | |
2567 | man3direxp (man3dir.U): |
2568 | This variable is the same as the man3dir variable, but is filename |
2569 | expanded at configuration time, for convenient use in makefiles. |
2570 | |
2571 | man3ext (man3dir.U): |
2572 | This variable contains the extension that the manual page should |
2573 | have: one of 'n', 'l', or '3'. The Makefile must supply the '.'. |
2574 | See man3dir. |
2575 | |
ff935051 |
2576 | Mcc (Loc.U): |
2577 | This variable is used internally by Configure to determine the |
2578 | full pathname (if any) of the Mcc program. After Configure runs, |
2579 | the value is reset to a plain "Mcc" and is not useful. |
2580 | |
781b178c |
2581 | medium (models.U): |
2582 | This variable contains a flag which will tell the C compiler and loader |
2583 | to produce a program running with a medium memory model. If the |
2584 | medium model is not supported, contains the flag to produce large |
2585 | model programs. It is up to the Makefile to use this. |
2586 | |
2587 | mips_type (usrinc.U): |
2588 | This variable holds the environment type for the mips system. |
2589 | Possible values are "BSD 4.3" and "System V". |
2590 | |
2591 | mkdir (Loc.U): |
5bf26616 |
2592 | This variable is used internally by Configure to determine the |
781b178c |
2593 | full pathname (if any) of the mkdir program. After Configure runs, |
2594 | the value is reset to a plain "mkdir" and is not useful. |
2595 | |
fe749a9f |
2596 | mmaptype (d_mmap.U): |
2597 | This symbol contains the type of pointer returned by mmap() |
2598 | (and simultaneously the type of the first argument). |
2599 | It can be 'void *' or 'caddr_t'. |
2600 | |
781b178c |
2601 | models (models.U): |
2602 | This variable contains the list of memory models supported by this |
2603 | system. Possible component values are none, split, unsplit, small, |
2604 | medium, large, and huge. The component values are space separated. |
2605 | |
2606 | modetype (modetype.U): |
2607 | This variable defines modetype to be something like mode_t, |
2608 | int, unsigned short, or whatever type is used to declare file |
2609 | modes for system calls. |
2610 | |
2611 | more (Loc.U): |
5bf26616 |
2612 | This variable is used internally by Configure to determine the |
781b178c |
2613 | full pathname (if any) of the more program. After Configure runs, |
2614 | the value is reset to a plain "more" and is not useful. |
2615 | |
2616 | multiarch (multiarch.U): |
2617 | This variable conditionally defines the MULTIARCH symbol |
2618 | which signifies the presence of multiplatform files. |
2619 | This is normally set by hints files. |
2620 | |
2621 | mv (Loc.U): |
2622 | This variable is defined but not used by Configure. |
2623 | The value is a plain '' and is not useful. |
2624 | |
2625 | myarchname (archname.U): |
2626 | This variable holds the architecture name computed by Configure in |
2627 | a previous run. It is not intended to be perused by any user and |
2628 | should never be set in a hint file. |
2629 | |
2630 | mydomain (myhostname.U): |
2631 | This variable contains the eventual value of the MYDOMAIN symbol, |
2632 | which is the domain of the host the program is going to run on. |
2633 | The domain must be appended to myhostname to form a complete host name. |
2634 | The dot comes with mydomain, and need not be supplied by the program. |
2635 | |
2636 | myhostname (myhostname.U): |
2637 | This variable contains the eventual value of the MYHOSTNAME symbol, |
2638 | which is the name of the host the program is going to run on. |
2639 | The domain is not kept with hostname, but must be gotten from mydomain. |
2640 | The dot comes with mydomain, and need not be supplied by the program. |
2641 | |
2642 | myuname (Oldconfig.U): |
2643 | The output of 'uname -a' if available, otherwise the hostname. On Xenix, |
2644 | pseudo variables assignments in the output are stripped, thank you. The |
2645 | whole thing is then lower-cased. |
2646 | |
2647 | n (n.U): |
2648 | This variable contains the '-n' flag if that is what causes the echo |
2649 | command to suppress newline. Otherwise it is null. Correct usage is |
2650 | $echo $n "prompt for a question: $c". |
2651 | |
2652 | netdb_hlen_type (netdbtype.U): |
2653 | This variable holds the type used for the 2nd argument to |
2654 | gethostbyaddr(). Usually, this is int or size_t or unsigned. |
2655 | This is only useful if you have gethostbyaddr(), naturally. |
2656 | |
2657 | netdb_host_type (netdbtype.U): |
2658 | This variable holds the type used for the 1st argument to |
2659 | gethostbyaddr(). Usually, this is char * or void *, possibly |
2660 | with or without a const prefix. |
2661 | This is only useful if you have gethostbyaddr(), naturally. |
2662 | |
2663 | netdb_name_type (netdbtype.U): |
2664 | This variable holds the type used for the argument to |
2665 | gethostbyname(). Usually, this is char * or const char *. |
2666 | This is only useful if you have gethostbyname(), naturally. |
2667 | |
2668 | netdb_net_type (netdbtype.U): |
2669 | This variable holds the type used for the 1st argument to |
2670 | getnetbyaddr(). Usually, this is int or long. |
2671 | This is only useful if you have getnetbyaddr(), naturally. |
2672 | |
2673 | nm (Loc.U): |
5bf26616 |
2674 | This variable is used internally by Configure to determine the |
781b178c |
2675 | full pathname (if any) of the nm program. After Configure runs, |
2676 | the value is reset to a plain "nm" and is not useful. |
2677 | |
2678 | nm_opt (usenm.U): |
2679 | This variable holds the options that may be necessary for nm. |
2680 | |
2681 | nm_so_opt (usenm.U): |
2682 | This variable holds the options that may be necessary for nm |
2683 | to work on a shared library but that can not be used on an |
2684 | archive library. Currently, this is only used by Linux, where |
2685 | nm --dynamic is *required* to get symbols from an ELF library which |
2686 | has been stripped, but nm --dynamic is *fatal* on an archive library. |
2687 | Maybe Linux should just always set usenm=false. |
2688 | |
2689 | nonxs_ext (Extensions.U): |
2690 | This variable holds a list of all non-xs extensions included |
2691 | in the package. All of them will be built. |
2692 | |
2693 | nroff (Loc.U): |
5bf26616 |
2694 | This variable is used internally by Configure to determine the |
781b178c |
2695 | full pathname (if any) of the nroff program. After Configure runs, |
2696 | the value is reset to a plain "nroff" and is not useful. |
2697 | |
a22e52b9 |
2698 | nvsize (perlxv.U): |
2699 | This variable is the size of an NV in bytes. |
2700 | |
2701 | nvtype (perlxv.U): |
2702 | This variable contains the C type used for Perl's NV. |
2703 | |
781b178c |
2704 | o_nonblock (nblock_io.U): |
2705 | This variable bears the symbol value to be used during open() or fcntl() |
2706 | to turn on non-blocking I/O for a file descriptor. If you wish to switch |
2707 | between blocking and non-blocking, you may try ioctl(FIOSNBIO) instead, |
2708 | but that is only supported by some devices. |
2709 | |
2710 | obj_ext (Unix.U): |
2711 | This is an old synonym for _o. |
2712 | |
2713 | old_pthread_create_joinable (d_pthrattrj.U): |
2714 | This variable defines the constant to use for creating joinable |
2715 | (aka undetached) pthreads. Unused if pthread.h defines |
2716 | PTHREAD_CREATE_JOINABLE. If used, possible values are |
2717 | PTHREAD_CREATE_UNDETACHED and __UNDETACHED. |
2718 | |
2719 | optimize (ccflags.U): |
2720 | This variable contains any optimizer/debugger flag that should be used. |
2721 | It is up to the Makefile to use it. |
2722 | |
2723 | orderlib (orderlib.U): |
2724 | This variable is "true" if the components of libraries must be ordered |
2725 | (with `lorder $* | tsort`) before placing them in an archive. Set to |
2726 | "false" if ranlib or ar can generate random libraries. |
2727 | |
2728 | osname (Oldconfig.U): |
2729 | This variable contains the operating system name (e.g. sunos, |
2730 | solaris, hpux, etc.). It can be useful later on for setting |
2731 | defaults. Any spaces are replaced with underscores. It is set |
2732 | to a null string if we can't figure it out. |
2733 | |
2734 | osvers (Oldconfig.U): |
2735 | This variable contains the operating system version (e.g. |
2736 | 4.1.3, 5.2, etc.). It is primarily used for helping select |
2737 | an appropriate hints file, but might be useful elsewhere for |
2738 | setting defaults. It is set to '' if we can't figure it out. |
2739 | We try to be flexible about how much of the version number |
2740 | to keep, e.g. if 4.1.1, 4.1.2, and 4.1.3 are essentially the |
2741 | same for this package, hints files might just be os_4.0 or |
2742 | os_4.1, etc., not keeping separate files for each little release. |
2743 | |
2744 | package (package.U): |
2745 | This variable contains the name of the package being constructed. |
2746 | It is primarily intended for the use of later Configure units. |
2747 | |
2748 | pager (pager.U): |
2749 | This variable contains the name of the preferred pager on the system. |
2750 | Usual values are (the full pathnames of) more, less, pg, or cat. |
2751 | |
2752 | passcat (nis.U): |
2753 | This variable contains a command that produces the text of the |
2754 | /etc/passwd file. This is normally "cat /etc/passwd", but can be |
2755 | "ypcat passwd" when NIS is used. |
aaacdc8b |
2756 | On some systems, such as os390, there may be no equivalent |
2757 | command, in which case this variable is unset. |
781b178c |
2758 | |
2759 | patchlevel (patchlevel.U): |
2760 | The patchlevel level of this package. |
2761 | The value of patchlevel comes from the patchlevel.h file. |
ff935051 |
2762 | In a version number such as 5.6.1, this is the "6". |
c890dc6c |
2763 | In patchlevel.h, this is referred to as "PERL_VERSION". |
781b178c |
2764 | |
2765 | path_sep (Unix.U): |
2766 | This is an old synonym for p_ in Head.U, the character |
2767 | used to separate elements in the command shell search PATH. |
2768 | |
c890dc6c |
2769 | perl5 (perl5.U): |
2770 | This variable contains the full path (if any) to a previously |
2771 | installed perl5.005 or later suitable for running the script |
2772 | to determine inc_version_list. |
2773 | |
781b178c |
2774 | perl (Loc.U): |
c890dc6c |
2775 | This variable is defined but not used by Configure. |
2776 | The value is a plain '' and is not useful. |
781b178c |
2777 | |
ff935051 |
2778 | PERL_REVISION (Oldsyms.U): |
2779 | In a Perl version number such as 5.6.2, this is the 5. |
2780 | This value is manually set in patchlevel.h |
2781 | |
2782 | PERL_SUBVERSION (Oldsyms.U): |
2783 | In a Perl version number such as 5.6.2, this is the 2. |
2784 | Values greater than 50 represent potentially unstable |
2785 | development subversions. |
2786 | This value is manually set in patchlevel.h |
2787 | |
2788 | PERL_VERSION (Oldsyms.U): |
2789 | In a Perl version number such as 5.6.2, this is the 6. |
2790 | This value is manually set in patchlevel.h |
2791 | |
781b178c |
2792 | perladmin (perladmin.U): |
2793 | Electronic mail address of the perl5 administrator. |
2794 | |
2795 | perlpath (perlpath.U): |
2796 | This variable contains the eventual value of the PERLPATH symbol, |
2797 | which contains the name of the perl interpreter to be used in |
2798 | shell scripts and in the "eval 'exec'" idiom. |
2799 | |
2800 | pg (Loc.U): |
5bf26616 |
2801 | This variable is used internally by Configure to determine the |
781b178c |
2802 | full pathname (if any) of the pg program. After Configure runs, |
2803 | the value is reset to a plain "pg" and is not useful. |
2804 | |
2805 | phostname (myhostname.U): |
2806 | This variable contains the eventual value of the PHOSTNAME symbol, |
2807 | which is a command that can be fed to popen() to get the host name. |
2808 | The program should probably not presume that the domain is or isn't |
2809 | there already. |
2810 | |
2811 | pidtype (pidtype.U): |
2812 | This variable defines PIDTYPE to be something like pid_t, int, |
2813 | ushort, or whatever type is used to declare process ids in the kernel. |
2814 | |
2815 | plibpth (libpth.U): |
2816 | Holds the private path used by Configure to find out the libraries. |
2817 | Its value is prepend to libpth. This variable takes care of special |
2818 | machines, like the mips. Usually, it should be empty. |
2819 | |
fe749a9f |
2820 | pm_apiversion (xs_apiversion.U): |
2821 | This variable contains the version of the oldest perl |
2822 | compatible with the present perl. (That is, pure perl modules |
2823 | written for $pm_apiversion will still work for the current |
2824 | version). perl.c:incpush() and lib/lib.pm will automatically |
2825 | search in $sitelib for older directories across major versions |
2826 | back to pm_apiversion. This is only useful if you have a perl |
2827 | library directory tree structured like the default one. The |
2828 | versioned site_perl library was introduced in 5.005, so that's |
2829 | the default setting for this variable. It's hard to imagine |
2830 | it changing before Perl6. It is included here for symmetry |
2831 | with xs_apiveprsion -- the searching algorithms will |
2832 | (presumably) be similar. |
2833 | See the INSTALL file for how this works. |
2834 | |
781b178c |
2835 | pmake (Loc.U): |
2836 | This variable is defined but not used by Configure. |
2837 | The value is a plain '' and is not useful. |
2838 | |
2839 | pr (Loc.U): |
2840 | This variable is defined but not used by Configure. |
2841 | The value is a plain '' and is not useful. |
2842 | |
2843 | prefix (prefix.U): |
2844 | This variable holds the name of the directory below which the |
2845 | user will install the package. Usually, this is /usr/local, and |
2846 | executables go in /usr/local/bin, library stuff in /usr/local/lib, |
2847 | man pages in /usr/local/man, etc. It is only used to set defaults |
2848 | for things in bin.U, mansrc.U, privlib.U, or scriptdir.U. |
2849 | |
2850 | prefixexp (prefix.U): |
2851 | This variable holds the full absolute path of the directory below |
2852 | which the user will install the package. Derived from prefix. |
2853 | |
2854 | privlib (privlib.U): |
2855 | This variable contains the eventual value of the PRIVLIB symbol, |
2856 | which is the name of the private library for this package. It may |
2857 | have a ~ on the front. It is up to the makefile to eventually create |
2858 | this directory while performing installation (with ~ substitution). |
2859 | |
2860 | privlibexp (privlib.U): |
2861 | This variable is the ~name expanded version of privlib, so that you |
2862 | may use it directly in Makefiles or shell scripts. |
2863 | |
2864 | prototype (prototype.U): |
2865 | This variable holds the eventual value of CAN_PROTOTYPE, which |
2866 | indicates the C compiler can handle funciton prototypes. |
2867 | |
2868 | ptrsize (ptrsize.U): |
2869 | This variable contains the value of the PTRSIZE symbol, which |
2870 | indicates to the C program how many bytes there are in a pointer. |
2871 | |
e0a10278 |
2872 | quadkind (quadtype.U): |
0befd8de |
2873 | This variable, if defined, encodes the type of a quad: |
2874 | 1 = int, 2 = long, 3 = long long, 4 = int64_t. |
2875 | |
2876 | quadtype (quadtype.U): |
2877 | This variable defines Quad_t to be something like long, int, |
2878 | long long, int64_t, or whatever type is used for 64-bit integers. |
2879 | |
781b178c |
2880 | randbits (randfunc.U): |
2881 | Indicates how many bits are produced by the function used to |
2882 | generate normalized random numbers. |
2883 | |
2884 | randfunc (randfunc.U): |
2885 | Indicates the name of the random number function to use. |
2886 | Values include drand48, random, and rand. In C programs, |
2887 | the 'Drand01' macro is defined to generate uniformly distributed |
2888 | random numbers over the range [0., 1.[ (see drand01 and nrand). |
2889 | |
2890 | randseedtype (randfunc.U): |
2891 | Indicates the type of the argument of the seedfunc. |
2892 | |
2893 | ranlib (orderlib.U): |
2894 | This variable is set to the pathname of the ranlib program, if it is |
2895 | needed to generate random libraries. Set to ":" if ar can generate |
2896 | random libraries or if random libraries are not supported |
2897 | |
2898 | rd_nodata (nblock_io.U): |
2899 | This variable holds the return code from read() when no data is |
2900 | present. It should be -1, but some systems return 0 when O_NDELAY is |
2901 | used, which is a shame because you cannot make the difference between |
2902 | no data and an EOF.. Sigh! |
2903 | |
c890dc6c |
2904 | revision (patchlevel.U): |
2905 | The value of revision comes from the patchlevel.h file. |
2906 | In a version number such as 5.6.1, this is the "5". |
2907 | In patchlevel.h, this is referred to as "PERL_REVISION". |
2908 | |
781b178c |
2909 | rm (Loc.U): |
5bf26616 |
2910 | This variable is used internally by Configure to determine the |
781b178c |
2911 | full pathname (if any) of the rm program. After Configure runs, |
2912 | the value is reset to a plain "rm" and is not useful. |
2913 | |
2914 | rmail (Loc.U): |
2915 | This variable is defined but not used by Configure. |
2916 | The value is a plain '' and is not useful. |
2917 | |
2918 | runnm (usenm.U): |
2919 | This variable contains 'true' or 'false' depending whether the |
2920 | nm extraction should be performed or not, according to the value |
2921 | of usenm and the flags on the Configure command line. |
2922 | |
2923 | sched_yield (d_pthread_y.U): |
2924 | This variable defines the way to yield the execution |
2925 | of the current thread. |
2926 | |
2927 | scriptdir (scriptdir.U): |
2928 | This variable holds the name of the directory in which the user wants |
2929 | to put publicly scripts for the package in question. It is either |
2930 | the same directory as for binaries, or a special one that can be |
2931 | mounted across different architectures, like /usr/share. Programs |
2932 | must be prepared to deal with ~name expansion. |
2933 | |
2934 | scriptdirexp (scriptdir.U): |
2935 | This variable is the same as scriptdir, but is filename expanded |
2936 | at configuration time, for programs not wanting to bother with it. |
2937 | |
2938 | sed (Loc.U): |
5bf26616 |
2939 | This variable is used internally by Configure to determine the |
781b178c |
2940 | full pathname (if any) of the sed program. After Configure runs, |
2941 | the value is reset to a plain "sed" and is not useful. |
2942 | |
2943 | seedfunc (randfunc.U): |
2944 | Indicates the random number generating seed function. |
2945 | Values include srand48, srandom, and srand. |
2946 | |
2947 | selectminbits (selectminbits.U): |
2948 | This variable holds the minimum number of bits operated by select. |
2949 | That is, if you do select(n, ...), how many bits at least will be |
2950 | cleared in the masks if some activity is detected. Usually this |
2951 | is either n or 32*ceil(n/32), especially many little-endians do |
2952 | the latter. This is only useful if you have select(), naturally. |
2953 | |
2954 | selecttype (selecttype.U): |
2955 | This variable holds the type used for the 2nd, 3rd, and 4th |
2956 | arguments to select. Usually, this is 'fd_set *', if HAS_FD_SET |
2957 | is defined, and 'int *' otherwise. This is only useful if you |
2958 | have select(), naturally. |
2959 | |
2960 | sendmail (Loc.U): |
ff935051 |
2961 | This variable is defined but not used by Configure. |
2962 | The value is a plain '' and is not useful. |
781b178c |
2963 | |
2964 | sh (sh.U): |
2965 | This variable contains the full pathname of the shell used |
2966 | on this system to execute Bourne shell scripts. Usually, this will be |
2967 | /bin/sh, though it's possible that some systems will have /bin/ksh, |
2968 | /bin/pdksh, /bin/ash, /bin/bash, or even something such as |
2969 | D:/bin/sh.exe. |
2970 | This unit comes before Options.U, so you can't set sh with a '-D' |
2971 | option, though you can override this (and startsh) |
2972 | with '-O -Dsh=/bin/whatever -Dstartsh=whatever' |
2973 | |
2974 | shar (Loc.U): |
2975 | This variable is defined but not used by Configure. |
2976 | The value is a plain '' and is not useful. |
2977 | |
2978 | sharpbang (spitshell.U): |
2979 | This variable contains the string #! if this system supports that |
2980 | construct. |
2981 | |
2982 | shmattype (d_shmat.U): |
2983 | This symbol contains the type of pointer returned by shmat(). |
2984 | It can be 'void *' or 'char *'. |
2985 | |
2986 | shortsize (intsize.U): |
2987 | This variable contains the value of the SHORTSIZE symbol which |
2988 | indicates to the C program how many bytes there are in a short. |
2989 | |
2990 | shrpenv (libperl.U): |
2991 | If the user builds a shared libperl.so, then we need to tell the |
2992 | 'perl' executable where it will be able to find the installed libperl.so. |
2993 | One way to do this on some systems is to set the environment variable |
2994 | LD_RUN_PATH to the directory that will be the final location of the |
2995 | shared libperl.so. The makefile can use this with something like |
2996 | $shrpenv $(CC) -o perl perlmain.o $libperl $libs |
2997 | Typical values are |
2998 | shrpenv="env LD_RUN_PATH=$archlibexp/CORE" |
2999 | or |
3000 | shrpenv='' |
3001 | See the main perl Makefile.SH for actual working usage. |
3002 | Alternatively, we might be able to use a command line option such |
3003 | as -R $archlibexp/CORE (Solaris, NetBSD) or -Wl,-rpath |
3004 | $archlibexp/CORE (Linux). |
3005 | |
3006 | shsharp (spitshell.U): |
3007 | This variable tells further Configure units whether your sh can |
3008 | handle # comments. |
3009 | |
3010 | sig_count (sig_name.U): |
3011 | This variable holds a number larger than the largest valid |
3012 | signal number. This is usually the same as the NSIG macro. |
3013 | |
3014 | sig_name (sig_name.U): |
3015 | This variable holds the signal names, space separated. The leading |
3016 | SIG in signal name is removed. A ZERO is prepended to the |
3017 | list. This is currently not used. |
3018 | |
3019 | sig_name_init (sig_name.U): |
3020 | This variable holds the signal names, enclosed in double quotes and |
3021 | separated by commas, suitable for use in the SIG_NAME definition |
3022 | below. A "ZERO" is prepended to the list, and the list is |
3023 | terminated with a plain 0. The leading SIG in signal names |
3024 | is removed. See sig_num. |
3025 | |
3026 | sig_num (sig_name.U): |
3027 | This variable holds the signal numbers, space separated. A ZERO is |
3028 | prepended to the list (corresponding to the fake SIGZERO), and |
3029 | the list is terminated with a 0. Those numbers correspond to |
3030 | the value of the signal listed in the same place within the |
3031 | sig_name list. |
3032 | |
3033 | sig_num_init (sig_name.U): |
3034 | This variable holds the signal numbers, enclosed in double quotes and |
3035 | separated by commas, suitable for use in the SIG_NUM definition |
3036 | below. A "ZERO" is prepended to the list, and the list is |
3037 | terminated with a plain 0. |
3038 | |
3039 | signal_t (d_voidsig.U): |
3040 | This variable holds the type of the signal handler (void or int). |
3041 | |
3042 | sitearch (sitearch.U): |
3043 | This variable contains the eventual value of the SITEARCH symbol, |
3044 | which is the name of the private library for this package. It may |
3045 | have a ~ on the front. It is up to the makefile to eventually create |
3046 | this directory while performing installation (with ~ substitution). |
f868067f |
3047 | The standard distribution will put nothing in this directory. |
3048 | After perl has been installed, users may install their own local |
3049 | architecture-dependent modules in this directory with |
3050 | MakeMaker Makefile.PL |
3051 | or equivalent. See INSTALL for details. |
781b178c |
3052 | |
3053 | sitearchexp (sitearch.U): |
3054 | This variable is the ~name expanded version of sitearch, so that you |
3055 | may use it directly in Makefiles or shell scripts. |
3056 | |
0617aed7 |
3057 | sitebin (sitebin.U): |
3058 | This variable holds the name of the directory in which the user wants |
3059 | to put add-on publicly executable files for the package in question. It |
3060 | is most often a local directory such as /usr/local/bin. Programs using |
3061 | this variable must be prepared to deal with ~name substitution. |
f868067f |
3062 | The standard distribution will put nothing in this directory. |
3063 | After perl has been installed, users may install their own local |
3064 | executables in this directory with |
3065 | MakeMaker Makefile.PL |
3066 | or equivalent. See INSTALL for details. |
0617aed7 |
3067 | |
3068 | sitebinexp (sitebin.U): |
3069 | This is the same as the sitebin variable, but is filename expanded at |
3070 | configuration time, for use in your makefiles. |
3071 | |
781b178c |
3072 | sitelib (sitelib.U): |
3073 | This variable contains the eventual value of the SITELIB symbol, |
3074 | which is the name of the private library for this package. It may |
3075 | have a ~ on the front. It is up to the makefile to eventually create |
3076 | this directory while performing installation (with ~ substitution). |
f868067f |
3077 | The standard distribution will put nothing in this directory. |
3078 | After perl has been installed, users may install their own local |
3079 | architecture-independent modules in this directory with |
3080 | MakeMaker Makefile.PL |
3081 | or equivalent. See INSTALL for details. |
781b178c |
3082 | |
526fdc24 |
3083 | sitelib_stem (sitelib.U): |
3084 | This variable is $sitelibexp with any trailing version-specific component |
3085 | removed. The elements in inc_version_list (inc_version_list.U) can |
3086 | be tacked onto this variable to generate a list of directories to search. |
3087 | |
781b178c |
3088 | sitelibexp (sitelib.U): |
3089 | This variable is the ~name expanded version of sitelib, so that you |
3090 | may use it directly in Makefiles or shell scripts. |
3091 | |
3092 | siteprefix (siteprefix.U): |
3093 | This variable holds the full absolute path of the directory below |
3094 | which the user will install add-on packages. |
f868067f |
3095 | See INSTALL for usage and examples. |
781b178c |
3096 | |
3097 | siteprefixexp (siteprefix.U): |
3098 | This variable holds the full absolute path of the directory below |
3099 | which the user will install add-on packages. Derived from siteprefix. |
3100 | |
a13ea748 |
3101 | sizesize (sizesize.U): |
3102 | This variable contains the size of a sizetype in bytes. |
3103 | |
781b178c |
3104 | sizetype (sizetype.U): |
3105 | This variable defines sizetype to be something like size_t, |
3106 | unsigned long, or whatever type is used to declare length |
3107 | parameters for string functions. |
3108 | |
3109 | sleep (Loc.U): |
3110 | This variable is defined but not used by Configure. |
3111 | The value is a plain '' and is not useful. |
3112 | |
3113 | smail (Loc.U): |
3114 | This variable is defined but not used by Configure. |
3115 | The value is a plain '' and is not useful. |
3116 | |
3117 | small (models.U): |
3118 | This variable contains a flag which will tell the C compiler and loader |
3119 | to produce a program running with a small memory model. It is up to |
3120 | the Makefile to use this. |
3121 | |
3122 | so (so.U): |
3123 | This variable holds the extension used to identify shared libraries |
3124 | (also known as shared objects) on the system. Usually set to 'so'. |
3125 | |
3126 | sockethdr (d_socket.U): |
3127 | This variable has any cpp '-I' flags needed for socket support. |
3128 | |
3129 | socketlib (d_socket.U): |
3130 | This variable has the names of any libraries needed for socket support. |
3131 | |
c890dc6c |
3132 | socksizetype (socksizetype.U): |
3133 | This variable holds the type used for the size argument |
3134 | for various socket calls like accept. Usual values include |
3135 | socklen_t, size_t, and int. |
3136 | |
781b178c |
3137 | sort (Loc.U): |
5bf26616 |
3138 | This variable is used internally by Configure to determine the |
781b178c |
3139 | full pathname (if any) of the sort program. After Configure runs, |
3140 | the value is reset to a plain "sort" and is not useful. |
3141 | |
3142 | spackage (package.U): |
3143 | This variable contains the name of the package being constructed, |
3144 | with the first letter uppercased, i.e. suitable for starting |
3145 | sentences. |
3146 | |
3147 | spitshell (spitshell.U): |
3148 | This variable contains the command necessary to spit out a runnable |
3149 | shell on this system. It is either cat or a grep '-v' for # comments. |
3150 | |
3151 | split (models.U): |
3152 | This variable contains a flag which will tell the C compiler and loader |
3153 | to produce a program that will run in separate I and D space, for those |
3154 | machines that support separation of instruction and data space. It is |
3155 | up to the Makefile to use this. |
3156 | |
ff935051 |
3157 | sPRId64 (quadfio.U): |
3158 | This variable, if defined, contains the string used by stdio to |
3159 | format 64-bit decimal numbers (format 'd') for output. |
3160 | |
3161 | sPRIeldbl (longdblfio.U): |
3162 | This variable, if defined, contains the string used by stdio to |
3163 | format long doubles (format 'e') for output. |
3164 | |
3165 | sPRIEldbl (longdblfio.U): |
3166 | This variable, if defined, contains the string used by stdio to |
3167 | format long doubles (format 'E') for output. |
3168 | |
3169 | sPRIfldbl (longdblfio.U): |
3170 | This variable, if defined, contains the string used by stdio to |
3171 | format long doubles (format 'f') for output. |
3172 | |
3173 | sPRIFldbl (longdblfio.U): |
3174 | This variable, if defined, contains the string used by stdio to |
3175 | format long doubles (format 'F') for output. |
3176 | |
3177 | sPRIgldbl (longdblfio.U): |
3178 | This variable, if defined, contains the string used by stdio to |
3179 | format long doubles (format 'g') for output. |
3180 | |
3181 | sPRIGldbl (longdblfio.U): |
3182 | This variable, if defined, contains the string used by stdio to |
3183 | format long doubles (format 'G') for output. |
3184 | |
3185 | sPRIi64 (quadfio.U): |
3186 | This variable, if defined, contains the string used by stdio to |
3187 | format 64-bit decimal numbers (format 'i') for output. |
3188 | |
3189 | sPRIo64 (quadfio.U): |
3190 | This variable, if defined, contains the string used by stdio to |
3191 | format 64-bit octal numbers (format 'o') for output. |
3192 | |
3193 | sPRIu64 (quadfio.U): |
3194 | This variable, if defined, contains the string used by stdio to |
3195 | format 64-bit unsigned decimal numbers (format 'u') for output. |
3196 | |
3197 | sPRIx64 (quadfio.U): |
3198 | This variable, if defined, contains the string used by stdio to |
3199 | format 64-bit hexadecimal numbers (format 'x') for output. |
3200 | |
3201 | sPRIX64 (quadfio.U): |
3202 | This variable, if defined, contains the string used by stdio to |
3203 | format 64-bit hExADECimAl numbers (format 'X') for output. |
3204 | |
781b178c |
3205 | src (src.U): |
3206 | This variable holds the path to the package source. It is up to |
3207 | the Makefile to use this variable and set VPATH accordingly to |
3208 | find the sources remotely. |
3209 | |
3210 | ssizetype (ssizetype.U): |
3211 | This variable defines ssizetype to be something like ssize_t, |
3212 | long or int. It is used by functions that return a count |
3213 | of bytes or an error condition. It must be a signed type. |
3214 | We will pick a type such that sizeof(SSize_t) == sizeof(Size_t). |
3215 | |
3216 | startperl (startperl.U): |
3217 | This variable contains the string to put on the front of a perl |
3218 | script to make sure (hopefully) that it runs with perl and not some |
3219 | shell. Of course, that leading line must be followed by the classical |
3220 | perl idiom: |
3221 | eval 'exec perl -S $0 ${1+"$@"}' |
3222 | if $running_under_some_shell; |
3223 | to guarantee perl startup should the shell execute the script. Note |
3224 | that this magic incatation is not understood by csh. |
3225 | |
3226 | startsh (startsh.U): |
3227 | This variable contains the string to put on the front of a shell |
3228 | script to make sure (hopefully) that it runs with sh and not some |
3229 | other shell. |
3230 | |
3231 | static_ext (Extensions.U): |
3232 | This variable holds a list of XS extension files we want to |
3233 | link statically into the package. It is used by Makefile. |
3234 | |
3235 | stdchar (stdchar.U): |
3236 | This variable conditionally defines STDCHAR to be the type of char |
3237 | used in stdio.h. It has the values "unsigned char" or "char". |
3238 | |
3239 | stdio_base (d_stdstdio.U): |
3240 | This variable defines how, given a FILE pointer, fp, to access the |
3241 | _base field (or equivalent) of stdio.h's FILE structure. This will |
3242 | be used to define the macro FILE_base(fp). |
3243 | |
3244 | stdio_bufsiz (d_stdstdio.U): |
3245 | This variable defines how, given a FILE pointer, fp, to determine |
3246 | the number of bytes store in the I/O buffer pointer to by the |
3247 | _base field (or equivalent) of stdio.h's FILE structure. This will |
3248 | be used to define the macro FILE_bufsiz(fp). |
3249 | |
3250 | stdio_cnt (d_stdstdio.U): |
3251 | This variable defines how, given a FILE pointer, fp, to access the |
3252 | _cnt field (or equivalent) of stdio.h's FILE structure. This will |
3253 | be used to define the macro FILE_cnt(fp). |
3254 | |
3255 | stdio_filbuf (d_stdstdio.U): |
3256 | This variable defines how, given a FILE pointer, fp, to tell |
3257 | stdio to refill it's internal buffers (?). This will |
3258 | be used to define the macro FILE_filbuf(fp). |
3259 | |
3260 | stdio_ptr (d_stdstdio.U): |
3261 | This variable defines how, given a FILE pointer, fp, to access the |
3262 | _ptr field (or equivalent) of stdio.h's FILE structure. This will |
3263 | be used to define the macro FILE_ptr(fp). |
3264 | |
3265 | stdio_stream_array (stdio_streams.U): |
3266 | This variable tells the name of the array holding the stdio streams. |
3267 | Usual values include _iob, __iob, and __sF. |
3268 | |
3269 | strings (i_string.U): |
3270 | This variable holds the full path of the string header that will be |
3271 | used. Typically /usr/include/string.h or /usr/include/strings.h. |
3272 | |
3273 | submit (Loc.U): |
3274 | This variable is defined but not used by Configure. |
3275 | The value is a plain '' and is not useful. |
3276 | |
3277 | subversion (patchlevel.U): |
3278 | The subversion level of this package. |
3279 | The value of subversion comes from the patchlevel.h file. |
ff935051 |
3280 | In a version number such as 5.6.1, this is the "1". |
c890dc6c |
3281 | In patchlevel.h, this is referred to as "PERL_SUBVERSION". |
781b178c |
3282 | This is unique to perl. |
3283 | |
3284 | sysman (sysman.U): |
3285 | This variable holds the place where the manual is located on this |
3286 | system. It is not the place where the user wants to put his manual |
3287 | pages. Rather it is the place where Configure may look to find manual |
3288 | for unix commands (section 1 of the manual usually). See mansrc. |
3289 | |
3290 | tail (Loc.U): |
3291 | This variable is defined but not used by Configure. |
3292 | The value is a plain '' and is not useful. |
3293 | |
3294 | tar (Loc.U): |
3295 | This variable is defined but not used by Configure. |
3296 | The value is a plain '' and is not useful. |
3297 | |
3298 | tbl (Loc.U): |
3299 | This variable is defined but not used by Configure. |
3300 | The value is a plain '' and is not useful. |
3301 | |
3302 | tee (Loc.U): |
3303 | This variable is defined but not used by Configure. |
3304 | The value is a plain '' and is not useful. |
3305 | |
3306 | test (Loc.U): |
5bf26616 |
3307 | This variable is used internally by Configure to determine the |
781b178c |
3308 | full pathname (if any) of the test program. After Configure runs, |
3309 | the value is reset to a plain "test" and is not useful. |
3310 | |
3311 | timeincl (i_time.U): |
3312 | This variable holds the full path of the included time header(s). |
3313 | |
3314 | timetype (d_time.U): |
3315 | This variable holds the type returned by time(). It can be long, |
3316 | or time_t on BSD sites (in which case <sys/types.h> should be |
3317 | included). Anyway, the type Time_t should be used. |
3318 | |
3319 | touch (Loc.U): |
5bf26616 |
3320 | This variable is used internally by Configure to determine the |
781b178c |
3321 | full pathname (if any) of the touch program. After Configure runs, |
3322 | the value is reset to a plain "touch" and is not useful. |
3323 | |
3324 | tr (Loc.U): |
5bf26616 |
3325 | This variable is used internally by Configure to determine the |
781b178c |
3326 | full pathname (if any) of the tr program. After Configure runs, |
3327 | the value is reset to a plain "tr" and is not useful. |
3328 | |
3329 | trnl (trnl.U): |
3330 | This variable contains the value to be passed to the tr(1) |
3331 | command to transliterate a newline. Typical values are |
3332 | '\012' and '\n'. This is needed for EBCDIC systems where |
3333 | newline is not necessarily '\012'. |
3334 | |
3335 | troff (Loc.U): |
3336 | This variable is defined but not used by Configure. |
3337 | The value is a plain '' and is not useful. |
3338 | |
a22e52b9 |
3339 | u16size (perlxv.U): |
3340 | This variable is the size of an U16 in bytes. |
3341 | |
3342 | u16type (perlxv.U): |
3343 | This variable contains the C type used for Perl's U16. |
3344 | |
3345 | u32size (perlxv.U): |
3346 | This variable is the size of an U32 in bytes. |
3347 | |
3348 | u32type (perlxv.U): |
3349 | This variable contains the C type used for Perl's U32. |
3350 | |
3351 | u64size (perlxv.U): |
3352 | This variable is the size of an U64 in bytes. |
3353 | |
3354 | u64type (perlxv.U): |
3355 | This variable contains the C type used for Perl's U64. |
3356 | |
3357 | u8size (perlxv.U): |
3358 | This variable is the size of an U8 in bytes. |
3359 | |
3360 | u8type (perlxv.U): |
3361 | This variable contains the C type used for Perl's U8. |
3362 | |
3363 | uidformat (uidf.U): |
3364 | This variable contains the format string used for printing a Uid_t. |
3365 | |
2d228ff3 |
3366 | uidsign (uidsign.U): |
3367 | This variable contains the signedness of a uidtype. |
3368 | 1 for unsigned, -1 for signed. |
3369 | |
785fb66b |
3370 | uidsize (uidsize.U): |
3371 | This variable contains the size of a uidtype in bytes. |
3372 | |
781b178c |
3373 | uidtype (uidtype.U): |
3374 | This variable defines Uid_t to be something like uid_t, int, |
3375 | ushort, or whatever type is used to declare user ids in the kernel. |
3376 | |
3377 | uname (Loc.U): |
5bf26616 |
3378 | This variable is used internally by Configure to determine the |
781b178c |
3379 | full pathname (if any) of the uname program. After Configure runs, |
3380 | the value is reset to a plain "uname" and is not useful. |
3381 | |
3382 | uniq (Loc.U): |
5bf26616 |
3383 | This variable is used internally by Configure to determine the |
781b178c |
3384 | full pathname (if any) of the uniq program. After Configure runs, |
3385 | the value is reset to a plain "uniq" and is not useful. |
3386 | |
0befd8de |
3387 | uquadtype (quadtype.U): |
3388 | This variable defines Uquad_t to be something like unsigned long, |
3389 | unsigned int, unsigned long long, uint64_t, or whatever type is |
3390 | used for 64-bit integers. |
3391 | |
aaacdc8b |
3392 | use5005threads (usethreads.U): |
3393 | This variable conditionally defines the USE_5005THREADS symbol, |
3394 | and indicates that Perl should be built to use the 5.005-based |
3395 | threading implementation. |
3396 | |
10cc9d2a |
3397 | use64bitall (use64bits.U): |
3398 | This variable conditionally defines the USE_64_BIT_ALL symbol, |
3399 | and indicates that 64-bit integer types should be used |
3400 | when available. The maximal possible |
3401 | 64-bitness is employed: LP64 or ILP64, meaning that you will |
3402 | be able to use more than 2 gigabytes of memory. This mode is |
3403 | even more binary incompatible than USE_64_BIT_INT. You may not |
3404 | be able to run the resulting executable in a 32-bit CPU at all or |
3405 | you may need at least to reboot your OS to 64-bit mode. |
3406 | |
3407 | use64bitint (use64bits.U): |
3408 | This variable conditionally defines the USE_64_BIT_INT symbol, |
aaacdc8b |
3409 | and indicates that 64-bit integer types should be used |
c890dc6c |
3410 | when available. The minimal possible 64-bitness |
3411 | is employed, just enough to get 64-bit integers into Perl. |
3412 | This may mean using for example "long longs", while your memory |
3413 | may still be limited to 2 gigabytes. |
781b178c |
3414 | |
3415 | usedl (dlsrc.U): |
ff935051 |
3416 | This variable indicates if the system supports dynamic |
781b178c |
3417 | loading of some sort. See also dlsrc and dlobj. |
3418 | |
aaacdc8b |
3419 | useithreads (usethreads.U): |
3420 | This variable conditionally defines the USE_ITHREADS symbol, |
3421 | and indicates that Perl should be built to use the interpreter-based |
3422 | threading implementation. |
3423 | |
5bf26616 |
3424 | uselargefiles (uselfs.U): |
1baac590 |
3425 | This variable conditionally defines the USE_LARGE_FILES symbol, |
3426 | and indicates that large file interfaces should be used when |
c890dc6c |
3427 | available. |
1baac590 |
3428 | |
ca24dfc6 |
3429 | uselongdouble (uselongdbl.U): |
3430 | This variable conditionally defines the USE_LONG_DOUBLE symbol, |
3431 | and indicates that long doubles should be used when available. |
3432 | |
1baac590 |
3433 | usemorebits (usemorebits.U): |
3434 | This variable conditionally defines the USE_MORE_BITS symbol, |
3435 | and indicates that explicit 64-bit interfaces and long doubles |
3436 | should be used when available. |
3437 | |
781b178c |
3438 | usemultiplicity (usemultiplicity.U): |
3439 | This variable conditionally defines the MULTIPLICITY symbol, |
3440 | and indicates that Perl should be built to use multiplicity. |
3441 | |
3442 | usemymalloc (mallocsrc.U): |
3443 | This variable contains y if the malloc that comes with this package |
3444 | is desired over the system's version of malloc. People often include |
3445 | special versions of malloc for effiency, but such versions are often |
3446 | less portable. See also mallocsrc and mallocobj. |
3447 | If this is 'y', then -lmalloc is removed from $libs. |
3448 | |
3449 | usenm (usenm.U): |
3450 | This variable contains 'true' or 'false' depending whether the |
3451 | nm extraction is wanted or not. |
3452 | |
3453 | useopcode (Extensions.U): |
3454 | This variable holds either 'true' or 'false' to indicate |
3455 | whether the Opcode extension should be used. The sole |
3456 | use for this currently is to allow an easy mechanism |
3457 | for users to skip the Opcode extension from the Configure |
3458 | command line. |
3459 | |
3460 | useperlio (useperlio.U): |
3461 | This variable conditionally defines the USE_PERLIO symbol, |
3462 | and indicates that the PerlIO abstraction should be |
3463 | used throughout. |
3464 | |
3465 | useposix (Extensions.U): |
3466 | This variable holds either 'true' or 'false' to indicate |
3467 | whether the POSIX extension should be used. The sole |
3468 | use for this currently is to allow an easy mechanism |
3469 | for hints files to indicate that POSIX will not compile |
3470 | on a particular system. |
3471 | |
3472 | usesfio (d_sfio.U): |
3473 | This variable is set to true when the user agrees to use sfio. |
3474 | It is set to false when sfio is not available or when the user |
3475 | explicitely requests not to use sfio. It is here primarily so |
3476 | that command-line settings can override the auto-detection of |
3477 | d_sfio without running into a "WHOA THERE". |
3478 | |
3479 | useshrplib (libperl.U): |
3480 | This variable is set to 'yes' if the user wishes |
3481 | to build a shared libperl, and 'no' otherwise. |
3482 | |
3483 | usesocks (usesocks.U): |
3484 | This variable conditionally defines the USE_SOCKS symbol, |
3485 | and indicates that Perl should be built to use SOCKS. |
3486 | |
3487 | usethreads (usethreads.U): |
3488 | This variable conditionally defines the USE_THREADS symbol, |
3489 | and indicates that Perl should be built to use threads. |
3490 | |
9f50e519 |
3491 | usevendorprefix (vendorprefix.U): |
3492 | This variable tells whether the vendorprefix |
3493 | and consequently other vendor* paths are in use. |
3494 | |
781b178c |
3495 | usevfork (d_vfork.U): |
3496 | This variable is set to true when the user accepts to use vfork. |
3497 | It is set to false when no vfork is available or when the user |
3498 | explicitely requests not to use vfork. |
3499 | |
3500 | usrinc (usrinc.U): |
3501 | This variable holds the path of the include files, which is |
3502 | usually /usr/include. It is mainly used by other Configure units. |
3503 | |
3504 | uuname (Loc.U): |
3505 | This variable is defined but not used by Configure. |
3506 | The value is a plain '' and is not useful. |
3507 | |
a22e52b9 |
3508 | uvoformat (perlxvf.U): |
3509 | This variable contains the format string used for printing |
3510 | a Perl UV as an unsigned octal integer. |
3511 | |
3512 | uvsize (perlxv.U): |
3513 | This variable is the size of a UV in bytes. |
3514 | |
3515 | uvtype (perlxv.U): |
3516 | This variable contains the C type used for Perl's UV. |
3517 | |
3518 | uvuformat (perlxvf.U): |
3519 | This variable contains the format string used for printing |
3520 | a Perl UV as an unsigned decimal integer. |
3521 | |
3522 | uvxformat (perlxvf.U): |
3523 | This variable contains the format string used for printing |
3524 | a Perl UV as an unsigned hexadecimal integer. |
3525 | |
526fdc24 |
3526 | vendorarch (vendorarch.U): |
3527 | This variable contains the value of the PERL_VENDORARCH symbol. |
3528 | It may have a ~ on the front. |
3529 | The standard distribution will put nothing in this directory. |
3530 | Vendors who distribute perl may wish to place their own |
3531 | architecture-dependent modules and extensions in this directory with |
3532 | MakeMaker Makefile.PL INSTALLDIRS=vendor |
3533 | or equivalent. See INSTALL for details. |
3534 | |
3535 | vendorarchexp (vendorarch.U): |
3536 | This variable is the ~name expanded version of vendorarch, so that you |
3537 | may use it directly in Makefiles or shell scripts. |
3538 | |
0617aed7 |
3539 | vendorbin (vendorbin.U): |
f868067f |
3540 | This variable contains the eventual value of the VENDORBIN symbol. |
3541 | It may have a ~ on the front. |
3542 | The standard distribution will put nothing in this directory. |
3543 | Vendors who distribute perl may wish to place additional |
3544 | binaries in this directory with |
3545 | MakeMaker Makefile.PL INSTALLDIRS=vendor |
3546 | or equivalent. See INSTALL for details. |
0617aed7 |
3547 | |
3548 | vendorbinexp (vendorbin.U): |
3549 | This variable is the ~name expanded version of vendorbin, so that you |
3550 | may use it directly in Makefiles or shell scripts. |
3551 | |
a3635516 |
3552 | vendorlib (vendorlib.U): |
3553 | This variable contains the eventual value of the VENDORLIB symbol, |
f868067f |
3554 | which is the name of the private library for this package. |
3555 | The standard distribution will put nothing in this directory. |
3556 | Vendors who distribute perl may wish to place their own |
3557 | modules in this directory with |
3558 | MakeMaker Makefile.PL INSTALLDIRS=vendor |
3559 | or equivalent. See INSTALL for details. |
a3635516 |
3560 | |
526fdc24 |
3561 | vendorlib_stem (vendorlib.U): |
3562 | This variable is $vendorlibexp with any trailing version-specific component |
3563 | removed. The elements in inc_version_list (inc_version_list.U) can |
3564 | be tacked onto this variable to generate a list of directories to search. |
3565 | |
a3635516 |
3566 | vendorlibexp (vendorlib.U): |
3567 | This variable is the ~name expanded version of vendorlib, so that you |
3568 | may use it directly in Makefiles or shell scripts. |
3569 | |
3570 | vendorprefix (vendorprefix.U): |
3571 | This variable holds the full absolute path of the directory below |
3572 | which the vendor will install add-on packages. |
f868067f |
3573 | See INSTALL for usage and examples. |
a3635516 |
3574 | |
3575 | vendorprefixexp (vendorprefix.U): |
3576 | This variable holds the full absolute path of the directory below |
3577 | which the vendor will install add-on packages. Derived from vendorprefix. |
3578 | |
781b178c |
3579 | version (patchlevel.U): |
ff935051 |
3580 | The full version number of this package, such as 5.6.1 (or 5_6_1). |
c890dc6c |
3581 | This combines revision, patchlevel, and subversion to get the |
ff935051 |
3582 | full version number, including any possible subversions. |
3583 | This is suitable for use as a directory name, and hence is |
3584 | filesystem dependent. |
781b178c |
3585 | |
3586 | vi (Loc.U): |
3587 | This variable is defined but not used by Configure. |
3588 | The value is a plain '' and is not useful. |
3589 | |
3590 | voidflags (voidflags.U): |
3591 | This variable contains the eventual value of the VOIDFLAGS symbol, |
3592 | which indicates how much support of the void type is given by this |
3593 | compiler. See VOIDFLAGS for more info. |
3594 | |
3595 | xlibpth (libpth.U): |
3596 | This variable holds extra path (space-separated) used to find |
3597 | libraries on this platform, for example CPU-specific libraries |
3598 | (on multi-CPU platforms) may be listed here. |
3599 | |
fe749a9f |
3600 | xs_apiversion (xs_apiversion.U): |
3601 | This variable contains the version of the oldest perl binary |
3602 | compatible with the present perl. perl.c:incpush() and |
3603 | lib/lib.pm will automatically search in $sitearch for older |
3604 | directories across major versions back to xs_apiversion. |
3605 | This is only useful if you have a perl library directory tree |
3606 | structured like the default one. |
3607 | See INSTALL for how this works. |
3608 | The versioned site_perl directory was introduced in 5.005, |
3609 | so that is the lowest possible value. |
3610 | Since this can depend on compile time options (such as |
3611 | bincompat) it is set by Configure. Other non-default sources |
3612 | of potential incompatibility, such as multiplicity, threads, |
3613 | debugging, 64bits, sfio, etc., are not checked for currently, |
3614 | though in principle we could go snooping around in old |
3615 | Config.pm files. |
3616 | |
781b178c |
3617 | zcat (Loc.U): |
3618 | This variable is defined but not used by Configure. |
3619 | The value is a plain '' and is not useful. |
3620 | |
3621 | zip (Loc.U): |
5bf26616 |
3622 | This variable is used internally by Configure to determine the |
781b178c |
3623 | full pathname (if any) of the zip program. After Configure runs, |
3624 | the value is reset to a plain "zip" and is not useful. |
3625 | |