GETPEERNAME

Section : Manuel du programmeur Linux (2)
Mise à jour de la version anglaise : 30 juillet 1993
Index Menu principal  

NOM

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

SYNOPSIS

#include <sys/socket.h>

int getpeername(int s, struct sockaddr *name, socklen_t *namelen);  

DESCRIPTION

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

VALEUR RENVOYÉE

Cet appel système renvoie 0 s'il réussit, ou -1 s'il échoue, auquel cas errno est renseignée en conséquence.  

ERREURS

EBADF
L'argument s n'est pas un descripteur valide.
EFAULT
name pointe en dehors de l'espace d'adressage accessible.
EINVAL
namelen n'est pas valide (par exemple, est négatif).
ENOBUFS
Les ressources système disponibles sont insuffisantes pour effectuer l'opération.
ENOTCONN
La socket n'est pas connectée.
ENOTSOCK
L'argument s 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)  

TRADUCTION

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 11 octobre 1996 et révisée le 23 juin 2008.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 2 getpeername ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.

 

Index

NOM
SYNOPSIS
DESCRIPTION
VALEUR RENVOYÉE
ERREURS
CONFORMITÉ
NOTES
VOIR AUSSI
TRADUCTION

Dernière mise à jour : 23 juin 2008