NOM
getsockname - Obtenir le nom d’une socket
SYNOPSIS
#include <sys/socket.h>
int getsockname(int sockfd, struct sockaddr *addr, socklen_t *addrlen);
getsockname() renvoie, dans le tampon pointé par addr, l’adresse à
laquelle la socket sockfd est liée. Le paramètre addrlen doit être
initialisé pour indiquer la taille de la zone mémoire pointée par addr.
En retour, il contiendra la taille effective (en octets) de l’adresse
de la socket.
L’adresse renvoyée est tronquée si le tampon fourni est trop petit ;
dans ce cas, addrlen renverra une valeur supérieure à celle fournie
lors de l’appel.
VALEUR RENVOYÉE
En cas de réussite, zéro est renvoyé, sinon -1 est renvoyé et errno
contient le code d’erreur.
ERREURS
EBADF sockfd n’est pas un descripteur valable.
EFAULT Le paramètre addr pointe en dehors de l’espace d’adressage
accessible.
EINVAL addrlen n’est pas valable (négatif, par exemple).
ENOBUFS
Les ressources système disponibles sont insuffisantes.
ENOTSOCK
Le paramètre sockfd est un fichier, pas une socket.
CONFORMITÉ
SVr4, BSD 4.4 (la fonction getsockname() est apparue dans BSD 4.2),
POSIX.1-2001.
NOTES
Le troisième argument de getsockname() 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. Voir aussi
accept(2).
VOIR AUSSI
bind(2), socket(2), getifaddrs(3), ip(7), socket(7), unix(7)
COLOPHON
Cette page fait partie de la publication 3.23 du projet man-pages
Linux. Une description du projet et des instructions pour signaler des
anomalies peuvent être trouvées à l’adresse
http://www.kernel.org/doc/man-pages/.
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, et mise à
disposition sur http://manpagesfr.free.fr/.
Les mises à jour et corrections de la version présente dans Debian sont
directement gérées par Julien Cristau <jcristau@debian.org> et l’équipe
francophone de traduction de Debian.
Veuillez signaler toute erreur de traduction en écrivant à
<debian-l10n-french@lists.debian.org> ou 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> ».