GETPEERNAME

Index

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

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

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

ERREURS

EBADF: Le paramètre s n'est pas un descripteur valide.
EFAULT: name pointe en dehors de l'espace d'adressage accessible.
EINVAL: namelen est invalide (s'il est négatif, par exemple).
ENOBUFS: Les ressources système disponibles sont insuffisantes.
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

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.
La traduction de cette page de manuel est basée sur les traductions disponibles sur http://manpagesfr.free.fr/, mais est gérée par l'équipe francophone de traduction de Debian au travers de la liste de discussion debian-l10n-french.
Veuillez signaler toute erreur de traduction 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> ».

Création : octobre 2007