catopen(3)

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.
Schnittstelle | Attribut | Wert
catopen() | Multithread-Fähigkeit | MT-Sicher env
catclose() | Multithread-Fähigkeit | MT-Sicher

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 (https://www.gnu.org/licenses/gpl-3.0.html) 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).