perkamon - en to fr translation catalogue (65 entries)

note: type: TH
en: 2017-09-15
fr: 15 septembre 2017

note: type: TH
en: Linux Programmer's Manual
fr: Manuel du programmeur Linux

note: type: SH
en: NAME
fr: NOM

note: type: Plain text
en: packet - packet interface on device level
fr: packet - Interface par paquet au niveau du périphérique

note: type: Plain text
en: B<packet_socket = socket(AF_PACKET, int >I<socket_type>B<, int >I<protocol>B<);>
fr: B<packet_socket = socket(AF_PACKET, int >I<type_socket>B<, int >I<protocole>B<);>

note: type: Plain text
en: Packet sockets are used to receive or send raw packets at the device driver (OSI Layer 2) level.  They allow the user to implement protocol modules in user space on top of the physical layer.
fr: Les sockets paquet sont utilisées pour envoyer ou recevoir des paquets de données bruts au pilote de périphérique (couche 2 OSI). Elles permettent d'implémenter des modules protocoles dans l'espace utilisateur au dessus de la couche physique.

note: type: Plain text
en: The B<connect>(2)  operation is not supported on packet sockets.
fr: L'opération B<connect>(2) n'est pas prise en charge avec les sockets paquet.

note: type: SS
en: Address types
fr: Types d’adresses

note: type: SS
en: Socket options
fr: Options de sockets

note: type: Plain text
en: Packet socket options are configured by calling B<setsockopt>(2)  with level B<SOL_PACKET>.
fr: Les options de la socket paquet sont configurées en appelant B<setsockopt>(2) avec le niveau B<SOL_PACKET>.

note: type: Plain text
en: In addition, the traditional ioctls B<SIOCSIFFLAGS>, B<SIOCADDMULTI>, B<SIOCDELMULTI> can be used for the same purpose.
fr: De plus, les ioctls classiques B<SIOCSIFFLAGS>, B<SIOCADDMULTI> et B<SIOCDELMULTI> peuvent donner les mêmes résultats.

note: type: TP
en: B<PACKET_AUXDATA> (since Linux 2.6.21)
fr: B<PACKET_AUXDATA> (depuis Linux 2.6.21)

note: commit 8dc4194474159660d7f37c495e3fc3f10d0db8cc type: Plain text
en: If this binary option is enabled, the packet socket passes a metadata structure along with each packet in the B<recvmsg>(2)  control field.  The structure can be read with B<cmsg>(3).  It is defined as
fr: Si cette option est activée, la socket paquet fournit avec chaque paquet une structure de métadonnées à l’aide du champ de contrôle de B<recvmsg>(2). La structure peut être lue avec B<cmsg>(3). Elle est définie ci-dessous :

note: type: Plain text
en: struct tpacket_auxdata {
        __u32 tp_status;
        __u32 tp_len;      /* packet length */
        __u32 tp_snaplen;  /* captured length */
        __u16 tp_mac;
        __u16 tp_net;
        __u16 tp_vlan_tci;
        __u16 tp_padding;
    };
fr: struct tpacket_auxdata {
        __u32 tp_status;
        __u32 tp_len;      /* longueur du paquet */
        __u32 tp_snaplen;  /* longueur capturée */
        __u16 tp_mac;
        __u16 tp_net;
        __u16 tp_vlan_tci;
        __u16 tp_padding;
    };

note: type: TP
en: B<PACKET_FANOUT> (since Linux 3.1)
fr: B<PACKET_FANOUT> (depuis Linux 3.1)

note: commit dc99f600698dcac69b8f56dda9a8a00d645c5ffc type: Plain text
en: To scale processing across threads, packet sockets can form a fanout group.  In this mode, each matching packet is enqueued onto only one socket in the group.  A socket joins a fanout group by calling B<setsockopt>(2)  with level B<SOL_PACKET> and option B<PACKET_FANOUT>.  Each network namespace can have up to 65536 independent groups.  A socket selects a group by encoding the ID in the first 16 bits of the integer option value.  The first packet socket to join a group implicitly creates it.  To successfully join an existing group, subsequent packet sockets must have the same protocol, device settings, fanout mode and flags (see below).  Packet sockets can leave a fanout group only by closing the socket.  The group is deleted when the last socket is closed.
fr: Pour s’adapter aux nombre de traitements des threads, les sockets paquet peuvent former un groupe de déploiement. Dans ce mode, tous les paquets correspondants sont mis en attente dans une seule socket du groupe. Une socket rejoint un groupe de déploiement en appelant B<setsockopt>(2) avec le niveau B<SOL_PACKET> et l’option B<PACKET_FANOUT>. Tous les espaces de noms réseau peuvent avoir jusqu’à 65536 groupes indépendants. Une socket sélectionne un groupe en encodant l’identifiant dans les 16 premiers bits du paramètre entier de cette option. La première socket paquet à rejoindre un groupe le crée implicitement. Pour réussir à rejoindre un groupe existant, les sockets paquet suivantes doivent avoir les mêmes protocole, configurations de périphérique, mode de déploiement et attributs (voir ci-dessous). Les sockets paquet ne peuvent quitter un groupe de déploiement qu’en fermant la socket. Le groupe est supprimé quand la dernière socket est fermée.

