Funciones de la biblioteca C -sigwait()

C 标准库 - <signal.h>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 <stdio.h>
#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ónsigwaitpuede evitar las condiciones de carrera y la complejidad en los manejadores de señales.

C 标准库 - <signal.h>Biblioteca estándar de C - <signal.h>

Otras extensiones