manpages-fr-extra-util-linux - en to fr translation catalogue (131 entries)

note: type: TH
en: February 2016
fr: Février 2016

note: type: TH
en: User Commands
fr: Commandes de l'utilisateur

note: type: SH
en: NAME
fr: NOM

note: type: Plain text
en: unshare - run program in new namespaces
fr: unshare – Exécuter un programme dans de nouveaux espaces de noms

note: type: Plain text
en: B<unshare> [options] [I<program> [I<arguments>]]
fr: B<unshare> [I<options>] [I<programme> [I<arguments>]]

note: type: Plain text
en: The B<unshare> command creates new namespaces (as specified by the command-line options described below)  and then executes the specified I<program>.  If I<program> is not given, then ``${SHELL}'' is run (default: /bin/sh).
fr: La commande B<unshare> crée de nouveaux espaces de noms (comme précisé par les options de ligne de commande décrites ci-après) puis exécute le I<programme> indiqué. Si I<programme> n’est pas fourni, alors I<${SHELL}> est exécuté (par défaut : I</bin/sh>).

note: type: Plain text
en: By default, a new namespace persists only as long as it has member processes.  A new namespace can be made persistent even when it has no member processes by bind mounting /proc/I<pid>/ns/I<type> files to a filesystem path.  A namespace that has been made persistent in this way can subsequently be entered with B<\%nsenter>(1)  even after the I<program> terminates (except PID namespaces where a permanently running init process is required).  Once a persistent \%namespace is no longer needed, it can be unpersisted by using B<umount>(8)  to remove the bind mount.  See the B<EXAMPLES> section for more details.
fr: Par défaut, un nouvel espace de noms subsiste aussi longtemps qu’il possède des processus membres. Un nouvel espace de noms peut être rendu persistant, même s’il ne possède pas de membres, par montage lié (bind) des fichiers I</proc/pid/ns/type> vers un chemin de système de fichiers. Un espace de noms qui a été rendu persistant de cette façon peut ensuite être entré avec B<\%nsenter>(1) même après que le I<programme> soit terminé (excepté les espaces de noms PID où l’exécution permanente de processus init est nécessaire). Une fois qu’un \%espace de noms n’est plus nécessaire, il peut être rendu temporaire avec B<umount>(8) pour supprimer le montage lié. Consulter la section B<EXEMPLES> pour plus de détails.

note: type: Plain text
en: B<unshare> since util-linux version 2.36 uses /I<proc/[pid]/ns/pid_for_children> and I</proc/[pid]/ns/time_for_children> files for persistent PID and TIME namespaces. This change requires Linux kernel 4.17 or newer.
fr: B<unshare> depuis la version 2.36 d’util-linux utilise les fichiers I</proc/[pid]/ns/pid_for_children> et I</proc/[pid]/ns/time_for_children> pour des espace de noms persistants PID et temps. Cette modification nécessite un noyau Linux version 4.17 ou plus récent.

note: type: Plain text
en: The following types of namespaces can be created with B<unshare>:
fr: Les types d’espace de noms suivants peuvent être créés avec B<unshare> :

note: type: TP
en: B<mount namespace>
fr: B<espace de noms montage>

note: type: Plain text
en: Mounting and unmounting filesystems will not affect the rest of the system, except for filesystems which are explicitly marked as shared (with B<mount --make-shared>; see I</proc/self/mountinfo> or B<findmnt -o+PROPAGATION> for the B<shared> flags).  For further details, see B<mount_namespaces>(7).
fr: Le montage et démontage de systèmes de fichiers n'affectera pas le reste du système, sauf pour les systèmes de fichiers explicitement marqués comme partagés (avec B<mount --make-shared>, consultez I</proc/self/mountinfo> ou B<findmnt -o+PROPAGATION> pour les drapeaux B<shared>). Pour de plus amples détails, consulter B<mount_namespaces>(7) et l’explication du drapeau B<CLONE_NEWNS> dans B<clone>(2).

note: type: Plain text
en: B<unshare> since util-linux version 2.27 automatically sets propagation to B<private> in a new mount namespace to make sure that the new namespace is really unshared.  It's possible to disable this feature with option B<--propagation unchanged>.  Note that B<private> is the kernel default.
fr: B<unshare>, depuis util-linux version 2.27, règle automatiquement la propagation à B<private> dans un nouvel espace de noms montage pour assurer que celui-ci soit vraiment isolé. Il est possible de désactiver cette caractéristique avec l’option B<--propagation unchanged>. Remarquez que B<private> est le comportement par défaut du noyau.

note: type: TP
en: B<UTS namespace>
fr: B<espace de noms UTS>

note: type: Plain text
en: Setting hostname or domainname will not affect the rest of the system.  For further details, see B<uts_namespaces>(7).
fr: La configuration du nom d'hôte ou du nom de domaine n'affectera pas le reste du système. Pour de plus amples détails, consulter B<namespaces>(7).

note: type: TP
en: B<IPC namespace>
fr: B<espace de noms IPC>

note: type: Plain text
en: The process will have an independent namespace for POSIX message queues as well as System V \%message queues, semaphore sets and shared memory segments.  For further details, see B<ipc_namespaces>(7).
fr: Le processus aura un nom d'espace indépendant pour les files de messages POSIX ainsi que pour les files de \%messages de System V, les ensembles de sémaphores et les segments de mémoire partagée. Pour de plus amples détails, consulter B<ipc_namespaces>(7).

note: type: TP
en: B<network namespace>
fr: B<espace de noms réseau>

