NOM

       ptsname, ptsname_r - Obtenir le nom d'un pseudoterminal esclave

SYNOPSIS

       #define _XOPEN_SOURCE       /* Consultez feature_test_macros(7) */
       #include <stdlib.h>

       char *ptsname(int fd);

       #define _GNU_SOURCE         /* Consultez feature_test_macros(7) */
       #include <stdlib.h>

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

DESCRIPTION

       La  fonction  ptsname()  renvoie  le nom du périphérique pseudoterminal esclave associé au
       pseudoterminal maître indiqué par fd.

       La fonction ptsname_r() est la version réentrante équivalente à ptsname(). Elle renvoie le
       nom  du  périphérique  pseudoterminal  esclave,  sous  la  forme d'une chaîne de caractère
       terminée par un octet nul, dans le tampon pointé par buf.  L'argument  buflen  indique  le
       nombre d'octets disponibles dans buf.

VALEUR RENVOYÉE

       Lorsqu'elle  réussit, la fonction ptsname() renvoie un pointeur sur une chaîne de stockage
       statique qui sera écrasée par des appels successifs. Le pointeur ne doit PAS être  libéré.
       Si elle échoue, ptsname() renvoie un pointeur NULL.

       Lorsqu'elle  réussit,  la fonction ptsname_r() renvoie 0. Si elle échoue, elle renvoie une
       valeur non nulle et errno contient le code de l'erreur.

ERREURS

       EINVAL (ptsname_r() seulement) buf est NULL.

       ENOTTY fd ne fait pas référence à un périphérique pseudoterminal maître.

       ERANGE (ptsname_r() seulement) buf est trop petit.

VERSIONS

       ptsname() est fournie par la glibc depuis la version 2.1.

ATTRIBUTS

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

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

CONFORMITÉ

       ptsname() fait partie du support pty d'UNIX 98  (consultez  pts(4)).  Cette  fonction  est
       spécifiée dans POSIX.1-2001.

       ptsname_r()  est  une  extension  Linux. Une version de cette fonction est documentée dans
       Tru64 et HP-UX, mais sur certaines implémentations, -1 est  renvoyé  en  cas  d'erreur  et
       errno  contient  le  code  d'erreur.  Évitez d'utiliser cette fonction dans des programmes
       destinés à être portables.

VOIR AUSSI

       grantpt(3), posix_openpt(3), ttyname(3), unlockpt(3), pts(4), pty(7)

COLOPHON

       Cette page fait partie de la publication 3.57 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     à
       <debian-l10n-french@lists.debian.org>   ou   par   un  rapport  de  bogue  sur  le  paquet
       manpages-fr.

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

                                           21 juin 2013                                PTSNAME(3)