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