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