openpty   Début   Suivant   Sommaire   Préc.page.lue   Accueil
Section: Manuel du programmeur Linux (3)
Updated: 18 juillet 2003
Sommaire  



NOM   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
openpty, login_tty, forkpty - Fonctions utilitaires pour terminaux tty  

SYNOPSIS        

#include <pty.h>

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

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

int login_tty(int fd);

Lier avec
-lutil.
 



DESCRIPTION   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
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 appelant, en affectant fd à l'entrée standard, à la sortie standard et aux flux d'erreur du processus appelant, 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 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.  




VALEUR RENVOYÉE   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
Lorsqu'un appel à openpty(), login_tty() ou forkpty() échoue, alors, on renvoie -1 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   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
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).  




CONFORMITÉ   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
Il s'agit de fonctions BSD présentes dans la libc5 et la glibc2.  



NOTES   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
Dans les versions de la glibc précédent la 2.0.92, openpty() renvoie des descripteurs de fichier pour des paires de pseudo-terminaux BSD. Depuis la glibc 2.0.92, elle essaye d'abord d'ouvrir une paire de pseudo-terminaux Unix 98, et se rabat sur une paire de pseudo-terminaux BSD si elle échoue.  



BOGUES   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
Personne ne sait combien d'espace il faut réserver pour name, ainsi les appels openpty() et forkpty() avec un argument name non nul peut poser un problème de sécurité.  



VOIR AUSSI   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
fork(2), ttyname(3), pty(7)  



TRADUCTION   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil

Ce document est une traduction réalisée par Stéphan Rafin <stephan DOT rafin AT laposte DOT net> le 15 mai 2002 et révisée le 6 juin 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 openpty ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.


 



Sommaire   Début   Suivant   Sommaire   Préc.page.lue   Accueil
NOM
SYNOPSIS        
DESCRIPTION
VALEUR RENVOYÉE
ERREURS
CONFORMITÉ
NOTES
BOGUES
VOIR AUSSI
TRADUCTION

Table des mots clés   Début   Suivant   Sommaire   Préc.page.lue   Accueil
ENOENTERREURS



Ce document a été créé par man2html suivi de man2html.pl, le 17/10/2008 17:53:58, en utilisant les pages de 'man'.
 

Valid HTML 4.01 Transitional