manpages-fr - en to fr translation catalogue (63 entries)

note: type: TH
en: 2023-03-30
fr: 30 mars 2023

note: type: TH
en: Linux man-pages 6.05.01
fr: Pages du manuel de Linux 6.05.01

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: SH
en: LIBRARY
fr: BIBLIOTHÈQUE

note: type: Plain text
en: Standard C library (I<libc>, I<-lc>)
fr: Bibliothèque C standard (I<libc>, I<-lc>)

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 creation or last
                                       modification by msgctl() */
        unsigned long   msg_cbytes; /* # of bytes in queue */
        msgqnum_t       msg_qnum;   /* # number of messages in queue */
        msglen_t        msg_qbytes; /* Maximum # of bytes 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 droits */
        time_t          msg_stime;  /* Heure du dernier msgsnd(2) */
        time_t          msg_rtime;  /* Heure du dernier msgrcv(2) */
        time_t          msg_ctime;  /* Heure de création ou de
                                       modification avec msgctl() */
        unsigned long   msg_cbytes; /* nombre d'octets dans la file */
        msgqnum_t       msg_qnum;   /* nombre de messages dans la file */
        msglen_t        msg_qbytes; /* nombre maximal d'octets 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 fields of the I<msqid_ds> structure are as follows:
fr: Les champs de la structure I<msqid_ds> sont les suivants :

note: type: Plain text
en: This is an I<ipc_perm> structure (see below) that specifies the access permissions on the message queue.
fr: Il s'agit d'une structure I<ipc_perm> (voir ci-dessous) qui indique les droits d'accès à la file de messages.

note: type: Plain text
en: Time of the last B<msgsnd>(2)  system call.
fr: Heure du dernier appel système B<msgsnd>(2).

note: type: Plain text
en: Time of the last B<msgrcv>(2)  system call.
fr: Heure du dernier appel système B<msgrcv>(2).

note: type: Plain text
en: Time of creation of queue or time of last B<msgctl>()  B<IPC_SET> operation.
fr: Heure de création de la file ou de la dernière opération B<IPC_SET> de B<msgctl>().

note: type: Plain text
en: Number of bytes in all messages currently on the message queue.  This is a nonstandard Linux extension that is not specified in POSIX.
fr: Nombre d'octets de tous les messages actuellement dans la file de messages. Il s'agit d'une extension Linux non standard qui n'est pas indiquée dans POSIX.

note: type: Plain text
en: Number of messages currently on the message queue.
fr: Nombre de messages actuellement dans la file de messages.

note: type: Plain text
en: Maximum number of bytes of message text allowed on the message queue.
fr: Nombre maximal d'octets de texte de message autorisés dans la file de messages.

note: type: Plain text
en: ID of the process that performed the last B<msgsnd>(2)  system call.
fr: Identifiant du processus qui a effectué le dernier appel système B<msgsnd>(2).

note: type: Plain text
en: ID of the process that performed the last B<msgrcv>(2)  system call.
fr: Identifiant du processus qui a effectué le dernier appel système B<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: The least significant 9 bits of the I<mode> field of the I<ipc_perm> structure define the access permissions for the message queue.  The permission bits are as follows:
fr: Les neuf bits de poids faible du champ I<mode> de la structure I<ipc_perm> définissent les droits d'accès à la file de messages. Les bits de droits sont les suivants :

note: type: tbl table
en: Read by user
fr: Lisible par l'utilisateur

note: type: tbl table
en: Write by user
fr: Droit d'écriture pour l'utilisateur

note: type: tbl table
en: Read by group
fr: Lisible par le groupe

note: type: tbl table
en: Write by group
fr: Autorisation d'écriture pour le groupe

note: type: tbl table
en: Read by others
fr: Lisible par les autres

note: type: tbl table
en: Write by others
fr: Écrit par d'autres

note: type: Plain text
en: Bits 0100, 0010, and 0001 (the execute bits) are unused by the system.
fr: Les bits 0100, 0010 et 0001 (les bits d'exécution) sont inusités par le système.

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 de données du noyau 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.
fr: Écrire les valeurs 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>.

note: type: Plain text
en: 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>.
fr: Les champs suivants de la structure peuvent être mis à jour : I<msg_qbytes>, I<msg_perm.uid>, I<msg_perm.gid> et (les neuf bits de poids faible de) I<msg_perm.mode>.

note: type: Plain text
en: 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: 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, en réveillant tous les processus écrivant et lisant en attente. Ils obtiendront un code d'erreur et I<errno> aura la valeur B<EIDRM>. Le processus appelant doit avoir les privilèges appropriés ou son UID effectif doit être celui du créateur ou du propriétaire de la file de messages. 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 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.
                        Non utilisé par le noyau */
        int msgmap;  /* Nombre maximal d'entrées dans la table 
                        des messages. Non 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 messages */
        int msgssz;  /* Taille du segment de message.
                        Non utilisé par le noyau */
        int msgtql;  /* Nombre maximal de messages dans
                        toutes les files du système.
                        Non utilisé par le noyau */
        unsigned short msgseg;
                     /* Nombre maximal de segments.
                        Non 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 à l’aide des 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 comme 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 index dans le tableau interne au noyau qui contient des informations sur toutes les files de messages du système.

note: type: TP
en: B<MSG_STAT_ANY> (Linux-specific, since Linux 4.17)
fr: B<MSG_STAT_ANY> (spécifique à Linux, depuis Linux 4.17)

note: type: Plain text
en: Return a I<msqid_ds> structure as for B<MSG_STAT>.  However, I<msg_perm.mode> is not checked for read access for I<msqid> meaning that any user can employ this operation (just as any user may read I</proc/sysvipc/msg> to obtain the same information).
fr: Renvoyer une structure I<msqid_ds> comme pour B<MSG_STAT>. Cependant, l'accès en lecture I<msg_perm.mode> n'est pas vérifié pour l’accès en lecture de I<msqid>, ce qui veut dire que n'importe quel utilisateur peut utiliser cette opération (tout comme n'importe quel utilisateur peut lire I</proc/sysvipc/msg> pour avoir les mêmes informations).

note: type: SH
en: RETURN VALUE
fr: VALEUR RENVOYÉE

note: type: Plain text
en: On success, B<IPC_STAT>, B<IPC_SET>, and B<IPC_RMID> return 0.  A successful B<IPC_INFO> or B<MSG_INFO> operation returns the index of the highest used entry in the kernel's internal array recording information about all message queues.  (This information can be used with repeated B<MSG_STAT> or B<MSG_STAT_ANY> operations to obtain information about all queues on the system.)  A successful B<MSG_STAT> or B<MSG_STAT_ANY> operation returns the identifier of the queue whose index was given in I<msqid>.
fr: Si elles réussissent, B<IPC_STAT>, B<IPC_SET> et B<IPC_RMID> renvoient B<0>. Une opération B<IPC_INFO> ou B<MSG_INFO> réussie renvoie le plus grand index d'élément utilisé dans la table interne du noyau contenant des informations sur les files de messages (cette information peut être utilisée par des opérations B<MSG_STAT> ou B<MSG_STAT_ANY> répétées afin d'obtenir des informations sur toutes les files du système). Une opération B<MSG_STAT> ou B<MSG_STAT_ANY> réussie renvoie l'identifiant de la file dont l'index était donné dans I<msqid>.

note: type: Plain text
en: On failure, -1 is returned and I<errno> is set to indicate the error.
fr: En cas d'échec, la valeur de retour est B<-1> et I<errno> est défini pour préciser l'erreur.

note: type: SH
en: ERRORS
fr: ERREURS

note: type: Plain text
en: The argument I<cmd> is equal to B<IPC_STAT> or B<MSG_STAT>, but the calling process does not have read permission on the message queue I<msqid>, and does not have the B<CAP_IPC_OWNER> capability in the user namespace that governs its IPC namespace.
fr: L'argument I<cmd> équivaut à B<IPC_STAT> ou B<MSG_STAT>, mais le processus appelant n'a pas d'accès en lecture sur la file de messages I<msqid>, et n'a pas la capacité B<CAP_IPC_OWNER> dans l'espace de noms utilisateur qui gère l'espace de noms IPC.

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> a pour valeur B<IPC_SET> ou B<IPC_STAT>, mais l’adresse pointée par I<buf> est 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 d’index 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> a pour valeur 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: HISTORY
fr: HISTORIQUE

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: 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 opérations B<IPC_INFO>, B<MSG_STAT> et B<MSG_INFO> sont utilisées par le programme B<ipcs>(1) pour fournir des informations sur les ressources allouées. À l'avenir, cela pourra être modifié ou remplacé par une interface avec le système de fichiers I</proc>.

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

note: type: TH
en: 2022-12-15
fr: 15 décembre 2022

note: type: TH
en: Linux man-pages 6.03
fr: Pages du manuel de Linux 6.03

note: type: TH
en: Linux man-pages 6.05
fr: Pages du manuel de Linux 6.05

note: type: TH
en: Linux man-pages 6.04
fr: Pages du manuel de Linux 6.04
