TTYNAME(3)

NOM
ttyname, ttyname_r - Obtenir le nom d'un terminal

SYNOPSIS
#include <unistd.h>

char *ttyname(int fd);
int ttyname_r(int fd, char *tampon, size_t lngtmp);

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 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 lngtmp.

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

EBADF
    Mauvais descripteur de fichier.

ENOTTY
    Le descripteur de fichier ne se rapporte pas à un terminal.

ERANGE
    (ttyname_r()) buflen est trop court pour stocker le chemin d'accès.

ATTRIBUTS

  Multithreading (voir pthreads(7))
La fonction ttyname() n'est pas sûre dans un contexte multithread.

La fonction ttyname_r() est sûre dans un contexte multithread.

CONFORMITÉ
BSD 4.2, POSIX.1-2001.

VOIR AUSSI
fstat(2), ctermid(3), isatty(3)

COLOPHON
Cette page fait partie de la publication 3.70 du projet man-pages Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse http://www.kernel.org/doc/man-pages/.

TRADUCTION
Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>.

Christophe Blaess <http://www.blaess.fr/christophe/> (1996-2003), Alain Portal <http://manpagesfr.free.fr/> (2003-2006). Nicolas François et l'équipe francophone de traduction de Debian (2006-2009).

Veuillez signaler toute erreur de traduction en écrivant à <perkamon-fr@traduc.org>.

Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « LC_ALL=C man <section> <page_de_man> ».