TTYNAME

Section : Manuel du programmeur Linux (3)
Mise à jour de la version anglaise : 20 juillet 2002
Index Menu principal

NOM

ttyname, ttyname_r - Obtenir le nom d'un terminal

SYNOPSIS

#include <unistd.h>

char *ttyname(int fd);

int ttyname_r(int fd, char *buf, size_t buflen);

DESCRIPTION

La fonction ttyname() renvoie un pointeur sur le chemin d'accès terminé par un octet nul du périphérique terminal ouvert 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 buf de longueur buflen.

VALEUR RENVOYÉE

La fonction ttyname() renvoie un pointeur sur le chemin d'accès. En cas d'erreur, elle renvoie NULL et remplit errno avec le code d'erreur. La fonction ttyname_r() renvoie zéro si elle réussit et un code d'erreur si elle échoue.

ERREURS

Les valeurs stockées dans errno par un échec de ttyname() ou renvoyées par un échec de ttyname_r() sont :

EBADF: Mauvais descripteur de fichier.
ENOTTY: Le descripteur de fichier ne se rapporte pas à un terminal.
ERANGE: buflen est trop court pour stocker le chemin d'accès.

CONFORMITÉ

BSD 4.2, POSIX.1-2001.

VOIR AUSSI

fstat(2), isatty(3)

TRADUCTION

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 11 décembre 1996 et révisée le 17 juillet 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 ttyname ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.

Dernière mise à jour : 17 juillet 2008