getconf(1) getconf(1)
NAME
getconf - get configuration values
SYNOPSIS
getconf system_var
getconf path_var pathname
DESCRIPTION
In the first synopsis form, the getconf utility will write to
the standard output the value of the variable specified by the
system_var operand.
In the second synopsis form, the getconf utility will write to
the standard output the value of the variable specified by the
path_var operand for the path specified by the pathname
operand.
The value of each configuration variable will be determine as
if it were obtained by calling the function from which it is
defined to be available. The value will reflect conditions in
the current operating environment.
path_var is the name of a configuration variable whose value
is available from pathconf function. The following
values are supported (other local values):
LINK_MAN NAME_MAX POSIX_CHOWN_RESTRICTED
MAX_CANON PATH_MAX POSIX_NO_TRUNC
MAX_INPUT PIPE_BUF POSIX_VDISABLE
pathname is the pathname for which the variable specified by
path_var is to be determined.
system_var
is the name of a configuration variable whose value
is available from the XSH specification confstr or
sysconf functions. The following values are
supported (other local values):
ARG_MAX NZERO POSIX_OPEN_MAX
BC_BASE_MAX OPEN_MAX POSIX_PATH_MAX
BC_DIM_MAX POSIX2_BC_BASE_MAX POSIX_PIPE_BUF
BC_SCALE_MAX POSIX2_BC_DIM_MAX POSIX_SAVED_IDS
BC_STRING_MAX POSIX2_BC_SCALE_MAX POSIX_SSIZE_MAX
CHARCLASS_NAME_MAX POSIX2_BC_STRING_MAX POSIX_STREAM_MAX
CHAR_BIT POSIX2_CHAR_TERM POSIX_TZNAME_MAX
Copyright 1994 Novell, Inc. Page 1
getconf(1) getconf(1)
CHAR_MAX POSIX2_COLL_WEIGHTS_MAX POSIX_VERSION
CHAR_MIN POSIX2_BIND RE_DUP_MAX
CHILD_MAX POSIX2_C_DEV SCHAR_MAX
CLK_TCK POSIX2_C_VERSION SCHAR_MIN
COLL_WEIGHTS_MAX POSIX2_EXPR_NEST_MAX SHRT_MAX
CS_PATH POSIX2_FORT_DEV SHRT_MIN
EXPR_NEST_MAX POSIX2_FORT_RUN SSIZE_MAX
INT_MAX POSIX2_LINE_MAX STREAM_MAX
INT_MIN POSIX2_LOCALEDEF TMP_MAX
LINE_MAX POSIX2_RE_DUP_MAX TZNAME_MAX
LONG_BIT POSIX2_SW_DEV UCHAR_MAX
LONG_MAX POSIX2_UPE UINT_MAX
LONG_MIN POSIX2_VERSION ULONG_MAX
MB_LEN_MAX POSIX_ARG_MAX USHRT_MAX
MN_NMAX POSIX_CHILD_MAX WORD_BIT
NGROUPS_MAX POSIX_JOB_CONTROL XOPEN_VERSION
NL_ARGMAX POSIX_LINK_MAX XOPEN_XCU_VERSION
NL_LANGMAX POSIX_MAX_CANON XOPEN_XPG2
NL_MSGMAX POSIX_MAX_INPUT XOPEN_XPG3
NL_SET_MAX POSIX_NAME_MAX XOPEN_XPG4
NL_TEXT_MAX POSIX_NGROUPS_MAX
The symbol PATH also is recognized, yielding the same value as
the confstr name value CS_PATH.
Environment Variables
LANG Provide a default value of the internationalization
variables that are unset or null. If LANG is unset
or null, the corresponding value from the
implementation-specific default locale will be used.
If any of the internationalization variables
contains an invalid setting, the utility will behave
as if none of the variables had been defined.
LC_ALL If set to a non-empty string value, override the
values of all the other internationalization
variables.
LC_CTYPE Determine the locale for the the interpretation of
sequences of bytes of text data as characters (for
example, single- as opposed to multi-byte characters
in arguments).
LC_MESSAGES
Determine the locale that should be used to affect
the format and contents of diagnostic messages
Copyright 1994 Novell, Inc. Page 2
getconf(1) getconf(1)
written to standard error.
NLSPATH Determine the location of message catalogues for the
processing of LC_MESSAGES.
Output
If the specified variable is defined on the system and its
value is described to be available from the XSH specification
confstr function, its value will be written in the following
format:
"%s\n", <value>
Otherwise, if the specified variable is defined on the system,
its value will be written in the following format:
"%d\n", <value>
If the specified variable is valid, but is undefined on the
system, getconf will write using the following format:
"undefined\n"
If the variable name is invalid or an error occurs, nothing
will be written to standard output.
Examples
This example illustrates the value of {NGROUPS_MAX}:
getconf NGROUPS_MAX
This example illustrates the value of {NAME_MAX} for a
specific directory:
getcon NAME_MAX /usr
This example shows how to deal more carefully with results
that might be unspecified:
if value=$(getconf PATH_MAX /usr); then
if ["$value" = "undefined"]; then
echo PATH_MAX in /usr is infinite.
else
echo PATH_MAX in /usr is $value.
fi
else
Copyright 1994 Novell, Inc. Page 3
getconf(1) getconf(1)
echo Error in getconf.
fi
Note that:
sysconf(_SC_POSIX_C_BIND);
and:
system("getconf POSIX2_C_BIND");
in a C program could give different answers. The sysconf call
supplies a value that corresponds to the conditions when the
program was either compiled or executed, depending on the
implementation; the system call to getconf always supplies a
value corresponding to conditions when the program is
executed.
REFERENCES
confstr(3C), fpathconf(2), sysconf(3C)
Copyright 1994 Novell, Inc. Page 4