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

       En cas de succès, 0 est renvoyé pour les options standards. En cas d'échec, -1 est renvoyé
       et errno est positionné en fonction.

       Netfilter  permet au programmeur de définir des options personnalisées pour un socket avec
       des gestionnaires associés ; pour de telles options, le  code  de  retour  est  la  valeur
       renvoyée par le gestionnaire en cas de succès.

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 (ces appels système sont apparus pour la première
       fis dans 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.10 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@laposte.net>,  Thierry
       Vignaud  <tvignaud@mandriva.com>,  François Micaux, Alain Portal <aportal@univ-montp2.fr>,
       Jean-Philippe   Guérard   <fevrier@tigreraye.org>,   Jean-Luc   Coulon   (f5ibh)    <jean-
       luc.coulon@wanadoo.fr>,    Julien    Cristau    <jcristau@debian.org>,    Thomas   Huriaux
       <thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centraliens.net>, Florentin
       Duneau  <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>, Denis
       Barbier  <barbier@debian.org>,  David  Prévot   <david@tilapin.org>,   Cédric   Boutillier
       <cedric.boutillier@gmail.com>,  Frédéric  Hantrais  <fhantrais@gmail.com> et Jean-Philippe
       MENGUAL <jpmengual@debian.org>

       Cette traduction est une documentation libre ; veuillez vous reporter  à  la  GNU  General
       Public   License   version 3  ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩  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@lists.debian.org ⟨⟩.