NOMBRE

       getcontext, setcontext - consulta o establece el contexto de usuario

SINOPSIS

       #include <ucontext.h>

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

DESCRIPCIÓN

       En un entorno del tipo SysV, se encuentran los dos tipos mcontext_t y ucontext_t definidos
       en <ucontext.h>  y  las  cuatro  funciones  getcontext(),  setcontext(),  makecontext()  y
       swapcontext()  que  permiten  el  intercambio  del  contexto  del  nivel  de usuario entre
       múltiples hilos de control dentro de un proceso.

       El tipo mcontext_t es dependiente de la máquina  y  opaco.   El  tipo  ucontext_t  es  una
       estructura que tiene al menos los campos siguientes:
              typedef struct ucontext {
                   struct ucontext *uc_link;
                   sigset_t uc_sigmask;
                   stack_t uc_stack;
                   mcontext_t uc_mcontext;
                   ...
              } ucontext_t;
       de  los  cuales  sigset_t  y  stack_t  están  definidos  en <signal.h>.  uc_link apunta al
       contexto que será reanudado cuando termine el contexto  actual  (en  el  caso  de  que  el
       contexto  actual  haya  sido  creado  usando  makecontext()), uc_sigmask es el conjunto de
       señales bloqueadas en este contexto (véase sigprocmask(2)), uc_stack es la pila usada  por
       este  contexto  (véase  sigaltstack(2)),  y  uc_mcontext es la representación del contexto
       guardado específica de la máquina, que incluye los registros de la máquina  para  el  hilo
       invocador.

       La  función  getcontext()  inicializa  la  estructura  apuntada por ucp al contexto activo
       actualmente.

       La función setcontext() restablece el contexto de usuario apuntado por ucp. Si la  llamada
       tiene  éxito  no  regresa.  El contexto debería haber sido obtenido mediante una llamada a
       getcontext(), o makecontext(), o pasada como tercer argumento al manejador de señales.

       Si el contexto se obtuvo mediante una llamada a getcontext(), la  ejecución  del  programa
       continúa como si esta llamada simplemente regresara.

       Si  el  contexto  fue  obtenido  mediante  una  llamada  a makecontext(), la ejecución del
       programa continua por la llamada a la función func especificada como segundo argumento  en
       la  llamada  a  makecontext().  Cuando la función func regresa, se continua con el miembro
       uc_link de  la  estructura  ucp  especificada  como  primer  argumento  en  la  llamada  a
       makecontext().  Cuando este miembro es NULL, el hilo termina.

       Cuando  el  contexto  se  obtiene mediante una llamada a un manejador de señales, se solía
       decir que "la ejecución del programa continua con la instrucción de programa  siguiente  a
       la  instrucción  interrumpida  por la señal". Sin embargo, esta sentencia fue eliminada en
       SUSv2, y ahora se establece que "el resultado es indefinido".

VALOR DEVUELTO

       Cuando tiene éxito,getcontext() devuelve 0 y setcontext() no regresa. En  caso  de  error,
       ambas devuelven -1 y modifican errno con el valor apropiado.

ERRORES

       No se definen errores.

OBSERVACIONES

       La primera manifestación de este mecanismo fue el mecanismo setjmp()/longjmp(). Puesto que
       no  define  el  manejo  del  contexto  de  señales,  el  siguiente   paso   fue   el   par
       sigsetjmp()/siglongjmp().   El  presente mecanismo proporciona mucho más control. Por otra
       parte, no hay un método sencillo de detectar si  un  regreso  de  getcontext()  es  de  la
       primera llamada o via una llamada a setcontext().  El usuario tiene que inventar su propio
       mecanismo de `contabilidad' y no se servirá una variable  de  tipo  registro  ya  que  los
       registros se restauran.

       Cuando ocurre una señal, el contexto de usuario actual se guarda y el núcleo crea un nuevo
       contexto para el manejador  de  señales.   No  deje  al  manejador  usar  longjmp()  -  es
       indefinido que ocurriría con contextos. Use siglongjmp() o setcontext() en su lugar.

CONFORME A

       SUSv2

VÉASE TAMBIÉN

       sigaction(2), sigaltstack(2), sigprocmask(2), longjmp(3), sigsetjmp(3), makecontext(3)