getcontext(3)              Library Functions Manual              getcontext(3)

NUME
       getcontext, setcontext - ob<?>ine sau stabile<?>te contextul
       utilizatorului

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #include <ucontext.h>

       int getcontext(ucontext_t *ucp);
       int setcontext(const ucontext_t *ucp);

DESCRIERE
       Intr-un mediu de tip System V, exista cele doua tipuri mcontext_t <?>i
       ucontext_t definite in <ucontext.h> <?>i cele patru func<?>ii
       getcontext(), setcontext(), makecontext(3) <?>i swapcontext(3) care
       permit comutarea contextului la nivel de utilizator intre mai multe
       fire de control in cadrul unui proces.

       Tipul mcontext_t depinde de ma<?>ina <?>i este opac. Tipul ucontext_t
       este o structura care are cel pu<?>in urmatoarele campuri:

           typedef struct ucontext_t {
               struct ucontext_t *uc_link;
               sigset_t          uc_sigmask;
               stack_t           uc_stack;
               mcontext_t        uc_mcontext;
               ...
           } ucontext_t;

       cu sigset_t <?>i stack_t definite in <signal.h>. Aici uc_link indica
       contextul care va fi reluat atunci cand contextul curent se termina (in
       cazul in care contextul curent a fost creat folosind makecontext(3)),
       uc_sigmask este setul de semnale blocate in acest context (a se vedea
       sigprocmask(2)), uc_stack este stiva utilizata de acest context (a se
       vedea sigaltstack(2)), iar uc_mcontext este reprezentarea specifica
       ma<?>inii a contextului salvat, care include registrele ma<?>inii
       firului apelant.

       Func<?>ia getcontext() ini<?>ializeaza structura indicata de ucp in
       contextul activ curent.

       Func<?>ia setcontext() restabile<?>te contextul utilizatorului indicat
       de ucp. Un apel reu<?>it nu returneaza. Contextul ar fi trebuit sa fie
       ob<?>inut printr-un apel la getcontext() sau makecontext(3), sau primit
       ca al treilea argument al unui gestionar de semnal (a se vedea
       discu<?>ia despre fanionul SA_SIGINFO din sigaction(2)).

       Daca contextul a fost ob<?>inut printr-un apel la getcontext(),
       execu<?>ia programului continua ca <?>i cum acest apel tocmai a fost
       returnat.

       In cazul in care contextul a fost ob<?>inut printr-un apel la
       makecontext(3), execu<?>ia programului continua printr-un apel la
       func<?>ia func specificata ca al doilea argument al apelului la
       makecontext(3). La intoarcerea func<?>iei func, continuam cu membrul
       uc_link al structurii ucp specificat ca prim argument al acelui apel la
       makecontext(3). Atunci cand acest membru este NULL, firul de execu<?>ie
       iese.

       Daca contextul a fost ob<?>inut printr-un apel la un gestionar de
       semnal, atunci vechiul text standard spune ca ,,execu<?>ia programului
       continua cu instruc<?>iunea de program care urmeaza instruc<?>iunii
       intrerupte de semnal". Cu toate acestea, aceasta propozi<?>ie a fost
       eliminata in SUSv2, iar verdictul actual este ,,rezultatul este
       nespecificat".

VALOAREA RETURNATA
       In caz de succes, getcontext() returneaza 0, iar setcontext() nu
       returneaza. In caz de eroare, ambele returneaza -1 <?>i seteaza errno
       pentru a indica eroarea.

ERORI-IE<?>IRE
       Nu sunt definite.

ATRIBUTE
       Pentru o explica<?>ie a termenilor folosi<?>i in aceasta sec<?>iune, a
       se vedea attributes(7).

       +-----------------------------+---------------------+------------------+
       |Interfa<?>a                  | Atribut             | Valoare          |
       +-----------------------------+---------------------+------------------+
       |getcontext(), setcontext()   | Siguran<?>a firelor | MT-Safe race:ucp |
       +-----------------------------+---------------------+------------------+
STANDARDE
       Niciunul.

ISTORIC
       SUSv2, POSIX.1-2001.

       POSIX.1-2008 elimina aceste func<?>ii, invocand probleme de
       portabilitate <?>i recomandand ca aplica<?>iile sa fie rescrise pentru
       a utiliza in schimb fire POSIX.

NOTE
       Cea mai veche intruchipare a acestui mecanism a fost mecanismul
       setjmp(3)/ longjmp(3). Deoarece acesta nu define<?>te gestionarea
       contextului semnalului, urmatoarea etapa a fost perechea sigsetjmp(3)/
       siglongjmp(3). Mecanismul actual ofera mult mai mult control. Pe de
       alta parte, nu exista o modalitate u<?>oara de a detecta daca o
       returnare de la getcontext() provine din primul apel sau prin
       intermediul unui apel setcontext(). Utilizatorul trebuie sa inventeze
       propriul dispozitiv de eviden<?>a contabila, iar o variabila de
       registru nu este suficienta, deoarece registrele sunt restaurate.

       Atunci cand apare un semnal, contextul curent al utilizatorului este
       salvat <?>i un nou context este creat de catre nucleu pentru
       gestionarul de semnal. Nu parasi<?>i gestionarul folosind longjmp(3):
       nu este definit ce se intampla cu contextele. Utiliza<?>i in schimb
       siglongjmp(3) sau setcontext().

CONSULTA<?>I <?>I
       sigaction(2), sigaltstack(2), sigprocmask(2), longjmp(3),
       makecontext(3), sigsetjmp(3), signal(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                 getcontext(3)