perkamon - en to fr translation catalogue (39 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: msgctl - System V message control operations
fr: msgctl - Contrôler les messages System V

note: type: Plain text
en: B<msgctl>()  performs the control operation specified by I<cmd> on the System\ V message queue with identifier I<msqid>.
fr: Cette fonction permet d'effectuer l'opération indiquée par I<cmd> sur la file de messages System V ayant l'identifiant I<msqid>.

note: type: Plain text
en: The I<msqid_ds> data structure is defined in I<E<lt>sys/msg.hE<gt>> as follows:
fr: La structure I<msqid_ds> est déclarée dans I<E<lt>sys/msg.hE<gt>> comme suit\ :

note: type: Plain text
en: struct msqid_ds {
        struct ipc_perm msg_perm;     /* Ownership and permissions */
        time_t          msg_stime;    /* Time of last msgsnd(2) */
        time_t          msg_rtime;    /* Time of last msgrcv(2) */
        time_t          msg_ctime;    /* Time of last change */
        unsigned long   __msg_cbytes; /* Current number of bytes in
                                         queue (nonstandard) */
        msgqnum_t       msg_qnum;     /* Current number of messages
                                         in queue */
        msglen_t        msg_qbytes;   /* Maximum number of bytes
                                         allowed in queue */
        pid_t           msg_lspid;    /* PID of last msgsnd(2) */
        pid_t           msg_lrpid;    /* PID of last msgrcv(2) */
    };
fr: struct msqid_ds {
        struct ipc_perm msg_perm;     /* Propriétaire et permissions */
        time_t          msg_stime;    /* Heure du dernier msgsnd(2) */
        time_t          msg_rtime;    /* Heure du dernier msgrcv(2) */
        time_t          msg_ctime;    /* Heure dernière modification */
        unsigned long   __msg_cbytes; /* Nombre actuel d'octets dans la
                                         file (non standard) */
        msgqnum_t       msg_qnum;     /* Nombre actuel de messages 
                                         dans la file */
        msglen_t        msg_qbytes;   /* Nombre maximal d'octets 
                                         autorisés dans la file */
        pid_t           msg_lspid;    /* PID du dernier msgsnd(2) */
        pid_t           msg_lrpid;    /* PID du dernier msgrcv(2) */
    };

note: type: Plain text
en: The I<ipc_perm> structure is defined as follows (the highlighted fields are settable using B<IPC_SET>):
fr: La structure I<ipc_perm> est définie de la façon suivante (les champs en gras peuvent être modifiés en utilisant B<IPC_SET>) :

note: type: Plain text
en: struct ipc_perm {
        key_t          __key;       /* Key supplied to msgget(2) */
        uid_t          B<uid>;         /* Effective UID of owner */
        gid_t          B<gid>;         /* Effective GID of owner */
        uid_t          cuid;        /* Effective UID of creator */
        gid_t          cgid;        /* Effective GID of creator */
        unsigned short B<mode>;        /* Permissions */
        unsigned short __seq;       /* Sequence number */
    };
fr: struct ipc_perm {
        key_t          __key;       /* Clé fournie à msgget(2) */
        uid_t          B<uid>;         /* UID effectif du propriétaire */
        gid_t          B<gid>;         /* GID effectif du propriétaire */
        uid_t          cuid;        /* UID effectif du créateur */
        gid_t          cgid;        /* GID effectif du créateur */
        unsigned short B<mode>;        /* Permissions */
        unsigned short __seq;       /* Numéro de séquence */
    };

note: type: Plain text
en: Valid values for I<cmd> are:
fr: Les valeurs autorisées pour I<cmd> sont\ :

note: type: Plain text
en: Copy information from the kernel data structure associated with I<msqid> into the I<msqid_ds> structure pointed to by I<buf>.  The caller must have read permission on the message queue.
fr: Copier les informations depuis la structure représentant la file de messages identifiée par I<msqid> dans la structure I<msqid_ds> pointée par I<buf>. L'appelant doit avoir des privilèges d'accès en lecture sur la file de messages.

note: type: Plain text
en: Write the values of some members of the I<msqid_ds> structure pointed to by I<buf> to the kernel data structure associated with this message queue, updating also its I<msg_ctime> member.  The following members of the structure are updated: I<msg_qbytes>, I<msg_perm.uid>, I<msg_perm.gid>, and (the least significant 9 bits of)  I<msg_perm.mode>.  The effective UID of the calling process must match the owner (I<msg_perm.uid>)  or creator (I<msg_perm.cuid>)  of the message queue, or the caller must be privileged.  Appropriate privilege (Linux: the B<CAP_SYS_RESOURCE> capability) is required to raise the I<msg_qbytes> value beyond the system parameter B<MSGMNB>.
fr: Écrire la valeur de certains champs de la structure I<msqid_ds> pointée par I<buf> dans la structure du noyau représentant la file de messages, en mettant à jour le champ I<msg_ctime>. Les champs suivants de la structure peuvent être mis à jour\ : I<msg_qbytes>, I<msg_perm.uid>, I<msg_perm.gid> et les 9 bits de poids faible de I<msg_perm.mode>. L'UID effectif du processus appelant doit être soit celui du propriétaire (I<msg_perm.uid>), soit celui du créateur (I<msg_perm.cuid>) de la file de messages, ou bien l'appelant doit être privilégié. Des privilèges particuliers (sous Linux, la capacité B<CAP_SYS_RESOURCE>) sont nécessaires pour augmenter la valeur de I<msg_qbytes> au\(hydessus de la constante système B<MSGMNB>.

note: type: Plain text
en: Immediately remove the message queue, awakening all waiting reader and writer processes (with an error return and I<errno> set to B<EIDRM>).  The calling process must have appropriate privileges or its effective user ID must be either that of the creator or owner of the message queue.  The third argument to B<msgctl>()  is ignored in this case.
fr: Effacer immédiatement la file de messages et ses structures de données, en réveillant tous les processus écrivains et lecteurs en attente. Ils obtiendront un code d'erreur, et I<errno> aura la valeur B<EIDRM>. L'UID effectif du processus appelant doit être celui du créateur ou du propriétaire de la file de messages, ou bien le processus appelant doit être privilégié. Le troisième argument de B<msgctl>() est dans ce cas ignoré.

note: type: TP
en: B<IPC_INFO> (Linux-specific)
fr: B<IPC_INFO> (spécifique à Linux)

note: type: Plain text
en: Return information about system-wide message queue limits and parameters in the structure pointed to by I<buf>.  This structure is of type I<msginfo> (thus, a cast is required), defined in I<E<lt>sys/msg.hE<gt>> if the B<_GNU_SOURCE> feature test macro is defined:
fr: Renvoyer des informations sur les limites et paramètres du système relatifs aux files de messages dans la structure pointée par I<buf>. Cette structure est de type I<msginfo> (ce qui nécessite un transtypage), qui est défini dans I<E<lt>sys/msg.hE<gt>> si la macro de test de fonctionnalités B<_GNU_SOURCE> est définie :

note: type: Plain text
en: struct msginfo {
        int msgpool; /* Size in kibibytes of buffer pool
                        used to hold message data;
                        unused within kernel */
        int msgmap;  /* Maximum number of entries in message
                        map; unused within kernel */
        int msgmax;  /* Maximum number of bytes that can be
                        written in a single message */
        int msgmnb;  /* Maximum number of bytes that can be
                        written to queue; used to initialize
                        msg_qbytes during queue creation
                        (msgget(2)) */
        int msgmni;  /* Maximum number of message queues */
        int msgssz;  /* Message segment size;
                        unused within kernel */
        int msgtql;  /* Maximum number of messages on all queues
                        in system; unused within kernel */
        unsigned short int msgseg;
                     /* Maximum number of segments;
                        unused within kernel */
    };
fr: struct msginfo {
        int msgpool; /* Taille en kibioctets du tampon utilisé
                        pour stocker les données des messages\ ;
                        pas utilisé par le noyau */
        int msgmap;  /* Nombre maximal d'entrées dans la table 
                        des messages\ ; pas utilisé par le noyau */
        int msgmax;  /* Nombre maximal d'octets pouvant être
                        écrits dans un seul message */
        int msgmnb;  /* Nombre maximal d'octets pouvant être 
                        écrits dans une file ; utilisé pour
                        initialiser msg_qbytes lors de la
                        création de la file (msgget(2)) */
        int msgmni;  /* Nombre maximal de files de message */
        int msgssz;  /* Taille du segment de message\ ;
                        pas utilisé par le noyau */
        int msgtql;  /* Nombre maximal de messages dans
                        toutes les files du système ;
                        pas utilisé par le noyau */
        unsigned short int msgseg;
                     /* Nombre maximal de segments\ ;
                        pas utilisé par le noyau */
    };

note: type: Plain text
en: The I<msgmni>, I<msgmax>, and I<msgmnb> settings can be changed via I</proc> files of the same name; see B<proc>(5)  for details.
fr: Les paramètres I<msgmni>, I<msgmax> et I<msgmnb> peuvent être modifiés via les fichiers du même nom dans I</proc>. Consultez B<proc>(5) pour plus de détails.

note: type: TP
en: B<MSG_INFO> (Linux-specific)
fr: B<MSG_INFO> (Spécifique à Linux)

note: type: Plain text
en: Return a I<msginfo> structure containing the same information as for B<IPC_INFO>, except that the following fields are returned with information about system resources consumed by message queues: the I<msgpool> field returns the number of message queues that currently exist on the system; the I<msgmap> field returns the total number of messages in all queues on the system; and the I<msgtql> field returns the total number of bytes in all messages in all queues on the system.
fr: Renvoyer une structure I<msginfo> contenant les mêmes informations que pour B<IPC_INFO>, sauf que les champs suivants contiennent des informations sur les ressources système utilisées par des files de messages\ : le champ I<msgpool> indique le nombre de files de messages existant actuellement sur le système\ ; le champ I<msgmap> contient le nombre total de messages dans l'ensemble des files du système\ ; enfin le champ I<msgtql> contient le nombre total d'octets dans tous les messages de toutes les files du système.

note: type: TP
en: B<MSG_STAT> (Linux-specific)
fr: B<MSG_STAT> (Spécifique à Linux)

note: type: Plain text
en: Return a I<msqid_ds> structure as for B<IPC_STAT>.  However, the I<msqid> argument is not a queue identifier, but instead an index into the kernel's internal array that maintains information about all message queues on the system.
fr: Renvoyer une structure I<msqid_ds> comme pour B<IPC_STAT>. Cependant, l'argument I<msqid> n'est pas l'identifiant d'une file, mais un indice dans le tableau interne au noyau qui contient des informations sur toutes les files de messages du système.

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

note: type: Plain text
en: On error, -1 is returned with I<errno> indicating the error.
fr: En cas d'erreur -1 est renvoyé, et I<errno> contient le code d'erreur.

note: type: SH
en: ERRORS
fr: ERREURS

note: type: Plain text
en: On failure, I<errno> is set to one of the following:
fr: En cas d'erreur, I<errno> prend l'une des valeurs suivantes\ :

note: type: Plain text
en: The argument I<cmd> has the value B<IPC_SET> or B<IPC_STAT>, but the address pointed to by I<buf> isn't accessible.
fr: L'argument I<cmd> réclame l'opération B<IPC_SET> ou B<IPC_STAT> mais I<buf> 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: Invalid value for I<cmd> or I<msqid>.  Or: for a B<MSG_STAT> operation, the index value specified in I<msqid> referred to an array slot that is currently unused.
fr: I<cmd> ou I<msqid> ont une valeur illégale. Ou alors, dans le cas d'une opération B<MSG_STAT>, la valeur indiquée par I<msqid> pointe vers un élément de tableau qui n'est pas en cours d'utilisation.

note: type: Plain text
en: The argument I<cmd> has the value B<IPC_SET> or B<IPC_RMID>, but the effective user ID of the calling process is not the creator (as found in I<msg_perm.cuid>)  or the owner (as found in I<msg_perm.uid>)  of the message queue, and the caller is not privileged (Linux: does not have the B<CAP_SYS_ADMIN> capability).
fr: L'argument I<cmd> réclame l'opération B<IPC_SET> ou B<IPC_RMID> mais l'UID effectif du processus appelant n'est pas le créateur (comme indiqué dans I<msg_perm.cuid>) ou le propriétaire (comme indiqué dans I<msg_perm.uid>) de la file de messages, et l'appelant n'est pas privilégié (sous Linux, il n'a pas la capacité B<CAP_SYS_ADMIN>).

note: type: Plain text
en: An attempt (B<IPC_SET>)  was made to increase I<msg_qbytes> beyond the system parameter B<MSGMNB>, but the caller is not privileged (Linux: does not have the B<CAP_SYS_RESOURCE> capability).
fr: Il a été tenté (via B<IPC_SET>) d'augmenter I<msg_qbytes> au-delà du paramètre système B<MSGMNB>, mais l'appelant n'est pas privilégié (sous Linux, il n'a pas la capacité B<CAP_SYS_RESOURCE>).

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

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 B<IPC_INFO>, B<MSG_STAT> and B<MSG_INFO> operations are used by the B<ipcs>(1)  program to provide information on allocated resources.  In the future these may modified or moved to a I</proc> filesystem interface.
fr: Les appels B<IPC_INFO>, B<MSG_STAT> et B<MSG_INFO> sont utilisés par le programme B<ipcs>(1) pour fournir des informations sur les ressources allouées. À l'avenir, ceci pourra être modifié ou remplacé par une interface avec le système de fichiers I</proc>.

note: type: Plain text
en: Various fields in the I<struct msqid_ds> were typed as I<short> under Linux 2.2 and have become I<long> under Linux 2.4.  To take advantage of this, a recompilation under glibc-2.1.91 or later should suffice.  (The kernel distinguishes old and new calls by an B<IPC_64> flag in I<cmd>.)
fr: Divers champs de la structure I<struct msqid_ds> étaient de type I<short> sous Linux 2.2 et sont devenus de type I<long> sous Linux 2.4. Pour en profiter, une recompilation avec la glibc 2.1.91 ou ultérieure devrait suffire. (Le noyau distingue les appels anciens et nouveaux par un drapeau B<IPC_64> dans I<cmd>.)

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