.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 1993 Mitchum DSouza .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" Modified Thu Dec 13 22:51:19 2001 by Martin Schulze .\" Modified 2001-12-14 aeb .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH catopen 3 "31 octombrie 2023" "Pagini de manual de Linux 6.06" .SH NUME catopen, catclose \- deschide/închide un catalog de mesaje .SH BIBLIOTECA Biblioteca C standard (\fIlibc\fP, \fI\-lc\fP) .SH REZUMAT .nf \fB#include \fP .P \fBnl_catd catopen(const char *\fP\fIname\fP\fB, int \fP\fIflag\fP\fB);\fP \fBint catclose(nl_catd \fP\fIcatalog\fP\fB);\fP .fi .SH DESCRIERE Funcția \fBcatopen\fP() deschide un catalog de mesaje și returnează un descriptor de catalog. Descriptorul rămâne valabil până când se execută \fBcatclose\fP() sau \fBexecve\fP(2). În cazul în care se utilizează un descriptor de fișier pentru a implementa descriptorii de catalog, atunci se va configura fanionul \fBFD_CLOEXEC\fP. .P Argumentul \fIname\fP specifică numele catalogului de mesaje care trebuie deschis. Dacă \fIname\fP specifică o rută absolută (adică, conține un \[aq]/\[aq]), atunci \fIname\fP specifică un nume de rută pentru catalogul de mesaje. În caz contrar, se utilizează variabila de mediu \fBNLSPATH\fP cu \fIname\fP înlocuit cu \fB%N\fP (a se vedea \fBlocale\fP(7)). Nu este specificat dacă \fBNLSPATH\fP va fi utilizată atunci când procesul are privilegii de root. Dacă \fBNLSPATH\fP nu există în mediul înconjurător sau dacă un catalog de mesaje nu poate fi deschis în niciuna dintre rutele specificate de acesta, atunci se utilizează o rută definită de implementare. Această ultimă rută implicită poate depinde de configurația regională \fBLC_MESSAGES\fP atunci când argumentul \fIflag\fP este \fBNL_CAT_LOCALE\fP și de variabila de mediu \fBLANG\fP atunci când argumentul \fIflag\fP este 0. Schimbarea părții \fBLC_MESSAGES\fP din configurația regională poate invalida descriptorii de cataloage deschise. .P Argumentul \fIflag\fP la \fBcatopen\fP() este utilizat pentru a indica sursa pentru limba care urmează să fie utilizată. Dacă este configurat la \fBNL_CAT_LOCALE\fP, atunci se va utiliza configurația regională curentă pentru \fBLC_MESSAGES\fP. În caz contrar, se va utiliza variabila de mediu \fBLANG\fP. .P Funcția \fBcatclose\fP() închide catalogul de mesaje identificat de \fIcatalog\fP. Aceasta invalidează orice referințe ulterioare la catalogul de mesaje definit de \fIcatalog\fP. .SH "VALOAREA RETURNATĂ" Funcția \fBcatopen\fP() returnează un descriptor de catalog de mesaje de tip \fInl_catd\fP în caz de succes. În caz de eșec, aceasta returnează \fI(nl_catd)\~\-1\fP și configurează \fIerrno\fP pentru a indica eroarea. Valorile posibile ale erorii includ toate valorile posibile pentru apelul \fBopen\fP(2). .P Funcția \fBcatclose\fP() returnează 0 în caz de succes sau \-1 în caz de eșec. .SH MEDIU .TP \fBLC_MESSAGES\fP Poate fi sursa configurației regionale \fBLC_MESSAGES\fP și, prin urmare, determină limba de utilizat dacă \fIflag\fP este configurat la \fBNL_CAT_LOCALE\fP. .TP \fBLANG\fP Limba care trebuie utilizată în cazul în care \fIflag\fP este 0. .SH ATRIBUTE Pentru o explicație a termenilor folosiți în această secțiune, a se vedea \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. Interfață Atribut Valoare T{ .na .nh \fBcatopen\fP() T} Siguranța firelor MT\-Safe env T{ .na .nh \fBcatclose\fP() T} Siguranța firelor MT\-Safe .TE .SH VERSIUNI .\" (Compare .\" .B MCLoadAll .\" below.) .\" .SS Linux notes .\" These functions are available for Linux since libc 4.4.4c. .\" In the case of linux libc4 and libc5, the catalog descriptor .\" .I nl_catd .\" is a .\" .BR mmap (2)'ed .\" area of memory and not a file descriptor. .\" The .\" .I flag .\" argument to .\" .BR catopen () .\" should be either .\" .B MCLoadBySet .\" (=0) or .\" .B MCLoadAll .\" (=1). .\" The former value indicates that a set from the catalog is to be .\" loaded when needed, whereas the latter causes the initial call to .\" .BR catopen () .\" to load the entire catalog into memory. .\" The default search path varies, but usually looks at a number of places below .\" .I /etc/locale .\" and .\" .IR /usr/lib/locale . Descrierea de mai sus este cea din POSIX.1. Valoarea glibc pentru \fBNL_CAT_LOCALE\fP este 1. Ruta implicită variază, dar, de obicei, caută un număr de locuri sub \fI/usr/share/locale\fP. .SH STANDARDE POSIX.1\-2008. .SH ISTORIC .\" In XPG 1987, Vol. 3 it says: .\" .I "The flag argument of catopen is reserved for future use" .\" .IR "and should be set to 0" . .\" .\" It is unclear what the source was for the constants .\" .B MCLoadBySet .\" and .\" .B MCLoadAll .\" (see below). POSIX.1\-2001. .SH "CONSULTAȚI ȘI" \fBcatgets\fP(3), \fBsetlocale\fP(3) .PP .SH TRADUCERE Traducerea în limba română a acestui manual a fost făcută de Remus-Gabriel Chelu . .PP Această traducere este documentație gratuită; citiți .UR https://www.gnu.org/licenses/gpl-3.0.html Licența publică generală GNU Versiunea 3 .UE sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă NICIO RESPONSABILITATE. .PP Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la .MT translation-team-ro@lists.sourceforge.net .ME .