perkamon - en to fr translation catalogue (77 entries)

note: type: TH
en: 2019-08-02
fr: 2 août 2019

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: msgrcv, msgsnd - System V message queue operations
fr: msgrcv, msgsnd - Opérations sur les files de messages System V

note: type: Plain text
en: The I<msgp> argument is a pointer to a caller-defined structure of the following general form:
fr: L'argument I<msgp> est un pointeur vers une structure définie par l'appelant de forme générale suivante\ :

note: type: Plain text
en: struct msgbuf {
        long mtype;       /* message type, must be E<gt> 0 */
        char mtext[1];    /* message data */
    };
fr: struct msgbuf {
        long mtype;       /* type de message, doit être E<gt> 0 */
        char mtext[1];    /* contenu du message */
    };

note: type: Plain text
en: The I<mtext> field is an array (or other structure) whose size is specified by I<msgsz>, a nonnegative integer value.  Messages of zero length (i.e., no I<mtext> field) are permitted.  The I<mtype> field must have a strictly positive integer value.  This value can be used by the receiving process for message selection (see the description of B<msgrcv>()  below).
fr: Le champ I<mtext> est un tableau ou autre structure de taille I<msgsz>, valeur entière positive ou nulle. Les message de taille nulle (sans champ I<mtext>) sont autorisés. Le membre I<mtype> doit avoir une valeur strictement positive qui puisse être utilisée par le processus lecteur pour la sélection de messages (voir la description de B<msgrcv> ci\(hydessous).

note: type: Plain text
en: The B<msgsnd>()  system call appends a copy of the message pointed to by I<msgp> to the message queue whose identifier is specified by I<msqid>.
fr: L'appel système B<msgsnd>() insère une copie du message pointé par l'argument I<msgp> dans la file dont l'identifiant est indiqué par la valeur de l'argument I<msqid>.

note: type: Plain text
en: If sufficient space is available in the queue, B<msgsnd>()  succeeds immediately.  The queue capacity is governed by the I<msg_qbytes> field in the associated data structure for the message queue.  During queue creation this field is initialized to B<MSGMNB> bytes, but this limit can be modified using B<msgctl>(2).  A message queue is considered to be full if either of the following conditions is true:
fr: S'il y a assez de place dans la file, B<msgsnd>() réussit immédiatement. La capacité de la file est régie par le champ I<msg_qbytes> de la structure associée à la file de messages. Durant la création de la file, ce champ est initialisé à B<MSGMNB> octets, mais cette limite peut être modifiée avec B<msgctl>(2). Une file de message est considérée pleine si une de ces conditions est remplie :

note: type: Plain text
en: Adding a new message to the queue would cause the total number of bytes in the queue to exceed the queue's maximum size (the I<msg_qbytes> field).
fr: Après l'ajout d'un message à la file, le nombre total d'octets dans la faille aurait dépassé la taille maximale de la file (champ I<msg_qbytes>).

note: type: Plain text
en: Adding another message to the queue would cause the total number of messages in the queue to exceed the queue's maximum size (the I<msg_qbytes> field).  This check is necessary to prevent an unlimited number of zero-length messages being placed on the queue.  Although such messages contain no data, they nevertheless consume (locked) kernel memory.
fr: Après l'ajout d'un message à la file, le nombre total de messages dans la faille aurait dépassé la taille maximale de la file (champ I<msg_qbytes>).Cette vérification permet d'éviter qu'un nombre illimité de messages de taille nulle soit ajouté à la file. Bien que tels messages ne contiennent pas de données, ils consomment néanmoins de la mémoire du noyau, sujette à verrou.

note: type: Plain text
en: If insufficient space is available in the queue, then the default behavior of B<msgsnd>()  is to block until space becomes available.  If B<IPC_NOWAIT> is specified in I<msgflg>, then the call instead fails with the error B<EAGAIN>.
fr: S'il n'y a pas assez de place, alors le comportement par défaut de B<msgsnd>() est de bloquer jusqu'à obtenir suffisamment d'espace. En indiquant B<IPC_NOWAIT> dans l'argument I<msgflg>, le message ne sera pas envoyé et l'appel système échouera en retournant B<EAGAIN> dans B<errno>.

note: type: Plain text
en: A blocked B<msgsnd>()  call may also fail if:
fr: Un appel à B<msgsnd>() bloqué peut échouer si\ :

note: type: Plain text
en: the queue is removed, in which case the system call fails with I<errno> set to B<EIDRM>; or
fr: la file est supprimée, auquel cas l'appel système échoue avec I<errno> valant B<EIDRM> ; ou

note: type: Plain text
en: a signal is caught, in which case the system call fails with I<errno> set to B<EINTR>;B<see> B<signal>(7).  (B<msgsnd>()  is never automatically restarted after being interrupted by a signal handler, regardless of the setting of the B<SA_RESTART> flag when establishing a signal handler.)
fr: un signal a été intercepté, auquel cas l'appel système échoue avec I<errno> valant B<EINTR> ; consultez B<signal>(7). (B<msgsnd>() n'est jamais relancé automatiquement après interruption par un gestionnaire de signal, quelle que soit la configuration de B<SA_RESTART> lors de l'installation du gestionnaire.)

note: type: Plain text
en: Upon successful completion the message queue data structure is updated as follows:
fr: Si l'appel système réussit, la structure décrivant la file de messages est mise à jour comme suit.

note: type: Plain text
en: I<msg_lspid> is set to the process ID of the calling process.
fr: I<msg_lspid> contient le PID du processus appelant.

note: type: Plain text
en: I<msg_qnum> is incremented by 1.
fr: I<msg_qnum> est incrémenté de 1.

note: type: Plain text
en: I<msg_stime> is set to the current time.
fr: I<msg_stime> est rempli avec l'heure actuelle.

note: type: Plain text
en: The B<msgrcv>()  system call removes a message from the queue specified by I<msqid> and places it in the buffer pointed to by I<msgp>.
fr: L'appel système B<msgrcv>() supprime un message depuis la file indiquée par I<msqid> et le place dans le tampon pointé par I<msgp>.

note: type: Plain text
en: The argument I<msgsz> specifies the maximum size in bytes for the member I<mtext> of the structure pointed to by the I<msgp> argument.  If the message text has length greater than I<msgsz>, then the behavior depends on whether B<MSG_NOERROR> is specified in I<msgflg>.  If B<MSG_NOERROR> is specified, then the message text will be truncated (and the truncated part will be lost); if B<MSG_NOERROR> is not specified, then the message isn't removed from the queue and the system call fails returning -1 with I<errno> set to B<E2BIG>.
fr: L'argument I<msgsz> indique la taille maximale en octets du membre I<mtext> de la structure pointée par l'argument I<msgp>. Si le contenu du message est plus long que I<msgsz> octets, le comportement dépend de la présence ou non de B<MSG_NOERROR> dans I<msgflg>. Si B<MSG_NOERROR> est spécifié, alors le message sera tronqué (et la partie tronquée sera perdue)\ ; si B<MSG_NOERROR> n'est pas spécifié, le message ne sera pas extrait de la file, et l'appel système échouera en renvoyant -1 et en indiquant B<E2BIG> dans B<errno>.

note: type: Plain text
en: Unless B<MSG_COPY> is specified in I<msgflg> (see below), the I<msgtyp> argument specifies the type of message requested, as follows:
fr: À moins que B<MSG_COPY> ne soit indiqué dans I<msgflg> (voir ci-dessous), l’argument I<msgtyp> indique le type de message désiré.

note: type: Plain text
en: If I<msgtyp> is 0, then the first message in the queue is read.
fr: Si I<msgtyp> vaut 0, le premier message est lu.

note: type: Plain text
en: If I<msgtyp> is greater than 0, then the first message in the queue of type I<msgtyp> is read, unless B<MSG_EXCEPT> was specified in I<msgflg>, in which case the first message in the queue of type not equal to I<msgtyp> will be read.
fr: Si I<msgtyp> est supérieur à 0, alors le premier message de type I<msgtyp> est extrait de la file. Si I<msgflg> contient B<MSG_EXCEPT> l'inverse est effectué, le premier message de type différent de I<msgtyp> est extrait de la file.

note: type: Plain text
en: If I<msgtyp> is less than 0, then the first message in the queue with the lowest type less than or equal to the absolute value of I<msgtyp> will be read.
fr: Si I<msgtyp> est inférieur à 0, le premier message de la file avec un type inférieur ou égal à la valeur absolue de I<msgtyp> est extrait.

note: type: Plain text
en: The I<msgflg> argument is a bit mask constructed by ORing together zero or more of the following flags:
fr: L'argument I<msgflg> est composé d'un I<OU> binaire «\ |\ » avec les attributs suivants.

note: type: Plain text
en: Return immediately if no message of the requested type is in the queue.  The system call fails with I<errno> set to B<ENOMSG>.
fr: S’arrêter immédiatement si aucun message du type désiré n'est présent dans la file. L'appel système échoue et I<errno> est configuré à B<ENOMSG>.

note: type: TP
en: B<MSG_COPY> (since Linux 3.8)
fr: B<MSG_COPY> (depuis Linux 3.8)

note: commit 4a674f34ba04a002244edaf891b5da7fc1473ae8 type: Plain text
en: Nondestructively fetch a copy of the message at the ordinal position in the queue specified by I<msgtyp> (messages are considered to be numbered starting at 0).
fr: Récupérer une copie de façon non destructive du message dans la file à la position ordinale indiquée par I<msgtyp> (les messages sont considérées numérotés à partir de 0).

note: type: Plain text
en: This flag must be specified in conjunction with B<IPC_NOWAIT>, with the result that, if there is no message available at the given position, the call fails immediately with the error B<ENOMSG>.  Because they alter the meaning of I<msgtyp> in orthogonal ways, B<MSG_COPY> and B<MSG_EXCEPT> may not both be specified in I<msgflg>.
fr: Cet attribut doit être indiqué en conjonction avec B<IPC_NOWAIT>, de telle sorte que si aucun message n’est disponible à la position donnée, l’appel échoue immédiatement avec l’erreur B<ENOMSG>. Parce qu'ils modifient le sens de I<msgtyp> de manière opposée, B<MSG_COPY> et B<MSG_EXCEPT> ne peuvent être définis simultanément dans I<msgflg>.

note: type: Plain text
en: The B<MSG_COPY> flag was added for the implementation of the kernel checkpoint-restore facility and is available only if the kernel was built with the B<CONFIG_CHECKPOINT_RESTORE> option.
fr: L'attribut B<MSG_COPY> a été ajouté pour l’implémentation de point de restauration du noyau et n’est disponible que si le noyau a été compilé avec l’option B<CONFIG_CHECKPOINT_RESTORE>.

note: type: Plain text
en: Used with I<msgtyp> greater than 0 to read the first message in the queue with message type that differs from I<msgtyp>.
fr: Utilisé avec I<msgtyp> supérieur à 0 pour lire les messages de type différent de I<msgtyp>.

note: type: Plain text
en: To truncate the message text if longer than I<msgsz> bytes.
fr: Tronquer silencieusement les messages plus longs que I<msgsz> octets.

note: type: Plain text
en: If no message of the requested type is available and B<IPC_NOWAIT> isn't specified in I<msgflg>, the calling process is blocked until one of the following conditions occurs:
fr: Si aucun message du type requis n'est disponible et si on n'a pas demandé B<IPC_NOWAIT> dans I<msgflg>, le processus appelant est bloqué jusqu'à l'occurrence d'un des événements suivants.

note: type: Plain text
en: A message of the desired type is placed in the queue.
fr: Un message du type désiré arrive dans la file.

note: type: Plain text
en: The message queue is removed from the system.  In this case, the system call fails with I<errno> set to B<EIDRM>.
fr: La file de messages est supprimée. L'appel système échoue et I<errno> contient B<EIDRM>.

note: type: Plain text
en: The calling process catches a signal.  In this case, the system call fails with I<errno> set to B<EINTR>.  (B<msgrcv>()  is never automatically restarted after being interrupted by a signal handler, regardless of the setting of the B<SA_RESTART> flag when establishing a signal handler.)
fr: Le processus appelant intercepte un signal. Dans ce cas l'appel système échoue avec I<errno> valant B<EINTR>. (B<msgrcv>() n'est jamais relancé automatiquement après interruption par un gestionnaire de signal, quelle que soit la configuration de B<SA_RESTART> lors de l'installation du gestionnaire.)

note: type: Plain text
en: I<msg_lrpid> is set to the process ID of the calling process.
fr: I<msg_lrpid> est rempli avec le PID du processus appelant.

note: type: Plain text
en: I<msg_qnum> is decremented by 1.
fr: I<msg_qnum> est décrémenté de 1.

note: type: Plain text
en: I<msg_rtime> is set to the current time.
fr: I<msg_rtime> est rempli avec l'heure actuelle.

note: type: SH
en: RETURN VALUE
fr: VALEUR DE RETOUR

note: type: Plain text
en: On failure both functions return -1 with I<errno> indicating the error, otherwise B<msgsnd>()  returns 0 and B<msgrcv>()  returns the number of bytes actually copied into the I<mtext> array.
fr: En cas d'échec les deux appels système renvoient -1 et I<errno> contient le code d'erreur. Sinon B<msgsnd>() renvoie 0 et B<msgrcv>() renvoie le nombre d'octets copiés dans la table I<mtext>.

note: type: SH
en: ERRORS
fr: ERREURS

note: type: Plain text
en: When B<msgsnd>()  fails, I<errno> will be set to one among the following values:
fr: En cas d'échec de B<msgsnd>(), I<errno> aura l'une des valeurs suivantes.

note: type: Plain text
en: The message can't be sent due to the I<msg_qbytes> limit for the queue and B<IPC_NOWAIT> was specified in I<msgflg>.
fr: Le message n'a pas pu être envoyé à cause de la limite I<msg_qbytes> pour la file et de la requête B<IPC_NOWAIT> dans I<msgflg>.

note: type: Plain text
en: The address pointed to by I<msgp> isn't accessible.
fr: I<msgp> pointe en dehors de l'espace d'adressage accessible.

note: type: Plain text
en: The message queue was removed.
fr: La file de messages a été supprimée.

note: type: Plain text
en: Sleeping on a full message queue condition, the process caught a signal.
fr: Un signal est arrivé avant d'avoir pu écrire quoi que ce soit.

note: type: Plain text
en: Invalid I<msqid> value, or nonpositive I<mtype> value, or invalid I<msgsz> value (less than 0 or greater than the system value B<MSGMAX>).
fr: I<msqid> est invalide, ou bien I<mtype> n'est pas positif, ou bien I<msgsz> est invalide (négatif ou supérieur à la valeur B<MSGMAX> du système).

note: type: Plain text
en: The system does not have enough memory to make a copy of the message pointed to by I<msgp>.
fr: Le système n'a pas assez de mémoire pour copier le message pointé par I<msgp>.

note: type: Plain text
en: When B<msgrcv>()  fails, I<errno> will be set to one among the following values:
fr: En cas d'échec de B<msgrcv>(), I<errno> prend l'une des valeurs suivantes.

note: type: Plain text
en: The message text length is greater than I<msgsz> and B<MSG_NOERROR> isn't specified in I<msgflg>.
fr: Le message est plus long que I<msgsz>, et B<MSG_NOERROR> n'a pas été indiqué dans I<msgflg>.

note: type: Plain text
en: While the process was sleeping to receive a message, the message queue was removed.
fr: La file de messages a été supprimée alors que le processus attendait un message.

note: type: Plain text
en: While the process was sleeping to receive a message, the process caught a signal; see B<signal>(7).
fr: Un signal est arrivé avant d'avoir pu lire quoi que ce soit ; consultez B<signal>(7).

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

note: type: Plain text
en: I<msgflg> specified B<MSG_COPY>, but not B<IPC_NOWAIT>.
fr: I<msgflg> définit B<MSG_COPY> sans définir B<IPC_NOWAIT>.

note: type: Plain text
en: I<msgflg> specified both B<MSG_COPY> and B<MSG_EXCEPT>.
fr: I<msgflg> définit à la fois B<MSG_COPY> et B<MSG_EXCEPT>.

note: type: Plain text
en: B<IPC_NOWAIT> was specified in I<msgflg> and no message of the requested type existed on the message queue.
fr: B<IPC_NOWAIT> a été indiqué dans I<msgflg> et aucun message du type réclamé n'existe dans la file.

note: type: Plain text
en: B<IPC_NOWAIT> and B<MSG_COPY> were specified in I<msgflg> and the queue contains less than I<msgtyp> messages.
fr: B<IPC_NOWAIT> et B<MSG_COPY> ont été indiqués dans I<msgflg> et la file contient moins de I<msgtyp> messages.

note: type: TP
en: B<ENOSYS> (since Linux 3.8)
fr: B<ENOSYS> (depuis Linux 3.8)

note: type: Plain text
en: I<MSG_COPY> was specified in I<msgflg>, and this kernel was configured without B<CONFIG_CHECKPOINT_RESTORE>.
fr: B<MSG_COPY> a été indiqué dans I<msgflg> et le noyau a été configuré sans B<CONFIG_CHECKPOINT_RESTORE>.

note: type: SH
en: CONFORMING TO
fr: CONFORMITÉ

note: MSG_COPY since glibc 2.18 type: Plain text
en: The B<MSG_EXCEPT> and B<MSG_COPY> flags are Linux-specific; their definitions can be obtained by defining the B<_GNU_SOURCE> feature test macro.
fr: Les attributs B<MSG_EXCEPT> et B<MSG_COPY> sont spécifiques à Linux. Leur définition peut être obtenue en définissant la macro de test de fonctionnalités B<_GNU_SOURCE>.

note: Like Linux, the FreeBSD man pages still document the inclusion of these header files. type: Plain text
en: The inclusion of I<E<lt>sys/types.hE<gt>> and I<E<lt>sys/ipc.hE<gt>> isn't required on Linux or by any version of POSIX.  However, some old implementations required the inclusion of these header files, and the SVID also documented their inclusion.  Applications intended to be portable to such old systems may need to include these header files.
fr: L'inclusion de I<E<lt>sys/types.hE<gt>> et I<E<lt>sys/ipc.hE<gt>> n'est pas nécessaire sous Linux et n'est exigée par aucune version de POSIX. Cependant, certaines implémentations anciennes nécessitent l'inclusion de ces fichiers d'en-tête, et le SVID documente aussi leur inclusion. Les applications ayant pour but d'être portables pourraient inclure ces fichiers d'en-tête.

note: type: Plain text
en: The I<msgp> argument is declared as I<struct msgbuf\ *> in glibc 2.0 and 2.1.  It is declared as I<void\ *> in glibc 2.2 and later, as required by SUSv2 and SUSv3.
fr: L'argument I<msgp> est déclaré comme un I<struct msgbuf *> avec les bibliothèques glibc 2.0 et glibc 2.1. Il est déclaré comme un I<void *> avec la bibliothèque glibc 2.2, suivant ainsi les spécifications SUSv2 et SUSv3.

note: type: Plain text
en: The following limits on message queue resources affect the B<msgsnd>()  call:
fr: Les limites suivantes concernent les files de messages et affectent l’appel B<msgsnd>().

note: type: Plain text
en: The implementation has no intrinsic system-wide limits on the number of message headers (B<MSGTQL>)  and the number of bytes in the message pool (B<MSGPOOL>).
fr: L'implémentation des files de messages sous Linux n'a pas de limites système intrinsèques ni pour le nombre d'en\(hytêtes de messages (B<MSGTQL>) ni pour la taille, en octets, de l'ensemble de tous les messages (B<MSGPOOL>).

note: type: SH
en: BUGS
fr: BOGUES

note: http://marc.info/?l=linux-kernel&m=139048542803605&w=2 commit 4f87dac386cc43d5525da7a939d4b4e7edbea22c type: Plain text
en: In Linux 3.13 and earlier, if B<msgrcv>()  was called with the B<MSG_COPY> flag, but without B<IPC_NOWAIT>, and the message queue contained less than I<msgtyp> messages, then the call would block until the next message is written to the queue.  At that point, the call would return a copy of the message, I<regardless> of whether that message was at the ordinal position I<msgtyp>.  This bug is fixed in Linux 3.14.
fr: Jusqu'à la version Linux 3.13, si B<msgrcv>() était appelé avec l’attribut B<MSG_COPY>, mais sans B<IPC_NOWAIT>, et que la file de messages contenait moins de B<msgtyp> messages, alors l’appel bloquait jusqu’à ce que le message suivant soit écrit dans la file. À ce moment là, l’appel renvoyait une copie du message, I<quelle que soit> la position ordinale I<msgtyp> de ce message. Ce bogue est corrigé depuis Linux 3.14.

note: http://marc.info/?l=linux-kernel&m=139048542803605&w=2 commit 4f87dac386cc43d5525da7a939d4b4e7edbea22c type: Plain text
en: Specifying both B<MSG_COPY> and B<MSC_EXCEPT> in I<msgflg> is a logical error (since these flags impose different interpretations on I<msgtyp>).  In Linux 3.13 and earlier, this error was not diagnosed by B<msgrcv>().  This bug is fixed in Linux 3.14.
fr: Indiquer à la fois B<MSG_COPY> et B<MSC_EXCEPT> dans I<msgflg> est une erreur de logique (puisque ces attributs imposent des interprétations différentes de I<msgtyp>). Jusqu'à Linux 3.13, cette erreur n’était pas diagnostiquée par I<msgsrv>(). Ce bogue est corrigé depuis Linux 3.14.

note: type: SH
en: EXAMPLE
fr: EXEMPLE

note: type: SS
en: Program source
fr: Source du programme

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

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: TH
en: 2019-03-06
fr: 6 mars 2019

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