Struct TidReceiver 

pub struct TidReceiver { /* private fields */ }

Emplacement mémoire où le kernel écrit (CLONE_PARENT_SETTID / CLONE_CHILD_SETTID) ou efface (CLONE_CHILD_CLEARTID) le TID d’un enfant créé par clone3.

Encapsule l’adresse d’un mot 32 bits partagé (AtomicU32) — un tid_t côté kernel — plutôt qu’un pointeur nu (convention 1 de l’ADR-021 : pas de pointeur brut non typé exposé). Le pattern de join de thread :

• CLONE_PARENT_SETTID + parent_tid = &mot → le kernel écrit le TID dans le mot, dans le contexte du parent, avant le retour de clone3 (sans course avec une terminaison précoce de l’enfant) ;
• CLONE_CHILD_CLEARTID + child_tid = &mot → à la mort du thread, le kernel remet le mot à 0 et effectue un FUTEX_WAKE dessus. Le parent joint donc en bouclant sur futex_wait(&mot, tid) jusqu’à lire 0.

Le mot doit rester vivant (et l’AtomicU32 non déplacé) jusqu’à la fin du join ; cette garantie incombe à l’appelant de la fonction unsafe clone_thread. Construire un TidReceiver est en soi inoffensif (on ne fait qu’enregistrer une adresse).

Implementations

impl TidReceiver

pub fn new(word: &AtomicU32) -> Self

Construit un récepteur à partir d’un mot atomique partagé vivant.

On ne capture que l’adresse du mot ; sa validité au moment de l’appel clone3/clone_thread (et jusqu’au join) relève du contrat unsafe de ces fonctions.

pub fn as_ptr(self) -> *mut u32

Retourne le pointeur brut du mot, pour le marshalling vers la structure clone_args du kernel (réservé aux wrappers de la couche 0).

Trait Implementations

impl Clone for TidReceiver

fn clone(&self) -> TidReceiver

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for TidReceiver

impl Debug for TidReceiver

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.