note: type: Plain text
en: The process will have independent IPv4 and IPv6 stacks, IP routing tables, firewall rules, the I</proc/net> and I</sys/class/net> directory trees, sockets, etc.  For further details, see B<network_namespaces>(7).
fr: Le processus aura des piles IPv4 et IPv6, des tables de routage IP, des règles de pare-feu, les arborescences de répertoires I</proc/net> et I</sys/class/net>, des sockets, etc., indépendantes. Pour de plus amples détails, consulter B<namespaces>(7).

note: type: TP
en: B<PID namespace>
fr: B<espace de noms PID>

note: type: Plain text
en: Children will have a distinct set of PID-to-process mappings from their parent.  For further details, see B<pid_namespaces>(7).
fr: Les enfants auront un ensemble distinct de mises en correspondance de PID à traiter de celui de leur parent. Pour de plus amples détails, consulter B<pid_namespaces>(7).

note: type: TP
en: B<cgroup namespace>
fr: B<espace de noms de groupe de contrôle>

note: type: Plain text
en: The process will have a virtualized view of I</proc\:/self\:/cgroup>, and new cgroup mounts will be rooted at the namespace cgroup root.  For further details, see B<cgroup_namespaces>(7).
fr: Le processus aura une vue virtualisée de I</proc\:/self\:/cgroup>, et les nouveaux montages de groupe de contrôle auront pour racine celle du groupe de contrôle d’espace de noms. Pour de plus amples détails, consulter B<cgroup_namespaces>(7).

note: type: TP
en: B<user namespace>
fr: B<espace de noms utilisateur>

note: type: Plain text
en: The process will have a distinct set of UIDs, GIDs and capabilities.  For further details, see B<user_namespaces>(7).
fr: Le processus aura un ensemble propre d’UID, de GID et de capacités. Pour de plus amples détails, consulter B<user_namespaces>(7).

note: type: TP
en: B<time namespace>
fr: B<espace de noms temps>

note: type: Plain text
en: The process can have a distinct view of B<CLOCK_MONOTONIC> and/or B<CLOCK_BOOTTIME> which can be changed using I</proc/self/timens_offsets>.  For further details, see B<time_namespaces>(7).
fr: Le processus peut avoir une vue distincte de B<CLOCK_MONOTONIC> ou B<CLOCK_BOOTTIME> qui peut être modifiée avec I</proc/self/timens_offsets>. Pour de plus amples détails, consulter, see B<time_namespaces>(7).

note: type: TP
en: B<-i>,B< --ipc>[B<=>I<file>]
fr: B<-i>,B< --ipc>[B<=>I<fichier>]

note: type: Plain text
en: Unshare the IPC namespace.  If I<file> is specified, then a persistent namespace is created by a bind mount.
fr: Isoler l’espace de noms IPC. Si I<fichier> est indiqué, alors un espace de noms persistant est créé par un montage lié.

note: type: TP
en: B<-m>,B< --mount>[B<=>I<file>]
fr: B<-m>,B< --mount>[B<=>I<fichier>]

note: type: Plain text
en: Unshare the mount namespace.  If I<file> is specified, then a persistent namespace is created by a bind mount.  Note that I<file> must be located on a mount whose propagation type is not B<shared> (or an error results).  Use the command B<findmnt -o+PROPAGATION> when not sure about the current setting.  See also the examples below.
fr: Isoler l’espace de noms montage. Si I<fichier> est indiqué, alors un espace de noms persistant est créé par un montage lié. Remarquez que I<fichier> doit être situé sur le système de fichiers avec le drapeau de propagation n’est pas B<shared> (ou une erreur survient). Utilisez la commande B<findmnt -o+PROPAGATION> si vous n’êtes pas sûr du réglage en cours. Consulter les exemples ci-dessous.

note: type: TP
en: B<-n>,B< --net>[B<=>I<file>]
fr: B<-n>,B< --net>[B<=>I<fichier>]

note: type: Plain text
en: Unshare the network namespace.  If I<file> is specified, then a persistent namespace is created by a bind mount.
fr: Isoler l’espace de noms réseau. Si I<fichier> est indiqué, alors un espace de noms persistant est créé par un montage lié.

note: type: TP
en: B<-p>,B< --pid>[B<=>I<file>]
fr: B<-p>,B< --pid>[B<=>I<fichier>]

note: type: Plain text
en: Unshare the PID namespace.  If I<file> is specified, then a persistent namespace is created by a bind mount.  (Creation of a persistent PID namespace will fail if the B<--fork> option is not also specified.)
fr: Isoler l'espace de noms PID. Si I<fichier> est indiqué, alors un espace de noms persistant est créé par un montage lié. (La création d’un espace de noms PID persistant échouera si l’option B<--fork> n’est pas aussi précisée.)

note: type: Plain text
en: See also the B<--fork> and B<--mount-proc> options.
fr: Consulter aussi les options B<--fork> et B<--mount-proc>.

note: type: TP
en: B<-u>,B< --uts>[B<=>I<file>]
fr: B<-u>,B< --uts>[B<=>I<fichier>]

note: type: Plain text
en: Unshare the UTS namespace.  If I<file> is specified, then a persistent namespace is created by a bind mount.
fr: Isoler l’espace de noms UTS. Si I<fichier> est indiqué, alors un espace de noms persistant est créé par un montage lié.

note: type: TP
en: B<-U>,B< --user>[B<=>I<file>]
fr: B<-U>,B< --user>[B<=>I<fichier>]

note: type: Plain text
en: Unshare the user namespace.  If I<file> is specified, then a persistent namespace is created by a bind mount.
fr: Isoler l’espace de noms utilisateur. Si I<fichier> est indiqué, alors un espace de noms persistant est créé par un montage lié.

note: type: TP
en: B<-C>,B< --cgroup>[B<=>I<file>]
fr: B<-C>,B< --cgroup>[B<=>I<fichier>]