note: type: TP
en: B<PACKET_LOSS> (with B<PACKET_TX_RING>)
fr: B<PACKET_LOSS> (avec B<PACKET_TX_RING>)

note: type: Plain text
en: When a malformed packet is encountered on a transmit ring, the default is to reset its I<tp_status> to B<TP_STATUS_WRONG_FORMAT> and abort the transmission immediately.  The malformed packet blocks itself and subsequently enqueued packets from being sent.  The format error must be fixed, the associated I<tp_status> reset to B<TP_STATUS_SEND_REQUEST>, and the transmission process restarted via B<send>(2).  However, if B<PACKET_LOSS> is set, any malformed packet will be skipped, its I<tp_status> reset to B<TP_STATUS_AVAILABLE>, and the transmission process continued.
fr: Lorsqu'un paquet malformé est trouvé dans le tampon circulaire de transmission, le comportement par défaut est de réinitialiser son I<tp_status> à B<TP_STATUS_WRONG_FORMAT> et d'abandonner immédiatement la transmission. Le paquet malformé ainsi que les paquets suivants mis en file d'attente voient leur transmission bloquée. L'erreur de format doit être corrigée, la valeur I<tp_status> associée doit être réinitialisée à B<TP_STATUS_SEND_REQUEST> et le processus de transmission redémarré par l'intermédiaire de l'interface B<send>(2). Cependant, si B<PACKET_LOSS> est défini, tout paquet malformé est ignoré, son I<tp_status> est réinitialisé à B<TP_STATUS_AVAILABLE> et le processus de transmission continue.

note: type: TP
en: B<PACKET_RESERVE> (with B<PACKET_RX_RING>)
fr: B<PACKET_RESERVE> (avec B<PACKET_RX_RING>)

note: type: Plain text
en: By default, a packet receive ring writes packets immediately following the metadata structure and alignment padding.  This integer option reserves additional headroom.
fr: Par défaut, un tampon circulaire de réception des paquets écrit les paquets juste après la structure de métadonnées et le bourrage dû à l'alignement. Le paramètre entier de cette option réserve de la place au début du paquet (« headroom »).

note: type: Plain text
en: Retrieve packet socket statistics in the form of a structure
fr: Récupérer les statistiques de la socket paquet sous la forme d'une structure

note: type: Plain text
en: struct tpacket_stats {
        unsigned int tp_packets;  /* Total packet count */
        unsigned int tp_drops;    /* Dropped packet count */
    };
fr: struct tpacket_stats {
        unsigned int tp_packets;  /* Décompte total des paquets */
        unsigned int tp_drops;    /* Décompte des paquets jetés */
    };

note: type: Plain text
en: Receiving statistics resets the internal counters.  The statistics structure differs when using a ring of variant B<TPACKET_V3>.
fr: Recevoir les statistiques réinitialise les compteurs internes. La structure de statistiques est différente lorsque le tampon circulaire utilisé est de type B<TPACKET_V3>.

note: type: TP
en: B<PACKET_TIMESTAMP> (with B<PACKET_RX_RING>; since Linux 2.6.36)
fr: B<PACKET_TIMESTAMP> (avec B<PACKET_RX_RING> ; depuis Linux 2.6.36)

note: commit 614f60fa9d73a9e8fdff3df83381907fea7c5649 type: Plain text
en: The packet receive ring always stores a timestamp in the metadata header.  By default, this is a software generated timestamp generated when the packet is copied into the ring.  This integer option selects the type of timestamp.  Besides the default, it support the two hardware formats described in I<Documentation/networking/timestamping.txt> in the Linux kernel source tree.
fr: Le tampon circulaire de réception des paquets stocke un horodatage dans l’en-tête de métadonnées. Par défaut, c’est un horodatage logiciel généré quand le paquet est copié dans le tampon circulaire. Le paramètre entier de cette option sélectionne le type d’horodatage. En plus du fonctionnement par défaut, deux formats matériels existent et sont décrits dans I<Documentation/networking/timestamping.txt> dans l'arborescence des sources du noyau Linux.

