Provided by: manpages-fr-dev_3.27fr1.4-1_all bug

NOM

       ptsname, ptsname_r - Obtenir le nom d'un pseudo-terminal esclave

SYNOPSIS

       #define _XOPEN_SOURCE
       #include <stdlib.h>

       char *ptsname(int fd);

       #define _GNU_SOURCE
       #include <stdlib.h>

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

DESCRIPTION

       La  fonction  ptsname()  renvoie le nom du peripherique pseudo-terminal
       esclave (pty) associe au pseudo-terminal maitre indique par fd.

       La  fonction  ptsname_r()  est  la  version  reentrante  equivalente  a
       ptsname(). Elle renvoie le nom du peripherique pseudo-terminal esclave,
       sous la forme d'une chaine de caractere terminee par un octet nul, dans
       le  tampon pointe par buf. L'argument buflen indique le nombre d'octets
       disponibles dans buf.

VALEUR RENVOY'EE

       Lorsqu'elle reussit, la fonction ptsname() renvoie un pointeur sur  une
       chaine de stockage statique qui sera ecrasee par des appels successifs.
       Le pointeur ne doit PAS etre libere. Si elle echoue, ptsname()  renvoie
       un pointeur NULL.

       Lorsqu'elle reussit, la fonction ptsname_r() renvoie 0. Si elle echoue,
       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  reference  a  un peripherique pseudo-terminal
              maitre.

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

VERSIONS

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

CONFORMIT'E

       ptsname() fait partie du support pty d'Unix98 (consultez pts(4)). Cette
       fonction est specifiee dans POSIX.1-2001.

       ptsname_r()  est une extension Linux. Une version de cette fonction est
       documentee dans Tru64 et HP-UX, mais sur certaines implementations,  -1
       est  renvoye en cas d'erreur et errno contient le code d'erreur. Evitez
       d'utiliser  cette  fonction  dans  des  programmes  destines   a   etre
       portables.

VOIR AUSSI

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

COLOPHON

       Cette page fait partie de  la  publication  3.27  du  projet  man-pages
       Linux.  Une description du projet et des instructions pour signaler des
       anomalies      peuvent      etre       trouvees       a       l'adresse
       <URL:http://www.kernel.org/doc/man-pages/>.

TRADUCTION

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

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

       Veuillez  signaler  toute  erreur   de   traduction   en   ecrivant   a
       <debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
       paquet manpages-fr.

       Vous pouvez toujours avoir acces a la version anglaise de  ce  document
       en utilisant la commande << man -L C <section> <page_de_man> >>.

                               3 septembre 2008                     PTSNAME(3)