1. NOM

ttyname, ttyname_r - Obtenir le nom d'un terminal

2. SYNOPSIS

 
Sélectionnez
#include <unistd.h>
char *ttyname(int fd);
int ttyname_r(int fd, char *tampon, size_t lngtmp);

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

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

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

6. ATTRIBUTS

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

7. CONFORMITÉ

BSD 4.2, POSIX.1-2001.

8. VOIR AUSSI

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

9. COLOPHON

Cette page fait partie de la publication 3.52 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/.

10. 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 à <>.

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