ttyname(3) Library Functions Manual ttyname(3)
NOM
ttyname, ttyname_r - Obtenir le nom d'un terminal
BIBLIOTHÈQUE
Bibliothèque C standard (libc, -lc)
SYNOPSIS
#include <unistd.h>
char *ttyname(int fd);
int ttyname_r(int fd, char tampon[.longtamp], size_t longtamp);
DESCRIPTION
La fonction ttyname() renvoie un pointeur sur le nom (terminé par un
caractère nul) du périphérique terminal associé au descripteur de fi-
chier fd, ou NULL en cas d'erreur (par exemple si fd n'est pas connecté
à un terminal). La valeur renvoyée peut pointer vers des données sta-
tiques, susceptibles d'être écrasées lors d'un appel ultérieur. La
fonction ttyname_r() stocke la valeur dans le tampon de longueur long-
tamp.
VALEUR RENVOYÉE
La fonction ttyname() renvoie un pointeur sur le chemin d'accès. En cas
d'erreur, elle renvoie NULL et errno est défini pour indiquer l'erreur.
La fonction ttyname_r() renvoie zéro si elle réussit et un code d'er-
reur si elle échoue.
ERREURS
EBADF Mauvais descripteur de fichier.
ENODEV fd se rapporte à un périphérique pseudoterminal esclave, mais le
chemin d'accès correspondant ne peut pas être trouvé (voir
NOTES).
ENOTTY Le descripteur de fichier fd ne se rapporte pas à un terminal.
ERANGE (ttyname_r()) longtamp est trop court pour stocker le chemin
d'accès.
ATTRIBUTS
Pour une explication des termes utilisés dans cette section, consulter
attributes(7).
┌──────────────────────┬──────────────────────┬────────────────────────┐
│Interface │ Attribut │ Valeur │
├──────────────────────┼──────────────────────┼────────────────────────┤
│ttyname() │ Sécurité des threads │ MT-Unsafe race:ttyname │
├──────────────────────┼──────────────────────┼────────────────────────┤
│ttyname_r() │ Sécurité des threads │ MT-Safe │
└──────────────────────┴──────────────────────┴────────────────────────┘
STANDARDS
POSIX.1-2001, POSIX.1-2008, 4.2BSD.
NOTES
Un processus qui conserve un descripteur de fichier que fait référence
à un périphérique pts ouvert lors du passage à un autre espace de noms
de montage qui utilise une instance /dev/ptmx différente peut toujours
accidentellement trouver qu'un chemin de périphérique du même nom que
celui du descripteur de fichier existe. Cependant, ce chemin de péri-
phérique fait référence à un périphérique différent et donc ne peut pas
être utilisé pour accéder au périphérique auquel le descripteur de fi-
chier fait référence. Appeler ttyname() ou ttyname_r() sur le descrip-
teur de fichier dans le nouvel espace de noms de montage fera que ces
fonctions renverront NULL et définiront errno à ENODEV.
VOIR AUSSI
tty(1), fstat(2), ctermid(3), isatty(3), pts(4)
TRADUCTION
La traduction française de cette page de manuel a été créée par Chris-
tophe Blaess <https://www.blaess.fr/christophe/>, Stéphan Rafin <ste-
phan.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.cou-
lon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux
<thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centra-
liens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <si-
mon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@de-
bian.org>, David Prévot <david@tilapin.org> et Jean-Pierre Giraud
<jean-pierregiraud@neuf.fr>
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⟩.
Pages du manuel de Linux 6.03 15 décembre 2022 ttyname(3)
Generated by dwww version 1.15 on Sat Jun 29 01:33:31 CEST 2024.