ptsname(3)                 Library Functions Manual                 ptsname(3)

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

BIBLIOTHEQUE
       Bibliotheque C standard (libc, -lc)

SYNOPSIS
       #include <stdlib.h>

       char *ptsname(int fd);
       int ptsname_r(size_t size;
                     int fd, char buf[size], size_t size);

   Exigences de macros de test de fonctionnalites pour la glibc (consulter
   feature_test_macros(7)) :

       ptsname() :
           Depuis la glibc 2.24 :
               _XOPEN_SOURCE >= 500
           glibc 2.23 et anterieures :
               _XOPEN_SOURCE

       ptsname_r() :
           _GNU_SOURCE

DESCRIPTION
       La fonction ptsname() renvoie le nom du peripherique pseudoterminal
       esclave associe au pseudoterminal maitre indique par fd.

       The ptsname_r()  function is the reentrant equivalent of ptsname().  It
       returns the name of the slave pseudoterminal device as a
       null-terminated string in the buffer pointed to by buf.  The size
       argument specifies the number of bytes available in buf.

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

       Lorsqu'elle reussit, la fonction ptsname_r() renvoie 0. Si elle echoue,
       elle renvoie un nombre qui indique la nature de l'erreur.

ERREURS
       EINVAL ptsname_r() seulement : tampon est egal a NULL (Cette erreur
              n'est renvoyee qu'avec les versions 2.25 et anterieures de la
              glibc).

       ENOTTY fd ne fait pas reference a un peripherique pseudoterminal
              maitre.

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

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

       +------------------+--------------------------+------------------------+
       |Interface         | Attribut                 | Valeur                 |
       +------------------+--------------------------+------------------------+
       |ptsname()         | Securite des threads     | MT-Unsafe race:ptsname |
       +------------------+--------------------------+------------------------+
       |ptsname_r()       | Securite des threads     | MT-Safe                |
       +------------------+--------------------------+------------------------+
VERSIONS
       A version of ptsname_r()  is documented on Tru64, HP-UX, and FreeBSD,
       but on those implementations, -1 is returned on error, with errno set
       to indicate the error.  Avoid using this function in portable programs.

NORMES
       ptsname() :
              POSIX.1-2008.

       ptsname_r() :
              POSIX.1-2024.

HISTORIQUE
       ptsname() :
              POSIX.1-2001. glibc 2.1.

       ptsname() fait partie de la prise en charge des pseudoterminaux
       d'UNIX 98 (consultez pts(4)).

       ptsname_r() :
              GNU.

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

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 Lucien Gentis <lucien.gentis@waika9.com>

       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.18   29 octobre 2025                     ptsname(3)