Provided by:
manpages-fr-dev_2.80.1-1_all 
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 s, int level, int optname,
void *optval, socklen_t *optlen);
int setsockopt(int s, int level, int optname,
const void *optval, socklen_t optlen);
DESCRIPTION
getsockopt() et setsockopt() manipulent les options associées à une
socket. 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 socket, 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 Le paramètre s 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 invalide (pour setsockopt()).
ENOPROTOOPT
L’option est inconnue pour ce protocole.
ENOTSOCK L’argument s 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 2.80 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@debian.org> et l’équipe
francophone de traduction de Debian.
Veuillez signaler toute erreur de traduction en écrivant à
<debian-l10n-french@lists.debian.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> ».