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(int fd, char tampon[.taille_tampon], size_t taille_tampon);

   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.

       La fonction ptsname_r() est la version reentrante equivalente a
       ptsname(). Elle renvoie le nom du peripherique pseudoterminal esclave,
       sous la forme d'une chaine de caracteres terminee par NULL dans le
       tampon pointe par tampon. L'argument taille_tampon indique le nombre
       d'octets disponibles dans tampon.

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 and HP-UX, but on
       those implementations, -1 is returned on error, with errno set to
       indicate the error.  Avoid using this function in portable programs.

STANDARDS
       ptsname() :
              POSIX.1-2008.

       ptsname_r()  is a Linux extension, that is proposed for inclusion in
       the next major revision of POSIX.1 (Issue 8).

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

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

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.06   31 octobre 2023                     ptsname(3)