Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

atomic_signal_fence — funkcja bariery C23

`atomic_signal_fence(order)` ustanawia ograniczenia porządkowania tylko między kodem wątku a procedurą obsługi sygnału wykonywaną w tym samym wątku. Ma klasy porządku takie jak `atomic_thread_fence`, niczego nie zwraca i nie jest funkcją generyczną.

Wersja: C23

Składnia

void atomic_signal_fence(memory_order order);

atomic_signal_fence(order) ustanawia ograniczenia porządkowania tylko między kodem wątku a procedurą obsługi sygnału wykonywaną w tym samym wątku. Ma klasy porządku takie jak atomic_thread_fence, niczego nie zwraca i nie jest funkcją generyczną.

Stosuj ją, gdy kompilator nie może przenieść dostępów przez granicę widoczną dla obsługi sygnału. Przykład zapisuje payload = 42, wykonuje barierę release, wywołuje handler przez raise, a handler po barierze acquire kopiuje wartość do observed, więc program drukuje 42.

Bariera sygnałowa hamuje optymalizacje i przestawianie dostępów jak bariera wątkowa, lecz nie emituje jej instrukcji sprzętowej i nie synchronizuje różnych wątków. memory_order_relaxed nie ma efektu; acquire/consume, release, acq_rel i seq_cst mają odpowiednie role. Sama bariera nie czyni zwykłych obiektów bezpiecznymi dla asynchronicznego handlera — przykład celowo używa volatile sig_atomic_t i synchronicznego raise.

Przykłady

#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;
}

Wynik

42

Stosuj ją, gdy kompilator nie może przenieść dostępów przez granicę widoczną dla obsługi sygnału. Przykład zapisuje `payload = 42`, wykonuje barierę release, wywołuje handler przez `raise`, a handler po barierze acquire kopiuje wartość do `observed`, więc program drukuje `42`.

Źródła