Loading

NOM

       getpeername - Obtenir le nom d’un correspondant connecté sur une socket

SYNOPSIS

       #include <sys/socket.h>

       int getpeername(int sockfd, struct sockaddr *addr, socklen_t *addrlen);

       La  fonction  getpeername() renvoie l’adresse du correspondant connecté
       sur la socket sockfd, dans le tampon  pointé  par  addr.  Le  paramètre
       addrlen doit être initialisé pour indiquer la taille de la zone pointée
       par addr. En retour, il contiendra la longueur effective (en octets) du
       nom retourné. Le nom est tronqué si le tampon est trop petit.

       L’adresse  renvoyée  est  tronquée si le tampon fourni est trop petit ;
       dans ce cas, addrlen renverra une valeur  supérieure  à  celle  fournie
       lors de l’appel.

VALEUR RENVOYÉE

       En  cas  de  réussite,  zéro est renvoyé, sinon -1 est renvoyé et errno
       contient le code d’erreur.

ERREURS

       EBADF  sockfd n’est pas un descripteur valable.

       EFAULT Le paramètre addr  pointe  en  dehors  de  l’espace  d’adressage
              accessible.

       EINVAL addrlen n’est pas valable (négatif, par exemple).

       ENOBUFS
              Les ressources système disponibles sont insuffisantes.

       ENOTCONN
              La socket n’est pas connectée.

       ENOTSOCK
              Le paramètre sockfd est un fichier, pas une socket.

CONFORMITÉ

       SVr4,  BSD 4.4  (la  fonction  getpeername() est apparue dans BSD 4.2),
       POSIX.1-2001.

NOTES

       Le troisième argument de getpeername() est en fait  un  « int  * »  (et
       c’est  ce qu’utilisent BSD 4.x, libc4 et libc5). Une certaine confusion
       POSIX a donné le « socklen_t » actuel, également utilisé par la  glibc.
       Pour plus de détails voir accept(2).

VOIR AUSSI

       accept(2), bind(2), getsockname(2), ip(7), socket(7), unix(7)

COLOPHON

       Cette  page  fait  partie  de  la  publication 3.23 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

       Cette page de manuel a été traduite  et  mise  à  jour  par  Christophe
       Blaess  <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis par
       Alain Portal <aportal AT univ-montp2 DOT fr> jusqu’en 2006, et  mise  à
       disposition sur http://manpagesfr.free.fr/.

       Les mises à jour et corrections de la version présente dans Debian sont
       directement gérées par Julien Cristau <jcristau@debian.org> et l’équipe
       francophone de traduction de Debian.

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