Struct TimerFd 

pub struct TimerFd(/* private fields */);

FD timerfd (cf. timerfd_create(2)).

Implementations

impl TimerFd

pub const fn from_owned_fd(fd: OwnedFd) -> Self

Construit depuis un OwnedFd déjà ouvert sur un timerfd.

pub fn as_fd(&self) -> BorrowedFd<'_>

Vue empruntée du FD sous-jacent.

pub fn into_fd(self) -> OwnedFd

Consomme et restitue le OwnedFd sous-jacent.

pub fn arm( &self, spec: &TimerFdSpecification, flags: TimerSetFlags, ) -> Result<TimerFdSpecification, Errno>

Arme le timer et retourne l’ancienne spécification.

Errors

• EINVAL : durée hors-plage (dépassement i64 lors de la conversion en KernelTimespec), ou combinaison de flags refusée par le kernel.
• EBADF : le FD sous-jacent n’est pas un timerfd valide.

pub fn disarm(&self) -> Result<TimerFdSpecification, Errno>

Désarme le timer et retourne l’ancienne spécification.

Errors

Délègue à TimerFd::arm avec une spécification nulle — seul EBADF peut survenir. EINVAL ne peut pas survenir ici car la spécification Duration::ZERO est toujours valide.

pub fn current(&self) -> Result<TimerFdSpecification, Errno>

Lit l’état courant du timer.

Errors

• EBADF : le FD sous-jacent n’est pas un timerfd valide.
• EINVAL : valeur renvoyée par le kernel hors-plage (ne devrait pas survenir sur un timerfd bien formé).

pub fn read(&self) -> Result<u64, Errno>

Lit le nombre d’expirations accumulées.

Errors

• EAGAIN : aucune expiration disponible et le FD a été créé avec TFD_NONBLOCK (cf. test timerfd_nonblocking_read_without_expiration_returns_eagain).
• EINTR : interrompu par un signal avant toute expiration. Conforme à la politique EINTR de la couche 0 : l’appelant doit retry explicitement s’il le souhaite.
• EBADF : le FD sous-jacent n’est pas un timerfd valide.
• ECANCELED : l’horloge CLOCK_REALTIME (ou CLOCK_REALTIME_ALARM) a subi un changement discontinu alors que le timer absolu avait été armé avec TFD_TIMER_CANCEL_ON_SET (cf. man 2 timerfd_create).

Trait Implementations

impl Debug for TimerFd

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

Formats the value using the given formatter.