ttyname

Autres langues

Langue: fr

Version: 21 juillet 2003 (openSuse - 09/10/07)

Section: 3 (Bibliothèques de fonctions)

NOM

ttyname - 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 caractère nul du périphérique terminal ouvert sur le 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 buffer 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ée par un échec de ttyname_r() :
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É

POSIX.1

VOIR AUSSI

fstat(2), isatty(3)

TRADUCTION

Christophe Blaess, 1996-2003.