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.