getpeername

Autres langues

Langue: fr

Version: 18 juillet 2003 (openSuse - 09/10/07)

Autres sections - même nom

Section: 2 (Appels système)

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 une 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 buffer est trop petit.

VALEUR RENVOYÉE

getpeername renvoie 0 s'il réussit, ou -1 s'il échoue, auquel cas errno contient le code d'erreur.

ERREURS

EBADF
L'argument s n'est pas un descripteur valide.
ENOTSOCK
L'argument s est un fichier, pas une socket.
ENOTCONN
La socket n'est pas connectée.
ENOBUFS
Pas assez de mémoire pour le noyau
EFAULT
name pointe en dehors de l'espace d'adressage accessible

CONFORMITÉ

SVr4, 4.4BSD (La fonction getpeername est apparue dans BSD 4.2).

NOTE

Le troisième argument de getpeername est en fait un int (et c'est ce qu'utilisent BSD 4.*, libc4 et libc5). Une certaine confusion POSIX résulte du "socklen_t" actuel. Les propositions de standard n'ont pas encore été adoptées, mais glibc2 les suit déjà et utilise socklen_t. Pour plus de détails voir accept(2).

VOIR AUSSI

accept(2), bind(2), getsockname(2)

TRADUCTION

Christophe Blaess, 1996-2003.