OPENPTY

Index

NOM
SYNOPSIS
DESCRIPTION
VALEURS RENVOYÉES
ERREURS
NOTES
CONFORMITÉ
BOGUES
VOIR AUSSI
TRADUCTION

NOM

openpty, login_tty, forkpty - Fonctions utilitaires pour terminaux tty

SYNOPSIS

#include <pty.h> /* pour openpty et forkpty */
#include <utmp.h> /* pour login_tty */
int openpty(int *amaster, int *aslave, char *name, struct termios *termp, struct winsize * winp);
int login_tty(int fd);
pid_t forkpty(int *amaster, char *name, struct termios *termp, struct winsize *winp);
Ajouter -lutil à l'édition des liens.

DESCRIPTION

La fonction openpty() localise un pseudo-terminal disponible et renvoie des descripteurs de fichiers 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.
La fonction login_tty() prépare une connexion sur le terminal fd (qui peut être un véritable périphérique tty, ou bien l'esclave d'un pseudo-terminal tel que celui renvoyé par openpty()) en créant une nouvelle session, en faisant de fd le terminal de contrôle pour le processus courant, 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() et login_tty() afin de créer un nouveau processus opérant dans un pseudo-terminal. Le descripteur de fichier de la partie maître du pseudo-terminal est renvoyé dans amaster, et le nom de fichier de l'esclave dans name s'il n'est pas NULL. 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 pseudo-terminal.

VALEURS RENVOYÉES

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_pty() échoue lorsque ioctl() ne parvient pas à affecter fd au terminal de contrôle du processus courant.
forkpty() échoue en cas d'échec de openpty() ou de fork().

NOTES

Ces fonctions sont dans la bibliothèque libutil, il faut donc ajouter -lutil sur la ligne de commande du compilateur.
Avec les versions de la glibc antérieures à 2.0.92, openpty() renvoie des descripteurs de fichiers pour une paire de pseudo-terminaux BSD ; depuis glibc 2.0.92, elle essaie d'abord d'ouvrir une paire de pseudo-terminaux Unix 98, et se rabat sur des pseudo-terminaux BSD en cas d'échec.

CONFORMITÉ

Il s'agit de fonctions BSD présentes dans la libc5 et la glibc2.

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), pty(7)

TRADUCTION

Cette page de manuel a été traduite par Stéphan Rafin <stephan DOT rafin AT laposte DOT net> en 2002, puis a été mise à jour par Alain Portal <aportal AT univ-montp2 DOT fr> jusqu'en 2006.
La traduction de cette page de manuel est basée sur les traductions disponibles sur http://manpagesfr.free.fr/, mais est gérée par l'équipe francophone de traduction de Debian au travers de la liste de discussion debian-l10n-french.
Veuillez signaler toute erreur de traduction 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> ».

Création : octobre 2007