Man page - catopen(3)

Packages contains this manual

Available languages:

en fr pt_BR es pl ja ru ro de

Manual

catopen

BEZEICHNUNG
BIBLIOTHEK
ÜBERSICHT
BESCHREIBUNG
RÜCKGABEWERT
UMGEBUNGSVARIABLEN
ATTRIBUTE
VERSIONEN
STANDARDS
GESCHICHTE
SIEHE AUCH
ÜBERSETZUNG

BEZEICHNUNG

catopen, catclose - Nachrichtenkataloge öffnen/schließen

BIBLIOTHEK

Standard-C-Bibliothek ( libc , -lc )

ÜBERSICHT

#include <nl_types.h>

nl_catd catopen(const char * Name , int Schalter );
int catclose(nl_catd
Katalog );

BESCHREIBUNG

Die Funktion catopen () öffnet einen Nachrichtenkatalog und liefert einen Katalogdeskriptor zurück. Der Deskriptor bleibt bis catclose () oder execve (2) gültig. Falls ein Dateideskriptor zur Implementierung von Katalogdeskriptoren verwandt wird, dann wird der Schalter FD_CLOEXEC gesetzt.

Das Argument Name legt den Namen des zu öffnenden Nachrichtenkatalogs fest. Falls Name einen absoluten Pfad festlegt (d.h. einen »/« enthält), dann legt Name einen Pfadnamen für den Nachrichtenkatalog fest. Andernfalls wird die Umgebungsvariable NLSPATH verwandt, wobei %N durch Name ersetzt wird (siehe locale (7)). Es ist nicht spezifiziert, ob NLSPATH verwandt wird, wenn der Prozess über Root-Rechte verfügt. Falls NLSPATH in der Umgebung nicht existiert oder falls ein Nachrichtenkatalog nicht in einem durch ihn festgelegten Pfade geöffnet werden kann, dann wird ein durch die Implementierung bestimmter Pfad verwandt. Dieser Vorgabepfad kann von den Locale-Einstellungen LC_MESSAGES abhängen, wenn das Argument Schalter NL_CAT_LOCALE lautet und von der Umgebungsvariable LANG , wenn das Argument Schalter 0 ist. Änderungen am LC_MESSAGES -Anteil der Locale kann dazu führen, dass offene Katalogdeskriptoren ungültig werden.

Das Argument Schalter von catopen () wird verwandt, um die Quelle für die zu verwendende Sprache anzuzeigen. Falls es auf NL_CAT_LOCALE gesetzt ist, dann wird es die aktuellen Locale-Einstellungen für LC_MESSAGES verwenden. Andernfalls wird es die Umgebungsvariable LANG verwenden.

Die Funktion catclose () schließt den durch Katalog identifizierten Nachrichtenkatalog. Dadurch werden alle nachfolgenden Referenzen auf den durch Katalog definierten Katalog ungültig.

RÜCKGABEWERT

Die Funktion catopen () liefert im Erfolgsfall einen Nachrichtenkatalogdeskriptor vom Typ nl_catd zurück. Im Fehlerfall liefert sie (nl_catd) -1 zurück und setzt errno , um den Fehler anzuzeigen. Die möglichen Fehlerwerte enthalten alle möglichen Werte des Aufrufs open (2).

Die Funktion catclose () liefert 0 im Erfolgsfall oder -1 im Fehlerfall zurück.

UMGEBUNGSVARIABLEN

LC_MESSAGES

Kann die Quelle der Einstellung LC_MESSAGES sein und daher die zu verwendende Sprache bestimmen, falls Schalter auf NL_CAT_LOCALE gesetzt ist.

LANG

Die zu verwendende Sprache falls Schalter 0 ist.

ATTRIBUTE

Siehe attributes (7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.

Image grohtml-1214573-1.png

VERSIONEN

Obige Beschreibung stammt aus POSIX.1. Der Glibc-Wert für NL_CAT_LOCALE lautet 1. Der Vorgabepfad variiert, aber normalerweise wird an verschiedenen Stellen unterhalb von /usr/share/locale gesucht.

STANDARDS

POSIX.1-2008.

GESCHICHTE

POSIX.1-2001.

SIEHE AUCH

catgets (3), setlocale (3)

ÜBERSETZUNG

Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann <debian@helgefjell.de> 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 die Mailingliste der Übersetzer: debian-l10n-german@lists.debian.org .