Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] getsockopt, setsockopt - Lire / écrire les options d'une socket. [size=18] [b]Résumé[/b] [/size] [b]#include <sys/types.h>[/b] [b][/b] [b]#include <sys/socket.h>[/b] 2 [b][i]int getsockopt(int s , int level , int optname ,[/i][/b] [b][i]void * optval , socklen_t * optlen );[/i][/b] [b][i]int setsockopt(int s , int level , int optname ,[/i][/b] [b][i]const void * optval , socklen_t optlen );[/i][/b] [size=18] [b]Description[/b] [/size] [b]Getsockopt[/b] et [b]setsockopt[/b] manipulent les [i]options[/i] associées à une socket. Ces options peuvent exister aux divers niveaux du protocole, et sont toujours présentes au niveau [b]socket[/b] 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, [i]level[/i] prend la valeur [b]SOL_SOCKET.[/b] Pour tous les autres niveaux, il faut fournir le numéro de protocole approprié. Par exemple, pour une option interprétée par le niveau de protocole [b]TCP ,[/b] [i]level[/i] prendra le numéro de protocole [b]TCP.[/b] Voir [b]getprotoent (3).[/b] Les paramètres [i]optval[/i] et [i]optlen[/i] sont utilisés pour déterminer les options pour [b]setsockopt.[/b] Pour [b]getsockopt[/b] ils identifient un buffer dans lequel la valeur de l'option désirée doit être renvoyée. Pour [b]getsockopt,[/b] [i]optlen[/i] est un paramètre résultat, contenant initialement la taille du buffer pointé par [b]optval,[/b] et rempli en retour pour indiquer la taille effective des valeurs renvoyées. Si aucune option n'est fournie ou renvoyée, [i]optval[/i] peut être NULL. [i]optname[/i] 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 [i]sys/socket.h[/i] 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 [i]int[/i] pour [b]optval .[/b] Pour [b]setsockopt ,[/b] un paramètre non nul valide une option booléenne, et zéro l'invalide. Pour une description des options disponibles voir [b]socket (7)[/b] et les pages correspondant au protocole concerné. [size=18] [b]Valeur renvoyée[/b] [/size] [b]getsockopt et setsockopt[/b] renvoient 0 s'ils réussissent, ou -1 s'ils échouent, auquel cas [i]errno[/i] contient le code d'erreur. [size=18] [b]Erreurs[/b] [/size] [b]EBADF[/b] [table][row][col]    [/col][col]L'argument [i]s[/i] n'est pas un descripteur valide.[/col][/row][/table] [b]ENOTSOCK[/b] [table][row][col]    [/col][col]L'argument [i]s[/i] est un fichier, pas une socket.[/col][/row][/table] [b]ENOPROTOOPT[/b] [table][row][col]    [/col][col]L'option est inconnue pour ce protocole.[/col][/row][/table] [b]EFAULT[/b] [i]optval[/i] [table][row][col]    [/col][col]pointe en dehors de l'espace d'adressage accessible. Avec [b]getsockopt ,[/b] ceci peut s'appliquer également à [b]optlen .[/b] [/col][/row][/table] [size=18] [b]Conformité[/b] [/size] SVr4, 4.4BSD (Ces appels systèmes sont apparus dans 4.2BSD). SVr4 présente des codes d'erreurs supplémentaires ENOMEM et ENOSR, mais ne documente pas les options [b]SO_SNDLOWAT , SO_RCVLOWAT , SO_SNDTIMEO , SO_RCVTIMEO .[/b] [size=18] [b]Note[/b] [/size] Le cinquième argument de [b]getsockopt et setsockopt[/b] est en fait un int (et c'est ce qu'utilisent BSD 4.*, libc4 et libc5). Une certaine confusion POSIX résulte du "socklen_t" actuel. Les propositions de standard n'ont pas encore été adoptées, mais glibc2 les suit déjà et utilise socklen_t. Pour plus de détails voir [b]accept (2).[/b] [size=18] [b]Bugs[/b] [/size] Plusieurs options sur les sockets devraient être gérées à un niveau plus bas par le système. [size=18] [b]Voir aussi[/b] [/size] [b]ioctl (2),[/b] [b]socket (2),[/b] [b]getprotoent (3),[/b] [b]protocols (5),[/b] [b]socket (7),[/b] [b]unix (7),[/b] [b]tcp (7)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier