perkamon - en to fr translation catalogue (44 entries)

note: type: TH
en: 2023-05-03
fr: 3 mai 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: capget, capset - set/get capabilities of thread(s)
fr: capget, capset - Configurer les capacités des threads

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: I<Note>: glibc provides no wrappers for these system calls, necessitating the use of B<syscall>(2).
fr: I<Note> : la glibc ne fournit pas de fonction autour de cet appel système, l'utilisation de B<syscall>(2) est requise.

note: type: Plain text
en: These two system calls are the raw kernel interface for getting and setting thread capabilities.  Not only are these system calls specific to Linux, but the kernel API is likely to change and use of these system calls (in particular the format of the I<cap_user_*_t> types) is subject to extension with each kernel revision, but old programs will keep working.
fr: Ces deux appels système constituent l'interface brute du noyau pour configurer ou lire les capacités d'un thread. Non seulement ces appels système sont spécifiques à Linux, mais l'API du noyau est susceptible de changer. L'utilisation de ces appels système (en particulier le format du type I<cap_user_*_t>) risque d'être étendue lors de nouvelles mises à jour du noyau, mais les anciens programmes continueront à fonctionner.

note: type: Plain text
en: The portable interfaces are B<cap_set_proc>(3)  and B<cap_get_proc>(3); if possible, you should use those interfaces in applications; see NOTES.
fr: Les interfaces portables sont constituées des fonctions B<cap_set_proc>(3) et B<cap_get_proc>(3)\ ; si possible, utilisez plutôt ces routines dans vos applications ; voir les NOTES.

note: type: SS
en: Current details
fr: Détails actuels

note: type: Plain text
en: Now that you have been warned, some current kernel details.  The structures are defined as follows.
fr: Maintenant que vous avez été avertis, quelques détails du noyau actuel. Les structures sont définies comme suit.

note: type: Plain text
en: The I<effective>, I<permitted>, and I<inheritable> fields are bit masks of the capabilities defined in B<capabilities>(7).  Note that the B<CAP_*> values are bit indexes and need to be bit-shifted before ORing into the bit fields.  To define the structures for passing to the system call, you have to use the I<struct __user_cap_header_struct> and I<struct __user_cap_data_struct> names because the typedefs are only pointers.
fr: Les champs I<effective>, I<permitted> et I<inheritable> sont des masques de bits de capacités définies dans B<capabilities>(7). Notez que les valeurs B<CAP_*> sont indices de bits et nécessitent d'être décalées avant le OU logique avec le champ de bits. Pour définir les structures à passer à l'appel système, vous devez utiliser les noms I<struct __user_cap_header_struct> et I<struct __user_cap_data_struct> car les typedef ne sont que des pointeurs.

note: type: Plain text
en: Kernels prior to Linux 2.6.25 prefer 32-bit capabilities with version B<_LINUX_CAPABILITY_VERSION_1>.  Linux 2.6.25 added 64-bit capability sets, with version B<_LINUX_CAPABILITY_VERSION_2>.  There was, however, an API glitch, and Linux 2.6.26 added B<_LINUX_CAPABILITY_VERSION_3> to fix the problem.
fr: Les noyaux antérieurs à Linux 2.6.25 préfèrent les capacités 32 bits avec la version B<_LINUX_CAPABILITY_VERSION_1>. Linux 2.6.25 a ajouté l'ensemble des capacités 64 bits avec la version B<_LINUX_CAPABILITY_VERSION_2>. Mais il y avait un bogue dans l'API, donc Linux 2.6.26 a ajouté B<_LINUX_CAPABILITY_VERSION_3> pour corriger le problème.

note: type: Plain text
en: Note that 64-bit capabilities use I<datap[0]> and I<datap[1]>, whereas 32-bit capabilities use only I<datap[0]>.
fr: Notez que les capacités 64 bits utilisent I<datap>[0] et I<datap>[1], tandis que celles 32 bits n'utilisent que I<datap>[0].

note: type: Plain text
en: On kernels that support file capabilities (VFS capabilities support), these system calls behave slightly differently.  This support was added as an option in Linux 2.6.24, and became fixed (nonoptional) in Linux 2.6.33.
fr: Sur les noyaux qui gèrent les capacités de fichier (VFS capabilities support), ces appels système se comportent légèrement autrement. Cette prise en charge a été ajoutée en option à Linux 2.6.24, avant de devenir incluse (non optionnelle) dans Linux 2.6.33.