note: type: Plain text
en: Unshare the cgroup namespace. If I<file> is specified then persistent namespace is created by bind mount.
fr: Isoler l’espace de noms groupe de contrôle. Si I<fichier> est indiqué, alors un espace de noms persistant est créé par un montage lié.

note: type: TP
en: B<-T>,B< --time>[B<=>I<file>]
fr: B<-T>,B< --time>[B<=>I<fichier>]

note: type: Plain text
en: Unshare the time namespace. If I<file> is specified then a persistent namespace is created by a bind mount. The B<--monotonic> and B<--boottime> options can be used to specify the corresponding offset in the time namespace.
fr: Isoler l'espace de noms temps. Si I<fichier> est indiqué, alors un espace de noms persistant est créé par un montage lié. Les options B<--monotonic> et B<--boottime> peuvent être utilisées pour les décalages correspondants dans l’espace de noms temps.

note: type: Plain text
en: Fork the specified I<program> as a child process of B<unshare> rather than running it directly.  This is useful when creating a new PID namespace.  Note that when B<unshare> is waiting for the child process, then it ignores SIGINT and SIGTERM and does not forward any signals to the child.  It is necessary to send signals to the child process.
fr: Fourcher le I<programme> indiqué comme processus enfant de B<unshare> plutôt que de l’exécuter directement. Cela est utile lors de la création d’un nouvel espace de noms PID. Il est à remarquer que quand B<unshare> est en attente d’un processus enfant, alors il ignore B<SIGINT> et B<SIGTERM> et ne transmet aucun signal à l’enfant. Cela est nécessaire pour envoyer des signaux au processus enfant.

note: type: Plain text
en: When the B<--user> option is given, ensure that capabilities granted in the user namespace are preserved in the child process.
fr: Quand l’option B<--user> est fournie, garantir que les capacités octroyées dans l’espace de noms utilisateur soient conservées dans le processus enfant.

note: type: TP
en: B<--kill-child>[B<=>I<signame>]
fr: B<--kill-child>[B<=>I<nom_de_signal>]

note: type: Plain text
en: When B<unshare> terminates, have I<signame> be sent to the forked child process.  Combined with B<--pid> this allows for an easy and reliable killing of the entire process tree below B<unshare>.  If not given, I<signame> defaults to B<SIGKILL>.  This option implies B<--fork>.
fr: À la fin de B<unshare>, envoyer un I<nom_signal> au processus enfant forké. Combiné avec B<--pid>, cela permet une extinction aisée et fiable de l’arbre entier de processus sous B<unshare>. S’il n’est pas donné, I<nom_signal> est par défaut B<SIGKILL>. Cela suppose B<--fork>.

note: type: TP
en: B<--mount-proc>[B<=>I<mountpoint>]
fr: B<--mount-proc>[B<=>I<point_de_montage>]

note: type: Plain text
en: Just before running the program, mount the proc filesystem at I<mountpoint> (default is /proc).  This is useful when creating a new PID namespace.  It also implies creating a new mount namespace since the /proc mount would otherwise mess up existing programs on the system.  The new proc filesystem is explicitly mounted as private (with MS_PRIVATE|MS_REC).
fr: Juste avant d’exécuter le programme, monter le système de fichiers proc sur I<point_de_montage> (I</proc> par défaut). C’est utile lors de la création d’un nouvel espace de noms PID. Cela implique aussi la création d’un nouvel espace de noms montage, sinon le montage de I</proc> perturberait les programmes existants sur le système. Le nouveau système de fichiers proc est explicitement monté comme privé (par MS_PRIVATE|MS_REC).

note: type: TP
en: B<--map-user=>I<uid|name>
fr: B<--map-user=>I<uid|nom>

note: type: Plain text
en: Run the program only after the current effective user ID has been mapped to I<uid>.  If this option is specified multiple times, the last occurrence takes precedence.  This option implies B<--user>.
fr: Exécuter le programme seulement après que les ID effectifs des utilisateurs actuels soient mappés à I<uid>. Si cette option est indiquée plusieurs fois, la dernière occurrence prévaudra. Cette option implique B<--user>.

note: type: TP
en: B<--map-group=>I<gid|name>
fr: B<--map-group=>I<gid|nom>

note: type: Plain text
en: Run the program only after the current effective group ID has been mapped to I<gid>.  If this option is specified multiple times, the last occurrence takes precedence.  This option implies B<--setgroups=deny> and B<--user>.
fr: Exécuter le programme seulement après que les ID effectifs des groupes actuels soient mappés à I<gid>. Si cette option est indiquée plusieurs fois, la dernière occurrence prévaudra. Cette option suppose B<--setgroups=deny> et B<--user>.

note: type: Plain text
en: Run the program only after the current effective user and group IDs have been mapped to the superuser UID and GID in the newly created user namespace.  This makes it possible to conveniently gain capabilities needed to manage various aspects of the newly created namespaces (such as configuring interfaces in the network namespace or mounting filesystems in the mount namespace) even when run unprivileged.  As a mere convenience feature, it does not support more sophisticated use cases, such as mapping multiple ranges of UIDs and GIDs.  This option implies B<--setgroups=deny> and B<--user>.  This option is equivalent to B<--map-user=0 --map-group=0>.
fr: Exécuter le programme seulement après que les identifiants d’utilisateur et de groupe effectifs ont été mis en correspondance avec les UID et GID du superutilisateur dans l’espace de noms utilisateur nouvellement créé. Cela permet d’obtenir facilement les capacités nécessaires pour gérer divers aspects des espaces de noms nouvellement créés (comme la configuration d’interfaces dans l’espace de noms réseau ou le montage des systèmes de fichiers dans l’espace de noms montage) même lors d’une exécution ordinaire. En tant que fonctionnalité surtout pratique, elle ne permet pas des cas d’utilisation plus sophistiqués comme la mise en correspondance de plusieurs intervalles d’UID et GID. Cette option implique B<--setgroups=deny> et B<--user>. Cette option est équivalente à B<--map-user=0 --map-group=0>.

