getconf(1)

NAME

getconf — get system configuration values

SYNOPSIS

getconf [-v specification] system_var

getconf [-v specification] system_var pathname

DESCRIPTION

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

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

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

Single-byte and multi-byte character code sets are supported.

RETURN VALUE

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

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 

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`	`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`	`POSIX_MAX_INPUT`
`POSIX_NAME_MAX`	`POSIX_NGROUPS_MAX`	`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_DEV`
`POSIX2_UPE`	`POSIX2_VERSION`	`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`

AUTHOR

getconf was developed by HP and POSIX.

STANDARDS CONFORMANCE

getconf: POSIX.2, XPG4