Skip to main content

tcgetpgrp

Function tcgetpgrp 

Source
pub fn tcgetpgrp(fd: BorrowedFd<'_>) -> Result<Option<Pid>, Errno>
Expand description

tcgetpgrp (TIOCGPGRP) — groupe de premier plan du terminal fd.

Le kernel écrit un pid_t (i32) à une adresse de pile. Un 0 signifie « aucun groupe de premier plan » : la sentinelle est convertie en None (ADR-021 conv. 1). La conversion passe par [Pid::try_from_raw], qui replie tout pid_t non strictement positif sur None — donc 0 comme un éventuel pid_t négatif (aberrant : ce ioctl ne peut pas en produire) donnent tous deux Ok(None) : défense en profondeur (Principe 5). Un pid_t > 0 est enveloppé dans un [Pid].

§Errors

  • [Errno::ENOTTY] : fd n’est pas le terminal de contrôle de l’appelant.
  • [Errno::EBADF] : fd n’est pas un descripteur valide.