OPENPTY(3)

NOM
openpty, login_tty, forkpty - Fonctions utilitaires pour terminaux (tty)

SYNOPSIS
#include <pty.h>

int openpty(int *amaster, int *aslave, char *name,
            const struct termios *termp,
            const struct winsize *winp);

pid_t forkpty(int *amaster, char *name,
              const struct termios *termp,
              const struct winsize *winp);
#include <utmp.h>

int login_tty(int fd);

Effectuez l'édition des liens avec l'option -lutil.

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 name ne vaut pas NULL, le nom de fichier de l'esclave est renvoyé dans name. 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.

The login_tty() function prepares for a login on the terminal referred to by the file descriptor fd (which may be a real terminal device, or the slave of a pseudoterminal as returned by openpty()) by creating a new session, making fd the controlling terminal for the calling process, setting fd to be the standard input, output, and error streams of the current process, and closing fd.

The forkpty() function combines openpty(), fork(2), and login_tty() to create a new process operating in a pseudoterminal. A file descriptor referring to master side of the pseudoterminal is returned in amaster. If name is not NULL, the buffer it points to is used to return the filename of the slave. The termp and winp arguments, if not NULL, will determine the terminal attributes and window size of the slave side of the 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() fails if:

ENOENT
    Il n'y a plus de terminaux disponibles.

login_tty() fails if ioctl(2) fails to set fd to the controlling terminal of the calling process.

forkpty() fails if either openpty() or fork(2) fails.

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

CONFORMITÉ
These are BSD functions, present in glibc. They are not standardized in 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.

Avec les versions de la glibc antérieures à 2.0.92, openpty() renvoie des descripteurs de fichier pour une paire de pseudoterminaux BSD ; depuis 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)

COLOPHON
Cette page fait partie de la publication 5.10 du projet man-pages Linux. Une description du projet et des instructions pour signaler des anomalies et la dernière version de cette page peuvent être trouvées à l'adresse https://www.kernel.org/doc/man-pages/.

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> et David Prévot <david@tilapin.org> 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.