Skip to main content

pidfd_send_signal

air_sys_syscall::process

Function pidfd_send_signal 

Source 
pub fn pidfd_send_signal(
    pidfd: BorrowedFd<'_>,
    signal: Signal,
    info: Option<&SignalInfo>,
) -> Result<(), Errno>
Expand description

Envoie un signal au processus référencé par pidfd.

Cf. docs/specs/layer-0/family-process.md, sous-section 3, pidfd_send_signal. À préférer à un futur kill(pid, sig) quand un pidfd est disponible : pas de race sur le PID recyclé.

§info

Si Some(info), le kernel utilise le siginfo_t fourni (sémantique rt_sigqueueinfo). Si None, le kernel synthétise un siginfo_t avec si_code = SI_USER, équivalent à un kill(2) standard.

Note périmètre. Cette PR n’expose aucun constructeur public pour [SignalInfo] (stub partiel) ; depuis l’extérieur de la crate, seul None est passable. Le bras Some(_) du wrapper reste type-reachable mais value-unreachable jusqu’à la PR family-signal.

§Errors

  • [Errno::EBADF] : pidfd invalide.
  • [Errno::EINVAL] : signal invalide.
  • [Errno::EPERM] : permissions insuffisantes pour signaler cette cible.
  • [Errno::ESRCH] : le processus référencé n’existe plus.