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.
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.65 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> ».