Provided by: manpages-fr-dev_4.21.0-2_all 
NOM
openpty, login_tty, forkpty - Fonctions utilitaires pour terminaux (tty)
BIBLIOTHÈQUE
Bibliothèque d'utilitaires système (libutil, -lutil)
SYNOPSIS
#include <pty.h>
int openpty(int *amaster, int *aslave, char *nom,
const struct termios *termp,
const struct winsize *winp);
pid_t forkpty(int *amaster, char *nom,
const struct termios *termp,
const struct winsize *winp);
#include <utmp.h>
int login_tty(int fd);
DESCRIPTION
La fonction openpty() localise un pseudoterminal disponible et renvoie des descripteurs de
fichier pour le maître et l'esclave dans amaster et aslave. Si la chaîne nom ne vaut pas
NULL, le nom de fichier de l'esclave est renvoyé dans nom. Si termp ne vaut pas NULL, les
paramètres du terminal esclave seront affectés conformément aux valeurs spécifiées dans
termp. Si winp ne vaut pas NULL, la taille de la fenêtre de l'esclave sera conditionnée
par les valeurs contenues dans winp.
La fonction login_tty() prépare une connexion sur le terminal auquel le descripteur de
fichier fd se réfère (qui peut être un véritable périphérique de terminal (tty), ou bien
l'esclave d'un pseudoterminal tel que celui renvoyé par openpty()) en créant une nouvelle
session, en faisant de fd le terminal de contrôle pour le processus appelant, en affectant
fd à l'entrée standard, à la sortie standard et aux flux d'erreur du processus courant, et
enfin, en fermant fd.
La fonction forkpty() combine openpty(), fork(2) et login_tty() afin de créer un nouveau
processus opérant dans un pseudoterminal. Un descripteur de fichier se référant à la
partie maître du pseudoterminal est renvoyé dans amaster. Si le nom n'est pas NULL, le
tampon vers lequel il pointe est utilisé pour pour renvoyer le nom de fichier de
l'esclave. Les paramètres termp et winp, s'ils ne valent pas NULL, déterminent les
attributs du terminal et la taille de la fenêtre de la partie esclave du pseudoterminal.
VALEUR RENVOYÉE
Lorsqu'un appel à openpty(), login_tty() ou forkpty() échoue, alors, -1 est renvoyé et
errno est positionnée afin de préciser l'erreur. Sinon openpty(), login_tty(), ainsi que
le processus fils de forkpty() renvoient 0 tandis que le processus père de forkpty()
renvoie le PID du processus fils.
ERREURS
openpty() échoue lorsque :
ENOENT Il n'y a plus de terminaux disponibles.
login_tty() échoue lorsque ioctl(2) ne parvient pas à affecter fd au terminal de contrôle
du processus appelant.
forkpty() échoue en cas d'échec de openpty() ou de fork(2).
ATTRIBUTS
Pour une explication des termes utilisés dans cette section, consulter attributes(7).
┌─────────────────────────────────────────┬──────────────────────┬────────────────────────┐
│Interface │ Attribut │ Valeur │
├─────────────────────────────────────────┼──────────────────────┼────────────────────────┤
│forkpty(), openpty() │ Sécurité des threads │ MT-Safe locale │
├─────────────────────────────────────────┼──────────────────────┼────────────────────────┤
│login_tty() │ Sécurité des threads │ MT-Unsafe race:ttyname │
└─────────────────────────────────────────┴──────────────────────┴────────────────────────┘
STANDARDS
Il s'agit de fonctions BSD présentes dans la glibc. Elles ne font pas partie du standard
POSIX.
NOTES
Les modificateurs const ont été ajoutés dans la glibc 2.8 aux arguments des fonctions
openpty() et forkpty() qui sont des pointeurs sur des structures.
Avant la glibc 2.0.92, openpty() renvoie des descripteurs de fichier pour une paire de
pseudoterminaux BSD ; depuis la glibc 2.0.92, elle essaie d'abord d'ouvrir une paire de
pseudoterminaux UNIX 98, et se rabat sur des pseudoterminaux BSD en cas d'échec.
BOGUES
Personne ne sait combien d'espace il faut réserver pour name, ainsi les appels openpty()
et forkpty() avec un argument name non nul peuvent poser un problème de sécurité.
VOIR AUSSI
fork(2), ttyname(3), pty(7)
TRADUCTION
La traduction française de cette page de manuel a été créée par Christophe Blaess
<https://www.blaess.fr/christophe/>, Stéphan Rafin <stephan.rafin@laposte.net>, Thierry
Vignaud <tvignaud@mandriva.com>, François Micaux, Alain Portal <aportal@univ-montp2.fr>,
Jean-Philippe Guérard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-
luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux
<thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centraliens.net>, Florentin
Duneau <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>, Denis
Barbier <barbier@debian.org>, David Prévot <david@tilapin.org> et Jean-Pierre Giraud
<jean-pierregiraud@neuf.fr>
Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General
Public License version 3 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ concernant les
conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un
message à ⟨debian-l10n-french@lists.debian.org⟩.