note: type: TP
en: B<PACKET_TX_RING> (since Linux 2.6.31)
fr: B<PACKET_TX_RING> (depuis Linux 2.6.31)

note: commit 69e3c75f4d541a6eb151b3ef91f34033cb3ad6e1 type: Plain text
en: Create a memory-mapped ring buffer for packet transmission.  This option is similar to B<PACKET_RX_RING> and takes the same arguments.  The application writes packets into slots with I<tp_status> equal to B<TP_STATUS_AVAILABLE> and schedules them for transmission by changing I<tp_status> to B<TP_STATUS_SEND_REQUEST>.  When packets are ready to be transmitted, the application calls B<send>(2)  or a variant thereof.  The I<buf> and I<len> fields of this call are ignored.  If an address is passed using B<sendto>(2)  or B<sendmsg>(2), then that overrides the socket default.  On successful transmission, the socket resets I<tp_status> to B<TP_STATUS_AVAILABLE>.  It immediately aborts the transmission on error unless B<PACKET_LOSS> is set.
fr: Créer un tampon circulaire projeté en mémoire pour la transmission de paquets. Cette option est similaire à B<PACKET_RX_RING> et accepte les mêmes arguments. L’application écrit des paquets dans des emplacements avec I<tp_status> égal à B<TP_STATUS_AVAILABLE> et les programme pour transmission en modifiant I<tp_status> à la valeur B<TP_STATUS_SEND_REQUEST>. Quand les paquets sont prêts à être transmis, l’application appelle B<send>(2) ou une de ses variantes. Les champs I<buf> et I<len> de cet appel sont ignorés. Si une adresse est passée en utilisant B<sendto>(2) ou B<sendmsg>(2), alors cela écrase la socket par défaut. En cas de transmission réussie, la socket réinitialise I<tp_status> à B<TP_STATUS_AVAILABLE>. Elle interrompt immédiatement la transmission en cas d’erreur sauf si B<PACKET_LOSS> est définie.

note: type: TP
en: B<PACKET_VERSION> (with B<PACKET_RX_RING>; since Linux 2.6.27)
fr: B<PACKET_VERSION> (avec B<PACKET_RX_RING> ; depuis Linux 2.6.27)

note: commit bbd6ef87c544d88c30e4b762b1b61ef267a7d279 type: Plain text
en: By default, B<PACKET_RX_RING> creates a packet receive ring of variant B<TPACKET_V1>.  To create another variant, configure the desired variant by setting this integer option before creating the ring.
fr: Par défaut, B<PACKET_RX_RING> crée un tampon circulaire de réception des paquets de variante B<TPACKET_V1>. Pour créer une autre variante, configurer la variante voulue en définissant le paramètre entier de cette option avant de créer le tampon circulaire.

note: type: TP
en: B<PACKET_QDISC_BYPASS> (since Linux 3.14)
fr: B<PACKET_QDISC_BYPASS> (depuis Linux 3.14)

note: commit d346a3fae3ff1d99f5d0c819bf86edf9094a26a1 type: Plain text
en: By default, packets sent through packet sockets pass through the kernel's qdisc (traffic control) layer, which is fine for the vast majority of use cases.  For traffic generator appliances using packet sockets that intend to brute-force flood the network\(emfor example, to test devices under load in a similar fashion to pktgen\(emthis layer can be bypassed by setting this integer option to 1.  A side effect is that packet buffering in the qdisc layer is avoided, which will lead to increased drops when network device transmit queues are busy; therefore, use at your own risk.
fr: Par défaut, les paquets envoyés par une socket paquet passent par la couche qdisc du noyau, dédiée au contrôle de trafic, ce qui répond bien à la majorité des cas d'utilisation. Les équipements de génération de trafic qui utilisent des sockets packet pour inonder le réseau — par exemple pour tester des appareils en charge comme le fait pktgen — peuvent désactiver cette couche de contrôle en définissant cette option à 1. Un des effets secondaires est l'absence de mise en mémoire tampon des paquets par la couche qdisc, ce qui peut provoquer des pertes de paquets lorsque les files de transmission du périphérique sont pleines. L'utilisation de cette option est à vos risques et périls.

