Loading

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> ».