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

CKTIS / C

atomic_signal_fence — função de barreira C23

`atomic_signal_fence(order)` estabelece restrições de ordem apenas entre código da thread e um tratador de sinal executado nessa mesma thread. Tem as classes de ordem de `atomic_thread_fence`, não devolve valor e não é genérica.

Versão: C23

Sintaxe

void atomic_signal_fence(memory_order order);

atomic_signal_fence(order) estabelece restrições de ordem apenas entre código da thread e um tratador de sinal executado nessa mesma thread. Tem as classes de ordem de atomic_thread_fence, não devolve valor e não é genérica.

Usa-a para impedir que o compilador mova acessos através de uma fronteira observável pelo tratador. O exemplo guarda payload = 42, executa barreira release, chama o tratador com raise e este copia para observed após barreira acquire; imprime 42.

A barreira de sinal inibe otimizações e reordenação como uma barreira de thread, mas não emite instrução de hardware nem sincroniza threads diferentes. memory_order_relaxed não tem efeito; acquire/consume, release, acq_rel e seq_cst mantêm os seus papéis. A barreira só por si não torna objetos comuns seguros para sinais assíncronos — o exemplo usa de propósito volatile sig_atomic_t e raise síncrono.

Exemplos

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

static volatile sig_atomic_t payload;
static volatile sig_atomic_t observed;

static void handler(int signal_number) {
    (void)signal_number;
    atomic_signal_fence(memory_order_acquire);
    observed = payload;
}

int main(void) {
    if (signal(SIGTERM, handler) == SIG_ERR) return 1;
    payload = 42;
    atomic_signal_fence(memory_order_release);
    if (raise(SIGTERM) != 0) return 1;
    printf("%d\n", (int)observed);
    return 0;
}

Resultado

42

Usa-a para impedir que o compilador mova acessos através de uma fronteira observável pelo tratador. O exemplo guarda `payload = 42`, executa barreira release, chama o tratador com `raise` e este copia para `observed` após barreira acquire; imprime `42`.

Fontes