ttyname, ttyname_r - Obtenir le nom d'un terminal
Bibliothèque C standard (
libc,
-lc)
#include <unistd.h>
char *ttyname(int fd);
int ttyname_r(int fd, char tampon[.longtamp], size_t longtamp);
La fonction
ttyname() renvoie un pointeur sur le nom (terminé par
un caractère nul) du périphérique terminal associé
au descripteur de fichier
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 statiques,
susceptibles d'être écrasées lors d'un appel
ultérieur. La fonction
ttyname_r() stocke la valeur dans le
tampon de longueur
longtamp.
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'erreur si elle échoue.
- 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.
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 |
POSIX.1-2001, POSIX.1-2008, 4.2BSD.
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ériphé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 fichier fait référence. Appeler
ttyname()
ou
ttyname_r() sur le descripteur de fichier dans le nouvel espace de
noms de montage fera que ces fonctions renverront NULL et définiront
errno à
ENODEV.
tty(1),
fstat(2),
ctermid(3),
isatty(3),
pts(4)
La traduction française de cette page de manuel a été
créée par Christophe Blaess
<
https://www.blaess.fr/christophe/>, Stéphan Rafin
<
[email protected]>, Thierry Vignaud
<
[email protected]>, François Micaux, Alain Portal
<
[email protected]>, Jean-Philippe Guérard
<
[email protected]>, Jean-Luc Coulon (f5ibh)
<
[email protected]>, Julien Cristau
<
[email protected]>, Thomas Huriaux <
[email protected]>,
Nicolas François <
[email protected]>, Florentin
Duneau <
[email protected]>, Simon Paillard
<
[email protected]>, Denis Barbier
<
[email protected]>, David Prévot <
[email protected]> et
Jean-Pierre Giraud <
[email protected]>
Cette traduction est une documentation libre ; veuillez vous reporter
à la
GNU
General Public License version 3 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 à
[email protected]