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

CKTIS / C

<signal.h> — tratamento de sinais

O cabeçalho <signal.h> disponibiliza signal, raise e sig_atomic_t. Permite tratar sinais, cujos manipuladores exigem cuidados especiais.

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

Sintaxe

#include <signal.h>
void (*signal(int sig, void (*func)(int)))(int);
int raise(int sig);

signal define o tratamento: SIG_DFL para o comportamento predefinido, SIG_IGN para ignorar o sinal ou uma função void handler(int). Devolve a definição anterior ou SIG_ERR em caso de erro. raise gera um sinal e devolve zero em caso de sucesso. Se raise chamar um manipulador, só devolve o controlo depois de o manipulador regressar. Se o sinal estiver configurado com SIG_IGN, raise pode devolver zero sem chamar nenhum manipulador.

Números de sinais: SIGABRT — terminação anormal; SIGFPE — exceção aritmética; SIGILL — instrução ilegal; SIGINT — interrupção interativa; SIGSEGV — acesso inválido à memória; SIGTERM — pedido de terminação.

Um padrão seguro para um manipulador assíncrono consiste em atribuir um valor a uma flag volatile sig_atomic_t; deixe a impressão e a alocação de memória fora do manipulador. sig_atomic_t assegura acessos indivisíveis apesar das interrupções assíncronas, mas não fornece sincronização geral entre threads.

N3096 considera comportamento indefinido usar signal num programa multithread. Não regresse dos manipuladores de SIGFPE, SIGILL ou SIGSEGV: regressar também tem comportamento indefinido.

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 != 1)
        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