signal

void (*signal( int sig, void (*handler) (int))) (int);

Cambia el manejo de la señal sig. Dependiendo del valor de handler, la señal puede ser ignorada, establecida al valor por defecto, o manejada por una función definida por el usuario invocada como (*handler)(sig).

Cuando el manejador de señal se establece a una función y ocurre una señal, está definido por la implementación si signal(sig, SIG_DFL) se ejecutará inmediatamente antes del inicio del manejador de señal. Además, la implementación puede evitar que ocurra un conjunto de señales definido por la implementación mientras el manejador de señal se ejecuta.

Parámetros

void fun(int sig);

Valor de retorno

Manejador de señal anterior en caso de éxito o SIG_ERR en caso de fallo (establecer un manejador de señal puede estar deshabilitado en algunas implementaciones).

Manejador de señal

Las siguientes limitaciones se imponen sobre la función definida por el usuario que se instala como manejador de señal.

Si la función definida por el usuario retorna al manejar SIGFPE, SIGILL o SIGSEGV, el comportamiento no está definido.

Si el manejador de señal es llamado como resultado de abort o raise, el comportamiento no está definido si el manejador de señal llama a raise.

Si el manejador de señal es llamado NO como resultado de abort o raise (en otras palabras, el manejador de señal es asíncrono), el comportamiento no está definido si

• el manejador de señal llama a cualquier función dentro de la biblioteca estándar, excepto

• abort
• _Exit
• quick_exit
• signal con el primer argumento siendo el número de la señal actualmente manejada (el manejador asíncrono puede volverse a registrar a sí mismo, pero no otras señales).
• funciones atómicas de <stdatomic.h> si los argumentos atómicos están libres de bloqueo
• atomic_is_lock_free (con cualquier tipo de argumentos atómicos)

• el manejador de señal se refiere a cualquier objeto con duración de almacenamiento estática o local al hilo(desde C11) que no sea una atómica(desde C11) libre de bloqueo, excepto asignando a un volatile sig_atomic_t estático.

Al entrar al manejador de señal, el estado del entorno de punto flotante y los valores de todos los objetos no están especificados, excepto para

• objetos de tipo volatile sig_atomic_t
• objetos de tipos atómicos libres de bloqueo (desde C11)
• efectos secundarios hechos visibles a través de atomic_signal_fence (desde C11)

Al retornar de un manejador de señal, el valor de cualquier objeto modificado por el manejador de señal que no sea volatile sig_atomic_t o atómico libre de bloqueo(desde C11) no está definido.

El comportamiento no está definido si signal se usa en un programa multihilo. No se requiere que sea seguro para hilos.

Notas

POSIX requiere que signal sea seguro para hilos, y especifica una lista de funciones de biblioteca seguras para señales asíncronas que pueden ser llamadas desde cualquier manejador de señal.

Además de abort y raise, POSIX especifica que kill, pthread_kill, y sigqueue generan señales síncronas.

POSIX recomienda sigaction en lugar de signal, debido a su comportamiento subespecificado y variaciones significativas de implementación, en cuanto a la entrega de señales mientras se ejecuta un manejador de señal.

Ejemplo

#include <signal.h>
#include <stdio.h>

volatile sig_atomic_t gSignalStatus;

void signal_handler(int signal)
{
    gSignalStatus = signal;
}

int main(void)
{
    signal(SIGINT, signal_handler);

    printf("SignalValue: %d\n", gSignalStatus);
    printf("Sending signal: %d\n", SIGINT);
    raise(SIGINT);
    printf("SignalValue: %d\n", gSignalStatus);
}

SignalValue: 0
Sending signal: 2
SignalValue: 2

Referencias

Véase también