note: type: Plain text
en: For B<capget>()  calls, one can probe the capabilities of any process by specifying its process ID with the I<hdrp-E<gt>pid> field value.
fr: Pour les appels B<capget>(), on peut tester les capacités de n'importe quel processus en indiquant l'identifiant du processus avec la valeur du champ I<hdrp-E<gt>pid>.

note: type: Plain text
en: For details on the data, see B<capabilities>(7).
fr: Pour les détails sur les données, consultez B<capabilities>(7).

note: type: SS
en: With VFS capabilities support
fr: Avec la prise en charge des capacités VFS

note: type: Plain text
en: VFS capabilities employ a file extended attribute (see B<xattr>(7))  to allow capabilities to be attached to executables.  This privilege model obsoletes kernel support for one process asynchronously setting the capabilities of another.  That is, on kernels that have VFS capabilities support, when calling B<capset>(), the only permitted values for I<hdrp-E<gt>pid> are 0 or, equivalently, the value returned by B<gettid>(2).
fr: Les capacités VFS utilisent un attribut de fichier étendu (voir B<xattr>(7)) pour pouvoir se rattacher à des exécutables. Ce modèle de privilèges rend obsolète la prise en charge par le noyau du paramétrage asynchrone des capacités d'un processus par un autre. C'est-à-dire que, avec la prise en charge VFS, pour les appels à B<capset>() les seules valeurs permises pour I<hdrp-E<gt>pid> sont B<0> ou, de manière équivalente, la valeur renvoyée par B<gettid>(2).

note: type: SS
en: Without VFS capabilities support
fr: Sans la gestion des capacités VFS

note: type: Plain text
en: On older kernels that do not provide VFS capabilities support B<capset>()  can, if the caller has the B<CAP_SETPCAP> capability, be used to change not only the caller's own capabilities, but also the capabilities of other threads.  The call operates on the capabilities of the thread specified by the I<pid> field of I<hdrp> when that is nonzero, or on the capabilities of the calling thread if I<pid> is 0.  If I<pid> refers to a single-threaded process, then I<pid> can be specified as a traditional process ID; operating on a thread of a multithreaded process requires a thread ID of the type returned by B<gettid>(2).  For B<capset>(), I<pid> can also be: -1, meaning perform the change on all threads except the caller and B<init>(1); or a value less than -1, in which case the change is applied to all members of the process group whose ID is -I<pid>.
fr: Sur les anciens noyaux qui ne gèrent pas les capacités VFS, B<capset>() peut être utilisé, si l'appelant a la capacité B<CAP_SETPCAP>, pour modifier non seulement les capacités propres à l'appelant, mais aussi les capacités d'autres threads. L'appel s'applique aux capacités du thread indiqué par le champ I<pid> de I<hdrp> lorsqu'il n'est pas nul, ou à celles du thread courant si I<pid> vaut B<0>. Si I<pid> correspond à un processus n'utilisant pas les threads, I<pid> peut être un identifiant de processus classique. Pour configurer les capacités d'un thread faisant partie d'un processus multithread, il faut utiliser un identifiant de thread du type que renvoie B<gettid>(2). Pour B<capset>(), I<pid> peut également être B<-1>, ce qui affecte tous les threads sauf l'appelant et B<init>(1), ou bien une valeur inférieure à B<-1>, ce qui applique la modification à tous les membres du groupe de processus identifiés par -I<pid>.

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

note: type: Plain text
en: On success, zero is returned.  On error, -1 is returned, and I<errno> is set to indicate the error.
fr: En cas de succès, zéro est renvoyé. En cas d'erreur, B<-1> est renvoyé et I<errno> est définie pour préciser l'erreur.

note: type: Plain text
en: The calls fail with the error B<EINVAL>, and set the I<version> field of I<hdrp> to the kernel preferred value of B<_LINUX_CAPABILITY_VERSION_?> when an unsupported I<version> value is specified.  In this way, one can probe what the current preferred capability revision is.
fr: Les appels échoueront avec l'erreur B<EINVAL>, et définiront le champ I<version> de I<hdrp> avec la valeur B<_LINUX_CAPABILITY_VERSION_?> préférée par le noyau quand une I<version> non prise en charge est fournie. De cette façon, on peut tester quelle est la révision actuelle de capacité préférée.