note: type: Plain text
en: Run the program only after the current effective user and group IDs have been mapped to the same UID and GID in the newly created user namespace. This option implies B<--setgroups=deny> and B<--user>.  This option is equivalent to B<--map-user=$(id -ru) --map-group=$(id -rg)>.
fr: Exécuter le programme seulement après que les ID effectifs des utilisateurs et des groupes actuels sont mappés aux mêmes UID et GID dans l’espace de noms nouvellement créé. Cette option suppose B<--setgroups=deny> et B<--user>. Cette option est équivalente à B<--map-user=$(id -ru) --map-group=$(id -rg)>.

note: type: Plain text
en: Recursively set the mount propagation flag in the new mount namespace.  The default is to set the propagation to I<private>.  It is possible to disable this feature with the argument B<unchanged>.  The option is silently ignored when the mount namespace (B<--mount>) is not requested.
fr: De manière récursive, régler le drapeau de propagation de montage dans le nouvel espace de noms montage. Le comportement par défaut est de régler la propagation à I<private>. Il est possible de désactiver cette caractéristique avec l’argument B<unchanged>. Cette option est ignorée silencieusement quand l’espace de noms montage (B<--mount>) n’est pas nécessaire.

note: type: Plain text
en: Allow or deny the B<setgroups>(2)  system call in a user namespace.
fr: Permettre ou interdire l’appel système B<setgroups>(2) dans les espaces de noms utilisateur.

