atribute(7)            Miscellaneous Information Manual            atribute(7)

NUME
       attributes - concepte de siguran<?>a POSIX

DESCRIERE
       Nota: textul acestei pagini de manual se bazeaza pe materialul preluat
       din sec<?>iunea ,,POSIX Safety Concepts" a manualului GNU C Library.
       Detalii suplimentare despre subiectele descrise aici pot fi gasite in
       acel manual.

       Diverse pagini de manual ale func<?>iilor includ o sec<?>iune ATRIBUTE
       care descrie siguran<?>a apelarii func<?>iei in diverse contexte.
       Aceasta sec<?>iune adnoteaza func<?>iile cu urmatoarele marcaje de
       siguran<?>a:

       MT-Safe
              Func<?>iile MT-Safe sau Thread-Safe pot fi apelate in
              siguran<?>a in prezen<?>a altor fire de execu<?>ie.  MT, in
              MT-Safe, inseamna Multi Thread. (multiple fire de execu<?>ie)

              A fi MT-Safe nu inseamna ca o func<?>ie este atomica <?>i nici
              ca utilizeaza vreunul dintre mecanismele de sincronizare a
              memoriei pe care POSIX le expune utilizatorilor. Este chiar
              posibil ca apelarea func<?>iilor MT-Safe in succesiune sa nu
              produca o combina<?>ie MT-Safe. De exemplu, apelarea de catre un
              fir de execu<?>ie a doua func<?>ii MT-Safe una imediat dupa alta
              nu garanteaza un comportament echivalent cu execu<?>ia atomica a
              unei combina<?>ii a ambelor func<?>ii, deoarece apelurile
              simultane in alte fire de execu<?>ie pot interfera intr-un mod
              distructiv.

              Optimizarile intregului program care ar putea include func<?>ii
              in interfe<?>e de biblioteca pot expune o reordonare nesigura
              <?>i, prin urmare, nu se recomanda includerea in interfa<?>a
              bibliotecii GNU C. Statutul MT-Safety documentat nu este
              garantat in cazul optimizarii intregului program. Cu toate
              acestea, func<?>iile definite in antetele vizibile pentru
              utilizator sunt proiectate sa fie sigure pentru ,,inlining".

       MT-Unsafe
              Func<?>iile MT-Unsafe nu pot fi apelate in siguran<?>a in
              programele multithreaded (executate folosind mai multe fire).

       Alte cuvinte-cheie care apar in notele de siguran<?>a sunt definite in
       sec<?>iunile urmatoare.

   Caracteristici de siguran<?>a condi<?>ionala
       Pentru unele caracteristici care fac ca apelarea func<?>iilor sa fie
       nesigura in anumite contexte, exista modalita<?>i cunoscute de a evita
       problema securita<?>ii, altele decat ab<?>inerea totala de la apelarea
       func<?>iei. Cuvintele-cheie care urmeaza se refera la astfel de
       caracteristici, iar fiecare dintre defini<?>iile lor indica modul in
       care intregul program trebuie sa fie constrans pentru a elimina
       problema de securitate indicata de cuvantul-cheie. Numai atunci cand
       toate motivele care fac o func<?>ie nesigura sunt observate <?>i
       abordate, prin aplicarea constrangerilor documentate, func<?>ia devine
       sigura pentru a fi apelata intr-un context.

       init   Func<?>iile marcate cu init ca o caracteristica MT-Unsafe
              efectueaza ini<?>ializarea MT-Unsafe atunci cand sunt apelate
              pentru prima data.

              Apelarea unei astfel de func<?>ii cel pu<?>in o data in modul
              single-threaded (un singur fir de execu<?>ie) elimina aceasta
              cauza specifica pentru care func<?>ia este considerata
              MT-Unsafe. Daca nu ramane nicio alta cauza, func<?>ia poate fi
              apelata in siguran<?>a dupa pornirea altor fire de execu<?>ie.

       race   Func<?>iile adnotate cu race ca o problema de siguran<?>a MT
              opereaza asupra obiectelor in moduri care pot cauza curse de
              date sau forme similare de interferen<?>a distructiva in afara
              execu<?>iei simultane. In unele cazuri, obiectele sunt transmise
              func<?>iilor de catre utilizatori; in altele, acestea sunt
              utilizate de catre func<?>ii pentru a returna valori
              utilizatorilor; in altele, acestea nici macar nu sunt expuse
              utilizatorilor.

       const  Func<?>iile marcate cu const ca o problema de MT-Safety modifica
              non-atomic obiecte interne care sunt mai bine considerate
              constante, deoarece o parte substan<?>iala a bibliotecii GNU C
              le acceseaza fara sincronizare. Spre deosebire de race, care
              face ca atat cititorii, cat <?>i scriitorii de obiecte interne
              sa fie considera<?>i MT-Unsafe, acest marcaj este aplicat doar
              scriitorilor.  Scriitorii raman MT-Unsafe la apelare, dar
              constan<?>a obligatorie a obiectelor pe care le modifica permite
              cititorilor sa fie considera<?>i MT-Safe (atat timp cat nu
              exista alte motive pentru care sa fie nesiguri), deoarece lipsa
              sincronizarii nu este o problema atunci cand obiectele sunt
              efectiv constante.

              Identificatorul care urmeaza marcajul const va aparea de la sine
              ca o nota de siguran<?>a in cititoare. Programele care doresc sa
              ocoleasca aceasta problema de siguran<?>a, astfel incat sa
              apeleze scriitorii, pot utiliza un blocaj de citire-scriere
              non-recursiv asociat identificatorului <?>i sa protejeze
              apelurile all catre func<?>iile marcate cu const urmate de
              identificator cu un blocaj de scriere <?>i apelurile all catre
              func<?>iile marcate cu identificatorul de la sine cu un blocaj
              de citire.

       sig    Func<?>iile marcate cu sig ca o problema de siguran<?>a MT pot
              instala temporar un gestionar de semnal in scopuri interne, care
              poate interfera cu alte utilizari ale semnalului, identificat
              dupa doua puncte (:).

              Aceasta problema de siguran<?>a poate fi rezolvata prin
              asigurarea faptului ca nu vor avea loc alte utilizari ale
              semnalului pe durata apelului. Se recomanda men<?>inerea unui
              mutex non-recursiv in timpul apelarii tuturor func<?>iilor care
              utilizeaza acela<?>i semnal temporar; blocarea semnalului
              respectiv inainte de apel <?>i reini<?>ializarea gestionarului
              acestuia dupa apel.

       term   Func<?>iile marcate cu term ca fiind o problema de MT-Safety pot
              modifica parametrii terminalului in modul recomandat, <?>i
              anume: apeleaza tcgetattr(3), modifica unele op<?>iuni <?>i apoi
              apeleaza tcsetattr(3), ceea ce creeaza o fereastra in care
              modificarile efectuate de alte fire se pierd. Astfel,
              func<?>iile marcate cu term sunt MT-Unsafe.

              Prin urmare, este recomandabil ca aplica<?>iile care utilizeaza
              terminalul sa evite interac<?>iunile concurente <?>i reentrante
              cu acesta, neutilizandu-l in gestionarii de semnale sau blocand
              semnalele care l-ar putea utiliza <?>i de<?>inand un blocaj in
              timp ce apeleaza aceste func<?>ii <?>i interac<?>ioneaza cu
              terminalul. Aceasta blocare ar trebui, de asemenea, utilizata
              pentru excluderea reciproca cu func<?>ii marcate cu
              race:tcattr(fd), unde fd este un descriptor de fi<?>ier pentru
              terminalul de control. Apelantul poate utiliza un singur mutex
              pentru simplificare sau poate utiliza un mutex pentru fiecare
              terminal, chiar daca se face referire la acesta prin descriptori
              de fi<?>ier diferi<?>i.

   Alte observa<?>ii privind siguran<?>a
       Func<?>iilor li se pot ata<?>a cuvinte-cheie suplimentare, indicand
       caracteristici care nu fac ca apelarea unei func<?>ii sa fie nesigura,
       dar care ar putea fi luate in considerare in anumite clase de programe:

       locale Func<?>iile notate cu locale ca o problema de siguran<?>a MT
              citesc din obiectul de configurare regionala fara nicio forma de
              sincronizare. Func<?>iile adnotate cu locale apelate concomitent
              cu modificarile configurarii regionale se pot comporta in moduri
              care nu corespund niciuneia dintre configura<?>iile regionale
              active in timpul execu<?>iei lor, ci unui amestec imprevizibil
              al acestora.

              Cu toate acestea, nu marcam aceste func<?>ii ca MT-Unsafe,
              deoarece func<?>iile care modifica obiectul de configurare
              regionala sunt marcate cu const:locale <?>i considerate
              nesigure. Fiind nesigure, acestea din urma nu trebuie sa fie
              apelate atunci cand ruleaza mai multe fire de execu<?>ie sau
              cand sunt activate semnale asincrone <?>i, astfel, configurarile
              regionale pot fi considerate efectiv constante in aceste
              contexte, ceea ce le face sigure.

       env    Func<?>iile marcate cu env ca o problema de siguran<?>a MT
              acceseaza mediul cu getenv(3) sau similar, fara nicio
              protec<?>ie pentru a asigura siguran<?>a in prezen<?>a
              modificarilor simultane.

              Cu toate acestea, nu marcam aceste func<?>ii ca MT-Unsafe,
              deoarece func<?>iile care modifica mediul sunt toate marcate cu
              const:env <?>i considerate nesigure. Fiind nesigure, acestea din
              urma nu trebuie sa fie apelate atunci cand ruleaza mai multe
              fire de execu<?>ie sau cand sunt activate semnale asincrone,
              astfel incat mediul poate fi considerat efectiv constant in
              aceste contexte, ceea ce le face sigure.

       hostid Func<?>iile marcate cu hostid ca o problema de siguran<?>a MT
              citesc din structurile de date la nivel de sistem care con<?>in
              ,,ID-ul de gazda" al ma<?>inii. In general, aceste structuri de
              date nu pot fi modificate atomic. Deoarece se preconizeaza ca
              ,,ID-ul gazdei" nu se va modifica in mod normal, func<?>ia care
              cite<?>te din acesta (gethostid(3)) este considerata sigura, in
              timp ce func<?>ia care il modifica (sethostid(3)) este marcata
              cu const:hostid, indicand faptul ca ar putea necesita o
              aten<?>ie speciala daca va fi apelata. In acest caz specific,
              grija speciala inseamna coordonare la nivelul intregului sistem
              (nu doar in interiorul procesului).

       sigintr
              Func<?>iile marcate cu sigintr ca o problema de siguran<?>a MT
              acceseaza structura interna de date _sigintr a Bibliotecii GNU C
              fara nicio protec<?>ie pentru a asigura siguran<?>a in
              prezen<?>a modificarilor simultane.

              Cu toate acestea, nu marcam aceste func<?>ii ca MT-Unsafe,
              deoarece func<?>iile care modifica aceasta structura de date
              sunt toate marcate cu const:sigintr <?>i considerate nesigure.
              Fiind nesigure, acestea din urma nu trebuie sa fie apelate
              atunci cand ruleaza mai multe fire de execu<?>ie sau cand sunt
              activate semnale asincrone, astfel incat structura de date poate
              fi considerata efectiv constanta in aceste contexte, ceea ce le
              face pe primele sigure.

       cwd    Func<?>iile marcate cu cwd ca o problema de siguran<?>a MT pot
              modifica temporar directorul curent de lucru in timpul
              execu<?>iei lor, ceea ce poate determina rezolvarea in moduri
              nea<?>teptate a numelor de rute relative in alte fire de
              execu<?>ie sau in cadrul gestionarilor asincroni de semnal sau
              de anulare.

              Acesta nu este un motiv suficient pentru a marca func<?>iile
              astfel marcate ca MT-Unsafe, dar atunci cand acest comportament
              este op<?>ional (de exemplu, nftw(3) cu FTW_CHDIR), evitarea
              op<?>iunii poate fi o alternativa buna la utilizarea numelor de
              ruta complete sau a apelurilor de sistem relative la
              descriptorul de fi<?>ier (de exemplu, openat(2)).

       :identifier
              Adnotarile pot fi uneori urmate de identificatori, destina<?>i
              sa grupeze mai multe func<?>ii care, de exemplu, acceseaza
              structurile de date intr-un mod nesigur, ca in race <?>i const,
              sau sa furnizeze informa<?>ii mai specifice, cum ar fi numirea
              unui semnal intr-o func<?>ie marcata cu sig. Se preconizeaza ca,
              in viitor, aceasta poate fi aplicata <?>i la lock <?>i corrupt.

              In majoritatea cazurilor, identificatorul va numi un set de
              func<?>ii, dar poate numi obiecte globale sau argumente de
              func<?>ii, sau proprieta<?>i identificabile sau componente
              logice asociate cu acestea, cu o nota<?>ie precum, de exemplu,
              :buf(arg) pentru a desemna un tampon asociat cu argumentul arg,
              sau :tcattr(fd) pentru a desemna atributele terminale ale unui
              descriptor de fi<?>ier fd.

              Cea mai frecventa utilizare a identificatorilor este de a
              furniza grupuri logice de func<?>ii <?>i argumente care trebuie
              sa fie protejate de aceea<?>i primitiva de sincronizare pentru a
              asigura func<?>ionarea sigura intr-un anumit context.

       /condition
              Unele adnotari de siguran<?>a pot fi condi<?>ionate, in sensul
              ca se aplica numai daca o expresie booleana care implica
              argumente, variabile globale sau chiar nucleul subiacent este
              evaluata la adevarat (true). De exemplu, /!ps <?>i /one_per_line
              indica faptul ca marcajul precedent se aplica numai atunci cand
              argumentul ps este NULL sau variabila globala one_per_line este
              diferita de zero.

              Atunci cand toate marcajele care fac o func<?>ie nesigura sunt
              ,,impodobite" cu astfel de condi<?>ii <?>i niciuna dintre
              condi<?>iile men<?>ionate nu se aplica, atunci func<?>ia poate
              fi considerata sigura.

CONSULTA<?>I <?>I
       pthreads(7), signal-safety(7)

TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

Pagini de manual de Linux 6.18 8 februarie 2026                    atribute(7)