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.

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.