getsockname − Obtenir le nom d’une socket.

#include <sys/socket.h>

int getsockname(int s, struct sockaddr *name, socklen_t *namelen)

getsockname() renvoie le nom name de la socket indiquée. Le paramètre namelen doit être initialisé pour indiquer la taille de la zone mémoire pointée par name. En retour, il contiendra la taille effective (en octets) du nom renvoyé.

getsockname() renvoie 0 s’il réussit, ou −1 s’il échoue, auquel cas errno contient le code d’erreur.

EBADF

L’argument s n’est pas un descripteur valide.

EFAULT

name pointe en dehors de l’espace d’adressage

accessible.

ENOTSOCK

L’argument s est un fichier, pas une socket.

EINVAL

namelen n’est pas valide (par exemple, est négatife).

ENOBUFS

Pas assez de ressources dans le système pour efectuer l’opération.

SVr4, BSD 4.4 (la fonction getsockname() est apparue dans BSD 4.2), POSIX.1-2001.

Le troisième argument de getsockname() 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, également utilisé par la glibc. Pour plus de détails voir accept(2).

bind(2), socket(2)

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 14 août 2006.

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 getsockname ». N’hésitez pas à signaler à l’auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.