Loading

NOM

       tcgetpgrp,  tcsetpgrp  -  Lire/écrire le processus de premier plan d’un
       terminal

SYNOPSIS

       #include <unistd.h>

       pid_t tcgetpgrp(int fd);

       int tcsetpgrp(int fd, pid_t pgrp);

       La fonction tcgetpgrp() renvoie l’ID du groupe de processus au  premier
       plan  sur le terminal associé fd, qui doit être le terminal de contrôle
       du processus appelant.

       La fonction tcsetpgrp() fait du groupe de processus pgrp le  groupe  au
       premier plan sur le terminal associé à fd, qui doit être le terminal de
       contrôle du processus appelant, et être toujours associé à sa  session.
       En  outre, pgrp doit être un groupe (non vide) de processus appartenant
       à la même session que le processus appelant.

       Si tcsetpgrp() est appelé par un membre d’un  groupe  de  processus  en
       arrière-plan  dans sa session, et si le processus appelant ne bloque ni
       n’ignore SIGTTOU, un signal SIGTTOU est envoyé à tous  les  membres  du
       groupe en arrière-plan.

VALEUR RENVOYÉE

       Quand  fd  identifie  le terminal de contrôle du processus appelant, la
       fonction tcgetpgrp() renverra l’ID du groupe de  processus  au  premier
       plan  sur  ce  terminal  s’il  existe,  sinon  il  renvoie  une  valeur
       supérieure à 1, différente d’un ID de groupe de processus existant.  Si
       fd  ne  correspond  pas  au  terminal  de contrôle du processus, -1 est
       renvoyé et errno est positionnée en conséquence.

       Lorsqu’elle réussit, la fonction tcsetpgrp()  renvoie  0.  Sinon,  elle
       renvoie -1, et remplit errno avec le code d’erreur.

ERREURS

       EBADF  fd n’est pas un descripteur de fichier valable.

       EINVAL pgrp a une valeur illégale.

       ENOTTY Le  processus appelant n’a pas de terminal de contrôle, ou il en
              a  un  mais  ce  n’est  pas  celui  décrit  par  fd,  ou,   pour
              tcsetpgrp(),  ce terminal de contrôle n’est plus associé avec la
              session du processus appelant.

       EPERM  pgrp a une valeur légale, mais ce n’est pas l’ID d’un groupe  de
              processus dans la même session que le processus appelant.

CONFORMITÉ

       POSIX.1-2001.

NOTES

       Ces  fonctions sont implémentées via les ioctls TIOCGPGRP et TIOCSPGRP.

   Historique
       Les ioctls sont apparus dans BSD 4.2. Ces fonctions sont des inventions
       POSIX.

VOIR AUSSI

       setpgid(2), setsid(2), credentials(7)

COLOPHON

       Cette  page  fait  partie  de  la  publication 3.23 du projet man-pages
       Linux. Une description du projet et des instructions pour signaler  des
       anomalies       peuvent       être       trouvées      à      l’adresse
       http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Cette page de manuel a été traduite  et  mise  à  jour  par  Christophe
       Blaess  <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis par
       Alain Portal <aportal AT univ-montp2 DOT fr> jusqu’en 2006, et  mise  à
       disposition sur http://manpagesfr.free.fr/.

       Les mises à jour et corrections de la version présente dans Debian sont
       directement         gérées         par         Nicolas         François
       <nicolas.francois@centraliens.net>    et    l’équipe   francophone   de
       traduction de Debian.

       Veuillez  signaler  toute  erreur   de   traduction   en   écrivant   à
       <debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
       paquet manpages-fr.

       Vous pouvez toujours avoir accès à la version anglaise de  ce  document
       en utilisant la commande « man -L C <section> <page_de_man> ».