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