getconf(1) getconf(1)
NAME
getconf - Konfigurationswerte abrufen
SYNTAX
getconf systemvar
getconf -64s systemvar
getconf pathvar pathname
BESCHREIBUNG
In der ersten Syntaxform schreibt das Kommando getconf den Wert der
durch den Operanden systemvar angegebenen Variablen auf die Standard-
ausgabe.
In der zweiten Syntaxform liefert das Kommando getconf 64-Bit-Werte
für die Variablen LONGMAX und ULONGMAX.
In der dritten Syntaxform schreibt das Kommando getconf den Wert der
durch den Operanden pathvar angegebenen Variablen auf die Standard-
ausgabe, der innerhalb des durch den Operanden pathname angegebenen
Pfades gültig ist.
Der Wert jeder Konfigurationsvariablen wird so ausgegeben, wie ihn ein
Aufruf der Funktion, von der er definiert wurde, ermittelt (siehe
ARGUMENTE). Der Wert gibt die Bedingungen in der aktuellen Ablaufumge-
bung wieder.
Ist die angegebene Variable gültig, aber auf dem System nicht defi-
niert, schreibt getconf undefined auf die Standardausgabe.
ARGUMENTE
pathvar
Name einer Konfigurationsvariablen, deren Wert über die Funktion
pathconf(2) abgerufen werden kann. Alle in der folgenden Tabelle
aufgeführten Werte werden unterstützt:
LINKMAX
MAXCANON
MAXINPUT
NAMEMAX
PATHMAX
PIPEBUF
POSIXCHOWNRESTRICTED
POSIXNOTRUNC
POSIXVDISABLE
Hinweis: Sie können alle Variablennamen mit oder ohne führenden
Unterstrich (_) angeben.
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98
getconf(1) getconf(1)
pathname
Pfadname, für den die durch pathvar angegebene Variable festge-
stellt werden soll.
systemvar
Name einer Konfigurationsvariablen, deren Wert über die Funktio-
nen confstr(3C) oder sysconf(3C) abgerufen werden kann. Alle in
der folgenden Tabelle aufgeführten Werte werden unterstützt:
ARGMAX
BCBASEMAX
BCDIMMAX
BCSCALEMAX
BCSTRINGMAX
BEILENMAX
CHARCLASSNAMEMAX
CHARBIT
CHARMAX
CHARMIN
CHILDMAX
CLKTCK
COLLWEIGHTSMAX
CSPATH
EXPRNESTMAX
INTMAX
INTMIN
LINEMAX
LONGBIT
LONGMAX
LONGMIN
NGROUPSMAX
NLARGMAX
NLLANGMAX
NLMSGMAX
NLNMAX
NLSETMAX
NLTEXTMAX
NZERO
OPENMAX
POSIX2BCBASEMAX
POSIX2BCDIMMAX
POSIX2BCSCALEMAX
POSIX2BCSTRINGMAX
POSIX2CHARTERM
POSIX2COLLWEIGHTSMAX
POSIX2CBIND
POSIX2CDEV
POSIX2CVERSION
POSIX2EXPRNESTMAX
POSIX2FORTDEV
POSIX2FORTRUN
POSIX2LINEMAX
Seite 2 Reliant UNIX 5.44 Gedruckt 11/98
getconf(1) getconf(1)
POSIX2LOCALEDEF
POSIX2REDUPMAX
POSIX2SWDEV
POSIX2UPE
POSIX2VERSION
POSIXARGMAX
POSIXCHILDMAX
POSIXJOBCONTROL
POSIXLINKMAX
POSIXMAXCANON
POSIXMAXINPUT
POSIXNAMEMAX
POSIXNGROUPSMAX
POSIXOPENMAX
POSIXPATHMAX
POSIXPIPEBUF
POSIXSAVEDIDS
POSIXSSIZEMAX
POSIXSTREAMMAX
POSIXTZNAMEMAX
POSIXVERSION
REDUPMAX
SCHARMAX
SCHARMIN
SHRTMAX
SHRTMIN
SSIZEMAX
STREAMMAX
TMPMAX
TZNAMEMAX
UCHARMAX
UINTMAX
ULONGMAX
USHRTMAX
WORDBIT
XOPENCRYPT
XOPENENHI18N
XOPENSHM
XOPENVERSION
XOPENXCUVERSION
XOPENXPG2
XOPENXPG3
XOPENXPG4
Das Symbol PATH wird ebenfalls erkannt. Es liefert denselben Wert
wie der Wert CSPATH von confstr(3C). Außerdem erkennt getconf
zusätzlich die Variablen LOGNAMEMAX, PAGESIZE, PAGESIZE und
PASSMAX.
Hinweis: Sie können alle Variablennamen mit oder ohne führenden
Unterstrich (_) angeben.
Seite 3 Reliant UNIX 5.44 Gedruckt 11/98
getconf(1) getconf(1)
UMGEBUNGSVARIABLEN
Die folgenden Umgebungsvariablen beeinflussen die Ausführung des Kom-
mandos getconf:
LANG Gibt einen Standardwert für die Internationalisierungsva-
riablen an, die nicht gesetzt oder null sind. Ist LANG
nicht gesetzt oder null, wird der entsprechende Standard-
wert der internationalen Umgebung verwendet. Enthält eine
der Internationalisierungsvariablen eine ungültige Ein-
stellung, verhält sich das Kommando so, als wäre keine
der Variablen definiert.
LCALL Ist diese Variable auf einen Wert gesetzt, d. h. ist sie
nicht leer, überschreibt dieser Wert die Werte aller
übrigen Internationalisierungsvariablen.
LCCTYPE Legt die internationale Umgebung für die Interpretation
von Byte-Folgen als Zeichen fest (z. B. Einzelbytezeichen
im Unterschied zu Mehrbytezeichen in Argumenten).
LCMESSAGES Legt das Format und den Inhalt von Fehlermeldungen fest.
NLSPATH Legt die Position der Meldungskataloge für die Verarbei-
tung von LCMESSAGES fest.
ENDESTATUS
Die folgenden Endewerte werden zurückgegeben:
0 Die angegebene Variable ist gültig, und es wurden Informationen
über ihren aktuellen Status auf die Standardausgabe geschrieben.
>0 Ein Fehler ist aufgetreten.
BEISPIELE
In diesem Beispiel wird der Wert von {NGROUPSMAX} abgerufen:
getconf NGROUPSMAX
In diesem Beispiel wird der Wert von {NAMEMAX} für ein bestimmtes
Verzeichnis abgerufen:
getconf NAMEMAX /usr
Dieses Beispiel zeigt den vorsichtigeren Umgang mit möglicherweise
unspezifizierten Ergebnissen:
if value=$(getconf PATHMAX /usr); then
if [ "$value" = "undefined" ]; then
echo PATHMAX in /usr is infinite.
else
echo PATHMAX in /usr is $value.
fi
Seite 4 Reliant UNIX 5.44 Gedruckt 11/98
getconf(1) getconf(1)
else
echo Error in getconf.
fi
Beachten Sie, daß folgende Aufrufe in einem C-Programm unterschiedli-
che Ergebnisse erzielen können:
sysconf(SCPOSIXCBIND);
und:
system("getconf POSIX2CBIND");
Der Aufruf sysconf(3C) ergibt einen Wert der den Bedingungen bei der
Kompilierung oder bei der Ausführung des Programms entspricht. Der
Aufruf von getconf über system(3S) ergibt immer einen Wert, der den
Bedingungen bei der Ausführung des Programms entspricht.
SIEHE AUCH
pathconf(2), confstr(3C), sysconf(3C).
Seite 5 Reliant UNIX 5.44 Gedruckt 11/98