X-Git-Url: https://perl5.git.perl.org/perl5.git/blobdiff_plain/1be1b388c18674b89d106c333a2dd62d9b736e29..668fdbe135fd76c7a654bedba52770966925f562:/Porting/Glossary diff --git a/Porting/Glossary b/Porting/Glossary index 2700073..9134dfa 100644 --- a/Porting/Glossary +++ b/Porting/Glossary @@ -142,7 +142,7 @@ baserev (baserev.U): bash (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. bin (bin.U): This variable holds the name of the directory in which the user wants @@ -150,6 +150,11 @@ bin (bin.U): is most often a local directory such as /usr/local/bin. Programs using this variable must be prepared to deal with ~name substitution. +bin_ELF (dlsrc.U): + This variable saves the result from configure if generated binaries + are in ELF format. Only set to defined when the test has actually + been performed, and the result was positive. + binexp (bin.U): This is the same as the bin variable, but is filename expanded at configuration time, for use in your makefiles. @@ -244,9 +249,17 @@ cf_time (cf_who.U): Holds the output of the "date" command when the configuration file was produced. This is used to tag both config.sh and config_h.SH. +charbits (charsize.U): + This variable contains the value of the CHARBITS symbol, which + indicates to the C program how many bits there are in a character. + +charsize (charsize.U): + This variable contains the value of the CHARSIZE symbol, which + indicates to the C program how many bytes there are in a character. + chgrp (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. chmod (Loc.U): This variable is used internally by Configure to determine the @@ -255,7 +268,7 @@ chmod (Loc.U): chown (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. clocktype (d_times.U): This variable holds the type returned by times(). It can be long, @@ -269,7 +282,24 @@ comm (Loc.U): compress (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. + +config_arg0 (Options.U): + This variable contains the string used to invoke the Configure + command, as reported by the shell in the $0 variable. + +config_argc (Options.U): + This variable contains the number of command-line arguments + passed to Configure, as reported by the shell in the $# variable. + The individual arguments are stored as variables config_argc1, + config_argc2, etc. + +config_args (Options.U): + This variable contains a single string giving the command-line + arguments passed to Configure. Spaces within arguments, + quotes, and escaped characters are not correctly preserved. + To reconstruct the command line, you must assemble the individual + command line pieces, given in config_arg[0-9]*. contains (contains.U): This variable holds the command to do a grep with a proper return @@ -284,7 +314,7 @@ cp (Loc.U): cpio (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. cpp (Loc.U): This variable is used internally by Configure to determine the @@ -406,6 +436,11 @@ d_atoll (atoll.U): This variable conditionally defines the HAS_ATOLL symbol, which indicates to the C program that the atoll() routine is available. +d_attribute_deprecated (d_attribut.U): + This variable conditionally defines HASATTRIBUTE_DEPRECATED, which + indicates that GCC can handle the attribute for marking deprecated + APIs + d_attribute_format (d_attribut.U): This variable conditionally defines HASATTRIBUTE_FORMAT, which indicates the C compiler can check for printf-like formats. @@ -493,7 +528,7 @@ d_casti32 (d_casti32.U): d_castneg (d_castneg.U): This variable conditionally defines CASTNEG, which indicates - wether the C compiler can cast negative float to unsigned. + whether the C compiler can cast negative float to unsigned. d_charvspr (d_vprintf.U): This variable conditionally defines CHARVSPRINTF if this system @@ -714,7 +749,7 @@ d_eofnblk (nblock_io.U): d_eunice (Guess.U): This variable conditionally defines the symbols EUNICE and VAX, which - alerts the C program that it must deal with ideosyncracies of VMS. + alerts the C program that it must deal with idiosyncrasies of VMS. d_faststdio (d_faststdio.U): This variable conditionally defines the HAS_FAST_STDIO symbol, @@ -894,6 +929,11 @@ d_gdbmndbm_h_uses_prototypes (i_ndbm.U): undefined. Consult the different d_*ndbm_h_uses_prototypes variables to get the same information for alternative ndbm.h include files. +d_getaddrinfo (d_getaddrinfo.U): + This variable conditionally defines the HAS_GETADDRINFO symbol, + which indicates to the C program that the getaddrinfo() function + is available. + d_getcwd (d_getcwd.U): This variable conditionally defines the HAS_GETCWD symbol, which indicates to the C program that the getcwd() routine is available @@ -901,7 +941,7 @@ d_getcwd (d_getcwd.U): d_getespwnam (d_getespwnam.U): This variable conditionally defines HAS_GETESPWNAM if getespwnam() is - available to retrieve enchanced (shadow) password entries by name. + available to retrieve enhanced (shadow) password entries by name. d_getfsstat (d_getfsstat.U): This variable conditionally defines the HAS_GETFSSTAT symbol, which @@ -996,6 +1036,11 @@ d_getmntent (d_getmntent.U): indicates to the C program that the getmntent() routine is available to iterate through mounted files to get their mount info. +d_getnameinfo (d_getnameinfo.U): + This variable conditionally defines the HAS_GETNAMEINFO symbol, + which indicates to the C program that the getnameinfo() function + is available. + d_getnbyaddr (d_getnbyad.U): This variable conditionally defines the HAS_GETNETBYADDR symbol, which indicates to the C program that the getnetbyaddr() routine is available @@ -1213,6 +1258,16 @@ d_inetaton (d_inetaton.U): indicates to the C program that the inet_aton() function is available to parse IP address "dotted-quad" strings. +d_inetntop (d_inetntop.U): + This variable conditionally defines the HAS_INETNTOP symbol, + which indicates to the C program that the inet_ntop() function + is available. + +d_inetpton (d_inetpton.U): + This variable conditionally defines the HAS_INETPTON symbol, + which indicates to the C program that the inet_pton() function + is available. + d_int64_t (d_int64_t.U): This symbol will be defined if the C compiler supports int64_t. @@ -1344,7 +1399,7 @@ d_memcpy (d_memcpy.U): d_memmove (d_memmove.U): This variable conditionally defines the HAS_MEMMOVE symbol, which indicates to the C program that the memmove() routine is available - to copy potentatially overlapping blocks of memory. + to copy potentially overlapping blocks of memory. d_memset (d_memset.U): This variable conditionally defines the HAS_MEMSET symbol, which @@ -1562,43 +1617,52 @@ d_portable (d_portable.U): indicates to the C program that it should not assume that it is running on the machine it was compiled on. +d_prctl (d_prctl.U): + This variable conditionally defines the HAS_PRCTL symbol, which + indicates to the C program that the prctl() routine is available. + +d_prctl_set_name (d_prctl.U): + This variable conditionally defines the HAS_PRCTL_SET_NAME symbol, + which indicates to the C program that the prctl() routine supports + the PR_SET_NAME option. + d_PRId64 (quadfio.U): This variable conditionally defines the PERL_PRId64 symbol, which - indiciates that stdio has a symbol to print 64-bit decimal numbers. + indicates that stdio has a symbol to print 64-bit decimal numbers. d_PRIeldbl (longdblfio.U): This variable conditionally defines the PERL_PRIfldbl symbol, which - indiciates that stdio has a symbol to print long doubles. + indicates that stdio has a symbol to print long doubles. d_PRIEUldbl (longdblfio.U): This variable conditionally defines the PERL_PRIfldbl symbol, which - indiciates that stdio has a symbol to print long doubles. + indicates that stdio has a symbol to print long doubles. The 'U' in the name is to separate this from d_PRIeldbl so that even case-blind systems can see the difference. d_PRIfldbl (longdblfio.U): This variable conditionally defines the PERL_PRIfldbl symbol, which - indiciates that stdio has a symbol to print long doubles. + indicates that stdio has a symbol to print long doubles. d_PRIFUldbl (longdblfio.U): This variable conditionally defines the PERL_PRIfldbl symbol, which - indiciates that stdio has a symbol to print long doubles. + indicates that stdio has a symbol to print long doubles. The 'U' in the name is to separate this from d_PRIfldbl so that even case-blind systems can see the difference. d_PRIgldbl (longdblfio.U): This variable conditionally defines the PERL_PRIfldbl symbol, which - indiciates that stdio has a symbol to print long doubles. + indicates that stdio has a symbol to print long doubles. d_PRIGUldbl (longdblfio.U): This variable conditionally defines the PERL_PRIfldbl symbol, which - indiciates that stdio has a symbol to print long doubles. + indicates that stdio has a symbol to print long doubles. The 'U' in the name is to separate this from d_PRIgldbl so that even case-blind systems can see the difference. d_PRIi64 (quadfio.U): This variable conditionally defines the PERL_PRIi64 symbol, which - indiciates that stdio has a symbol to print 64-bit decimal numbers. + indicates that stdio has a symbol to print 64-bit decimal numbers. d_printf_format_null (d_attribut.U): This variable conditionally defines PRINTF_FORMAT_NULL_OK, which @@ -1606,20 +1670,20 @@ d_printf_format_null (d_attribut.U): d_PRIo64 (quadfio.U): This variable conditionally defines the PERL_PRIo64 symbol, which - indiciates that stdio has a symbol to print 64-bit octal numbers. + indicates that stdio has a symbol to print 64-bit octal numbers. d_PRIu64 (quadfio.U): This variable conditionally defines the PERL_PRIu64 symbol, which - indiciates that stdio has a symbol to print 64-bit unsigned decimal + indicates that stdio has a symbol to print 64-bit unsigned decimal numbers. d_PRIx64 (quadfio.U): This variable conditionally defines the PERL_PRIx64 symbol, which - indiciates that stdio has a symbol to print 64-bit hexadecimal numbers. + indicates that stdio has a symbol to print 64-bit hexadecimal numbers. d_PRIXU64 (quadfio.U): This variable conditionally defines the PERL_PRIXU64 symbol, which - indiciates that stdio has a symbol to print 64-bit hExADECimAl numbers. + indicates that stdio has a symbol to print 64-bit hExADECimAl numbers. The 'U' in the name is to separate this from d_PRIx64 so that even case-blind systems can see the difference. @@ -1769,7 +1833,7 @@ d_scm_rights (d_socket.U): d_SCNfldbl (longdblfio.U): This variable conditionally defines the PERL_PRIfldbl symbol, which - indiciates that stdio has a symbol to scan long doubles. + indicates that stdio has a symbol to scan long doubles. d_seekdir (d_readdir.U): This variable conditionally defines HAS_SEEKDIR if seekdir() is @@ -2007,6 +2071,11 @@ d_sigsetjmp (d_sigsetjmp.U): which indicates that the sigsetjmp() routine is available to call setjmp() and optionally save the process's signal mask. +d_sin6_scope_id (d_socket.U): + This variable conditionally defines the HAS_SIN6_SCOPE_ID symbol, which + indicates that a struct sockaddr_in6 structure has the sin6_scope_id + member. + d_sitearch (sitearch.U): This variable conditionally defines SITEARCH to hold the pathname of architecture-dependent library files for $package. If @@ -2017,6 +2086,11 @@ d_snprintf (d_snprintf.U): indicates to the C program that the snprintf () library function is available. +d_sockaddr_sa_len (d_socket.U): + This variable conditionally defines the HAS_SOCKADDR_SA_LEN symbol, + which indicates that a struct sockaddr structure has the sa_len + member. + d_sockatmark (d_sockatmark.U): This variable conditionally defines the HAS_SOCKATMARK symbol, which indicates to the C program that the sockatmark() routine is available. @@ -2089,6 +2163,12 @@ d_statfs_s (d_statfs_s.U): This variable conditionally defines the HAS_STRUCT_STATFS symbol, which indicates that the struct statfs is supported. +d_static_inline (d_static_inline.U): + This variable conditionally defines the HAS_STATIC_INLINE symbol, + which indicates that the C compiler supports C99-style static + inline. That is, the function can't be called from another + translation unit. + d_statvfs (d_statvfs.U): This variable conditionally defines the HAS_STATVFS symbol, which indicates to the C program that the statvfs() routine is available. @@ -2261,7 +2341,7 @@ d_telldirproto (d_telldirproto.U): d_time (d_time.U): This variable conditionally defines the HAS_TIME symbol, which indicates - that the time() routine exists. The time() routine is normaly + that the time() routine exists. The time() routine is normally provided on UNIX systems. d_timegm (d_timegm.U): @@ -2270,7 +2350,7 @@ d_timegm (d_timegm.U): d_times (d_times.U): This variable conditionally defines the HAS_TIMES symbol, which indicates - that the times() routine exists. The times() routine is normaly + that the times() routine exists. The times() routine is normally provided on UNIX systems. You may have to include . d_tm_tm_gmtoff (i_time.U): @@ -2372,7 +2452,7 @@ d_voidtty (i_sysioctl.U): This variable conditionally defines USE_IOCNOTTY to indicate that the ioctl() call with TIOCNOTTY should be used to void tty association. Otherwise (on USG probably), it is enough to close the standard file - decriptors and do a setpgrp(). + descriptors and do a setpgrp(). d_volatile (d_volatile.U): This variable conditionally defines the HASVOLATILE symbol, which @@ -2507,7 +2587,7 @@ egrep (Loc.U): emacs (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. endgrent_r_proto (d_endgrent_r.U): This variable encodes the prototype of endgrent_r. @@ -2561,7 +2641,7 @@ expr (Loc.U): extensions (Extensions.U): This variable holds a list of all extension files (both XS and non-xs linked into the package. It is propagated to Config.pm - and is typically used to test whether a particular extesion + and is typically used to test whether a particular extension is available. extern_C (Csym.U): @@ -2584,7 +2664,7 @@ fflushNULL (fflushall.U): find (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. firstmakefile (Unix.U): This variable defines the first file searched by make. On unix, @@ -2594,7 +2674,7 @@ firstmakefile (Unix.U): flex (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. fpossize (fpossize.U): This variable contains the size of a fpostype in bytes. @@ -3294,13 +3374,13 @@ inc_version_list_init (inc_version_list.U): suitable for use in the PERL_INC_VERSION_LIST initialization. incpath (usrinc.U): - This variable must preceed the normal include path to get hte + This variable must precede the normal include path to get the right one, as in "$incpath/usr/include" or "$incpath/usr/lib". Value can be "" or "/bsd43" on mips. inews (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. initialinstalllocation (bin.U): When userelocatableinc is true, this variable holds the location @@ -3317,7 +3397,7 @@ installarchlib (archlib.U): installbin (bin.U): This variable is the same as binexp unless AFS is running in which case - the user is explicitely prompted for it. This variable should always + the user is explicitly prompted for it. This variable should always be used in your makefiles for maximum portability. installhtml1dir (html1dir.U): @@ -3514,7 +3594,7 @@ known_extensions (Extensions.U): ksh (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. ld (dlsrc.U): This variable indicates the program to be used to link @@ -3596,11 +3676,11 @@ libswanted_uselargefiles (uselfs.U): line (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. lint (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. lkflags (ccflags.U): This variable contains any additional C partial linker flags desired by @@ -3650,11 +3730,11 @@ longsize (intsize.U): lp (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. lpr (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. ls (Loc.U): This variable is used internally by Configure to determine the @@ -3689,11 +3769,11 @@ madlysrc (mad.U): mail (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. mailx (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. make (Loc.U): This variable is used internally by Configure to determine the @@ -3798,7 +3878,7 @@ multiarch (multiarch.U): mv (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. myarchname (archname.U): This variable holds the architecture name computed by Configure in @@ -3997,8 +4077,9 @@ path_sep (Unix.U): used to separate elements in the command shell search PATH. perl (Loc.U): - This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + This variable is used internally by Configure to determine the + full pathname (if any) of the perl program. After Configure runs, + the value is reset to a plain "perl" and is not useful. perl5 (perl5.U): This variable contains the full path (if any) to a previously @@ -4047,6 +4128,16 @@ PERL_REVISION (Oldsyms.U): In a Perl version number such as 5.6.2, this is the 5. This value is manually set in patchlevel.h +perl_static_inline (d_static_inline.U): + This variable defines the PERL_STATIC_INLINE symbol to + the best-guess incantation to use for static inline functions. + Possibilities include + static inline (c99) + static __inline__ (gcc -ansi) + static __inline (MSVC) + static _inline (older MSVC) + static (c89 compilers) + PERL_SUBVERSION (Oldsyms.U): In a Perl version number such as 5.6.2, this is the 2. Values greater than 50 represent potentially unstable @@ -4097,11 +4188,11 @@ plibpth (libpth.U): pmake (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. pr (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. prefix (prefix.U): This variable holds the name of the directory below which the @@ -4203,7 +4294,7 @@ rm_try (Unix.U): rmail (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. run (Cross.U): This variable contains the command used by Configure @@ -4255,7 +4346,7 @@ selecttype (selecttype.U): sendmail (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. setgrent_r_proto (d_setgrent_r.U): This variable encodes the prototype of setgrent_r. @@ -4319,7 +4410,7 @@ sh (sh.U): shar (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. sharpbang (spitshell.U): This variable contains the string #! if this system supports that @@ -4533,7 +4624,7 @@ sizetype (sizetype.U): sleep (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. sLOCALTIME_max (time_size.U): This variable defines the maximum value of the time_t offset that @@ -4545,7 +4636,7 @@ sLOCALTIME_min (time_size.U): smail (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. so (so.U): This variable holds the extension used to identify shared libraries @@ -4659,6 +4750,13 @@ ssizetype (ssizetype.U): of bytes or an error condition. It must be a signed type. We will pick a type such that sizeof(SSize_t) == sizeof(Size_t). +st_ino_sign (st_ino_def.U): + This variable contains the signedness of struct stat's st_ino. + 1 for unsigned, -1 for signed. + +st_ino_size (st_ino_def.U): + This variable contains the size of struct stat's st_ino in bytes. + startperl (startperl.U): This variable contains the string to put on the front of a perl script to make sure (hopefully) that it runs with perl and not some @@ -4667,7 +4765,7 @@ startperl (startperl.U): eval 'exec perl -S $0 ${1+"$@"}' if $running_under_some_shell; to guarantee perl startup should the shell execute the script. Note - that this magic incatation is not understood by csh. + that this magic incantation is not understood by csh. startsh (startsh.U): This variable contains the string to put on the front of a shell @@ -4724,7 +4822,7 @@ strings (i_string.U): submit (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. subversion (patchlevel.U): The subversion level of this package. @@ -4741,11 +4839,11 @@ sysman (sysman.U): tail (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. tar (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. targetarch (Cross.U): If cross-compiling, this variable contains the target architecture. @@ -4753,11 +4851,11 @@ targetarch (Cross.U): tbl (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. tee (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. test (Loc.U): This variable is used internally by Configure to determine the @@ -4802,7 +4900,7 @@ trnl (trnl.U): troff (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. ttyname_r_proto (d_ttyname_r.U): This variable encodes the prototype of ttyname_r. @@ -4937,7 +5035,7 @@ usemultiplicity (usemultiplicity.U): usemymalloc (mallocsrc.U): This variable contains y if the malloc that comes with this package is desired over the system's version of malloc. People often include - special versions of malloc for effiency, but such versions are often + special versions of malloc for efficiency, but such versions are often less portable. See also mallocsrc and mallocobj. If this is 'y', then -lmalloc is removed from $libs. @@ -4981,7 +5079,7 @@ userelocatableinc (bin.U): usesfio (d_sfio.U): This variable is set to true when the user agrees to use sfio. It is set to false when sfio is not available or when the user - explicitely requests not to use sfio. It is here primarily so + explicitly requests not to use sfio. It is here primarily so that command-line settings can override the auto-detection of d_sfio without running into a "WHOA THERE". @@ -5009,7 +5107,7 @@ usevendorprefix (vendorprefix.U): usevfork (d_vfork.U): This variable is set to true when the user accepts to use vfork. It is set to false when no vfork is available or when the user - explicitely requests not to use vfork. + explicitly requests not to use vfork. usrinc (usrinc.U): This variable holds the path of the include files, which is @@ -5017,7 +5115,7 @@ usrinc (usrinc.U): uuname (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. uvoformat (perlxvf.U): This variable contains the format string used for printing @@ -5041,6 +5139,11 @@ uvXUformat (perlxvf.U): This variable contains the format string used for printing a Perl UV as an unsigned hexadecimal integer in uppercase ABCDEF. +vaproto (vaproto.U): + This variable conditionally defines CAN_VAPROTO on systems supporting + prototype declaration of functions with a variable number of + arguments. See also prototype. + vendorarch (vendorarch.U): This variable contains the value of the PERL_VENDORARCH symbol. It may have a ~ on the front. @@ -5189,7 +5292,7 @@ versiononly (versiononly.U): vi (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. voidflags (voidflags.U): This variable contains the eventual value of the VOIDFLAGS symbol, @@ -5211,7 +5314,7 @@ yaccflags (yacc.U): zcat (Loc.U): This variable is defined but not used by Configure. - The value is a plain '' and is not useful. + The value is the empty string and is not useful. zip (Loc.U): This variable is used internally by Configure to determine the