note: FIXME Document SIOCGSTAMPNS type: Plain text
en: B<SIOCGSTAMP> can be used to receive the timestamp of the last received packet.  Argument is a I<struct timeval> variable.
fr: B<SIOCGSTAMP> peut servir à obtenir l'horodatage du dernier paquet reçu. Le paramètre est une variable I<struct timeval>.

note: type: Plain text
en: In addition, all standard ioctls defined in B<netdevice>(7)  and B<socket>(7)  are valid on packet sockets.
fr: De plus, les ioctls standards définis dans B<netdevice>(7) et B<socket>(7) sont valables sur les sockets paquet.

note: type: SS
en: Error handling
fr: Traitement des erreurs

note: type: Plain text
en: Packet sockets do no error handling other than errors occurred while passing the packet to the device driver.  They don't have the concept of a pending error.
fr: Les sockets paquet ne gèrent pas d'autres erreurs que celles se produisant durant la transmission des paquets au pilote de périphérique. Elles ne traitent pas le concept de file d'erreurs.

note: type: SH
en: ERRORS
fr: ERREURS

note: type: Plain text
en: Unknown multicast group address passed.
fr: Adresse de groupe multicast inconnue.

note: type: Plain text
en: User passed invalid memory address.
fr: Adresse mémoire incorrecte.

note: type: Plain text
en: Invalid argument.
fr: Argument incorrect.

note: type: Plain text
en: Packet is bigger than interface MTU.
fr: Le paquet est plus grand que le MTU de l'interface.

note: type: Plain text
en: Interface is not up.
fr: L'interface n'est pas active.

note: type: Plain text
en: Not enough memory to allocate the packet.
fr: Pas assez de mémoire pour le paquet.

note: type: Plain text
en: Unknown device name or interface index specified in interface address.
fr: Le nom du périphérique ou l'index d’interface indiqué dans l'adresse de l'interface est inconnu.

note: type: Plain text
en: No packet received.
fr: Pas de paquet reçu.

note: type: Plain text
en: No interface address passed.
fr: Aucune adresse d'interface n'a été passée.

note: type: Plain text
en: Interface address contained an invalid interface index.
fr: Numéro d'interface non valable.

note: type: Plain text
en: User has insufficient privileges to carry out this operation.
fr: L'utilisateur n'a pas les privilèges nécessaires pour l'opération.

note: type: Plain text
en: In addition, other errors may be generated by the low-level driver.
fr: De plus, d'autres erreurs peuvent être engendrées par le pilote bas niveau.

note: type: Plain text
en: B<AF_PACKET> is a new feature in Linux 2.2.  Earlier Linux versions supported only B<SOCK_PACKET>.
fr: B<AF_PACKET> est une nouveauté de Linux 2.2. Les versions précédentes de Linux ne prenaient en charge que B<SOCK_PACKET>.

note: type: Plain text
en: For portable programs it is suggested to use B<AF_PACKET> via B<pcap>(3); although this covers only a subset of the B<AF_PACKET> features.
fr: Pour la portabilité, il est conseillé d'utiliser les fonctionnalités B<AF_PACKET> par l'intermédiaire de l'interface B<pcap>(3), bien que cela ne couvre qu'un sous-ensembles des possibilités de B<AF_PACKET>.

note: type: Plain text
en: The B<SOCK_DGRAM> packet sockets make no attempt to create or parse the IEEE 802.2 LLC header for a IEEE 802.3 frame.  When B<ETH_P_802_3> is specified as protocol for sending the kernel creates the 802.3 frame and fills out the length field; the user has to supply the LLC header to get a fully conforming packet.  Incoming 802.3 packets are not multiplexed on the DSAP/SSAP protocol fields; instead they are supplied to the user as protocol B<ETH_P_802_2> with the LLC header prefixed.  It is thus not possible to bind to B<ETH_P_802_3>; bind to B<ETH_P_802_2> instead and do the protocol multiplex yourself.  The default for sending is the standard Ethernet DIX encapsulation with the protocol filled in.
fr: Les sockets paquet B<SOCK_DGRAM> n'essayent pas de créer ou de traiter les en-têtes IEEE 802.2 LLC pour une trame IEEE 802.3. Lorsque le protocole B<ETH_P_802_3> est indiqué en émission, le noyau crée la trame 802.3 et remplit le champ de longueur. L'utilisateur doit fournir l'en-tête LLC pour obtenir un paquet entièrement conforme. Les paquets 802.3 entrants ne sont pas multiplexés sur les champs du protocole DSAP/SSAP. À la place, ils sont fournis à l'utilisateur sous le protocole B<ETH_P_802_2> avec un en-tête LLC ajouté. L’attachement B<ETH_P_802_3> n’est donc pas possible, l'attachement B<ETH_P_802_2> doit être utilisé à la place, et vous devez réaliser le multiplexage de protocole vous-même. Le comportement par défaut en émission est l'encapsulation Ethernet DIX standard, avec le protocole renseigné.

