Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

atomic_signal_fence — fonction de barrière C23

`atomic_signal_fence(order)` n’établit des contraintes d’ordre qu’entre le code du thread et un gestionnaire de signal exécuté dans ce même thread. Elle partage les classes d’ordre de `atomic_thread_fence`, ne renvoie rien et n’est pas générique.

Version : C23

Syntaxe

void atomic_signal_fence(memory_order order);

atomic_signal_fence(order) n’établit des contraintes d’ordre qu’entre le code du thread et un gestionnaire de signal exécuté dans ce même thread. Elle partage les classes d’ordre de atomic_thread_fence, ne renvoie rien et n’est pas générique.

Elle empêche le compilateur de déplacer des accès au-delà d’une frontière visible par le gestionnaire. L’exemple écrit payload = 42, exécute une barrière release, appelle le gestionnaire avec raise, puis celui-ci copie vers observed après une barrière acquire ; le résultat est 42.

La barrière de signal bloque optimisations et réordonnancements comme une barrière de thread, sans instruction matérielle ni synchronisation entre threads différents. memory_order_relaxed est sans effet ; acquire/consume, release, acq_rel et seq_cst gardent leurs rôles. La barrière seule ne sécurise pas un objet ordinaire pour un signal asynchrone — l’exemple emploie volontairement volatile sig_atomic_t et raise synchrone.

Exemples

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

Résultat

42

Elle empêche le compilateur de déplacer des accès au-delà d’une frontière visible par le gestionnaire. L’exemple écrit `payload = 42`, exécute une barrière release, appelle le gestionnaire avec `raise`, puis celui-ci copie vers `observed` après une barrière acquire ; le résultat est `42`.

Sources