NOM

       udplite - Protocole « Lightweight User Datagram Protocol »

SYNOPSIS

       #include <sys/socket.h>

       sockfd = socket(AF_INET, SOCK_DGRAM, IPPROTO_UDPLITE);

DESCRIPTION

       C'est  une implémentation du protocol « Lightweight User Datagram Protocol » (UDP-Lite, version légère de
       UDP), comme décrit dans la RFC 3828.

       UDP-Lite est une extension de UDP (RFC 768) pour prendre en charge  des  sommes  de  contrôle  de  taille
       variable.  Cela  a des avantages pour certains types de communication multimedia qui peuvent être capable
       d'utiliser des datagrammes légèrement abîmés, plutôt que de  les  ignorer  dans  les  couches  basses  du
       protocole.

       La  couverture  de  la somme de contrôle de taille variable se fait par un option setsockopt(2). Si cette
       option n'est pas positionnée, la seule différence avec UDP réside dans l'utilisation d'un identifiant  de
       protocole IP différent (numéro IANA 136).

       L'implémentation  UDP-Lite est une extension complète de udp(7), c'est-à-dire qu'elle partage la même API
       et le même comportement de l'API et offre en plus deux nouvelles options  de  socket  pour  contrôler  la
       couverture de la somme de contrôle.

   Format d'adresse
       UDP-Litev4  utilise  le  format  d'adresse  sockaddr_in  décrit  dans ip(7). UDP-Litev6 utilise le format
       d'adresse sockaddr_in6 décrit dans ipv6(7).

   Options de sockets
       Pour lire ou écrire une option de socket UDP-Lite, appeler getsockopt(2) pour la lecture ou setsockopt(2)
       pour l'écriture, avec l'argument niveau de socket valant IPPROTO_UDPLITE. De plus, la plupart des options
       de socket IPPROTO_UDP sont valables sur les sockets UDP-Lite. Pour plus de détails, consultez udp(7).

       Les deux opérations suivantes sont spécifiques à UDP-Lite.

       UDPLITE_SEND_CSCOV
              Cette option configure la couverture de la somme de  contrôle  pour  les  émissions  et  prend  un
              paramètre de type int, avec une couverture de somme de contrôle dans l'intervalle 0..2^16-1.

              Une valeur de 0 signifie que le datagramme en entier est couvert. Les valeurs de 1 à 7 ne sont pas
              autorisées (RFC 3828, 3.1) et sont remplacées par 8, la couverture minimale.

              Par rapport aux jumbogrammes IPv6 (RFC 2675), la couverture de la somme de contrôle UDP-Litev6 est
              limitée  aux  premier  2^16-1 octets,  comme d'après la RFC 3828, 3.5. Les valeurs les plus hautes
              sont donc tronquées à 2^16-1. En cas de doute, la valeur de couverture en cours peut toujours être
              demandée en utilisant getsockopt(2).

       UDPLITE_RECV_CSCOV
              Il s'agit de l'option analogue pour la réception. Elle utilise un paramètre au même format et avec
              le même intervalle que UDPLITE_SEND_CSCOV. Cette option n'est pas obligée  d'autoriser  le  trafic
              avec  une  couverture  de  somme de contrôle partielle. Son rôle est celui d'un filtre de trafic :
              lorsqu'elle est activée, elle indique au noyau d'ignorer tous les paquets dont la  couverture  est
              inférieure à celle indiquée dans la valeur de couverture.

              Quand  la  valeur  UDPLITE_RECV_CSCOV  dépasse  la  couverture  du  paquet en cours, le paquet est
              simplement ignoré, mais il peut générer un avertissement dans le journal système.

ERREURS

       Toutes les erreurs documentées pour  udp(7)  peuvent  être  renvoyées.  UDP-Lite  n'ajoute  pas  d'autres
       erreurs.

FICHIERS

       /proc/net/snmp - compteurs de statistiques de base UDP-Litev4.
       /proc/net/snmp6 - compteurs de statistiques de base UDP-Litev6.

VERSIONS

       UDP-Litev4/v6 est apparu dans Linux 2.6.20.

BOGUES

       Quand la prise en charge de la glibc n'est pas présente, les définitions suivantes sont nécessaires :

           #define IPPROTO_UDPLITE     136
           #define UDPLITE_SEND_CSCOV  10
           #define UDPLITE_RECV_CSCOV  11

VOIR AUSSI

       ip(7), ipv6(7), socket(7), udp(7)

       RFC 3828 pour le protocole « Lightweight User Datagram Protocol » (UDP-Lite).

       Documentation/networking/udplite.txt dans l'arborescence des sources du noyau Linux.

COLOPHON

       Cette page fait partie de la publication 3.65 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

       Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par
       l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>.

       Alain Portal <http://manpagesfr.free.fr/> (2008).

       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> ».

Linux                                            3 décembre 2008                                      UDPLITE(7)