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 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.

Linux man-pages 6.9.1                              2. Mai 2024                                        catopen(3)