getsockname - Obtenir le nom d'une socket
Bibliothèque C standard (
libc,
-lc)
#include <sys/socket.h>
int getsockname(int sockfd, struct sockaddr *restrict addr,
socklen_t *restrict 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.
En cas de succès, zéro est renvoyé. En cas d'erreur,
-1 est renvoyé et
errno est définie pour
préciser l'erreur.
- EBADF
-
sockfd n'est pas un descripteur de fichier
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 descripteur de fichier sockfd ne fait pas
référence à un socket.
POSIX.1-2001, POSIX.1-2008, SVr4, 4.4BSD (
getsockname() est apparu pour
la première fois dans 4.2BSD).
Pour plus de détails sur le type
socklen_t, voir
accept(2).
bind(2),
socket(2),
getifaddrs(3),
ip(7),
socket(7),
unix(7)
La traduction française de cette page de manuel a été
créée par Christophe Blaess
<
https://www.blaess.fr/christophe/>, Stéphan Rafin
<
[email protected]>, Thierry Vignaud
<
[email protected]>, François Micaux, Alain Portal
<
[email protected]>, Jean-Philippe Guérard
<
[email protected]>, Jean-Luc Coulon (f5ibh)
<
[email protected]>, Julien Cristau
<
[email protected]>, Thomas Huriaux <
[email protected]>,
Nicolas François <
[email protected]>, Florentin
Duneau <
[email protected]>, Simon Paillard
<
[email protected]>, Denis Barbier
<
[email protected]>, David Prévot <
[email protected]>,
Cédric Boutillier <
[email protected]> et
Frédéric Hantrais <
[email protected]>
Cette traduction est une documentation libre ; veuillez vous reporter
à la
GNU
General Public License version 3 concernant les conditions de copie
et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
Si vous découvrez un bogue dans la traduction de cette page de manuel,
veuillez envoyer un message à
[email protected]