getconf ( 1 ) USER COMMANDSgetconf ( 1 )


NAME

getconf - get configuration values

SYNOPSIS

getconf [ options ] [ name [ path [ value ] ] ... ]

DESCRIPTION

getconf displays the system configuration value for name. If name is a filesystem specific variable then the value is determined relative to path or the current directory if path is omitted. If value is specified then getconf attempts to change the process local value to value. - may be used in place of path when it is not relevant. If path is = then the the value is cached and used for subsequent tests in the calling and all child processes. Only writable variables may be set; readonly variables cannot be changed.

The current value for name is written to the standard output. If name is valid but undefined then undefined is written to the standard output. If name is invalid or an error occurs in determining its value, then a diagnostic written to the standard error and getconf exits with a non-zero exit status.

More than one variable may be set or queried by providing the name path value 3-tuple for each variable, specifying - for value when querying.

If no operands are specified then all known variables are written in name=value form to the standard output, one per line. Only one of --call, --name or --standard may be specified.

This implementation uses the astgetconf(3) string interface to the native sysconf(2), confstr(2), pathconf(2), and sysinfo(2) system calls. If getconf on $PATH is not the default native getconf, named by $(getconf GETCONF), then astgetconf(3) checks only ast specific extensions and the native system calls; invalid options and/or names not supported by astgetconf(3) cause the getconf on $PATH to be executed.

OPTIONS

-a, --all
Call the native getconf(1) with option -a.
-b, --base
List base variable name sans call and standard prefixes.
-c, --call=RE
Display variables with call prefix that matches RE. The call prefixes are:
CS
confstr(2)
PC
pathconf(2)
SC
sysconf(2)
SI
sysinfo(2)
XX
Constant value.
-d, --defined
Only display defined values when no operands are specified.
-l, --lowercase
List variable names in lower case.
-n, --name=RE
Display variables with name that match RE.
-p, --portable
Display the named writable variables and values in a form that can be directly executed by sh(1) to set the values. If name is omitted then all writable variables are listed.
-q, --quote
"..." quote values.
-r, --readonly
Display the named readonly variables in name=value form. If name is omitted then all readonly variables are listed.
-s, --standard=RE
Display variables with standard prefix that matches RE. Use the --table option to view all standard prefixes, including local additions. The standard prefixes available on all systems are:
AES
AST
C
GNU
POSIX
SVID
XBS5
XOPEN
XPG
-t, --table
Display the internal table that contains the name, standard, standard section, and system call symbol prefix for each variable.
-w, --writable
Display the named writable variables in name=value form. If name is omitted then all writable variables are listed.
-v, --specification=name
Call the native getconf(1) with option -v name.

ENVIRONMENT

_AST_FEATURES
Process local writable values that are different from the default are stored in the _AST_FEATURES environment variable. The _AST_FEATURES value is a space-separated list of name path value 3-tuples, where name is the system configuration name, path is the corresponding path, - if no path is applicable, and value is the system configuration value.

SEE ALSO

pathchk(1), confstr(2), pathconf(2), sysconf(2), astgetconf(3)

IMPLEMENTATION

version
getconf (AT&T Research) 2008-04-24
author
Glenn Fowler <glenn.s.fowler@gmail.com >
author
David Korn <dgkorn@gmail.com>
copyright
Copyright © 1992-2010 AT&T Intellectual Property
license
http://www.opensource.org/licenses/cpl1.0.txt