.\" -*- coding: UTF-8 -*- '\" t .\" Copyright (c) OpenBSD Group .\" All rights reserved. .\" .\" SPDX-License-Identifier: BSD-3-Clause .\" .\" Converted into a manpage again by Martin Schulze .\" .\" Added -lutil remark, 030718 .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH openpty 3 "20 juillet 2023" "Pages du manuel de Linux 6.05.01" .SH NOM openpty, login_tty, forkpty \- Fonctions utilitaires pour terminaux (tty) .SH BIBLIOTHÈQUE Bibliothèque d'utilitaires système (\fIlibutil\fP, \fI\-lutil\fP) .SH SYNOPSIS .nf \fB#include \fP .PP \fBint openpty(int *\fP\fIamaster\fP\fB, int *\fP\fIaslave\fP\fB, char *\fP\fInom\fP\fB,\fP \fB const struct termios *\fP\fItermp\fP\fB,\fP \fB const struct winsize *\fP\fIwinp\fP\fB);\fP \fBpid_t forkpty(int *\fP\fIamaster\fP\fB, char *\fP\fInom\fP\fB,\fP \fB const struct termios *\fP\fItermp\fP\fB,\fP \fB const struct winsize *\fP\fIwinp\fP\fB);\fP .PP \fB#include \fP .PP \fBint login_tty(int \fP\fIfd\fP\fB);\fP .fi .SH DESCRIPTION La fonction \fBopenpty\fP() localise un pseudoterminal disponible et renvoie des descripteurs de fichier pour le maître et l'esclave dans \fIamaster\fP et \fIaslave\fP. Si la chaîne \fInom\fP ne vaut pas NULL, le nom de fichier de l'esclave est renvoyé dans \fInom\fP. Si \fItermp\fP ne vaut pas NULL, les paramètres du terminal esclave seront affectés conformément aux valeurs spécifiées dans \fItermp\fP. Si \fIwinp\fP ne vaut pas NULL, la taille de la fenêtre de l'esclave sera conditionnée par les valeurs contenues dans \fIwinp\fP. .PP La fonction \fBlogin_tty\fP() prépare une connexion sur le terminal auquel le descripteur de fichier \fIfd\fP 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 \fBopenpty\fP()) en créant une nouvelle session, en faisant de \fIfd\fP le terminal de contrôle pour le processus appelant, en affectant \fIfd\fP à l'entrée standard, à la sortie standard et aux flux d'erreur du processus courant, et enfin, en fermant \fIfd\fP. .PP La fonction \fBforkpty\fP() combine \fBopenpty\fP(), \fBfork\fP(2) et \fBlogin_tty\fP() 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 \fIamaster\fP. Si le \fInom\fP 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 \fItermp\fP et \fIwinp\fP, 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. .SH "VALEUR RENVOYÉE" Lorsqu'un appel à \fBopenpty\fP(), \fBlogin_tty\fP() ou \fBforkpty\fP() échoue, alors, \-1 est renvoyé et \fIerrno\fP est positionnée afin de préciser l'erreur. Sinon \fBopenpty\fP(), \fBlogin_tty\fP(), ainsi que le processus fils de \fBforkpty\fP() renvoient 0 tandis que le processus père de \fBforkpty\fP() renvoie le PID du processus fils. .SH ERREURS \fBopenpty\fP() échoue lorsque\ : .TP \fBENOENT\fP Il n'y a plus de terminaux disponibles. .PP \fBlogin_tty\fP() échoue lorsque \fBioctl\fP(2) ne parvient pas à affecter \fIfd\fP au terminal de contrôle du processus appelant. .PP \fBforkpty\fP() échoue en cas d'échec de \fBopenpty\fP() ou de \fBfork\fP(2). .SH ATTRIBUTS Pour une explication des termes utilisés dans cette section, consulter \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. Interface Attribut Valeur T{ .na .nh \fBforkpty\fP(), \fBopenpty\fP() T} Sécurité des threads MT\-Safe locale T{ .na .nh \fBlogin_tty\fP() T} Sécurité des threads MT\-Unsafe race:ttyname .TE .sp 1 .SH STANDARDS BSD. .SH HISTORIQUE Les modificateurs \fBconst\fP ont été ajoutés dans la glibc 2.8 aux arguments des fonctions \fBopenpty\fP() et \fBforkpty\fP() qui sont des pointeurs sur des structures. .PP Avant la glibc\ 2.0.92, \fBopenpty\fP() 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. .SH BOGUES Personne ne sait combien d'espace il faut réserver pour \fIname\fP, ainsi les appels \fBopenpty\fP() et \fBforkpty\fP() avec un argument \fIname\fP non nul peuvent poser un problème de sécurité. .SH "VOIR AUSSI" \fBfork\fP(2), \fBttyname\fP(3), \fBpty\fP(7) .PP .SH TRADUCTION La traduction française de cette page de manuel a été créée par Christophe Blaess , Stéphan Rafin , Thierry Vignaud , François Micaux, Alain Portal , Jean-Philippe Guérard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas François , Florentin Duneau , Simon Paillard , Denis Barbier , David Prévot et Jean-Pierre Giraud . .PP Cette traduction est une documentation libre ; veuillez vous reporter à la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License version 3 .UE concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE. .PP Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à .MT debian-l10n-french@lists.debian.org .ME .