perkamon - en to fr translation catalogue (49 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: shmctl - System V shared memory control
fr: shmctl - Contrôler la mémoire partagée System V

note: type: Plain text
en: B<shmctl>()  performs the control operation specified by I<cmd> on the System\ V shared memory segment whose identifier is given in I<shmid>.
fr: B<shmctl>() effectue l'opération de contrôle indiquée par I<cmd> sur le segment de mémoire partagée System V identifié par I<shmid>.

note: type: Plain text
en: The I<buf> argument is a pointer to a I<shmid_ds> structure, defined in I<E<lt>sys/shm.hE<gt>> as follows:
fr: L'argument I<buf> est un pointeur sur une structure I<shmid_ds>, définie dans I<E<lt>sys/shm.hE<gt>> comme suit\ :

note: type: Plain text
en: struct shmid_ds {
        struct ipc_perm shm_perm;    /* Ownership and permissions */
        size_t          shm_segsz;   /* Size of segment (bytes) */
        time_t          shm_atime;   /* Last attach time */
        time_t          shm_dtime;   /* Last detach time */
        time_t          shm_ctime;   /* Last change time */
        pid_t           shm_cpid;    /* PID of creator */
        pid_t           shm_lpid;    /* PID of last shmat(2)/shmdt(2) */
        shmatt_t        shm_nattch;  /* No. of current attaches */
        ...
    };
fr: struct shmid_ds {
        struct ipc_perm shm_perm;   /* Propriétaire et permissions   */
        size_t          shm_segsz;  /* Taille segment en octets      */
        time_t          shm_atime;  /* Heure dernier attachement     */
        time_t          shm_dtime;  /* Heure dernier détachement     */
        time_t          shm_ctime;  /* Heure dernier changement      */
        pid_t           shm_cpid;   /* PID du créateur               */
        pid_t           shm_lpid;   /* PID du dernier shmat(2) /
                                       shmdt(2) */
        shmatt_t        shm_nattch; /* Nombre d'attachements actuels */
        ...
    };

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 shmget(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>;     /* B<Permissions> + SHM_DEST and
                                    SHM_LOCKED flags */
        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>;     /* B<Permissions> + attributs 
                                    SHM_DEST et SHM_LOCKED */
        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<shmid> into the I<shmid_ds> structure pointed to by I<buf>.  The caller must have read permission on the shared memory segment.
fr: Copier dans la structure I<shmid_ds> pointée par I<buf> la structure de données du noyau concernant I<shmid>. Le processus appelant doit avoir des privilèges de lecture sur le jeu de sémaphores

note: type: Plain text
en: Write the values of some members of the I<shmid_ds> structure pointed to by I<buf> to the kernel data structure associated with this shared memory segment, updating also its I<shm_ctime> member.  The following fields can be changed: I<shm_perm.uid>, I<shm_perm.gid>, and (the least significant 9 bits of) I<shm_perm.mode>.  The effective UID of the calling process must match the owner (I<shm_perm.uid>)  or creator (I<shm_perm.cuid>)  of the shared memory segment, or the caller must be privileged.
fr: Écrire la valeur de certains champs de la structure I<shmid_ds> pointée par I<buf> dans la structure du noyau représentant ce segment de mémoire partagée, en mettant à jour le champ I<shm_ctime>. Les champs suivants peuvent être mis à jour\ : I<shm_perm.uid>, I<shm_perm.gid> et les 9 bits de poids faible de I<shm_perm.mode>. L'UID effectif du processus appelant doit être soit celui du propriétaire (I<shm_perm.uid>) soit celui du créateur (I<shm_perm.cuid>) du segment partagé, ou bien l'appelant doit être privilégié.

note: type: Plain text
en: If a segment has been marked for destruction, then the (nonstandard)  B<SHM_DEST> flag of the I<shm_perm.mode> field in the associated data structure retrieved by B<IPC_STAT> will be set.
fr: Si un segment est marqué pour destruction, le drapeau (non standard) B<SHM_DEST> sera levé dans le champ I<shm_perm.mode> de la structure de données associée récupérée par B<IPC_STAT>.

note: type: Plain text
en: The caller I<must> ensure that a segment is eventually destroyed; otherwise its pages that were faulted in will remain in memory or swap.
fr: L'appelant I<doit> s'assurer que le segment sera bien détruit. Autrement, les pages qui ont été allouées resteront indéfiniment en mémoire ou en swap.

note: type: Plain text
en: See also the description of I</proc/sys/kernel/shm_rmid_forced> in B<proc>(5).
fr: Consultez la description de I</proc/sys/kernel/shm_rmid_forced> dans B<proc>(5).

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 shared memory limits and parameters in the structure pointed to by I<buf>.  This structure is of type I<shminfo> (thus, a cast is required), defined in I<E<lt>sys/shm.hE<gt>> if the B<_GNU_SOURCE> feature test macro is defined:
fr: Fournir des informations sur les limites et paramètres du système concernant la mémoire partagée dans la structure pointée par I<buf>. Cette structure est de type I<shminfo> (ce qui nécessite un transtypage), qui est défini dans I<E<lt>sys/shm.hE<gt>> si la macro B<_GNU_SOURCE> est définie\ :

note: type: Plain text
en: struct shminfo {
        unsigned long shmmax; /* Maximum segment size */
        unsigned long shmmin; /* Minimum segment size;
                                 always 1 */
        unsigned long shmmni; /* Maximum number of segments */
        unsigned long shmseg; /* Maximum number of segments
                                 that a process can attach;
                                 unused within kernel */
        unsigned long shmall; /* Maximum number of pages of
                                 shared memory, system-wide */
    };
fr: struct shminfo {
        unsigned long shmmax; /* Taille maximum de segment */
        unsigned long shmmin; /* Taille minimum de segment\ ;
                                 toujours 1 */
        unsigned long shmmni; /* Nombre maximal de segments */
        unsigned long shmseg; /* Nombre maximal de segments qu'un
                                 processus peut attacher\ ;
                                 pas utilisé par le noyau */
        unsigned long shmall; /* Nombre maximal de pages de
                                 mémoire partagée sur le
                                 système */
    };

note: type: Plain text
en: The I<shmmni>, I<shmmax>, and I<shmall> settings can be changed via I</proc> files of the same name; see B<proc>(5)  for details.
fr: Les paramètres I<shmmni>, I<shmmax> et I<shmall> 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<SHM_INFO> (Linux-specific)
fr: B<SHM_INFO> (spécifique à Linux)

note: type: Plain text
en: Return a I<shm_info> structure whose fields contain information about system resources consumed by shared memory.  This structure is defined in I<E<lt>sys/shm.hE<gt>> if the B<_GNU_SOURCE> feature test macro is defined:
fr: Fournir une structure I<shm_info> contenant des informations sur les ressources système utilisées par des segments de mémoire partagée. Cette structure est définie dans I<E<lt>sys/shm.hE<gt>> si la macro B<_GNU_SOURCE> est définie\ :

note: type: Plain text
en: struct shm_info {
        int           used_ids; /* # of currently existing
                                   segments */
        unsigned long shm_tot;  /* Total number of shared
                                   memory pages */
        unsigned long shm_rss;  /* # of resident shared
                                   memory pages */
        unsigned long shm_swp;  /* # of swapped shared
                                   memory pages */
        unsigned long swap_attempts;
                                /* Unused since Linux 2.4 */
        unsigned long swap_successes;
                                /* Unused since Linux 2.4 */
    };
fr: struct shm_info {
        int           used_ids; /* Nombre de segments 
                                   actuellement existants */
        unsigned long shm_tot;  /* Nombre total de pages de
                                   mémoire partagée */
        unsigned long shm_rss;  /* Nombre de pages de mémoire
                                   partagée actuellement en RAM */
        unsigned long shm_swp;  /* Nombre de pages de mémoire
                                   partagée actuellement en swap */
        unsigned long swap_attempts;
                                /* Non utilisé depuis Linux 2.4 */
        unsigned long swap_successes;
                                /* Non utilisé depuis Linux 2.4 */
    };

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

note: type: Plain text
en: Return a I<shmid_ds> structure as for B<IPC_STAT>.  However, the I<shmid> argument is not a segment identifier, but instead an index into the kernel's internal array that maintains information about all shared memory segments on the system.
fr: Renvoyer une structure I<shmid_ds> comme pour B<IPC_STAT>. Cependant, l'argument I<shmid> n'est pas l'identifiant d'un segment, mais un indice dans la table interne du noyau qui contient les informations sur tous les segments de mémoire partagée du système.

note: type: Plain text
en: The caller can prevent or allow swapping of a shared memory segment with the following I<cmd> values:
fr: L'appelant peut empêcher ou autoriser le noyau à évincer un segment de mémoire partagée en swap avec les valeurs suivantes de I<cmd>\ :

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

note: type: Plain text
en: Prevent swapping of the shared memory segment.  The caller must fault in any pages that are required to be present after locking is enabled.  If a segment has been locked, then the (nonstandard)  B<SHM_LOCKED> flag of the I<shm_perm.mode> field in the associated data structure retrieved by B<IPC_STAT> will be set.
fr: Empêcher le segment d'être évincé en swap. L'appelant doit consulter chaque page concernée après avoir effectué le verrouillage pour s'assurer qu'elle est bien présente en mémoire. Si un segment est verrouillé, le drapeau (non standard) B<SHM_LOCKED> sera levé dans le champ I<shm_perm.mode> de la structure de données, récupérée avec B<IPC_STAT>, associée au segment.

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

note: type: Plain text
en: Unlock the segment, allowing it to be swapped out.
fr: Déverrouiller le segment, ce qui autorise son swapping.

note: There was some weirdness in 2.6.9: SHM_LOCK and SHM_UNLOCK could be applied to a segment, regardless of ownership of the segment. This was a botch-up in the move to RLIMIT_MEMLOCK, and was fixed in 2.6.10.  MTK, May 2005 type: Plain text
en: In kernels before 2.6.10, only a privileged process could employ B<SHM_LOCK> and B<SHM_UNLOCK>.  Since kernel 2.6.10, an unprivileged process can employ these operations if its effective UID matches the owner or creator UID of the segment, and (for B<SHM_LOCK>)  the amount of memory to be locked falls within the B<RLIMIT_MEMLOCK> resource limit (see B<setrlimit>(2)).
fr: Dans les noyaux antérieurs à 2.6.10, seul un processus privilégié pouvait utiliser B<SHM_LOCK> et B<SHM_UNLOCK>. Depuis Linux 2.6.10, un processus non privilégié peut utiliser ces opérations si son UID effectif est celui du propriétaire ou du créateur du segment, et (pour B<SHM_LOCK>) la quantité de mémoire à verrouiller ne dépasse pas la limite de ressource B<RLIMIT_MEMLOCK> (consultez B<setrlimit>(2)).

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

note: type: Plain text
en: On error, -1 is returned, and I<errno> is set appropriately.
fr: En cas d'erreur, la valeur de retour est -1, et I<errno> contient le code d'erreur.

note: type: SH
en: ERRORS
fr: ERREURS

note: type: Plain text
en: The argument I<cmd> has value B<IPC_SET> or B<IPC_STAT> but the address pointed to by I<buf> isn't accessible.
fr: I<cmd> a la valeur B<IPC_SET> ou B<IPC_STAT> mais I<buf> pointe en dehors de l'espace d'adressage accessible.

note: type: Plain text
en: I<shmid> points to a removed identifier.
fr: I<shmid> pointe sur un segment détruit.

note: type: Plain text
en: (In kernels since 2.6.9), B<SHM_LOCK> was specified and the size of the to-be-locked segment would mean that the total bytes in locked shared memory segments would exceed the limit for the real user ID of the calling process.  This limit is defined by the B<RLIMIT_MEMLOCK> soft resource limit (see B<setrlimit>(2)).
fr: (Depuis le noyau 2.6.9) L'opération B<SHM_LOCK> a été demandée, et la taille du segment à verrouiller entraînerait un dépassement de la limite du nombre total d'octets de mémoire partagée verrouillés pour l'UID réel du processus appelant. Cette limite est la limite souple de ressource B<RLIMIT_MEMLOCK> (consultez B<setrlimit>(2)).

note: type: Plain text
en: B<IPC_STAT> is attempted, and the GID or UID value is too large to be stored in the structure pointed to by I<buf>.
fr: L'opération demandée est B<IPC_STAT> mais la valeur de GID ou d'UID est trop grande pour être stockée dans la structure pointée par I<buf>.

note: type: Plain text
en: B<IPC_SET> or B<IPC_RMID> is attempted, and the effective user ID of the calling process is not that of the creator (found in I<shm_perm.cuid>), or the owner (found in I<shm_perm.uid>), and the process was not privileged (Linux: did not have the B<CAP_SYS_ADMIN> capability).
fr: On réclame B<IPC_SET> ou B<IPC_RMID> mais l'appelant n'est ni le créateur du segment (trouvé dans I<shm_perm.cuid>), ni le propriétaire (trouvé dans I<shm_perm.uid>) et le processus n'est pas privilégié (sous Linux\ : n'a pas la capacité B<CAP_SYS_ADMIN>.

note: type: Plain text
en: Or (in kernels before 2.6.9), B<SHM_LOCK> or B<SHM_UNLOCK> was specified, but the process was not privileged (Linux: did not have the B<CAP_IPC_LOCK> capability).  (Since Linux 2.6.9, this error can also occur if the B<RLIMIT_MEMLOCK> is 0 and the caller is not privileged.)
fr: Ou bien (pour les noyaux antérieurs à 2.6.9) soit B<SHM_LOCK> soit B<SHM_UNLOCK> a été spécifié, mais le processus n'est pas privilégié (sous Linux\ : n'a pas la capacité B<CAP_IPC_LOCK>. Depuis Linux 2.6.9, cette erreur peut également se produire si la limite B<RLIMIT_MEMLOCK> est 0, et l'appelant n'est pas privilégié.

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<SHM_STAT> and B<SHM_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<SHM_STAT> et B<SHM_INFO> sont utilisées par le programme B<ipcs>(1) pour fournir des informations sur les ressources allouées. Ceci peut changer dans le futur, en utilisant une interface sur le système de fichiers I</proc>.

note: type: Plain text
en: Linux permits a process to attach (B<shmat>(2))  a shared memory segment that has already been marked for deletion using I<shmctl(IPC_RMID)>.  This feature is not available on other UNIX implementations; portable applications should avoid relying on it.
fr: Linux autorise un processus à attacher (B<shmat>(2)) un segment de mémoire partagée ayant été marqué pour suppression (avec I<shmctl(IPC_RMID)>. Cette particularité n'est pas disponible sur d'autres variantes d'UNIX\ ; des applications portables ne devraient pas compter sur ce comportement.

note: type: Plain text
en: Various fields in a I<struct shmid_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<shmid_ds> étaient de type I<short> sous Linux 2.2 et sont devenus des I<long> sous Linux 2.4. Pour en tirer parti, une recompilation sous glibc 2.1.91 ou ultérieure doit suffire. (Le noyau distingue les anciens et nouveaux appels 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/.
