NAZWA

       catopen, catclose - otwarcie/zamknięcie katalogu komunikatów

SKŁADNIA

       #include <nl_types.h>

       nl_catd catopen(const char *name, int flag);

       int catclose(nl_catd catalog);

OPIS

       Funkcja  catopen()  otwiera  katalog  komunikatów i zwraca deskryptor tego katalogu. Deskryptor pozostaje
       ważny aż do wywołania catclose() lub execve(2). Jeśli w celu implementacji deskryptorów katalogów,  użyty
       zostanie deskryptor pliku, to zostanie ustawiony znacznik FD_CLOEXEC.

       Argument  name  określa nazwę otwieranego katalogu komunikatów. Jeśli name jest ścieżką bezwzględną (tzn.
       zawiera znak "/"), to name wyznacza ścieżkę do katalogu komunikatów. W przeciwnym  wypadku  używana  jest
       zmienna  środowiskowa NLSPATH z ciągiem %N zastąpionym przez name (zobacz locale(7)). Nie jest określone,
       czy zmienna NLSPATH zostanie użyta, gdy proces ma uprawnienia administratora. Jeśli zmienna  NLSPATH  nie
       istnieje  lub  katalog  komunikatów nie może zostać otwarty w żadnej ze ścieżek przez nią określonych, to
       zostanie użyta ścieżka zależna od implementacji. Ta domyślna ścieżka może zależeć od  bieżących  ustawień
       regionalnych LC_MESSAGES, gdy argument flag jest równy NL_CAT_LOCALE, lub od zmiennej środowiskowej LANG,
       gdy argument flag jest równy 0. Zmiana części LC_MESSAGES ustawień regionalnych może  unieważnić  otwarte
       deskryptory katalogów.

       Argument  flag  funkcji  catopen()  służy  do  wskazania  źródeł  dla  używanego języka. Jeśli ma wartość
       NL_CAT_LOCALE, to użyte zostanie bieżące ustawienie regionalne dla LC_MESSAGES.  W  przeciwnym  przypadku
       użyta zostanie zmienna środowiskowa LANG.

       Funkcja  catclose()  zamyka  katalog  komunikatów  określony  przez  deskryptor catalog. Unieważnia każde
       następne odwołania do katalogu komunikatów określonego przez catalog.

WARTOŚĆ ZWRACANA

       Jeśli funkcja catopen() zakończy się pomyślnie, zwraca deskryptor katalogu komunikatów, który  jest  typu
       nl_catd.   Jeśli  funkcja zawiedzie, zwraca (nl_catd) -1 i ustawia errno, wskazując rodzaj błędu. Możliwe
       wartości błędów obejmują wszystkie możliwe wartości dla wywołania open(2).

       Funkcja catclose() zwraca 0, jeśli zakończy się pomyślnie, a -1 w przypadku błędu.

ŚRODOWISKO

       LC_MESSAGES
              Może stanowić źródło ustawienia regionalnego LC_MESSAGES i wówczas określa język używany, gdy flag
              jest ustawione na NL_CAT_LOCALE.

       LANG   Język używany, gdy flag wynosi 0.

ATRYBUTY

       Informacje o pojęciach używanych w tym rozdziale można znaleźć w podręczniku attributes(7).

       ┌───────────┬────────────────────────┬─────────────┐
       │Interfejs  │ Atrybut                │ Wartość     │
       ├───────────┼────────────────────────┼─────────────┤
       │catopen()  │ Bezpieczeństwo wątkowe │ MT-Safe env │
       ├───────────┼────────────────────────┼─────────────┤
       │catclose() │ Bezpieczeństwo wątkowe │ MT-Safe     │
       └───────────┴────────────────────────┴─────────────┘

ZGODNE Z

       POSIX.1-2001, POSIX.1-2008.

UWAGI

       Powyższe  stanowi  opis  wg  POSIX.1.  W  glibc wartość NL_CAT_LOCALE wynosi 1. Domyślna ścieżka może być
       różna, ale zazwyczaj stanowi kilka miejsc wewnątrz katalogu /usr/share/locale.

ZOBACZ TAKŻE

       catgets(3), setlocale(3)

O STRONIE

       Angielska wersja tej strony pochodzi z wydania 4.07 projektu Linux man-pages. Opis  projektu,  informacje
       dotyczące   zgłaszania   błędów   oraz   najnowszą   wersję   oryginału   można   znaleźć   pod   adresem
       https://www.kernel.org/doc/man-pages/.

TŁUMACZENIE

       Autorami  polskiego   tłumaczenia   niniejszej   strony   podręcznika   man   są:   Adam   Byrtek   (PTM)
       <abyrtek@priv.onet.pl>,    Andrzej    Krzysztofowicz    (PTM)   <ankry@mif.pg.gda.pl>,   Robert   Luberda
       <robert@debian.org> i Michał Kułach <michal.kulach@gmail.com>.

       Polskie tłumaczenie jest częścią  projektu  manpages-pl;  uwagi,  pomoc,  zgłaszanie  błędów  na  stronie
       http://sourceforge.net/projects/manpages-pl/. Jest zgodne z wersją  4.07 oryginału.