note: type: Plain text
en: Packet sockets are not subject to the input or output firewall chains.
fr: Les sockets paquet ne sont pas soumises aux chaînes de pare-feu en entrée ou sortie.

note: type: SS
en: Compatibility
fr: Compatibilité

note: type: Plain text
en: I<spkt_family> contains the device type, I<spkt_protocol> is the IEEE 802.3 protocol type as defined in I<E<lt>sys/if_ether.hE<gt>> and I<spkt_device> is the device name as a null-terminated string, for example, eth0.
fr: I<spkt_family> contient le type de périphérique, I<spkt_protocol> est le type de protocole IEEE 802.3 comme défini dans I<E<lt>sys/if_ether.hE<gt>> et I<spkt_device> est le nom du périphérique sous forme de chaîne terminée par un caractère nul, par exemple eth0.

note: type: Plain text
en: This structure is obsolete and should not be used in new code.
fr: Cette structure est obsolète et ne doit pas être employée dans des nouveaux programmes.

note: type: SH
en: BUGS
fr: BOGUES

note: type: Plain text
en: The IEEE 802.2/803.3 LLC handling could be considered as a bug.
fr: La gestion des en-têtes LLC IEEE 802.2/802.3 devrait être considérée comme un bogue.

note: type: Plain text
en: Socket filters are not documented.
fr: Les filtres des sockets ne sont pas documentés.

note: .SH CREDITS This man page was written by Andi Kleen with help from Matthew Wilcox. AF_PACKET in Linux 2.2 was implemented by Alexey Kuznetsov, based on code by Alan Cox and others. type: Plain text
en: The B<MSG_TRUNC> B<recvmsg>(2)  extension is an ugly hack and should be replaced by a control message.  There is currently no way to get the original destination address of packets via B<SOCK_DGRAM>.
fr: L'extension B<MSG_TRUNC> de B<recvmsg>(2) est une bidouille horrible et devrait être remplacée par un message de commande. Il n'y a actuellement aucun moyen d'obtenir l'adresse de destination originale des paquets à l’aide de B<SOCK_DGRAM>.

note: type: SH
en: SEE ALSO
fr: VOIR AUSSI

note: type: Plain text
en: RFC\ 894 for the standard IP Ethernet encapsulation.  RFC\ 1700 for the IEEE 802.3 IP encapsulation.
fr: RFC\ 894 pour l'encapsulation IP Ethernet standard. RFC\ 1700 pour l'encapsulation IP IEEE 802.3.

note: type: Plain text
en: The Linux kernel source tree.  I</Documentation/networking/filter.txt> describes how to apply Berkeley Packet Filters to packet sockets.  I</tools/testing/selftests/net/psock_tpacket.c> contains example source code for all available versions of B<PACKET_RX_RING> and B<PACKET_TX_RING>.
fr: L'arbre des sources du noyau Linux. I</Documentation/networking/filter.txt> décrit comment appliquer des filtres Berkeley de paquets aux sockets paquet. I</tools/testing/selftests/net/psock_tpacket.c> contient un exemple de code source pour toutes les versions de B<PACKET_RX_RING> et B<PACKET_TX_RING>.

note: type: Plain text
en: This page is part of release 5.03 of the Linux I<man-pages> project.  A description of the project, information about reporting bugs, and the latest version of this page, can be found at \%https://www.kernel.org/doc/man-pages/.
fr: Cette page fait partie de la publication 5.03 du projet I<man-pages> Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse \%https://www.kernel.org/doc/man-pages/.

note: type: Plain text
en: This page is part of release 5.02 of the Linux I<man-pages> project.  A description of the project, information about reporting bugs, and the latest version of this page, can be found at \%https://www.kernel.org/doc/man-pages/.
fr: Cette page fait partie de la publication 5.02 du projet I<man-pages> Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse \%https://www.kernel.org/doc/man-pages/.

note: type: Plain text
en: This page is part of release 5.01 of the Linux I<man-pages> project.  A description of the project, information about reporting bugs, and the latest version of this page, can be found at \%https://www.kernel.org/doc/man-pages/.
fr: Cette page fait partie de la publication 5.01 du projet I<man-pages> Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse \%https://www.kernel.org/doc/man-pages/.
