Funciones de la biblioteca C -sigwait()
Biblioteca estándar de C - <signal.h>
Descripción
sigwaitLa función es una función de la biblioteca estándar de C que se utiliza para esperar sincrónicamente la llegada de señales. Extrae una de las señales del conjunto de señales especificado de la cola y devuelve su número. Esta función está definida en<signal.h>el archivo de cabecera.
Sintaxis
int sigwait(const sigset_t *set, int *sig);
Parámetros
const sigset_t *set: apunta a unsigset_tvariable de conjunto de señales de tipo, que especifica las señales a esperar.int *sig: apunta a una variable entera, utilizada para almacenar el número de la señal capturada.
Valor de retorno
- Devuelve 0 en caso de éxito.
- Devuelve un código de error en caso de fallo.
Ejemplo
A continuación se muestra un ejemplo de uso desigwaitla función para esperar sincrónicamenteSIGINTuna señal. Este programa imprime un mensaje mientras espera la señal; cuando captura laSIGINTseñal, usa lasigwaitfunción para esperar y manejar la señal sincrónicamente.
Ejemplo
#include <signal.h>
#include <unistd.h>
#include <pthread.h>
// Función del hilo, espera la señal SIGINT
void* wait_for_signal(void* arg) {
sigset_t *set = (sigset_t *)arg;
int sig;
printf("Thread waiting for signal...\n");
if (sigwait(set, &sig) == 0) {
printf("Caught signal %d: %s\n", sig, strsignal(sig));
} else {
perror("sigwait");
}
return NULL;
}
int main() {
pthread_t thread;
sigset_t set;
// Inicializa el conjunto de señales y agrega SIGINT al conjunto
sigemptyset(&set);
sigaddset(&set, SIGINT);
// Bloquea la señal SIGINT en el hilo principal
pthread_sigmask(SIG_BLOCK, &set, NULL);
// Crea un hilo para esperar la señal SIGINT
pthread_create(&thread, NULL, wait_for_signal, (void*)&set);
// El hilo principal continúa ejecutándose hasta que se presiona Ctrl+C para enviar la señal SIGINT
while (1) {
printf("Main thread running... Press Ctrl+C to send SIGINT\n");
sleep(1);
}
// Espera a que el hilo secundario termine
pthread_join(thread, NULL);
return 0;
}
Después de compilar y ejecutar el programa, presione Ctrl+C para enviarSIGINTla señal; la salida será:
Main thread running... Press Ctrl+C to send SIGINT Main thread running... Press Ctrl+C to send SIGINT Main thread running... Press Ctrl+C to send SIGINT Thread waiting for signal... Caught signal 2: Interrupt
El programa bloquea en el hilo principalSIGINTla señal, y crea un hilo secundario para esperar y manejarSIGINTla señal. Cuando se captura laSIGINTseñal, el hilo secundario utiliza lasigwaitfunción para esperar y manejar la señal sincrónicamente.
Explicación
sigemptyset(&set);: inicializa el conjunto de señales como vacío.sigaddset(&set, SIGINT);: agrega laSIGINTseñal al conjunto de señales.pthread_sigmask(SIG_BLOCK, &set, NULL);: bloquea en el hilo principalSIGINTla señal, para que el hilo secundario pueda manejarla.pthread_create(&thread, NULL, wait_for_signal, (void*)&set);: crea un hilo secundario para esperarSIGINTla señal.sigwait(set, &sig);: el hilo secundario utiliza lasigwaitfunción para esperar y manejar sincrónicamente laSIGINTseñal.
Precauciones
sigwaitLa función solo retorna cuando se captura una de las señales del conjunto de señales.sigwaitSe puede usar junto con la máscara de señales para garantizar que la señal se maneje en el hilo esperado.- El uso de esta función
sigwaitpuede evitar las condiciones de carrera y la complejidad en los manejadores de señales.