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