Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C

raise — generar una señal

raise(sig) activa el tratamiento de la señal según la configuración actual; no registra un controlador.

Versión: C23; repository compiler flag, production runtime not attested

Sintaxis

#include <signal.h>
int raise(int sig);

raise(sig) de <signal.h> genera una señal. signal establece la respuesta: un controlador, SIG_IGN (ignorar) o SIG_DFL (comportamiento predeterminado definido por la implementación).

El resultado es 0 si tiene éxito y un valor distinto de cero si falla. Si se llama a un controlador y este retorna, raise solo retorna después; la terminación del programa puede impedir que retorne.

Según N3096, un controlador invocado por raise no debe llamar a raise. Retornar desde un controlador de SIGFPE, SIGILL o SIGSEGV provoca un comportamiento indefinido. El uso de signal en un programa multihilo también es indefinido.

El ejemplo usa SIGTERM; su controlador solo asigna un valor a volatile sig_atomic_t. La impresión se realiza después.

Ejemplos

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

static volatile sig_atomic_t received = 0;

static void handle_signal(int sig)
{
    (void)sig;
    received = 1;
}

int main(void)
{
    if (signal(SIGTERM, handle_signal) == SIG_ERR) {
        return EXIT_FAILURE;
    }
    if (raise(SIGTERM) != 0) {
        return EXIT_FAILURE;
    }
    if (received == 0) {
        return EXIT_FAILURE;
    }
    puts("Signal handled");
    return EXIT_SUCCESS;
}

Resultado

Signal handled

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes