NOM
getsockopt, setsockopt - Lire et écrire les options d’une socket
SYNOPSIS
#include
<sys/types.h> /* Consultez NOTES */
#include <sys/socket.h>
int
getsockopt(int sockfd, int
level, int optname,
void *optval, socklen_t
*optlen);
int setsockopt(int sockfd, int
level, int optname,
const void *optval, socklen_t
optlen);
DESCRIPTION
getsockopt() et setsockopt() manipulent les options associées à la socket à laquelle fait référence le descripteur de fichier sockfd. Ces options peuvent exister aux divers niveaux de protocole, et sont toujours présentes au niveau socket le plus élevé.
Quand on manipule une option d’une socket, il faut préciser le niveau où elle s’applique, et le nom de l’option. Au niveau de l’API des sockets, level prend la valeur SOL_SOCKET. Pour tous les autres niveaux, il faut fournir le numéro de protocole approprié. Par exemple, pour une option interprétée par le protocole TCP, level prendra le numéro du protocole TCP. Consultez getprotoent(3).
Les paramètres optval et optlen sont utilisés pour déterminer les options pour setsockopt(). Pour getsockopt ils identifient un tampon dans lequel la valeur de l’option désirée doit être renvoyée. Pour getsockopt, optlen est un paramètre résultat, contenant initialement la taille du tampon pointé par optval, et rempli en retour pour indiquer la taille effective des valeurs renvoyées. Si aucune option n’est fournie ou renvoyée, optval peut être NULL.
optname et toute autre option sont passés sans interprétation au protocole approprié, pour qu’il l’interprète lui-même. Le fichier d’en-tête <sys/socket.h> contient les définitions pour le niveau socket. Les options pour les autres niveaux de protocole peuvent varier tant en format qu’en nom, consultez les pages de manuel de la section 7 pour plus d’informations.
La plupart des options au niveau socket utilisent un paramètre de type int pour optval. Pour setsockopt(), un paramètre non nul valide une option booléenne, et zéro l’invalide.
Pour une description des options disponibles consultez socket(7) et les pages correspondant au protocole concerné.
VALEUR RENVOYÉE
On success, zero is returned for the standard options. On error, -1 is returned, and errno is set appropriately.
Netfilter allows the programmer to define custom socket options with associated handlers; for such options, the return value on success is the value returned by the handler.
ERREURS
|
EBADF |
sockfd n’est pas un descripteur de fichier valable. | ||
|
EFAULT |
optval pointe en dehors de l’espace d’adressage accessible. Avec getsockopt(), ceci peut s’appliquer également à optlen. | ||
|
EINVAL |
optlen non valable pour setsockopt(). Dans certains cas cette erreur peut aussi se produire pour une valeur non valable de optval (par exemple, pour l’option IP_ADD_MEMBERSHIP décrite dans ip(7)). |
ENOPROTOOPT
L’option est inconnue pour ce protocole.
ENOTSOCK
Le descripteur de fichier sockfd ne fait pas référence à un socket.
CONFORMITÉ
POSIX.1-2001, POSIX.1-2008, SVr4, 4.4BSD (these system calls first appeared in 4.2BSD).
NOTES
POSIX.1-2001 ne requiert pas l’inclusion de <sys/types.h>, et cet en-tête n’est pas nécessaire sous Linux. Cependant, il doit être inclus sous certaines implémentations historiques (BSD), et les applications portables devraient probablement l’utiliser.
Pour plus de détails sur le type socklen_t, voir accept(2).
BOGUES
Plusieurs options sur les sockets devraient être gérées à un niveau plus bas par le système.
VOIR AUSSI
ioctl(2), socket(2), getprotoent(3), protocols(5), ip(7), packet(7), socket(7), tcp(7), udp(7), unix(7)
COLOPHON
Cette page fait partie de la publication 5.07 du projet man-pages Linux. Une description du projet et des instructions pour signaler des anomalies et la dernière version de cette page, peuvent être trouvées à l’adresse https://www.kernel.org/doc/man-pages/.
TRADUCTION
La traduction française de cette page de manuel a été créée par Christophe Blaess <https://www.blaess.fr/christophe/>;, Stéphan Rafin <stephan.rafin [AT] laposte.net>, Thierry Vignaud <tvignaud [AT] mandriva.com>, François Micaux, Alain Portal <aportal [AT] univ-montp2.fr>, Jean-Philippe Guérard <fevrier [AT] tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.coulon [AT] wanadoo.fr>, Julien Cristau <jcristau [AT] debian.org>, Thomas Huriaux <thomas.huriaux [AT] gmail.com>, Nicolas François <nicolas.francois [AT] centraliens.net>, Florentin Duneau <fduneau [AT] gmail.com>, Simon Paillard <simon.paillard [AT] resel.fr>, Denis Barbier <barbier [AT] debian.org>, David Prévot <david [AT] tilapin.org>, Cédric Boutillier <cedric.boutillier [AT] gmail.com> et Frédéric Hantrais <fhantrais [AT] gmail.com>
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 à <debian-l10n-french [AT] lists.org>.