Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] openpty, login_tty, forkpty - Fonctions utilitaires pour terminaux tty. [size=18] [b]Résumé[/b] [/size] [b]#include <pty.h>[/b] /* for openpty and forkpty / [b][/b] [b]#include <utmp.h>[/b] / for login_tty / [b][i]int openpty(int amaster , int * aslave , char * name , struct termios * termp , struct winsize * winp );[/i][/b] [b][i]int login_tty(int fd );[/i][/b] [b][i]pid_t forkpty(int * amaster , char * name , struct termios * termp , struct winsize * winp );[/i][/b] [size=18] [b]Description[/b] [/size] La fonction [b]openpty()[/b] localise un pseudo terminal disponible et renvoie des descripteurs de fichiers pour le maître et l'esclave dans [i]amaster[/i] et [b]aslave .[/b] Si la chaîne [i]name[/i] ne vaut pas NULL, le nom de fichier de l'esclave est renvoyé dans [b]name .[/b] Si [i]termp[/i] ne vaut pas NULL, les paramètres du terminal esclave seront affectés conformément aux valeurs spécifiées dans [b]termp .[/b] Si [i]winp[/i] ne vaut pas NULL, la taille de la fenêtre de l'esclave sera conditionnée par les valeurs contenues dans [b]winp .[/b] La fonction [b]login_tty()[/b] prépare une connexion sur le terminal [i]fd[/i] (qui peut être un véritable périphérique tty, ou bien l'esclave d'un pseudo terminal tel que celui renvoyé par [b]openpty() )[/b] en créant une nouvelle session, en faisant de [i]fd[/i] le terminal de contrôle pour le processus courant, en affectant [i]fd[/i] à l'entrée standard, à la sortie standard et aux flux d'erreur du processus courant, et enfin, en fermant [b]fd .[/b] La fonction [b]forkpty()[/b] combine [b]openpty() ,[/b] [b]fork() ,[/b] et [b]login_tty()[/b] 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 [b]amaster ,[/b] et le nom de fichier de l'esclave dans [i]name[/i] s'il n'est pas NULL. Les paramètres [i]termp[/i] et [i]winp[/i] , 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. [size=18] [b]Valeur renvoyée[/b] [/size] Lorsqu'un appel à [b]openpty() ,[/b] [b]login_tty() ,[/b] ou [b]forkpty()[/b] échoue, alors, on renvoie -1 et [i]errno[/i] est positionnée afin de préciser l'erreur. Sinon [b]openpty() ,[/b] [b]login_tty() ,[/b] ainsi que le processus fils de [b]forkpty()[/b] renvoient 0 tandis que le processus père de [b]forkpty()[/b] renvoie le PID du processus fils. [size=18] [b]Erreurs[/b] [/size] [b]openpty()[/b] échoue lorsque : [b]ENOENT[/b] [table][row][col]    [/col][col]Il n'y a plus de terminaux disponibles.[/col][/row][/table]     [b]login_pty()[/b] échoue lorsque [b]ioctl()[/b] ne parvient pas à affecter [i]fd[/i] au terminal de contrôle du processus courant.     [b]forkpty()[/b] échoue en cas d'échec de [b]openpty()[/b] ou de [b]fork().[/b] [size=18] [b]Note[/b] [/size] Ces fonctions sont dans la bibliothèque libutil, il faut donc ajouter [b]-lutil[/b] sur la ligne de commande du compilateur. [size=18] [b]Fichiers[/b] [/size] [i]/dev/[pt]ty[pqrstuwxyzabcdePQRST][0123456789abcdef][/i] [size=18] [b]Conformité[/b] [/size] Il s'agit de fonctions BSD présentes dans la libc5 et la glibc2. [size=18] [b]Bugs[/b] [/size] Personne ne sait combien d'espace il faut réserver pour [b]name ,[/b] ainsi les appels [b]openpty()[/b] et [b]forkpty()[/b] avec un argument [i]name[/i] non-nul peut poser un problème de sécurité. [size=18] [b]Voir aussi[/b] [/size] [b]fork (2)[/b] [size=18] [b]Traduction[/b] [/size] Stéphan Rafin, 2002. [b][/b] Christophe Blaess, 2003.
Fichier