KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

atomic_signal_fence — C23-fencefunctie

`atomic_signal_fence(order)` legt alleen ordeningsbeperkingen op tussen threadcode en een signaalhandler die in dezelfde thread draait. Hij kent de ordeklassen van `atomic_thread_fence`, retourneert niets en is niet generiek.

Versie: C23

Syntax

void atomic_signal_fence(memory_order order);

atomic_signal_fence(order) legt alleen ordeningsbeperkingen op tussen threadcode en een signaalhandler die in dezelfde thread draait. Hij kent de ordeklassen van atomic_thread_fence, retourneert niets en is niet generiek.

Gebruik hem om compilerverplaatsing over een voor de handler zichtbare grens te verhinderen. Het voorbeeld schrijft payload = 42, voert een release-fence uit, roept de handler aan met raise en kopieert daar na een acquire-fence naar observed; de uitvoer is 42.

De signal-fence verhindert compileroptimalisaties en herordening als een thread-fence, maar geeft geen hardware-fence en synchroniseert geen verschillende threads. memory_order_relaxed heeft geen effect; acquire/consume, release, acq_rel en seq_cst behouden hun rollen. Alleen een fence maakt gewone objecten niet async-signaalveilig — het voorbeeld gebruikt bewust volatile sig_atomic_t en synchrone raise.

Voorbeelden

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

Resultaat

42

Gebruik hem om compilerverplaatsing over een voor de handler zichtbare grens te verhinderen. Het voorbeeld schrijft `payload = 42`, voert een release-fence uit, roept de handler aan met `raise` en kopieert daar na een acquire-fence naar `observed`; de uitvoer is `42`.

Bronnen