getpeername(2)                System Calls Manual               getpeername(2)

NOM
       getpeername - Obtenir le nom d'un correspondant connecte sur un socket

BIBLIOTHEQUE
       Bibliotheque C standard (libc, -lc)

SYNOPSIS
       #include <sys/socket.h>

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

DESCRIPTION
       La fonction getpeername() renvoie l'adresse du correspondant connecte
       sur le socket sockfd, dans le tampon pointe par addr. Le parametre
       addrlen doit etre initialise pour indiquer la taille de la zone pointee
       par addr. En retour, il contiendra la longueur effective (en octets) du
       nom retourne. Le nom est tronque si le tampon est trop petit.

       L'adresse renvoyee est tronquee si le tampon fourni est trop petit ;
       dans ce cas, addrlen renverra une valeur superieure a celle fournie
       lors de l'appel.

VALEUR RENVOYEE
       En cas de succes, zero est renvoye. En cas d'erreur, -1 est renvoye et
       errno est definie pour preciser l'erreur.

ERREURS
       EBADF  sockfd n'est pas un descripteur de fichier valable.

       EFAULT Le parametre addr pointe en dehors de l'espace d'adressage
              accessible.

       EINVAL addrlen n'est pas valable (negatif, par exemple).

       ENOBUFS
              Les ressources systeme disponibles sont insuffisantes.

       ENOTCONN
              Le socket n'est pas connecte.

       ENOTSOCK
              Le descripteur de fichier sockfd ne fait pas reference a un
              socket.

STANDARDS
       POSIX.1-2008.

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

NOTES
       Pour les sockets flux, une fois que connect(2) a ete realise, chaque
       socket peut appeler getpeername() pour obtenir l'adresse du socket
       correspondant. D'un autre cote, les sockets datagramme sont sans
       connexion. Appeler connect(2) sur un socket datagramme definit
       simplement l'adresse correspondante pour les datagrammes sortants
       envoyes avec write(2) ou recv(2). L'appelant de connect(2) peut
       utiliser getpeername() pour obtenir l'adresse correspondante qui est
       definie plus tot pour le socket. Cependant, le socket correspondant ne
       connait pas ces renseignements et appeler getpeername() sur le socket
       correspondant ne renverra aucun renseignement utile (sauf si un appel
       connect(2) est aussi execute sur l correspondant). Remarquez aussi que
       le destinataire d'un datagramme peut obtenir l'adresse de l'expediteur
       en utilisant recvfrom(2).

VOIR AUSSI
       accept(2), bind(2), getsockname(2), ip(7), socket(7), unix(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 Jean-Philippe MENGUAL <jpmengual@debian.org>

       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                 getpeername(2)