note: type: SH
en: ERRORS
fr: ERREURS

note: type: Plain text
en: Bad memory address.  I<hdrp> must not be NULL.  I<datap> may be NULL only when the user is trying to determine the preferred capability version format supported by the kernel.
fr: Mauvaise adresse mémoire. I<hdrp> ne doit pas être NULL. I<datap> ne peut être NULL que quand l'utilisateur cherche à déterminer la version du format préféré des capacités gérée par le noyau.

note: type: Plain text
en: One of the arguments was invalid.
fr: Un argument est non valable.

note: type: Plain text
en: An attempt was made to add a capability to the permitted set, or to set a capability in the effective set that is not in the permitted set.
fr: Une tentative a été opérée pour ajouter une capacité dans l'ensemble I<permitted>, ou pour placer une capacité dans l'ensemble I<effective> hors de l'ensemble I<permitted>.

note: type: Plain text
en: An attempt was made to add a capability to the inheritable set, and either:
fr: Une tentative a été faite pour ajouter une capacité dans l'ensemble I<inheritable> et soit :

note: type: IP
en: \[bu]
fr: -

note: type: Plain text
en: that capability was not in the caller's bounding set; or
fr: cette capacité n'était pas présente dans l'ensemble applicable à l'appel ; soit

note: type: Plain text
en: the capability was not in the caller's permitted set and the caller lacked the B<CAP_SETPCAP> capability in its effective set.
fr: cette capacité n'était pas dans l'ensemble I<permitted> pour l'appel et l'appelant n'avait pas de capacité B<CAP_SETPCAP> dans son ensemble effectif.

note: type: Plain text
en: The caller attempted to use B<capset>()  to modify the capabilities of a thread other than itself, but lacked sufficient privilege.  For kernels supporting VFS capabilities, this is never permitted.  For kernels lacking VFS support, the B<CAP_SETPCAP> capability is required.  (A bug in kernels before Linux 2.6.11 meant that this error could also occur if a thread without this capability tried to change its own capabilities by specifying the I<pid> field as a nonzero value (i.e., the value returned by B<getpid>(2))  instead of 0.)
fr: Le processus appelant a tenté d'utiliser B<capset>() pour modifier les capacités d'un thread autre que lui\(hymême, sans avoir les privilèges nécessaires. Pour les noyaux avec la gestion des capacités VFS, ce n'est jamais permis. Pour les noyaux sans la gestion des capacités VFS, la capacité B<CAP_SETPCAP> est requise. (En raison d'un bogue dans les noyaux antérieurs à Linux 2.6.11, cette erreur était aussi renvoyée si un thread sans cette capacité tentait de modifier ses propres capacités en indiquant une valeur non nulle de I<pid> (la valeur renvoyée par B<getpid>(2), au lieu de B<0>).

note: type: Plain text
en: No such thread.
fr: Pas de thread correspondant.

note: type: Plain text
en: The portable interface to the capability querying and setting functions is provided by the I<libcap> library and is available here:
fr: L'interface portable pour les fonctions de lecture des capacités et de configuration est fournie par la bibliothèque I<libcap> disponible à\ :

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

note: type: TH
en: 2023-02-05
fr: 5 février 2023

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

note: commit e338d263a76af78fe8f38a72131188b58fceb591 Added 64 bit capability support type: Plain text
en:         /* V2 added in Linux 2.6.25; deprecated */
    #define _LINUX_CAPABILITY_VERSION_2  0x20071026
    #define _LINUX_CAPABILITY_U32S_2     2
fr:        /* V2 ajoutée à Linux 2.6.25 ; obsolète */
    #define _LINUX_CAPABILITY_VERSION_2  0x20071026
    #define _LINUX_CAPABILITY_U32S_2     2

note: commit ca05a99a54db1db5bca72eccb5866d2a86f8517f type: Plain text
en:         /* V3 added in Linux 2.6.26 */
    #define _LINUX_CAPABILITY_VERSION_3  0x20080522
    #define _LINUX_CAPABILITY_U32S_3     2
fr:        /* V3 ajoutée à Linux 2.6.26 */
    #define _LINUX_CAPABILITY_VERSION_3  0x20080522
    #define _LINUX_CAPABILITY_U32S_3     2

note: type: Plain text
en: These system calls are Linux-specific.
fr: Ces appels système sont spécifiques à Linux.

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

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

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