TCGETPGRP
Section : Manuel du programmeur Linux (
3)
Mise à jour de la version anglaise : 28 janvier 2003
Index
Menu principal
NOM
tcgetpgrp, tcsetpgrp - Lire/écrire le processus d'avant-plan d'un terminal
SYNOPSIS
#include <unistd.h>
pid_t tcgetpgrp(int fd);
int tcsetpgrp(int fd, pid_t pgrp);
DESCRIPTION
La fonction
tcgetpgrp()
renvoie l'ID du groupe de processus
à l'avant-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 en avant-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'identifiant du groupe de processus en avant-plan sur ce terminal
s'il existe, et une valeur supérieure à 1 différente d'un identifiant de groupe
de processus existant sinon.
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 valide.
- 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)
TRADUCTION
Ce document est une traduction réalisée par Christophe Blaess
<http://www.blaess.fr/christophe/> le 21 juillet 2003
et révisée le 17 juillet 2008.
L'équipe de traduction a fait le maximum pour réaliser une adaptation
française de qualité. La version anglaise la plus à jour de ce document est
toujours consultable via la commande : « LANG=C man 3 tcgetpgrp ».
N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute
erreur dans cette page de manuel.
Index
- NOM
-
- SYNOPSIS
-
- DESCRIPTION
-
- VALEUR RENVOYÉE
-
- ERREURS
-
- CONFORMITÉ
-
- NOTES
-
- Historique
-
- VOIR AUSSI
-
- TRADUCTION
-
Dernière mise à jour : 17 juillet 2008