[Previous] [Contents] [Index] [Next]

Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

getconf

Get system configuration values (POSIX)

Syntax:

getconf system_var
getconf path_var pathname

Options:

None.

Description:

This utility gets system configuration values.

The first form writes to standard output the value of the specified system variable. The possible values of system_var are those for sysconf() and confstr() (see the Library Reference):

_CS_ARCHITECTURE
The name of the instruction set architecture for this node's CPU(s).
_CS_DOMAIN
The domain name.
_CS_HOSTNAME
The name of this node in the network.
Note: A hostname can consist only of letters, numbers, and hyphens, and must not start or end with a hyphen. For more information, see RFC 952.

_CS_HW_PROVIDER
The name of the hardware manufacturer.
_CS_HW_SERIAL
Serial number associated with the hardware.
_CS_LIBPATH
A value similar to the LD_LIBRARY_PATH environment variable that finds all standard libraries.
_CS_LOCALE
The name of the current locale.
_CS_MACHINE
This node's hardware type.
_CS_PATH
A value similar to the PATH environment variable that finds all standard utilities.
_CS_RELEASE
The current OS release level.
_CS_RESOLVE
The contents of the resolv.conf file, excluding the domain name.
_CS_SRPC_DOMAIN
The secure RPC domain.
_CS_SYSNAME
The name of the operating system.
_CS_TIMEZONE
Time zone string (TZ style)
_CS_VERSION
The current OS version number.
_SC_ARG_MAX
Maximum length of arguments for the exec*() functions, in bytes, including environment data.
_SC_CHILD_MAX
Maximum number of simultaneous processes per real user ID.
_SC_CLK_TCK
The number of intervals per second used to express the value in type clock_t.
_SC_NGROUPS_MAX
The maximum number of simultaneous supplementary group IDs per process.
_SC_OPEN_MAX
Maximum number of files that one process can have open at any given time.
_SC_JOB_CONTROL
If this variable is defined, then job control is supported.
_SC_SAVED_IDS
If this variable is defined, then each process has a saved set-user ID and a saved set-group ID.
_SC_VERSION
The current POSIX version that is currently supported. A value of 198808L indicates the August (08) 1988 standard, as approved by the IEEE Standards Board.

The second form writes to standard output the value of the specified path variable for the given path. The possible values of path_var are those for pathconf() (see the Library Reference):

_PC_LINK_MAX
Maximum value of a file's link count.
_PC_MAX_CANON
Maximum number of bytes in a terminal's canonical input buffer (edit buffer).
_PC_MAX_INPUT
Maximum number of bytes in a terminal's raw input buffer.
_PC_NAME_MAX
Maximum number of bytes in a file name (not including the terminating null).
_PC_PATH_MAX
Maximum number of bytes in a pathname (not including the terminating null).
_PC_PIPE_BUF
Maximum number of bytes that can be written atomically when writing to a pipe.
_PC_CHOWN_RESTRICTED
If defined (not -1), indicates that the use of the chown function is restricted to a process with root privileges, and to changing the group ID of a file to the effective group ID of the process or to one of its supplementary group IDs.
_PC_NO_TRUNC
If defined (not -1), indicates that the use of pathname components longer than the value given by _PC_NAME_MAX will generate an error.
_PC_VDISABLE
If defined (not -1), this is the character value which can be used to individually disable special control characters in the termios control structure.

Examples:

$ getconf _CS_PATH
/bin
$ getconf _SC_ARG_MAX
61440
$ getconf _PC_LINK_MAX /bin
65535

Environment variables:

LANG
The locale to use for the locale categories.
Note: QNX Neutrino currently supports only the POSIX (i.e. C) locale.

Exit status:

0
Successful completion.
1
An error occurred.

See also:

setconf

confstr(), pathconf(), sysconf() in the Library Reference

"Configuration strings" in the Configuring Your Environment chapter of the Neutrino User's Guide


[Previous] [Contents] [Index] [Next]