ttyname(3)                 Library Functions Manual                 ttyname(3)

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

BIBLIOTHEQUE
       Bibliotheque C standard (libc, -lc)

SYNOPSIS
       #include <unistd.h>

       char *ttyname(int fd);
       int ttyname_r(int fd, char tampon[.longtamp], size_t longtamp);

DESCRIPTION
       La fonction ttyname() renvoie un pointeur sur le nom (termine par un
       caractere nul) du peripherique terminal associe au descripteur de
       fichier fd, ou NULL en cas d'erreur (par exemple si fd n'est pas
       connecte a un terminal). La valeur renvoyee peut pointer vers des
       donnees statiques, susceptibles d'etre ecrasees lors d'un appel
       ulterieur. La fonction ttyname_r() stocke la valeur dans le tampon de
       longueur longtamp.

VALEUR RENVOYEE
       La fonction ttyname() renvoie un pointeur sur le chemin d'acces. En cas
       d'erreur, elle renvoie NULL et errno est defini pour indiquer l'erreur.
       La fonction ttyname_r() renvoie zero si elle reussit et un code
       d'erreur si elle echoue.

ERREURS
       EBADF  Mauvais descripteur de fichier.

       ENODEV fd se rapporte a un peripherique pseudoterminal esclave, mais le
              chemin d'acces correspondant ne peut pas etre trouve (voir
              NOTES).

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

       ERANGE (ttyname_r()) longtamp est trop court pour stocker le chemin
              d'acces.

ATTRIBUTS
       Pour une explication des termes utilises dans cette section, consulter
       attributes(7).

       +------------------+--------------------------+------------------------+
       |Interface         | Attribut                 | Valeur                 |
       +------------------+--------------------------+------------------------+
       |ttyname()         | Securite des threads     | MT-Unsafe race:ttyname |
       +------------------+--------------------------+------------------------+
       |ttyname_r()       | Securite des threads     | MT-Safe                |
       +------------------+--------------------------+------------------------+
STANDARDS
       POSIX.1-2008.

HISTORIQUE
       POSIX.1-2001, 4.2BSD.

NOTES
       Un processus qui conserve un descripteur de fichier que fait reference
       a un peripherique pts ouvert lors du passage a un autre espace de noms
       de montage qui utilise une instance /dev/ptmx differente peut toujours
       accidentellement trouver qu'un chemin de peripherique du meme nom que
       celui du descripteur de fichier existe. Cependant, ce chemin de
       peripherique fait reference a un peripherique different et donc ne peut
       pas etre utilise pour acceder au peripherique auquel le descripteur de
       fichier fait reference. 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 definiront errno a ENODEV.

VOIR AUSSI
       tty(1), fstat(2), ctermid(3), isatty(3), pts(4)

TRADUCTION
       La traduction francaise de cette page de manuel a ete creee par
       Christophe Blaess <https://www.blaess.fr/christophe/>, Stephan Rafin
       <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>,
       Francois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe
       Guerard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-
       luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas
       Huriaux <thomas.huriaux@gmail.com>, Nicolas Francois
       <nicolas.francois@centraliens.net>, Florentin Duneau
       <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-
       bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prevot
       <david@tilapin.org> et Jean-Pierre Giraud <jean-pierregiraud@neuf.fr>

       Cette traduction est une documentation libre ; veuillez vous reporter a
       la GNU General Public License version 3
       <https://www.gnu.org/licenses/gpl-3.0.html> concernant les conditions
       de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE.

       Si vous decouvrez un bogue dans la traduction de cette page de manuel,
       veuillez envoyer un message a <debian-l10n-french@lists.debian.org>.

Pages du manuel de Linux 6.06   31 octobre 2023                     ttyname(3)