Available in

(2) (3) (2)/es (2)/fr (2)/ja (2)/ko (2)/ru

Contents

NOM

getsockopt, setsockopt − Lire et écrire les options d’une socket

SYNOPSIS

#include <sys/types.h> /* Voir 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. Voir 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, consulter 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 voir socket(7) et les pages correspondant au protocole concerné.

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

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 paramètre sockfd est un fichier, pas une socket.

CONFORMITÉ

SVr4, BSD 4.4 (ces appels système sont apparus dans BSD 4.2), POSIX.1−2001.

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.

Le paramètre optlen de getsockopt() et setsockopt() 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 glibc. Pour plus de détails 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), socket(7), tcp(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 [AT] debian.org> et l’équipe francophone de traduction de Debian.

Veuillez signaler toute erreur de traduction en écrivant à <debian−l10n−french [AT] lists.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> ».

COMMENTS

blog comments powered by Disqus