note: type: Plain text
en: To be able to call B<setgroups>(2), the calling process must at least have CAP_SETGID.  But since Linux 3.19 a further restriction applies: the kernel gives permission to call B<\%setgroups>(2)  only after the GID map (B</proc/>I<pid>B</gid_map>) has been set.  The GID map is writable by root when B<\%setgroups>(2)  is enabled (i.e., B<allow>, the default), and the GID map becomes writable by unprivileged processes when B<\%setgroups>(2)  is permanently disabled (with B<deny>).
fr: Pour pouvoir appeler B<setgroups>(2), le processus appelant doit au moins avoir CAP_SETGID. Mais depuis Linux 3.19, une restriction supplémentaire est appliquée : le noyau accorde la permission à l’appel B<\%setgroups>(2) seulement après que le mappage de GID (B</proc/>I<pid>B</gid_map>) a été réglé. La carte de correspondances de GID peut être écrite par le superutilisateur quand B<\%setgroups>(2) est activé (c'est-à-dire, B<allow>, le comportement par défaut), et la carte de GID peut être écrite par des processus normaux quand B<\%setgroups>(2) est désactivé de façon permanente (avec B<deny>).

note: type: TP
en: B<-R>,B< --root=>I<dir>
fr: B<-R>, B<--root=>I<répertoire>

note: type: Plain text
en: run the command with root directory set to I<dir>.
fr: Exécuter la commande avec le répertoire racine défini à I<répertoire>.

note: type: TP
en: B<-w>,B< --wd=>I<dir>
fr: B<-w>, B<--wd=>I<répertoire>

note: type: Plain text
en: change working directory to I<dir>.
fr: Changer le répertoire de travail à I<répertoire>.

note: type: TP
en: B<-S>,B< --setuid >I<uid>
fr: B<-S>, B<--setuid> I<UID>

note: type: Plain text
en: Set the user ID which will be used in the entered namespace.
fr: Définir l’identifiant d’utilisateur qui sera utilisé dans l’espace de noms saisi.

note: type: TP
en: B<-G>,B< --setgid >I<gid>
fr: B<-G>, B<--setgid> I<GID>

note: type: Plain text
en: Set the group ID which will be used in the entered namespace and drop supplementary groups.
fr: Définir l’identifiant de groupe qui sera utilisé dans l’espace de noms saisi et abandonner les autres groupes.

note: type: TP
en: B<--monotonic>I< offset>
fr: B<--monotonic>I< décalage>

note: type: Plain text
en: Set the offset of B<CLOCK_MONOTONIC> which will be used in the entered time namespace. This option requires unsharing a time namespace with B<--time>.
fr: Régler le décalage de B<CLOCK_MONOTONIC> qui sera utilisé dans l’espace de noms temps saisi. Cette option nécessite de ne plus partager un espace de noms temps avec B<--time>.

note: type: TP
en: B<--boottime>I< offset>
fr: B<--boottime>I< décalage>

note: type: Plain text
en: Set the offset of B<CLOCK_BOOTTIME> which will be used in the entered time namespace. This option requires unsharing a time namespace with B<--time>.
fr: Régler le décalage de B<CLOCK_BOOTTIME> qui sera utilisé dans l’espace de noms temps saisi. Cette option nécessite de ne plus partager un espace de noms temps avec B<--time>.

note: type: Plain text
en: Display version information and exit.
fr: Afficher les informations de version et quitter.

note: type: Plain text
en: Display help text and exit.
fr: Afficher l’aide-mémoire puis quitter.

note: type: Plain text
en: The proc and sysfs filesystems mounting as root in a user namespace have to be restricted so that a less privileged user can not get more access to sensitive files that a more privileged user made unavailable. In short the rule for proc and sysfs is as close to a bind mount as possible.
fr: Les systèmes de fichiers proc et sysfs montés comme racine dans un espace de noms utilisateur doivent être restreints de façon qu’un utilisateur moins privilégié ne puisse avoir davantage d’accès aux fichiers sensibles qu’un utilisateur plus privilégié aurait rendus indisponibles. En bref, la règle pour proc et sysfs est aussi près que possible d’un montage lié.

note: type: SH
en: EXAMPLES
fr: EXEMPLES

note: type: Plain text
en: The following command creates a PID namespace, using B<--fork> to ensure that the executed command is performed in a child process that (being the first process in the namespace) has PID 1.  The B<--mount-proc> option ensures that a new mount namespace is also simultaneously created and that a new B<proc>(5)  filesystem is mounted that contains information corresponding to the new PID namespace.  When the B<readlink> command terminates, the new namespaces are automatically torn down.
fr: La commande suivante crée un espace de noms PID, en utilisant B<--fork> pour garantir que l’exécution de la commande est réalisée dans un processus enfant qui (étant le premier processus dans l’espace de noms) a le PID 1. L’option B<--mount-proc> assure que le nouvel espace de noms montage est aussi créé simultanément et qu’un nouveau système de fichiers B<proc>(5) est monté contenant une information correspondant au nouvel espace de noms PID. Quand la commande B<readlink> se termine, les nouveaux espaces de noms sont automatiquement détruits.

note: type: Plain text
en: As an unprivileged user, create a new user namespace where the user's credentials are mapped to the root IDs inside the namespace:
fr: En tant qu’utilisateur ordinaire, créer un nouvel espace de noms où les accréditations sont mappées à l’ID racine à l’intérieur de l’espace de noms :

note: type: Plain text
en: The first of the following commands creates a new persistent UTS namespace and modifies the hostname as seen in that namespace.  The namespace is then entered with B<nsenter>(1)  in order to display the modified hostname; this step demonstrates that the UTS namespace continues to exist even though the namespace had no member processes after the B<unshare> command terminated.  The namespace is then destroyed by removing the bind mount.
fr: La première des commandes suivantes crée un nouvel espace de noms UTS persistant et modifie le nom d’hôte tel que vu dans cet espace de noms. L’espace de noms est alors saisi avec B<nsenter>(1) dans le but d’afficher le nom d’hôte modifié. Cette étape montre que l’espace de noms UTS continue d’exister même si l’espace de noms n’a pas de processus membre après que la commande B<unshare> ait terminé. L’espace de noms est alors détruit en retirant le montage lié.

note: type: Plain text
en: B<# touch /root/uts-ns>
    B<# unshare --uts=/root/uts-ns hostname FOO>
    B<# nsenter --uts=/root/uts-ns hostname>
    FOO
    B<# umount /root/uts-ns>
fr: B<# touch /root/uts-ns>
    B<# unshare --uts=/root/uts-ns hostname TOTO>
    B<# nsenter --uts=/root/uts-ns hostname>
    TOTO
    B<# umount /root/uts-ns>

note: type: Plain text
en: The following commands establish a persistent mount namespace referenced by the bind mount I</root/namespaces/mnt>.  In order to ensure that the creation of that bind mount succeeds, the parent directory (I</root/namespaces>)  is made a bind mount whose propagation type is not B<shared>.
fr: Les commandes suivantes établissent un espace de noms montage permanent référencé par le montage lié I</root/namespaces/mnt>. Dans le but d’assurer que la création de ce montage lié soit une réussite, le répertoire parent (I</root/namespaces>) est transformé en montage lié dont le type de propagation n’est pas B<shared>.

note: type: Plain text
en: The following commands demonstrate the use of the B<--kill-child> option when creating a PID namespace, in order to ensure that when B<unshare> is killed, all of the processes within the PID namespace are killed.
fr: Les commandes suivantes montrent l’utilisation de l’option B<--kill-child> lors de la création d’espace de noms PID, dans le but d’assurer que lorsque B<unshare> est tué, tous les autres processus dans l’espace de noms PID soient tués.

note: type: Plain text
en: B<# set +m                ># Don't print job status messages
    B<# unshare --pid --fork --mount-proc --kill-child -- \e>
    B<bash --norc -c \(aq(sleep 555 &) && (ps a &) && sleep 999\(aq &>
    [1] 53456
    #     PID TTY      STAT   TIME COMMAND
          1 pts/3    S+     0:00 sleep 999
          3 pts/3    S+     0:00 sleep 555
          5 pts/3    R+     0:00 ps a
fr: B<# set +m                ># Ne pas imprimer les messages d’état de travaux
    B<# unshare --pid --fork --mount-proc --kill-child -- \e>
    B<bash --norc -c \(aq(sleep 555 &) && (ps a &) && sleep 999\(aq &>
    [1] 53456
    #     PID TTY      STAT   TIME COMMAND
          1 pts/3    S+     0:00 sleep 999
          3 pts/3    S+     0:00 sleep 555
          5 pts/3    R+     0:00 ps a

note: type: Plain text
en: B<# ps h -o 'comm' $!     ># Show that background job is unshare(1)
    unshare
    B<# kill $!               ># Kill unshare(1)
    B<# pidof sleep>
fr: B<# ps h -o 'comm' $!     ># Montrer que le dorsal de travail est unshare(1)
    unshare
    B<# kill $!               ># Tuer unshare(1)
    B<# pidof sleep>

note: type: Plain text
en: The B<pidof> command prints no output, because the B<sleep> processes have been killed.  More precisely, when the B<sleep> process that has PID 1 in the namespace (i.e., the namespace's init process)  was killed, this caused all other processes in the namespace to be killed.  By contrast, a similar series of commands where the B<--kill-child> option is not used shows that when B<unshare> terminates, the processes in the PID namespace are not killed:
fr: La commande B<pidof> n’affiche rien car le processus B<sleep> a été tué. Plus précisément, quand le processus B<sleep> ayant le PID 1 dans l’espace de noms (c'est-à-dire, le processus init de l’espace de noms) a été tué, cela a entrainé que tous les autres processus soient tués. En revanche, une série de commandes similaires où l’option B<--kill-child> n’est pas utilisée montre que quand B<unshare> se termine, les processus dans l’espace de noms PID ne sont pas tués :

note: type: Plain text
en: The following example demonstrates the creation of a time namespace where the boottime clock is set to a point several years in the past:
fr: L’exemple suivant montre la création d’un espace de noms temps où l’horloge « boottime » est réglée à un point plusieurs années en arrière :

note: type: Plain text
en: B<# uptime -p             ># Show uptime in initial time namespace
    up 21 hours, 30 minutes
    B<# unshare --time --fork --boottime 300000000 uptime -p>
    up 9 years, 28 weeks, 1 day, 2 hours, 50 minutes
fr: B<# uptime -p             ># Afficher le temps de fonctionnement
                            # dans l’espace de noms temps initial
    up 21 hours, 30 minutes
    B<# unshare --time --fork --boottime 300000000 uptime -p>
    up 9 years, 28 weeks, 1 day, 2 hours, 50 minutes

note: type: SH
en: AUTHORS
fr: AUTEURS

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

note: type: SH
en: AVAILABILITY
fr: DISPONIBILITÉ

note: type: Plain text
en: The unshare command is part of the util-linux package and is available from https://www.kernel.org/pub/linux/utils/util-linux/.
fr: La commande B<unshare> fait partie du paquet util-linux, elle est disponible sur E<lt>I<https://www.kernel.org/pub/linux/utils/util-linux/>E<gt>.

note: type: Plain text
en: unshare - run program with some namespaces unshared from parent
fr: unshare - Exécuter un programme avec des espaces de noms isolés du parent

note: type: Plain text
en: Unshares the indicated namespaces from the parent process and then executes the specified I<program>. If I<program> is not given, then ``${SHELL}'' is run (default: /bin/sh).
fr: Isoler les espaces de noms indiqués du processus parent puis exécuter le I<programme> indiqué. Si I<programme> n’est pas fourni, alors I<${SHELL}> est exécuté (par défaut : I</bin/sh>).

note: type: Plain text
en: The namespaces can optionally be made persistent by bind mounting /proc/I<pid>/ns/I<type> files to a filesystem path and entered with B<\%nsenter>(1)  even after the I<program> terminates (except PID namespaces where permanently running init process is required).  Once a persistent \%namespace is no longer needed, it can be unpersisted with B<umount>(8).  See the B<EXAMPLES> section for more details.
fr: Les espaces de noms peuvent facultativement être rendus persistants par un montage lié des fichiers I</proc/pid/ns/type> à un chemin de système de fichiers et entrés avec B<\%nsenter>(1) même après que le I<programme> est terminé (excepté les espaces de noms PID où l’exécution permanente de processus init est nécessaire). Une fois qu’un \%espace de noms n’est plus nécessaire, il peut être rendu temporaire avec B<umount>(8). Consulter la section B<EXEMPLES> pour plus de détails.

note: type: Plain text
en: The namespaces to be unshared are indicated via options.  Unshareable namespaces are:
fr: Les espaces de noms à séparer sont indiqués à l’aide d’options. Les espaces de noms non isolables sont :

note: type: Plain text
en: Mounting and unmounting filesystems will not affect the rest of the system, except for filesystems which are explicitly marked as shared (with B<mount --make-shared>; see I</proc/self/mountinfo> or B<findmnt -o+PROPAGATION> for the B<shared> flags).  For further details, see B<mount_namespaces>(7)  and the discussion of the B<CLONE_NEWNS> flag in B<clone>(2).
fr: Le montage et démontage de systèmes de fichiers n'affectera pas le reste du système, sauf pour les systèmes de fichiers explicitement marqués comme partagés (avec B<mount --make-shared>, consultez I</proc/self/mountinfo> ou B<findmnt -o+PROPAGATION> pour les drapeaux B<shared>). Pour de plus amples détails, consulter B<mount_namespaces>(7) et l’explication du drapeau B<CLONE_NEWNS> dans B<clone>(2).

note: type: Plain text
en: Setting hostname or domainname will not affect the rest of the system.  For further details, see B<namespaces>(7)  and the discussion of the B<CLONE_NEWUTS> flag in B<clone>(2).
fr: La configuration du nom d'hôte ou du nom de domaine n'affectera pas le reste du système. Pour de plus amples détails, consulter B<namespaces>(7) et l’explication du drapeau B<CLONE_NEWUTS> dans B<clone>(2).

note: type: Plain text
en: The process will have an independent namespace for POSIX message queues as well as System V \%message queues, semaphore sets and shared memory segments.  For further details, see B<namespaces>(7)  and the discussion of the B<CLONE_NEWIPC> flag in B<clone>(2).
fr: Le processus aura un nom d'espace indépendant pour les files de messages POSIX ainsi que pour les files de \%messages de System V, les ensembles de sémaphores et les segments de mémoire partagée. Pour de plus amples détails, consulter B<namespaces>(7) et l’explication du drapeau B<CLONE_NEWIPC> dans B<clone>(2).

note: type: Plain text
en: The process will have independent IPv4 and IPv6 stacks, IP routing tables, firewall rules, the I</proc/net> and I</sys/class/net> directory trees, sockets, etc.  For further details, see B<namespaces>(7)  and the discussion of the B<CLONE_NEWNET> flag in B<clone>(2).
fr: Le processus aura des piles IPv4 et IPv6, des tables de routage IP, des règles de pare-feu, des arborescences de répertoires I</proc/net> et I</sys/class/net>, des sockets, etc., indépendantes. Pour de plus amples détails, consulter B<namespaces>(7) et l’explication du drapeau B<CLONE_NEWNET> dans B<clone>(2).

note: type: Plain text
en: Children will have a distinct set of PID-to-process mappings from their parent.  For further details, see B<pid_namespaces>(7)  and the discussion of the B<CLONE_NEWPID> flag in B<clone>(2).
fr: Les enfants auront un ensemble distinct de mises en correspondance de PID à traiter de celui de leur parent. Pour de plus amples détails, consulter B<pid_namespaces>(7) et l’explication du drapeau B<CLONE_NEWPID> dans B<clone>(2).

note: type: Plain text
en: The process will have a virtualized view of I</proc\:/self\:/cgroup>, and new cgroup mounts will be rooted at the namespace cgroup root.  For further details, see B<cgroup_namespaces>(7)  and the discussion of the B<CLONE_NEWCGROUP> flag in B<clone>(2).
fr: Le processus aura une vue virtualisée de I</proc\:/self\:/cgroup>, et les nouveaux montages de groupe de contrôle auront pour racine celle du groupe de contrôle d’espace de noms. Pour de plus amples détails, consulter B<cgroup_namespaces>(7) et l’explication du drapeau B<CLONE_NEWCGROUP> dans B<clone>(2).

note: type: Plain text
en: The process will have a distinct set of UIDs, GIDs and capabilities.  For further details, see B<user_namespaces>(7)  and the discussion of the B<CLONE_NEWUSER> flag in B<clone>(2).
fr: Le processus aura un ensemble propre d’UID, de GID et de capacités. Pour de plus amples détails, consulter B<user_namespaces>(7) et l’explication du drapeau B<CLONE_NEWUSER> dans B<clone>(2).

note: type: Plain text
en: Unshare the mount namespace.  If I<file> is specified, then a persistent namespace is created by a bind mount.  Note that I<file> has to be located on a filesystem with the propagation flag set to B<private>.  Use the command B<findmnt -o+PROPAGATION> when not sure about the current setting.  See also the examples below.
fr: Isoler l’espace de noms de montage. Si I<fichier> est indiqué, alors un espace de noms persistant est créé par un montage lié. Remarquez que I<fichier> doit être situé sur le système de fichiers avec le drapeau de propagation réglé à B<private>. Utilisez la commande B<findmnt -o+PROPAGATION> si vous n’êtes pas sûr du réglage en cours. Consulter les exemples ci-dessous.

note: type: Plain text
en: Unshare the PID namespace.  If I<file> is specified then persistent namespace is created by a bind mount.  See also the B<--fork> and B<--mount-proc> options.
fr: Isoler l'espace de noms PID. Si I<fichier> est indiqué, alors un espace de noms persistant est créé par un montage lié. Consultez également les options B<--fork> et B<--mount-proc>.

note: type: TP
en: B<-C>,B< --cgroup>[=I<file>]
fr: B<-m>,B< --cgroup>[B<=>I<fichier>]

note: type: Plain text
en: Fork the specified I<program> as a child process of B<unshare> rather than running it directly.  This is useful when creating a new PID namespace.
fr: Engendrer le I<programme> indiqué comme un processus enfant d’B<unshare> au lieu de l’exécuter directement. C’est utile lors de la création d’un nouvel espace de noms PID.

note: type: Plain text
en: Run the program only after the current effective user and group IDs have been mapped to the superuser UID and GID in the newly created user namespace.  This makes it possible to conveniently gain capabilities needed to manage various aspects of the newly created namespaces (such as configuring interfaces in the network namespace or mounting filesystems in the mount namespace) even when run unprivileged.  As a mere convenience feature, it does not support more sophisticated use cases, such as mapping multiple ranges of UIDs and GIDs.  This option implies B<--setgroups=deny>.
fr: Exécuter le programme seulement après que les identifiants d’utilisateur et de groupe effectifs ont été mis en correspondance avec les UID et GID du superutilisateur dans le nouvel espace de noms utilisateur. Cela permet d’obtenir facilement les capacités nécessaires pour gérer divers aspects des nouveaux espaces de noms (comme la configuration d’interfaces dans l’espace de noms réseau ou le montage des systèmes de fichiers dans l’espace de noms de montage) même lors d’une exécution ordinaire. En tant que fonctionnalité surtout pratique, elle ne permet pas des cas d’utilisation plus sophistiquée comme la mise en correspondance de plusieurs intervalles d’UID et GID. Cette option implique B<--setgroups=deny>.

note: type: Plain text
en: To be able to call B<setgroups>(2), the calling process must at least have CAP_SETGID.  But since Linux 3.19 a further restriction applies: the kernel gives permission to call B<\%setgroups>(2)  only after the GID map (B</proc/>I<pid>B</gid_map>) has been set.  The GID map is writable by root when B<\%setgroups>(2)  is enabled (i.e. B<allow>, the default), and the GID map becomes writable by unprivileged processes when B<\%setgroups>(2)  is permanently disabled (with B<deny>).
fr: Pour pouvoir appeler B<setgroups>(2), le processus appelant doit au moins avoir CAP_SETGID. Mais depuis Linux 3.19, une restriction supplémentaire est appliquée : le noyau accorde la permission à l’appel B<\%setgroups>(2) seulement après que le mappage de GID (B</proc/>I<pid>B</gid_map>) a été réglé. La carte de correspondances de GID peut être écrite par le superutilisateur quand B<\%setgroups>(2) est activé (c'est-à-dire, B<allow>, le comportement par défaut), et la carte de GID peut être écrite par des processus normaux quand B<\%setgroups>(2) est désactivé de façon permanente (avec B<deny>).

note: type: TP
en: B<# unshare --fork --pid --mount-proc readlink /proc/self>
fr: # unshare --fork --pid --mount-proc readlink /proc/self

note: type: Plain text
en: Establish a PID namespace, ensure we're PID 1 in it against a newly mounted procfs instance.
fr: Établir un espace de noms PID, s’assurer d’être le PID 1 dedans par rapport à une instance procfs nouvellement montée.

note: type: TP
en: B<$ unshare --map-root-user --user sh -c whoami>
fr: $ unshare --map-root-user --user sh -c whoami

note: type: TQ
en: root
fr: superutilisateur

note: type: Plain text
en: Establish a user namespace as an unprivileged user with a root user within it.
fr: Établir un espace de noms utilisateur en tant qu’utilisateur ordinaire avec un superutilisateur dedans.

note: type: TP
en: B<# touch /root/uts-ns>
fr: # touch /root/uts-ns

note: type: TQ
en: B<# unshare --uts=/root/uts-ns hostname FOO>
fr: # unshare --uts=/root/uts-ns nom_hôte TOTO

note: type: TQ
en: B<# nsenter --uts=/root/uts-ns hostname>
fr: # nsenter --uts=/root/uts-ns nom_hôte

note: type: TQ
en: FOO
fr: TOTO

note: type: TQ
en: B<# umount /root/uts-ns>
fr: # umount /root/uts-ns

note: type: Plain text
en: Establish a persistent UTS namespace, and modify the hostname.  The namespace is then entered with B<nsenter>.  The namespace is destroyed by unmounting the bind reference.
fr: Établir un espace de noms persistant UTS et modifier le nom d’hôte. L’espace de noms est entré avec B<nsenter>. L’espace de noms est détruit en démontant la référence liée.

note: type: TP
en: B<# mount --bind /root/namespaces /root/namespaces>
fr: # mount --bind /root/espace_de noms /root/espace_de_noms

note: type: TQ
en: B<# mount --make-private /root/namespaces>
fr: # mount --make-private /root/espace_de_noms

note: type: TQ
en: B<# touch /root/namespaces/mnt>
fr: # touch /root/espace_de_noms/montage

note: type: TQ
en: B<# unshare --mount=/root/namespaces/mnt>
fr: # unshare --mount=/root/espace_de_noms/montage

note: type: Plain text
en: Establish a persistent mount namespace referenced by the bind mount /root/namespaces/mnt.  This example shows a portable solution, because it makes sure that the bind mount is created on a shared filesystem.
fr: Établir un espace de noms montage permanent référencé par le montage lié /root/espace_de_noms/montage. Cet exemple montre une solution portable, car il assure que le montage lié est créé sur un système de fichiers partagé.

note: type: TP
en: B<# unshare -pf --kill-child -- bash -c (sleep 999 &) && sleep 1000 &>
fr: # unshare -pf --kill-child -- bash -c (sleep 999 &) && sleep 1000 &

note: type: TQ
en: B<# pid=$!>
fr: # pid=$!

note: type: TQ
en: B<# kill $pid>
fr: # kill $pid

note: type: Plain text
en: Reliable killing of subprocesses of the I<program>.  When B<unshare> gets killed, everything below it gets killed as well.  Without it, the children of I<program> would have orphaned and been re-parented to PID 1.
fr: Destruction fiable de sous-processus du I<programme>. Quand B<unshare> est détruit, toute chose sous lui est aussi détruite. Sans cela, l’enfant du I<programme> serait devenu orphelin et rattaché au PID 1.

note: type: Plain text
en: Run the program only after the current effective user and group IDs have been mapped to the superuser UID and GID in the newly created user namespace.  This makes it possible to conveniently gain capabilities needed to manage various aspects of the newly created namespaces (such as configuring interfaces in the network namespace or mounting filesystems in the mount namespace) even when run unprivileged.  As a mere convenience feature, it does not support more sophisticated use cases, such as mapping multiple ranges of UIDs and GIDs.  This option implies B<--setgroups=deny> and B<--user>.
fr: Exécuter le programme seulement après que les identifiants d’utilisateur et de groupe effectifs ont été mis en correspondance avec les UID et GID du superutilisateur dans le nouvel espace de noms utilisateur. Cela permet d’obtenir facilement les capacités nécessaires pour gérer divers aspects des nouveaux espaces de noms (comme la configuration d’interfaces dans l’espace de noms réseau ou le montage des systèmes de fichiers dans l’espace de noms montage) même lors d’une exécution ordinaire. En tant que fonctionnalité surtout pratique, elle ne permet pas des cas d’utilisation plus sophistiqués comme la mise en correspondance de plusieurs intervalles d’UID et GID. Cette option implique B<--setgroups=deny>.

note: type: Plain text
en: Run the program only after the current effective user and group IDs have been mapped to the same UID and GID in the newly created user namespace. This option implies B<--setgroups=deny> and B<--user>.
fr: Exécuter le programme seulement après que les ID effectifs des utilisateurs et des groupes actuels sont mappés aux mêmes UID et GID dans l’espace de noms nouvellement créé. Cette option suppose B<--setgroups=deny> et B<--user>.

note: type: TP
en: B<-R,>--root=I<dir>
fr: B<-R>, B<--root=>I<répertoire>

note: type: TP
en: B<-w,>--wd=I<dir>
fr: B<-w>, B<--wd=>I<répertoire>

note: type: TP
en: B<-S,>--setuid I<uid>
fr: B<-S>, B<--setuid> I<UID>
