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