.\" -*- coding: UTF-8 -*- .\" Copyright (c) 1993 by Thomas Koenig (ig25@rz.uni-karlsruhe.de) .\" .\" %%%LICENSE_START(VERBATIM) .\" Permission is granted to make and distribute verbatim copies of this .\" manual provided the copyright notice and this permission notice are .\" preserved on all copies. .\" .\" Permission is granted to copy and distribute modified versions of this .\" manual under the conditions for verbatim copying, provided that the .\" entire resulting derived work is distributed under the terms of a .\" permission notice identical to this one. .\" .\" Since the Linux kernel and libraries are constantly changing, this .\" manual page may be incorrect or out-of-date. The author(s) assume no .\" responsibility for errors or omissions, or for damages resulting from .\" the use of the information contained herein. The author(s) may not .\" have taken the same level of care in the production of this manual, .\" which is licensed free of charge, as they might when working .\" professionally. .\" .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" .\" Modified Sat Jul 24 17:51:42 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Tue Aug 17 11:42:20 1999 by Ariel Scolnicov (ariels@compugen.co.il) .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH SYSCONF 3 "26. November 2017" GNU Linux\-Programmierhandbuch .SH BEZEICHNUNG sysconf \- Konfigurationsinformationen zur Laufzeit abfragen .SH ÜBERSICHT .nf \fB#include \fP .PP \fBlong sysconf(int \fP\fIname\fP\fB);\fP .fi .SH BESCHREIBUNG POSIX erlaubt es einer Anwendung zur Kompilier\- oder Laufzeit zu testen, ob bestimmte Optionen unterstützt werden oder wie der Wert bestimmter konfigurierbarer Konstanten oder Beschränkungen ist. .PP Zur Kompilierzeit wird dies durch Einbinden von \fI\fP und/oder \fI\fP und Testen des Wertes durch bestimmte Makros erledigt. .PP Zur Laufzeit können numerische Werte durch die vorhandene Funktion \fBsysconf\fP() abgefragt werden. Vom Dateisystem, auf dem sich eine Datei befindet, abhängige Werte können mittels \fBfpathconf\fP(3) und \fBpathconf\fP(3) abgefragt werden. Zeichenkettenwerte können mittels \fBconfstr\fP(3) abgefragt werden. .PP .\" except that sysconf(_SC_OPEN_MAX) may change answer after a call .\" to setrlimit( ) which changes the RLIMIT_NOFILE soft limit Die Werte, die diese Funktionen zurückgeben, sind Systemkonfigurations\-Konstanten. Sie ändern sich während der Lebensdauer eines Prozesses nicht. .PP .\" and 999 to indicate support for options no longer present in the latest .\" standard. (?) Für jede optionale Funktionalität gibt es typischerweise eine Konstante \fB_POSIX_FOO\fP, die in \fI\fP definiert würde. Wenn sie nicht definiert ist, sollte zur Laufzeit nachgefragt werden. Wenn sie als \-1 definiert ist, wird die Funktionalität nicht unterstützt. Wenn sie als 0 definiert ist, existieren die notwendigen Funktionen und Header, aber es muss zur Laufzeit nachgefragt werden, wie weit die Option unterstützt wird. Wenn sie definiert und nicht 0 oder \-1 ist, wird die Option unterstützt. Üblicherweise gibt der Wert (z.B. 200112L) das Jahr und den Monat der POSIX\-Überarbeitung an, die diese Option hinzufügte. Glibc benutzt dem Wert 1, um die Unterstützung anzuzeigen, solange die POSIX\-Überarbeitung noch nicht veröffentlicht wurde. Das \fBsysconf\fP()\-Argument wird \fB_SC_FOO\fP sein. Eine Liste der Optionen finden die unter \fBposixoptions\fP(7). .PP Für Variablen oder Begrenzungen gibt es typischerweise eine Konstante \fB_FOO\fP, die in \fI\fP definiert würde, oder \fB_POSIX_FOO\fP, die möglicherweise in \fI\fP definiert wurde. Die Konstante ist nicht definiert, wenn keine Begrenzung angegeben wurde. Falls die Konstante definiert ist, gibt es einen garantierten Wert, es könnte aber tatsächlich ein größerer unterstützt werden. Falls eine Anwendung Werte nutzen möchte, die sich zwischen Systemen ändern könnten, kann \fBsysconf\fP() aufgerufen werden. Das \fBsysconf\fP()\-Argument wird \fB_SC_FOO\fP sein. .SS POSIX.1\-Variablen Es werden der Name der Variable, der Name des \fBsysconf\fP()\-Arguments, das zum Abfragen ihres Wertes benutzt wird und eine kurze Beschreibung angegeben. .PP .\" [for the moment: only the things that are unconditionally present] .\" .TP .\" .BR AIO_LISTIO_MAX " - " _SC_AIO_LISTIO_MAX .\" (if _POSIX_ASYNCHRONOUS_IO) .\" Maximum number of I/O operations in a single list I/O call. .\" Must not be less than _POSIX_AIO_LISTIO_MAX. .\" .TP .\" .BR AIO_MAX " - " _SC_AIO_MAX .\" (if _POSIX_ASYNCHRONOUS_IO) .\" Maximum number of outstanding asynchronous I/O operations. .\" Must not be less than _POSIX_AIO_MAX. .\" .TP .\" .BR AIO_PRIO_DELTA_MAX " - " _SC_AIO_PRIO_DELTA_MAX .\" (if _POSIX_ASYNCHRONOUS_IO) .\" The maximum amount by which a process can decrease its .\" asynchronous I/O priority level from its own scheduling priority. .\" Must be nonnegative. zuerst die POSIX.1\-kompatiblen Werte .TP \fBARG_MAX\fP \- \fB_SC_ARG_MAX\fP die maximale Länge von Argumenten für die Funktionsfamilie \fBexec(3)\fP. Darf nicht weniger als \fB_POSIX_ARG_MAX\fP (4096) sein. .TP \fBCHILD_MAX\fP \- \fB_SC_CHILD_MAX\fP die maximale Anzahl von simultanen Prozessen pro Benutzerkennung. Muss mindestens \fB_POSIX_CHILD_MAX\fP (25) sein. .TP \fBHOST_NAME_MAX\fP \- \fB_SC_HOST_NAME_MAX\fP maximale Länge des Rechnernamens, ausschließlich des abschließenden Null\-Bytes, wie er von \fBgethostname\fP(2) zurückgegeben wird. Muss mindestens \fB_POSIX_HOST_NAME_MAX\fP (255) sein. .TP \fBLOGIN_NAME_MAX\fP \- \fB_SC_LOGIN_NAME_MAX\fP maximale Länge des Anmeldenamens, einschließlich des abschließenden Null\-Bytes. Muss mindestens \fB_POSIX_LOGIN_NAME_MAX\fP (9) sein. .TP \fBNGROUPS_MAX\fP \- \fB_SC_NGROUPS_MAX\fP maximale Anzahl zusätzlicher Gruppenkennungen .TP Takte \- \fB_SC_CLK_TCK\fP die Anzahl der Takte pro Sekunde. Die zugehörige Variable ist veraltet. Sie wurde sicherlich \fBCLK_TCK\fP genannt. (Beachten Sie: Das Makro \fBCLOCKS_PER_SEC\fP gibt keinen Hinweis. Es muss 1000000 sein.) .TP \fBOPEN_MAX\fP \- \fB_SC_OPEN_MAX\fP die maximale Anzahl von Dateien, die ein Prozess gleichzeitig geöffnet haben kann. Muss mindestens \fB_POSIX_OPEN_MAX\fP (20) sein. .TP \fBPAGESIZE\fP \- \fB_SC_PAGESIZE\fP Größe einer Seite in Bytes. Muss mindestens 1 sein. (Einige Systeme benutzen stattdessen PAGE_SIZE.) .TP \fBRE_DUP_MAX\fP \- \fB_SC_RE_DUP_MAX\fP maximale von \fBregexec\fP(3) und \fBregcomp\fP(3) erlaubte Wiederholungsanzahl in einem gewöhnlichen regulären Ausdruck. Muss mindestens \fB_POSIX2_RE_DUP_MAX\fP (255) sein. .TP \fBSTREAM_MAX\fP \- \fB_SC_STREAM_MAX\fP die maximale Anzahl von Datenströmen, die ein Prozess gleichzeitig geöffnet haben kann. Falls es definiert ist, hat es den gleichen Wert wie das Standard\-C\-Makro \fBFOPEN_MAX\fP. Muss mindestens \fB_POSIX_STREAM_MAX\fP (8) sein. .TP \fBSYMLOOP_MAX\fP \- \fB_SC_SYMLOOP_MAX\fP die maximale Anzahl symbolischer Links an, bevor die Auflösung eines Pfadnamens \fBELOOP\fP zurückgibt. Muss mindestens \fB_POSIX_SYMLOOP_MAX\fP (8) sein. .TP \fBTTY_NAME_MAX\fP \- \fB_SC_TTY_NAME_MAX\fP die maximale Länge von Terminal\-Gerätenamen einschließlich des abschließenden Null\-Bytes. Muss mindestens \fB_POSIX_TTY_NAME_MAX\fP (9) sein. .TP \fBTZNAME_MAX\fP \- \fB_SC_TZNAME_MAX\fP die maximale Anzahl von Bytes eines Zeitzonennamens. Muss mindestens \fB_POSIX_TZNAME_MAX\fP (6) sein. .TP \fB_POSIX_VERSION\fP \- \fB_SC_VERSION\fP zeigt Jahr und Monat, zu dem der Standard POSIX.1 festgesetzt wurde, im Format \fBYYYYMML\fP an; der Wert \fB199009L\fP zeigt die Überarbeitung vom September 1990 an. .SS POSIX.2\-Variablen als nächstes die POSIX.2\-Werte, die Begrenzungen für Hilfswerkzeuge angeben .TP \fBBC_BASE_MAX\fP \- \fB_SC_BC_BASE_MAX\fP zeigt den maximalen Wert für \fIobase\fP an, der von dem Hilfprogramm \fBbc\fP(1)akzeptiert wird .TP \fBBC_DIM_MAX\fP \- \fB_SC_BC_DIM_MAX\fP zeigt den maximalen Wert von Elementen an, die in einem Feld von \fBbc\fP(1) zugelassen sind .TP \fBBC_SCALE_MAX\fP \- \fB_SC_BC_SCALE_MAX\fP zeigt den maximalen Wert für \fIscale\fP an, der für \fBbc\fP(1) erlaubt ist .TP \fBBC_STRING_MAX\fP \- \fB_SC_BC_STRING_MAX\fP zeigt die maximale Länge einer Zeichenkette an, die von \fBbc\fP(1) akzeptiert wird .TP \fBCOLL_WEIGHTS_MAX\fP \- \fB_SC_COLL_WEIGHTS_MAX\fP zeigt die maximale Anzahl von Gewichtungen, die einem Eintrag des Schlüsselworts für die Reihenfolge \fBLC_COLLATE\fP in der Lokale\-Definitionsdatei zugewiesen werden können .TP \fBEXPR_NEST_MAX\fP \- \fB_SC_EXPR_NEST_MAX\fP ist die maximale Anzahl von Ausdrücken, die bei \fBexpr\fP(1) durch Klammern eingeschlossen werden dürfen .TP \fBLINE_MAX\fP \- \fB_SC_LINE_MAX\fP die maximale Länge der Eingabezeile eines Hilfsprogramms, entweder von der Standardeingabe oder aus einer Datei. Dies schließt den Platz für einen folgenden Zeilenumbruch ein. .TP \fBRE_DUP_MAX\fP \- \fB_SC_RE_DUP_MAX\fP die maximale Anzahl wiederholten Auftretens von regulären Ausdrücken, wenn Intervallschreibweise \fB\e{m,n\e}\fP benutzt wird. .TP \fBPOSIX2_VERSION\fP \- \fB_SC_2_VERSION\fP zeigt die Version des Standards POSIX.2 im Format YYYYMML an .TP \fBPOSIX2_C_DEV\fP \- \fB_SC_2_C_DEV\fP zeigt an, ob die POSIX.2\-C\-Sprachentwicklungseinrichtungen unterstützt werden .TP \fBPOSIX2_FORT_DEV\fP \- \fB_SC_2_FORT_DEV\fP zeigt an, ob die POSIX.2\-FORTRAN\-Entwicklungshilfsprogramme unterstützt werden .TP \fBPOSIX2_FORT_RUN\fP \- \fB_SC_2_FORT_RUN\fP zeigt an, ob die POSIX.2\-FORTRAN\-Laufzeithilfsprogramme unterstützt werden .TP \fB_POSIX2_LOCALEDEF\fP \- \fB_SC_2_LOCALEDEF\fP zeigt an, ob die POSIX.2\-Erzeugung von Locales mittels \fBlocaledef\fP(1) unterstützt wird .TP \fBPOSIX2_SW_DEV\fP \- \fB_SC_2_SW_DEV\fP zeigt an, ob die POSIX.2\-Softwareentwicklungs\-Hilfsprogrammoption unterstützt wird .PP Diese Werte existieren auch, sind möglicherweise aber kein Standard. .TP \fB_SC_PHYS_PAGES\fP die Anzahl physischer Speicherseiten. Beachten Sie, dass es möglich ist, dass das Produkt dieses Wertes und des Werts von \fB_SC_PAGESIZE\fP überlaufen kann. .TP \- \fB_SC_AVPHYS_PAGES\fP die Anzahl derzeit verfügbarer physischer Speicherseiten .TP \- \fB_SC_NPROCESSORS_CONF\fP die Anzahl konfigurierter Prozessoren. Siehe auch \fBget_nprocs_conf\fP(3). .TP \- \fB_SC_NPROCESSORS_ONLN\fP die Anzahl der Prozessoren, die derzeit online (verfügbar) sind. Siehe auch \fBget_nprocs_conf\fP(3). .SH RÜCKGABEWERT Der Rückgabewert von \fBsysconf\fP() ist einer der Folgenden: .IP * 3 Bei Fehlern wird \-1 zurückgeliefert und \fIerrno\fP gesetzt, um den Grund des Fehlers anzuzeigen (beispielsweise \fBEINVAL\fP, um anzuzeigen, dass der \fIname\fP ungültig ist). .IP * Falls \fIname\fP einer Maximal\- oder Minimalgrenze entspricht und diese Grenze unbestimmt ist, wird \-1 zurückgeliefert und \fIerrno\fP nicht geändert. (Um eine unbestimmte Grenze von einem Fehler zu unterscheiden, setzen Sie \fIerrno\fP vor dem Aufruf auf Null und prüfen dann, ob \fIerrno\fP von Null verschieden ist, wenn \-1 zurückgeliefert wird.) .IP * Falls \fIname\fP einer Option entspricht, wird ein positiver Wert zurückgeliefert, falls die Option unterstützt wird und \-1, falls die Option nicht unterstützt wird. .IP * Andernfalls wird der aktuelle Wert der Option oder Grenze zurückgeliefert. Dieser Wert ist nicht eingeschränkter als der entsprechende Wert, der der Anwendung in \fI\fP oder \fI\fP beschrieben wurde, als die Anwendung übersetzt wurde. .SH FEHLER .TP \fBEINVAL\fP \fIname\fP ist ungültig. .SH ATTRIBUTE Siehe \fBattributes\fP(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke. .TS allbox; lb lb lb l l l. Schnittstelle Attribut Wert T{ \fBsysconf\fP() T} Multithread\-Fähigkeit MT\-Safe env .TE .SH "KONFORM ZU" POSIX.1\-2001, POSIX.1\-2008. .SH FEHLER Es ist schwierig \fBARG_MAX\fP zu benutzen, da unbekannt ist, wie viel des Argumentbereichs für \fBexec\fP(3) von den Umgebungsvariablen des Benutzers belegt wird. .PP Einige zurückgegebene Werte könnten riesig sein; sie sind nicht geeignet, um Speicher zu reservieren. .SH "SIEHE AUCH" \fBbc\fP(1), \fBexpr\fP(1), \fBgetconf\fP(1), \fBlocale\fP(1), \fBconfstr\fP(3), \fBfpathconf\fP(3), \fBpathconf\fP(3), \fBposixoptions\fP(7) .SH KOLOPHON Diese Seite ist Teil der Veröffentlichung 4.16 des Projekts Linux\-\fIman\-pages\fP. Eine Beschreibung des Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden sich unter \%https://www.kernel.org/doc/man\-pages/. .SH ÜBERSETZUNG Die deutsche Übersetzung dieser Handbuchseite wurde von Patrick Rother , Chris Leick und Helge Kreutzmann erstellt. Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen. Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an .