pthread_spin_init(3)       Library Functions Manual       pthread_spin_init(3)

NUME
       pthread_spin_init, pthread_spin_destroy - ini<?>ializeaza sau distruge
       un blocaj de rota<?>ie

BIBLIOTECA
       Biblioteca de fire de execu<?>ie POSIX (libpthread, -lpthread)

REZUMAT
       #include <pthread.h>

       int pthread_spin_init(pthread_spinlock_t *lock, int pshared);
       int pthread_spin_destroy(pthread_spinlock_t *lock);

   Cerin<?>e pentru macrocomenzi de testare a caracteristicilor pentru glibc
   (consulta<?>i feature_test_macros(7)):

       pthread_spin_init(), pthread_spin_destroy():
           _POSIX_C_SOURCE >= 200112L

DESCRIERE
       Nota generala: Majoritatea programelor ar trebui sa utilizeze mutex-uri
       in loc de blocaje de rota<?>ie. Blocajele rotative sunt utile in primul
       rand in combina<?>ie cu politicile de planificare in timp real. A se
       vedea NOTE.

       Func<?>ia pthread_spin_init() aloca toate resursele necesare pentru
       utilizarea blocarii prin rota<?>ie la care face referire lock <?>i
       ini<?>ializeaza blocarea pentru a fi in stare deblocata. Argumentul
       pshared trebuie sa aiba una dintre urmatoarele valori:

       PTHREAD_PROCESS_PRIVATE
              Blocajul de rota<?>ie trebuie sa fie operat numai de fire din
              acela<?>i proces ca <?>i firul care apeleaza
              pthread_spin_init(); (incercarea de a impar<?>i blocajul de
              rota<?>ie intre procese duce la un comportament nedefinit).

       PTHREAD_PROCESS_SHARED
              Blocajul de rota<?>ie poate fi operat de orice fir din orice
              proces care are acces la memoria care con<?>ine blocajul (de
              exemplu, blocajul poate fi intr-un obiect de memorie partajata
              care este partajat intre mai multe procese).

       Apelarea pthread_spin_init() pe un blocaj de rota<?>ie care a fost deja
       ini<?>ializat are ca rezultat un comportament nedefinit.

       Func<?>ia pthread_spin_destroy() distruge un blocaj de rota<?>ie
       ini<?>ializat anterior, eliberand toate resursele care au fost alocate
       pentru acel blocaj. Distrugerea unui blocaj de rota<?>ie care nu a fost
       ini<?>ializat anterior sau distrugerea unui blocaj de rota<?>ie in timp
       ce un alt fir de execu<?>ie de<?>ine blocajul are ca rezultat un
       comportament nedefinit.

       Odata ce un blocaj de rota<?>ie a fost distrus, efectuarea oricarei
       opera<?>ii asupra blocajului in afara de ini<?>ializarea acestuia cu
       pthread_spin_init() duce la un comportament nedefinit.

       Rezultatul efectuarii unor opera<?>ii precum pthread_spin_lock(3),
       pthread_spin_unlock(3) <?>i pthread_spin_destroy() pe copii ale
       obiectului la care se face referire prin lock este nedefinit.

VALOAREA RETURNATA
       In caz de succes, aceste func<?>ii returneaza zero.  In caz de e<?>ec,
       acestea returneaza un numar de eroare.  In cazul in care
       pthread_spin_init() e<?>ueaza, blocajul nu este ini<?>ializat.

ERORI-IE<?>IRE
       pthread_spin_init() poate e<?>ua cu urmatoarele erori:

       EAGAIN Sistemul nu dispune de resurse suficiente pentru a ini<?>ializa
              un nou blocaj de rota<?>ie.

       ENOMEM Memorie insuficienta pentru a ini<?>ializa blocajul de rotire.

STANDARDE
       POSIX.1-2008.

ISTORIC
       glibc 2.2.  POSIX.1-2001.

       Suportul pentru blocajele de rota<?>ie partajate de proces este o
       op<?>iune POSIX.  Op<?>iunea este acceptata in implementarea glibc.

NOTE
       Blocajele de rota<?>ie trebuie utilizate impreuna cu politicile de
       planificare in timp real (SCHED_FIFO sau, eventual, SCHED_RR).
       Utilizarea de blocaje de rotire cu politici de planificare
       nedeterministe, cum ar fi SCHED_OTHER, indica probabil o gre<?>eala de
       proiectare. Problema consta in faptul ca, daca un fir care
       func<?>ioneaza in conformitate cu o astfel de politica este programat
       in afara CPU in timp ce de<?>ine un blocaj de rotire, atunci alte fire
       vor pierde timp cu rotirea pe blocaj pana cand de<?>inatorul blocajului
       este reprogramat din nou <?>i elibereaza blocajul.

       Daca firele de execu<?>ie creeaza o situa<?>ie de blocaj in timp ce
       utilizeaza blocaje de rotire, aceste fire de execu<?>ie se vor roti la
       nesfar<?>it, consumand timp de procesor.

       Blocajele de rota<?>ie din spa<?>iul utilizatorului nu sunt aplicabile
       ca solu<?>ie generala de blocare. Acestea sunt, prin defini<?>ie,
       predispuse la inversarea priorita<?>ilor <?>i la timpi de rota<?>ie
       nelimita<?>i. Un programator care utilizeaza blocaje de rota<?>ie
       trebuie sa fie extrem de atent nu numai la cod, ci <?>i in ceea ce
       prive<?>te configura<?>ia sistemului, plasarea firelor <?>i atribuirea
       priorita<?>ilor.

CONSULTA<?>I <?>I
       pthread_mutex_init(3), pthread_mutex_lock(3), pthread_spin_lock(3),
       pthread_spin_unlock(3), pthreads(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.06 31 octombrie 2023          pthread_spin_init(3)