GETPEERNAME(2)     Manuel du programmeur Linux     GETPEERNAME(2)


NOM
       getpeername  - Obtenir le nom d'un correspondant connecté.

SYNOPSIS
       #include <sys/socket.h>

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

DESCRIPTION
       Getpeername  retourne 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  appparue  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, 1997.




Linux                      18 Mai 1999                          1