catopen(3) Library Functions Manual catopen(3) NAZWA catopen, catclose - otwarcie/zamkniecie katalogu komunikatow BIBLIOTEKA Standardowa biblioteka C (libc, -lc) SKLADNIA #include nl_catd catopen(const char *name, int flag); int catclose(nl_catd katalog); OPIS Funkcja catopen() otwiera katalog komunikatow i zwraca deskryptor tego katalogu. Deskryptor pozostaje wazny az do wywolania catclose() lub execve(2). Jesli w celu implementacji deskryptorow katalogow, uzyty zostanie deskryptor pliku, to zostanie ustawiony znacznik FD_CLOEXEC. Argument name okresla nazwe otwieranego katalogu komunikatow. Jesli name jest sciezka bezwzgledna (tzn. zawiera znak ,,/"), to name wyznacza sciezke do katalogu komunikatow. W przeciwnym wypadku uzywana jest zmienna srodowiskowa NLSPATH z ciagiem %N zastapionym przez name (zobacz locale(7)). Nie jest okreslone, czy zmienna NLSPATH zostanie uzyta, gdy proces ma uprawnienia administratora. Jesli zmienna NLSPATH nie istnieje lub katalog komunikatow nie moze zostac otwarty w zadnej ze sciezek przez nia okreslonych, to zostanie uzyta sciezka zalezna od implementacji. Ta domyslna sciezka moze zalezec od biezacych ustawien regionalnych LC_MESSAGES, gdy argument flag jest rowny NL_CAT_LOCALE, lub od zmiennej srodowiskowej LANG, gdy argument flag jest rowny 0. Zmiana czesci LC_MESSAGES ustawien regionalnych moze uniewaznic otwarte deskryptory katalogow. Argument flag funkcji catopen() sluzy do wskazania zrodel dla uzywanego jezyka. Jesli ma wartosc NL_CAT_LOCALE, to uzyte zostanie biezace ustawienie regionalne dla LC_MESSAGES. W przeciwnym przypadku uzyta zostanie zmienna srodowiskowa LANG. Funkcja catclose() zamyka katalog komunikatow okreslony przez deskryptor catalog. Uniewaznia kazde nastepne odwolania do katalogu komunikatow okreslonego przez catalog. WARTOSC ZWRACANA The function catopen() returns a message catalog descriptor of type nl_catd on success. On failure, it returns (nl_catd) -1 and sets errno to indicate the error. The possible error values include all possible values for the open(2) call. Funkcja catclose() zwraca 0, jesli zakonczy sie pomyslnie, a -1 w przypadku bledu. SRODOWISKO LC_MESSAGES Moze stanowic zrodlo ustawienia regionalnego LC_MESSAGES i wowczas okresla jezyk uzywany, gdy flag jest ustawione na NL_CAT_LOCALE. LANG Jezyk uzywany, gdy flag wynosi 0. ATRYBUTY Informacje o pojeciach uzywanych w tym rozdziale mozna znalezc w podreczniku attributes(7). +-----------------------+--------------------------+-------------------+ |Interfejs | Atrybut | Wartosc | +-----------------------+--------------------------+-------------------+ |catopen() | Bezpieczenstwo watkowe | MT-bezpieczne env | +-----------------------+--------------------------+-------------------+ |catclose() | Bezpieczenstwo watkowe | MT-bezpieczne | +-----------------------+--------------------------+-------------------+ WERSJE Powyzsze stanowi opis wg POSIX.1. W glibc wartosc NL_CAT_LOCALE wynosi 1. Domyslna sciezka moze byc rozna, ale zazwyczaj stanowi kilka miejsc wewnatrz katalogu /usr/share/locale. STANDARDY POSIX.1-2008. HISTORIA POSIX.1-2001. ZOBACZ TAKZE catgets(3), setlocale(3) TLUMACZENIE Autorami polskiego tlumaczenia niniejszej strony podrecznika sa: Adam Byrtek , Andrzej Krzysztofowicz , Robert Luberda i Michal Kulach Niniejsze tlumaczenie jest wolna dokumentacja. Blizsze informacje o warunkach licencji mozna uzyskac zapoznajac sie z GNU General Public License w wersji 3 lub nowszej. Nie przyjmuje sie ZADNEJ ODPOWIEDZIALNOSCI. Bledy w tlumaczeniu strony podrecznika prosimy zglaszac na adres listy dyskusyjnej . Linux man-pages 6.06 31 pazdziernika 2023 r. catopen(3)