getconf(1) getconf(1)
NAME [Toc] [Back]
getconf - get system configuration values
SYNOPSIS [Toc] [Back]
getconf [-v specification] system_var
getconf [-v specification] system_var pathname
DESCRIPTION [Toc] [Back]
The getconf command provides an interface to the confstr(3C),
pathconf(2), and sysconf(2) library routines and system calls.
The system_var argument specifies the configuration value desired in
confstr(), pathconf(), or sysconf(). Use the first synopsis form, for
inquiries involving confstr(), or sysconf() (in the first table
below). Use the second synopsis form, for inquiries involving
pathconf() (in the second table below). For inquiries involving
pathconf() the pathname operand should be specified.
Options [Toc] [Back]
getconf recognizes the following option:
-v specification Return configuration variables corresponding to
a particular compilation environment supported
by HP-UX. If the -v option is not specified,
specification defaults to XBS5_ILP32_OFF32. See
table below for possible specifications and
meanings.
Specification int long pointer off_t
_________________________________________________
XBS5_ILP32_OFF32 32 32 32 32
XBS5_ILP32_OFFBIG 32 32 32 >=64
XBS5_LP64_OFF64 32 64 64 64
XBS5_LPBIG_OFFBIG >=32 >=64 >=64 >=64
EXTERNAL INFLUENCES [Toc] [Back]
Environment Variables
LC_MESSAGES determines the language in which messages are displayed.
If LC_MESSAGES is not specified in the environment or is set to the
empty string, the value of LANG is used as a default for each
unspecified or empty variable. If LANG is not specified or is set to
the empty string, a default of "C" (see lang(5)) is used instead of
LANG.
If any internationalization variable contains an invalid setting,
getconf behaves as if all internationalization variables are set to
"C". See environ(5).
International Code Set Support [Toc] [Back]
Single-byte and multi-byte character code sets are supported.
Hewlett-Packard Company - 1 - HP-UX 11i Version 2: August 2003
getconf(1) getconf(1)
RETURN VALUE [Toc] [Back]
The error codes returned by getconf are:
0 Success. A value corresponding to the operand was returned.
1 One or more missing operands.
2 Operand was not recognized.
3 pathname either invalid or inaccessible.
EXAMPLES [Toc] [Back]
Request the number of intervals per second:
getconf CLK_TCK
Request the maximum value of a file's link count:
getconf LINK_MAX /etc/passwd
Enquire if the implementation supports multiple locality domains:
getconf CCNUMA_SUPPORT
getconf gives the following output:
1 If the implementation supports multiple locality
domains.
undefined If the implementation doesn't support multiple
locality domains.
Other supported inquiries include the following:
ARG_MAX _BC_BASE_MAX BC_DIM_MAX
BS_SCALE_MAX BC_STRING_MAX CHARCLASS_NAME_MAX
CHAR_BIT CHAR_MAX CHAR_MIN
CHILD_MAX CLK_TCK COLL_WEIGHTS_MAX
CPU_CHIP_TYPE CS_MACHINE_IDENT CS_PARTITION_IDENT
CS_PATH CS_MACHINE_SERIAL EXPR_NEST_MAX
HW_CPU_SUPP_BITS HW_32_64_CAPABLE INT_MAX
INT_MIN IPMI_INTERFACE KERNEL_BITS
LINE_MAX LONG_BIT LONG_MAX
LONG_MIN MACHINE_IDENT MACHINE_MODEL
MACHINE_SERIAL MB_LEN_MAX NGROUPS_MAX
NL_ARGMAX NL_LANGMAX NL_MSGMAX
NL_NMAX NL_SETMAX NL_TEXTMAX
NZERO OPEN_MAX PARTITION_IDENT
PATH _POSIX_ARG_MAX _POSIX_JOB_CONTROL
_POSIX_NGROUPS_MAX _POSIX_OPEN_MAX _POSIX_SAVED_IDS
_POSIX_SSIZE_MAX _POSIX_STREAM_MAX _POSIX_TZNAME_MAX
_POSIX_VERSION POSIX_ARG_MAX POSIX_CHILD_MAX
POSIX_JOB_CONTROL POSIX_LINK_MAX POSIX_MAX_CANON
Hewlett-Packard Company - 2 - HP-UX 11i Version 2: August 2003
getconf(1) getconf(1)
POSIX_MAX_INPUT POSIX_NAME_MAX POSIX_NGROUPS_MA
POSIX_OPEN_MAX POSIX_PATH_MAX POSIX_PIPE_BUF
POSIX_SAVED_IDS POSIX_SSIZE_MAX POSIX_STREAM_MAX
POSIX_TZNAME_MAX POSIX_VERSION POSIX2_BC_BASE_MAX
POSIX2_BC_DIM_MAX POSIX2_BC_SCALE_MAX POSIX2_BC_STRING_MAX
POSIX2_C_BIND POSIX2_C_DEV POSIX2_C_VERSION
POSIX2_CHAR_TERM POSIX_CHILD_MAX POSIX2_COLL_WEIGHTS_MAX
POSIX2_EXPR_NEST_MAX POSIX2_FORT_DEV POSIX2_FORT_RUN
POSIX2_LINE_MAX POSIX2_LOCALEDEF POSIX2_RE_DUP_MAX
POSIX2_SW_DE POSIX2_UPE POSIX2_VERSION
PSET_SUPPORT SC_PASS_MAX SC_XOPEN_VERSION
SCHAR_MAX SCHAR_MIN SHRT_MAX
SHRT_MIN SSIZE_MAX STREAM_MAX
RE_DUP_MAX TMP_MAX TZNAME_MAX
UCHAR_MAX UINT_MAX ULONG_MAX
USHRT_MAX WORD_BIT XOPEN_VERSION
XOPEN_XCU_VERSION XOPEN_XPG2 XOPEN_XPG3
XOPEN_XPG4
XBS5_ILP32_OFF32_CFLAGS XBS5_ILP32_OFF32_LDFLAGS
XBS5_ILP32_OFF32_LIBS XBS5_ILP32_OFF32_LINTFLAGS
XBS5_ILP32_OFFBIG_CFLAGS XBS5_ILP32_OFFBIG_LDFLAGS
XBS5_ILP32_OFFBIG_LIBS XBS5_ILP32_OFFBIG_LINTFLAGS
XBS5_LP64_OFF64_CFLAGS XBS5_LP64_OFF64_LDFLAGS
XBS5_LP64_OFF64_LIBS XBS5_LP64_OFF64_LINTFLAGS
Supported inquiries requiring the second parameter include:
LINK_MAX MAX_CANON MAX_INPUT
NAME_MAX PATH_MAX PIPE_BUF
_POSIX_CHOWN_RESTRICTED _POSIX_LINK_MAX _POSIX_MAX_CANON
_POSIX_MAX_INPUT _POSIX_NO_TRUNC _POSIX_NAME_MAX
_POSIX_PATH_MAX _POSIX_PIPE_BUF _POSIX_VDISABLE
POSIX_CHOWN_RESTRICTED POSIX_NO_TRUNC POSIX_VDISABLE
Note [Toc] [Back]
For a complete list of parameters supported by getconf, look into the
manual pages of sysconf(), pathconf(), and confstr().
AUTHOR [Toc] [Back]
getconf was developed by HP and POSIX.
SEE ALSO [Toc] [Back]
pathconf(2), sysconf(2), confstr(3C).
STANDARDS CONFORMANCE [Toc] [Back]
getconf: POSIX.2, XPG4
Hewlett-Packard Company - 3 - HP-UX 11i Version 2: August 2003 [ Back ] |
