Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

raise — gerar um sinal

raise(sig) desencadeia o tratamento do sinal de acordo com a definição atual; não regista um gestor.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

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

raise(sig) de <signal.h> gera um sinal. signal define a resposta: um gestor, SIG_IGN (ignorar) ou SIG_DFL (comportamento predefinido definido pela implementação).

O resultado é 0 em caso de sucesso e um valor diferente de zero em caso de falha. Se um gestor for chamado e regressar, raise só regressa depois; o fim do programa pode impedir esse regresso.

Segundo N3096, um gestor chamado por raise não pode chamar raise. Regressar de um gestor para SIGFPE, SIGILL ou SIGSEGV provoca comportamento indefinido. A utilização de signal num programa multithread também é indefinida.

O exemplo utiliza SIGTERM; o gestor limita-se a atribuir um valor a volatile sig_atomic_t. A impressão ocorre depois.

Exemplos

#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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes