*** UNIX MANUAL PAGE BROWSER ***

getconf(1) General Commands Manual getconf(1) NAME getconf - Displays system configuration variable values SYNOPSIS getconf system_configuration getconf path_configuration pathname STANDARDS Interfaces documented on this reference page conform to industry stan- dards as follows: getconf: XPG4, XPG4-UNIX Refer to the standards(5) reference page for more information about in- dustry standards and associated tags. OPTIONS None OPERANDS Name of a system-wide configuration variable. Name of a system path- configuration variable. A path name for the path_configuration vari- able. DESCRIPTION The system_configuration argument specifies system-configuration vari- ables whose values are valid throughout the system. There are two kinds of system-wide configuration values: System-wide configuration variables System standards configuration variables The path_configuration argument specifies system path-configuration variables whose values contain information about paths and the path structure in the system. System-Wide Configuration Variables System-wide configuration variables contain the minimum values met throughout all portions of the system. The following list defines the system-wide configuration variables used with the getconf command: The maximum length, in bytes, of the arguments for one of the exec func- tions, including environment data. [XPG4-UNIX] The maximum number of functions that can be registered with atexit() per process. The maxi- mum value allowed for the obase variable with the bc command. The max- imum number of elements permitted in an array by the bc command. The maximum value allowed for the scale variable with the bc command. The maximum length of string constants accepted by the bc command. The maximum number of bytes in a character class name. Number of bits in a type of char. The maximum value of a type char. The minimum value of a type char. The maximum number of simultaneous processes for each real user ID. The number of clock ticks per second. The value of CLK_TCK may be variable, and it should not be assumed that CLK_TCK is a compile-time constant. The maximum number of weights that can be as- signed to an entry in the LC_COLLATE locale-dependent information in a locale-definition file. A value for the PATH environment variable that finds all standard utilities. [DIGITAL] The maximum number of data keys that may be created per process. The maximum number of expres- sions that can be nested within parentheses by the expr command. The maximum value of an int. The minimum value of an int. The maximum length, in bytes, of a command's input line (either standard input or another file) when the utility is described as processing text files. The length includes room for the trailing newline character. Number of bits in a long int. The maximum value of a long int. The minimum value of a long int. The maximum number of bytes in a character for any supported locale. The maximum number of simultaneous supplementary group IDs for each process. The maximum value of digit in calls to the printf() and scanf() functions. The maximum number of bytes in a LANG name. The maximum message number. [DIGITAL] The maximum number of bytes in an N-to-1 collation mapping. The maximum set number. The maximum number of bytes in a message string. Default process priority. The maximum number of files that one process can have open at one time. [XPG4-UNIX] The page size granularity for memory regions. [DIGI- TAL] The maximum number of characters returned by getpass() (not in- cluding terminating null). A value for the PATH environment variable that finds all standard utilities. The maximum number of repeated oc- currences of a regular expression permitted when using the interval-no- tation parameters, such as the m and n parameters with the ed command. The maximum value of a type signed char. The minimum value of a type signed char. The maximum value of a type short. The minimum value of a type short. The maximum value that can be stored in an object of type ssize_t. The number of streams that one process can have open at one time. The minimum number of unique path names generated by tmp- nam(). Maximum number of times an application can call tmpnam() reli- ably. The maximum number of bytes supported for the name of a time zone (not the length of the TZ environmental variable). The maximum value of a type unsigned char. The maximum value of a type unsigned int. The maximum value of a type unsigned long int. The maximum value of a type unsigned short int. Number of bits in a word or type int. System Standards Configuration Variables System standards configuration variables contain the minimum values re- quired by a particular system standard. The prefixes _POSIX_, POSIX2_, _XOPEN, and _AES indicate that the variable contains the minimum value for a system characteristic required by the POSIX 1003.1 (POSIX.1), POSIX 1003.2 (POSIX.2), X/Open, and the Open Software Foundation's AES system standards, respectively. System standards are system-wide mini- mums that the system meets to support the particular system standard. Actual configuration values may exceed these standards. The system standards configuration variables for the getconf command are defined as follows: [DIGITAL] The integer value indicating the revision of the Application Environment Specification to which the implementation is compliant. The length of the arguments for one of the exec functions, in bytes, including environment data. The maximum number of simultane- ous processes for each real user ID. This variable has a value of 1 if the system supports job control; otherwise, the variable is undefined. The maximum value of a file's link count. The maximum number of bytes in a terminal canonical input queue. The maximum number of bytes for which space will be available in a terminal input queue. The maximum number of bytes in a file name. The maximum number of simultaneous supplementary group IDs for each process. The maximum number of files that one process can have open at one time. The maximum number of bytes in a path name. The maximum number of bytes that can be written atomically when writing to a pipe. [DIGITAL] This variable has a value of 1 if the system supports POSIX reentrant functions; otherwise, the variable is undefined. This variable has a value of 1 if each process has a saved set-user-ID and a saved set-group-ID; otherwise, the variable is undefined. The maximum value that can be stored in an object of type ssize_t. The number of streams that one process can have open at one time. [DIGITAL] This variable has a value of 1 if the system supports the POSIX threads stack size attribute; otherwise, the variable is undefined. [DIGITAL] This variable has a value of 1 if the system supports POSIX threads; otherwise, the variable is unde- fined. The maximum number of bytes supported for the name of a time zone (not the length of the TZ environmental variable). The date of approval of the most current version of the POSIX.1 standard that the system supports. The date is a 6-digit number, with the first 4 digits signifying the year and the last 2 digits the month. Different versions of the POSIX.1 standard are periodically approved by the IEEE Standards Board, and the date of approval is used to distinguish between differ- ent versions. The maximum value allowed for the obase variable with the bc command. The maximum number of elements permitted in an array by the bc command. The maximum value allowed for the scale variable with the bc command. The maximum length string constants accepted by the bc command. One or more terminal types capable of all operations described in ISO/IEC 9945. This value need not be present on a system not supporting the User Portability Utilities Option. The maximum num- ber of weights that can be assigned to an entry of the LC_COLLATE lo- cale variable in a locale-definition file. The maximum number of ex- pressions that can be nested within parentheses by the expr command. The maximum length, in bytes, of a command's input line (either stan- dard input or another file) when the utility is described as processing text files. The length includes room for the trailing newline charac- ter. This variable has a value of 1 if the system supports the cre- ation of new locales with the localedef command; otherwise, the vari- able is undefined. The maximum number of repeated occurrences of a regular expression permitted when using the interval-notation parame- ters, such as the m and n parameters with the ed command. This vari- able has a value of 1 if the system supports the User Portability Util- ities Option; otherwise, the variable has a value of 0 (zero). The date of approval of the most current version of the POSIX.2 standard that the system supports. The date is a 6-digit number, with the first 4 digits signifying the year and the last 2 digits the month. Different versions of the POSIX.2 standard are periodically approved by the IEEE Standards Board, and the date of approval is used to distinguish be- tween different versions. This variable has a value of 1 if the system supports the optional C Language Development Facilities specified by POSIX.2 and the optional C Language Bindings Option from POSIX.2; oth- erwise, the variable is undefined. This variable has a value of 1 if the system supports the optional C Language Development Utilities from POSIX.2; otherwise, the variable is undefined. This value indicates the version of the interfaces described in the C-Language Bindings Op- tion section of the XPG4 standard. This value changes with each pub- lished version of ISO/IEC 9945 to indicate the 4-digit year and 2-digit month that the standard was approved by the IEEE Standards Board. This variable has a value of 1 if the system supports the FORTRAN Develop- ment Utilities Option from POSIX.2; otherwise, the variable is unde- fined. This variable has a value of 1 if the system supports the FOR- TRAN Runtime Utilities Option from POSIX.2; otherwise, the variable is undefined. This variable has a value of 1 if the system supports the Software Development Utilities Option from POSIX.2; otherwise, the variable is undefined. This variable has a value other than -1 if the implementation supports the X/Open Encryption Feature Group. This variable has a value other than -1 if the implementation supports the X/Open Enhanced Internationalization Feature Group. This variable has a value other than -1 if the implementation supports the X/Open Shared Memory Feature Group. An integer indicating the most current version of the X/OPEN standard that the system supports. An integer value in- dicating the version of the XCU specification to which the implementa- tion conforms. If the value is -1, no commands and utilities are pro- vided on the implementation. This variable is defined only if the im- plementation supports the X/Open Portability Guide, Volume 2, January 1987, XVS System Calls and Libraries. This variable is defined only if the implementation supports the X/Open Specification, February 1992, System Interfaces and Headers, Issue 3. This variable is defined only if the implementation supports the X/Open CAE Specification, July 1992, Systems Interfaces and Headers, Issue 4. System Path Configuration Variables The maximum value of a file's link count. If the pathname argument refers to a directory, the value returned applies to the directory it- self. The maximum number of bytes in a terminal canonical input queue. If the pathname argument does not specify a terminal file, the getconf command exits with a nonzero value. The maximum number of bytes for which space will be available in a terminal input queue. If the path- name argument does not specify a terminal file, the getconf command ex- its with a nonzero value. The maximum number of bytes in a file name. If the pathname argument specifies a directory, the value returned ap- plies to the file names within the directory. The maximum number of bytes in a path name. If the pathname argument specifies a directory, the value returned is the maximum length of a relative path name when the specified directory is the working directory. The maximum number of bytes that can be written atomically when writing to a pipe. If the pathname argument specifies a FIFO or a pipe, the value returned ap- plies to that object. If the pathname argument specifies a directory, the value returned applies to any FIFO created in that directory. If the pathname argument does not specify a directory or a FIFO file, the getconf command exits with a nonzero value. This variable has a value of 1 when the use of the chown function is restricted to a process with appropriate privileges and the group ID of a file can only be changed to the effective group ID of the process or to one of its supplementary group IDs. If the variable is undefined, it varies in the system, de- pending upon the path. This variable has a value of 1 when path names longer than the limit specified by the NAME_MAX variable will generate an error. If the variable is undefined, it varies in the system, de- pending upon the path. When this variable has a value of 1, terminal special characters, which are defined in the <termios.h> header file, can be disabled. If the pathname argument does not specify a terminal file, the getconf command will exit with a nonzero value. EXIT STATUS The following exit values are returned: The specified variable is valid and information about its current state has been displayed success- fully. An error occurred. EXAMPLES To display the value of the ARG_MAX environment variable, enter: get- conf ARG_MAX To display the value of the PATH_MAX environmental vari- able for the /usr directory, enter: getconf PATH_MAX /usr This sequence returns the following message: The value of PATH_MAX in /usr is 1023 ENVIRONMENT VARIABLES The following environment variables affect the execution of getconf: Provides a default value for the internationalization variables that are unset or null. If LANG is unset or null, the corresponding value from the default locale is used. If any of the internationalization variables contain an invalid setting, the utility behaves as if none of the variables had been defined. If set to a non-empty string value, overrides the values of all the other internationalization variables. Determines the locale for the interpretation of sequences of bytes of text data as characters (for example, single-byte as opposed to multi- byte characters in arguments). Determines the locale for the format and contents of diagnostic messages written to standard error. Deter- mines the location of message catalogues for the processing of LC_MES- SAGES. FILES Defines system configuration variables. Defines system configuration variables. Defines terminal characteristics. SEE ALSO Commands: env(1) Functions: pathconf(2) Routines: confstr(3), sysconf(3) Environment: environ(5) Standards: standards(5) getconf(1)