[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    getconf(1) manual page Table of Contents

Name

getconf - get configuration values

Synopsis

getconf system_var
getconf path_var pathname

Availability

SUNWcsu

Description

In the first synopsis form, the getconf utility will write to the standard output the value of the variable specified by system_var.

In the second synopsis form, getconf will write to the standard output the value of the variable specified by path_var for the path specified by pathname.

The value of each configuration variable will be determined 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.

Operands

The following operands are supported:
path_var
A name of a configuration variable whose value is available from the pathconf(2) function. All of the values in the following table are supported and the implementation may add other local values:
LINK_MAXNAME_MAXPOSIX_CHOWN_RESTRICTED
MAX_CANONPATH_MAXPOSIX_NO_TRUNC
MAX_INPUTPIPE_BUFPOSIX_VDISABLE
pathname
A path name for which the variable specified by path_var is to be determined.
system_var
A name of a configuration variable whose value is available from confstr(3C) or sysconf(3C) . All of the values in the following table are supported and the implementation may add other local values:

ARG_MAXOPEN_MAX_POSIX_PIPE_BUF
BC_BASE_MAXPOSIX2_BC_BASE_MAX_POSIX_SAVED_IDS
BC_DIM_MAXPOSIX2_BC_DIM_MAX_POSIX_SSIZE_MAX
BC_SCALE_MAXPOSIX2_BC_SCALE_MAX_POSIX_STREAM_MAX
BC_STRING_MAXPOSIX2_BC_STRING_MAX_POSIX_TZNAME_MAX
CHARCLASS_NAME_MAXPOSIX2_CHAR_TERM_POSIX_VERSION
CHAR_BITPOSIX2_COLL_WEIGHTS_MAXRE_DUP_MAX
CHAR_MAXPOSIX2_C_BINDSCHAR_MAX
CHAR_MINPOSIX2_C_DEVSCHAR_MIN
CHILD_MAXPOSIX2_C_VERSIONSHRT_MAX
CLK_TCKPOSIX2_EXPR_NEST_MAXSHRT_MIN
COLL_WEIGHTS_MAXPOSIX2_FORT_DEVSSIZE_MAX
CS_PATHPOSIX2_FORT_RUNSTREAM_MAX
EXPR_NEST_MAXPOSIX2_LINE_MAXTMP_MAX
INT_MAXPOSIX2_LOCALEDEFTZNAME_MAX
INT_MINPOSIX2_RE_DUP_MAXUCHAR_MAX
LINE_MAXPOSIX2_SW_DEVUINT_MAX
LONG_BITPOSIX2_UPEULONG_MAX
LONG_MAXPOSIX2_VERSIONUSHRT_MAX
LONG_MIN_POSIX_ARG_MAXWORD_BIT
MB_LEN_MAX_POSIX_CHILD_MAX_XOPEN_CRYPT
NGROUPS_MAX_POSIX_JOB_CONTROL_XOPEN_ENH_I18N
NL_ARGMAX_POSIX_LINK_MAX_XOPEN_SHM
NL_LANGMAX_POSIX_MAX_CANON_XOPEN_VERSION
NL_MSGMAX_POSIX_MAX_INPUT_XOPEN_XCU_VERSION
NL_NMAX_POSIX_NAME_MAX_XOPEN_XPG2
NL_SETMAX_POSIX_NGROUPS_MAX_XOPEN_XPG3
NL_TEXTMAX_POSIX_OPEN_MAX_XOPEN_XPG4
NZERO_POSIX_PATH_MAX

The symbol PATH also is recognized, yielding the same value as the confstr() name value CS_PATH.

Examples

This example illustrates the value of {NGROUPS_MAX} :

getconf NGROUPS_MAX

This example illustrates the value of NAME_MAX for a specific directory:

getconf 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
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.

Environment

See environ(5) for descriptions of the following environment variables that affect the execution of getconf: LC_CTYPE, LC_MESSAGES, and NLSPATH.

Exit Status

The following exit values are returned:
  1. The specified variable is valid and information about its current state was written successfully.
    >0
    An error occurred.

    See Also

    pathconf(2) , confstr(3C) , sysconf(3C) , environ(5)

    Table of Contents