getconf(1) MPE/iX Shell and Utilities getconf(1)
______________________________________________________________________
NAME
getconf -- display POSIX configuration information
SYNOPSIS
getconf parameter_name [pathname]
DESCRIPTION
getconf writes the value of a configuration variable to the stan-
dard output. getconf displays numeric values in decimal format
and non-numeric values as simple strings. If the value is unde-
fined, getconf displays it as the string undefined.
The following are POSIX.1 standard parameter_names that require a
pathname.
LINK_MAX
maximum number of links that this file can have.
MAX_CANON
maximum number of bytes in the terminal's canonical
input queue (before line editing).
MAX_INPUT
space available in terminal input queue.
NAME_MAX
largest file name size.
PATH_MAX
number of bytes in a path name.
PIPE_BUF
largest atomic write to a pipe.
_POSIX_CHOWN_RESTRICTED
restrictions apply to file ownership changes.
_POSIX_NO_TRUNC
if set, it is error for any path name component to be
longer than NAME_MAX bytes.
_POSIX_VDISABLE
processes are allowed to disable terminal special char-
acters.
The following are POSIX.1 standard names which do not require a
pathname.
ARG_MAX
maximum length of arguments for running a program,
including environment.
1
getconf(1) MPE/iX Shell and Utilities getconf(1)
______________________________________________________________________
CHILD_MAX
maximum number of simultaneous processes allowed per
real user.
CLK_TCK
number of intervals per second in machine clock.
NGROUPS_MAX
number of simultaneous group IDs, per process.
OPEN_MAX
number of open files at any time, per process.
STREAM_MAX
number of streams that one process can have open at one
time.
TZNAME_MAX
maximum number of bytes supported for the name of a
time zone (not of the TZ variable).
PATH
standard PATH setting.
_CS_PATH
standard PATH setting.
_POSIX_ARG_MAX
minimum conforming value for ARG_MAX.
_POSIX_CHILD_MAX
minimum conforming value for CHILD_MAX.
_POSIX_JOB_CONTROL
POSIX job control supported.
_POSIX_LINK_MAX
minimum conforming value for LINK_MAX.
_POSIX_MAX_CANON
minimum conforming value for MAX_CANON.
_POSIX_MAX_INPUT
minimum conforming value for MAX_INPUT.
_POSIX_NAME_MAX
minimum conforming value for NAME_MAX.
_POSIX_NGROUPS_MAX
minimum conforming value for NGROUPS_MAX.
_POSIX_OPEN_MAX
minimum conforming value for OPEN_MAX.
2
getconf(1) MPE/iX Shell and Utilities getconf(1)
______________________________________________________________________
_POSIX_PATH_MAX
minimum conforming value for PATH_MAX.
_POSIX_PIPE_BUF
minimum conforming value for PIPE_BUF.
_POSIX_SAVED_IDS
processes have saved set-user-ID and saved set-
group-ID.
_POSIX_SSIZE_MAX
value that can be stored in an object of type ssize_t.
_POSIX_STREAM_MAX
minimum conforming value for STREAM_MAX.
_POSIX_TZNAME_MAX
minimum conforming value for TZNAME_MAX.
_POSIX_VERSION
gives version of POSIX adhered to in this release.
The following are POSIX.2 standard names that do not require a
pathname.
BC_BASE_MAX
maximum ibase and obase values for the bc command.
BC_DIM_MAX
maximum number of elements permitted in a bc array.
BC_SCALE_MAX
maximum scale size allowed in bc.
BC_STRING_MAX
maximum number of characters in a string in bc.
COLL_WEIGHTS_MAX
maximum number of weights assignable to an entry of the
LC_COLLATE order keyword.
EXPR_NEST_MAX
maximum number of expressions that you can nest inside
parentheses in an expression evaluated by expr.
LINE_MAX
maximum number of characters that a utility can accept
as an input line (either from the standard input or a
text file), when the utility takes text files as input.
This number includes the trailing newline.
3
getconf(1) MPE/iX Shell and Utilities getconf(1)
______________________________________________________________________
RE_DUP_MAX
maximum number of repeated occurrences of a regular
expression when using the interval notation \{m,n\}
(see regexp(3)).
POSIX2_C_BIND
indicates if the system supports the C Language Bind-
ings Option.
POSIX2_C_DEV
indicates if the system supports the C Language Devel-
opment Utilities Option.
POSIX2_FORT_DEV
indicates if the system supports the FORTRAN Develop-
ment Utilities Option.
POSIX2_FORT_RUN
indicates if the system supports the FORTRAN Runtime
Utilities Option.
POSIX2_LOCALEDEF
indicates if the system supports the creation of
locales.
POSIX2_SW_DEV
indicates if the system supports the Software Develop-
ment Utilities Option.
POSIX2_CHAR_TERM
indicates if the system supports at least one terminal
type capable of all operations necessary for the User
Portability Utilities. Only on if POSIX2_UPE is on.
POSIX2_UPE
indicates if the system supports the User Portability
Utilities Option.
POSIX2_VERSION
gives the version of POSIX.2 adhered to in this
release.
POSIX2_BC_BASE_MAX
minimum conforming value for BC_BASE_MAX.
POSIX2_BC_DIM_MAX
minimum conforming value for BC_DIM_MAX.
POSIX2_BC_SCALE_MAX
minimum conforming value for BC_SCALE_MAX.
POSIX2_BC_STRING_MAX
minimum conforming value for BC_STRING_MAX.
4
getconf(1) MPE/iX Shell and Utilities getconf(1)
______________________________________________________________________
POSIX2_COLL_WEIGHTS_MAX
minimum conforming value for EQUIV_CLASS_MAX.
POSIX2_EXPR_NEST_MAX
minimum conforming value for EXPR_NEST_MAX.
POSIX2_LINE_MAX
minimum conforming value for LINE_MAX.
POSIX2_RE_DUP_MAX
minimum conforming value for RE_DUP_MAX.
This implementation of getconf also recognizes the following non-
POSIX-compliant name.
_CS_SHELL
default shell (command interpreter).
EXAMPLES
The following example uses getconf to find the largest scale
value supported by the MPE/iX bc utility. If you enter
getconf BC_SCALE_MAX
getconf displays
32767
DIAGNOSTICS
Possible exit status values are:
0 The specified parameter_name was valid and getconf displayed
its value successfully.
>0 An error occurred.
Messages
Message: argument: system error
Cause: See syserror(3).
Action: See syserror(3).
5
getconf(1) MPE/iX Shell and Utilities getconf(1)
______________________________________________________________________
Message: insufficient memory for buffer.
Cause: There were not enough free system resources for getconf
to allocate to its buffer.
Action: Free up more resources.
Message: Unknown option "-option"
Cause: You specified an option that is not valid for this com-
mand.
Action: Check the DESCRIPTIONS section for a list of valid
options.
PORTABILITY
POSIX.2. x/OPEN Portability Guide 4.0.
_CS_SHELL is an extension to the POSIX standard. Some symbols are
only supported on systems that support POSIX.2, Draft 8. Some
symbols only exist on POSIX.1 systems later than 1990.
SEE ALSO
bc(1), expr(1), sh(1), regexp(3)
6