oracular (3) catopen.3.gz

Provided by: manpages-pl-dev_4.23.1-1_all bug

NAZWA

       catopen, catclose - otwiera/zamyka katalog komunikatów

BIBLIOTEKA

       Standardowa biblioteka C (libc, -lc)

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

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

WERSJE

       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.

STANDARDY

       POSIX.1-2008.

HISTORIA

       POSIX.1-2001.

ZOBACZ TAKŻE

       catgets(3), setlocale(3)

TŁUMACZENIE

       Autorami polskiego tłumaczenia niniejszej strony podręcznika  są:  Adam  Byrtek  <alpha@irc.pl>,  Andrzej
       Krzysztofowicz   <ankry@green.mf.pg.gda.pl>,   Robert   Luberda   <robert@debian.org>   i  Michał  Kułach
       <michal.kulach@gmail.com>

       Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje  o  warunkach  licencji  można  uzyskać
       zapoznając  się  z  GNU General Public License w wersji 3 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ lub
       nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.

       Błędy w tłumaczeniu  strony  podręcznika  prosimy  zgłaszać  na  adres  listy  dyskusyjnej  ⟨manpages-pl-
       list@lists.sourceforge.net⟩.