Provided by:
manpages-es_1.55-9_all 
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)