.\" -*- coding: UTF-8 -*- .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH UNSHARE 1 "Februar 2016" util\-linux "Dienstprogramme für Benutzer" .SH BEZEICHNUNG unshare \- Programm in neuen Namensräumen ausführen .SH ÜBERSICHT \fBunshare\fP [Optionen] [\fIProgramm\fP [\fIArgumente\fP]] .SH BESCHREIBUNG Der Befehl \fBunshare\fP erzeugt neue Namensräume (wie in den nachfolgend beschriebenen Befehlszeilenoptionen angegeben) und führt dann das angegebene \fIProgramm\fP aus. Falls kein \fIProgramm\fP angegeben ist, dann wird »${SHELL}« ausgeführt (Vorgabe: /bin/sh). .PP In der Voreinstellung ist ein neuer Namensraum nur so lange beständig, wie er Mitgliedprozesse hat. Ein neuer Namensraum kann beständig gemacht werden, selbst wenn es keine Mitgliedprozesse gibt, indem /proc/\fIPID\fP/ns/\fITyp\fP\-Dateien mit »bind« in einen Dateisystempfad eingebunden werden. Ein Namensraum, der auf diese Weise beständig gemacht wurde, kann anschließend mit \fB\%nsenter\fP(1) betreten werden, sogar, wenn das \fIProgramm\fP beendet wird (außer PID\-Namensräume, bei denen ein dauerhaft laufender Init\-Prozess benötigt wird). Sobald ein beständiger \%Namensraum nicht länger benötigt wird, kann die Beständigkeit mit \fBumount\fP(8) aufgehoben werden, um die Bind\-Einhängung aufzuheben. Weitere Einzelheiten finden Sie im Abschnitt \fBBEISPIELE\fP. .PP \fBunshare\fP verwendet seit Util\-linux Version 2.36 die Dateien /\fIproc/[PID]/ns/pid_for_children\fP und \fI/proc/[PID]/ns/time_for_children\fP für dauerhafte PID\- und ZEIT\-Namensräume. Diese Änderung erfordert einen Linux\-Kernel der Version 4.17 oder neuer. .PP Die folgenden Namensraumtypen können mit \fBunshare\fP erzeugt werden: .TP \fBEinhänge\-Namensraum\fP Ein\- und Aushängen von Dateisystemen betrifft den Rest des Systems nicht, außer für Dateisysteme, die explizit als Mehrfacheinhängungen markiert sind (mit \fBmount \-\-make\-shared\fP; siehe \fI/proc/self/mountinfo\fP oder \fBfindmnt \-o+PROPAGATION\fP für die \fBshared\fP\-Schalter). Für weitere Details siehe \fBmount_namespaces\fP(7). .IP Seit Util\-Linux Version 2.27 setzt \fBunshare\fP die Ausbreitung in einem neuen Einhängenamensraum auf \fBprivate\fP, um sicherzustellen, dass der neue Namensraum wirklich getrennt ist. Diese Funktionalität kann mit der Option \fB\-\-propagation unchanged\fP deaktiviert werden. Beachten Sie, dass \fBprivate\fP die Vorgabe des Kernels ist. .TP \fBUTS\-Namensraum\fP Setzen des Rechner\- oder Domain\-Namens wird den Rest des Systems nicht betreffen. Für weitere Details siehe \fButs_namespaces\fP(7). .TP \fBIPC\-Namensraum\fP Der Prozess wird einen unabhängigen Namensraum für POSIX\-Nachrichtenwarteschlangen sowie System\-V\-\%Nachrichtenwarteschlangen, Semaphore\-Gruppen und gemeinsame Speichersegmente haben. Für weitere Details siehe \fBipc_namespaces\fP(7). .TP \fBNetz\-Namensraum\fP Der Prozess wird über unabhängige IPv4\- und IPv6\-Stapel, IP\-Routing\-Tabellen, Firewall\-Regeln, die Verzeichnisbäume \fI/proc/net\fP und \fI/sys/class/net\fP usw. verfügen. Für weitere Details siehe \fBnetwork_namespaces\fP(7). .TP \fBPID\-Namensraum\fP Kindprozesse werden eine eigene Gruppe von Abbildungen der PIDs zu Prozessen haben. Für weitere Details siehe \fBpid_namespaces\fP(7). .TP \fBCgroup\-Namensraum\fP Der Prozess wird über einen virtualisierten Blick auf \fI/proc\:/self\:/cgroup\fP verfügen und neue Cgroup\-Einhängungen werden ihre Wurzel in der Wurzel der Cgroup\-Namensraum\-Wurzel haben. Für weitere Details siehe \fBcgroup_namespaces\fP(7). .TP \fBBenutzer\-Namensraum\fP Der Prozess wird über eine eindeutige Gruppe an UIDs, GIDS und Capabilities verfügen. Für weitere Details siehe \fBuser_namespaces\fP(7). .TP \fBZeit\-Namensraum\fP Der Prozess kann eine abweichende Sicht auf \fBCLOCK_MONOTONIC\fP und/oder \fBCLOCK_BOOTTIME\fP haben, was mittels \fI/proc/self/timens_offsets\fP geändert werden kann. Für weitere Details, siehe \fBtime_namespaces\fP(7). .SH OPTIONEN .TP \fB\-i\fP,\fB \-\-ipc\fP[\fB=\fP\fIDatei\fP] Trennen des IPC\-Namensraums. Falls \fIDatei\fP angegeben ist, wird ein beständiger Namensraum mit einer »bind«\-Einhängung erstellt. .TP \fB\-m\fP,\fB \-\-mount\fP[\fB=\fP\fIDatei\fP] Hebt die Freigabe des eingehängten Namensraums auf. Falls \fIDatei\fP angegeben ist, wird ein beständiger Namensraum durch ein Einhängen mit »bind« erstellt. Beachten Sie, dass \fIDatei\fP auf einem Dateisystem liegen muss, dessen Ausbreitungstyp nicht auf \fBshared\fP gesetzt ist (anderenfalls würde ein Fehler auftreten). Verwenden Sie den Befehl \fBfindmnt \-o+PROPAGATION\fP, wenn Sie sich bezüglich der derzeitigen Einstellung nicht sicher sind. Lesen Sie auch die nachfolgenden Beispiele. .TP \fB\-n\fP,\fB \-\-net\fP[\fB=\fP\fIDatei\fP] Trennen des Netz\-Namensraums. Falls \fIDatei\fP angegeben ist, wird ein beständiger Namensraum mit einer »bind«\-Einhängung erstellt. .TP \fB\-p\fP,\fB \-\-pid\fP[\fB=\fP\fIDatei\fP] Trennen des PID\-Namensraums. Falls \fIDatei\fP angegeben ist, wird ein beständiger Namensraum mit einer »bind«\-Einhängung erstellt. (Die Erstellung eines beständigen Namensraums wird fehlschlagen, wenn nicht auch die Option \fB\-\-fork\fP angegeben ist.) .IP Siehe auch die Optionen \fB\-\-fork\fP und \fB\-\-mount\-proc\fP. .TP \fB\-u\fP,\fB \-\-uts\fP[\fB=\fP\fIDatei\fP] Trennen des UTS\-Namensraums. Falls \fIDatei\fP angegeben ist, wird ein beständiger Namensraum mit einer »bind«\-Einhängung erstellt. .TP \fB\-U\fP,\fB \-\-user\fP[\fB=\fP\fIDatei\fP] Trennen des Benutzer\-Namensraums. Falls \fIDatei\fP angegeben ist, wird ein beständiger Namensraum mit einer »bind«\-Einhängung erstellt. .TP \fB\-C\fP,\fB \-\-cgroup\fP[\fB=\fP\fIDatei\fP] Trennen des Cgroup\-Namensraums. Falls \fIDatei\fP angegeben ist, wird ein beständiger Namensraum mit einer »bind«\-Einhängung erstellt. .TP \fB\-T\fP,\fB \-\-time\fP[\fB=\fP\fIDatei\fP] Trennen des Zeit\-Namensraums. Falls \fIDatei\fP angegeben ist, wird ein beständiger Namensraum mit einer »bind«\-Einhängung erstellt. Mit den Optionen \fB\-\-monotonic\fP und \fB\-\-bootime\fP können Sie den korrespondierenden Versatz im Zeit\-Namensraum angeben. .TP \fB\-f\fP,\fB \-\-fork\fP Forkt das angegebene \fIProgramm\fP als Kindprozess von \fBunshare\fP, anstatt es direkt auszuführen. Dies ist nützlich, wenn Sie einen neuen PID\-Namensraum erstellen. Beachten Sie: Wenn \fBunshare\fP auf einen Kindprozess wartet, dann ignoriert es SIGINT und SIGTERM und leitet keine Signale an den Kindprozess weiter. Es ist daher nötig, Signale an den Kindprozess zu senden. .TP \fB\-\-keep\-caps\fP stellt bei übergebener Option \fB\-\-user\fP sicher, dass die im Benutzernamensraum gewährten Capabilities im Kindprozess erhalten bleiben. .TP \fB\-\-kill\-child\fP[\fB=\fP\fISigname\fP] Wenn sich \fBunshare\fP beendet, soll \fISigname\fP an den mit Fork erstellten Kindprozess gesandt werden. Kombiniert mit \fB\-\-pid\fP erlaubt dies ein leichtes und zuverlässiges Töten eines gesamten Prozessbaums unterhalb von \fBunshare\fP. Falls nicht angegeben, ist \fISigname\fP standardmäßig \fBSIGKILL\fP. Diese Option impliziert \fB\-\-fork\fP. .TP \fB\-\-mount\-proc\fP[\fB=\fP\fIEinhängepunkt\fP] Direkt vor Ausführung des Programms wird das proc\-Dateisystem unter \fIEinhängepunkt\fP (Vorgabe ist /proc) eingehängt. Das ist bei der Erstellung eines neuen PID\-Namensraums nützlich. Dies impliziert auch die Erstellung eines neuen Einhängenamensraums, da die /proc\-Einhängung ansonsten bestehende Programme auf dem System durcheinanderbringen würde. Das neue proc\-Dateisystem wird explizit als privat eingehängt (mit MS_PRIVATE|MS_REC). .TP \fB\-\-map\-user=\fP\fIUID|Name\fP führt das Programm erst aus, nachdem die aktuelle effektive Benutzerkennung auf \fIUID\fP gesetzt wurde. Falls diese Option mehrfach angegeben wird, hat die zuletzt angegebene Option Vorrang. Diese Option impliziert \fB\-\-user\fP. .TP \fB\-\-map\-group=\fP\fIGID|Name\fP führt das Programm erst aus, nachdem die aktuelle effektive Gruppenkennung auf \fIGID\fP gesetzt wurde. Falls diese Option mehrfach angegeben wird, hat die zuletzt angegebene Option Vorrang. Diese Option impliziert \fB\-\-setgroups=deny\fP und \fB\-\-user\fP. .TP \fB\-r\fP,\fB \-\-map\-root\-user\fP Führt das Programm erst aus, wenn die effektive Benutzer\- und Gruppenkennungen auf die UID und GID des Systemverwalters in dem neu erstellten Namensraum abgebildet wurde. Dies ermöglicht es, bequem die benötigten Capabilities zu erlangen, um verschiedene Aspekte in dem neu erstellten Namensraum zu verwalten (wie die Konfiguration von Schnittstellen im Netz\-Namensraum oder das Einhängen von Dateisystemen in dem Einhängenamensraum), selbst bei unprivilegierter Ausführung. Als reine Bequemlichkeitsfunktionalität unterstützt es keine fortgeschritteneren Anwendungsfälle, wie das Abbilden von mehreren Bereichen von UIDs und GIDs. Diese Option impliziert \fB\-\-setgroups=deny\fP und \fB\-\-user\fP. Diese Option ist äquivalent zu \fB\-\-map\-user=0 \-\-map\-group=0\fP. .TP \fB\-c\fP,\fB \-\-map\-current\-user\fP führt das Programm erst aus, nachdem die aktuellen effektiven Benutzer\- und Gruppenkennungen im neu erzeugten Benutzernamensraum auf die gleiche UID und GID gesetzt wurden. Diese Option impliziert \fB\-\-setgroups=deny\fP und \fB\-\-user\fP. Diese Option ist äquivalent zu \fB\-\-map\-user=$(id \-ru) \-\-map\-group=$(id \-rg)\fP. .TP \fB\-\-propagation private\fP|\fBshared\fP|\fBslave\fP|\fBunchanged\fP Setzt den Einhängeausbreitungsschalter in dem neuen Einhängenamensraum rekursiv. Die Vorgabe ist, die Ausbreitung auf \fIprivate\fP zu setzen. Es ist möglich, diese Funktionalität mit dem Argument \fBunchanged\fP zu deaktivieren. Diese Option wird ohne Rückmeldung ignoriert, wenn der Einhängenamensraum (\fB\-\-mount\fP) nicht angefordert wird. .TP \fB\-\-setgroups allow\fP|\fBdeny\fP Erlaubt oder verweigert den Systemaufruf \fBsetgroups\fP(2) in Benutzer\-Namensräumen. .sp Um \fBsetgroups\fP(2) aufrufen zu können, muss der aufrufende Prozess mindestens über CAP_SETGID verfügen. Seit Linux 3.19 gilt eine weitere Einschränkung: Der Kernel erteilt die Berechtigung, \fB\%setgroups\fP(2) aufzurufen, nur nachdem die GID\-Abbildung (\fB/proc/\fP\fIPID\fP\fB/gid_map\fP) eingerichtet wurde. Die GID\-Abbildung ist durch Root beschreibbar, wenn \fB\%setgroups\fP(2) aktiviert ist (d.h. \fBallow\fP, die Vorgabe) und die GID\-Abbildung wird durch unprivilegierte Prozesse beschreibbar, wenn \fB\%setgroups\fP(2) permanent deaktiviert ist (mit \fBdeny\fP). .TP \fB\-R\fP,\fB \-\-root=\fP\fIVerzeichnis\fP führt den Befehl aus, wobei das Wurzelverzeichnis auf das angegebene \fIVerzeichnis\fP gesetzt wird. .TP \fB\-w\fP,\fB \-\-wd=\fP\fIVerzeichnis\fP ändert das Arbeitsverzeichnis auf das angegebene \fIVerzeichnis\fP. .TP \fB\-S\fP,\fB \-\-setuid \fP\fIUID\fP legt die Benutzerkennung fest, die in dem betretenen Namensraum verwendet wird. .TP \fB\-G\fP,\fB \-\-setgid \fP\fIGID\fP legt die Gruppenkennung fest, die in dem betretenen Namensraum verwendet wird und entfernt zusätzliche Gruppen. .TP \fB\-\-monotonic\fP\fI Versatz\fP legt den Versatz von \fBCLOCK_MONOTONIC\fP fest, der im betretenen Zeit\-Namensraum verwendet wird. Diese Option erfordert die Trennung eines Zeit\-Namensraums mit \fB\-\-time\fP. .TP \fB\-\-boottime\fP\fI Versatz\fP legt den Versatz von \fBCLOCK_BOOTTIME\fP fest, der im betretenen Zeit\-Namensraum verwendet wird. Diese Option erfordert die Trennung eines Zeit\-Namensraums mit \fB\-\-time\fP. .TP \fB\-V\fP,\fB \-\-version\fP zeigt Versionsinformationen an und beendet das Programm. .TP \fB\-h\fP,\fB \-\-help\fP zeigt einen Hilfetext an und beendet das Programm. .SH ANMERKUNGEN Die proc\- und sysfs\-Dateisystemeinhängungen als Root in einem Benutzernamensraum müssen eingeschränkt werden, so dass ein weniger privilegierter Benutzer nicht mehr Zugriffe auf sensible Dateien haben kann, als ein höher privilegierter Benutzer unverfügbar gemacht hat. Kurz gesagt, die Regeln für proc und sysfs sind so ähnlich zu einer Bind\-Einhängung wie möglich. .SH BEISPIELE Der folgende Befehl erzeugt einen PID\-Namensraum, wobei \fB\-\-fork\fP verwendet wird, um sicherzustellen, dass der aufgerufene Befehl in einem Kind\-Namensraum ausgeführt wird (welcher der erste Prozess im Namensraum ist), der die PID 1 hat. Die Option \fB\-\-mount\-proc\fP sorgt dafür, dass gleichzeitig auch ein neuer Einhängenamensraum erzeugt und ein neues \fBproc\fP(5)\-Dateisystem eingehängt wird, das Informationen zum neuen PID\-Namensraum enthält. Wenn der Befehl \fBreadlink\fP beendet wird, werden die neuen Namensräume automatisch zerstört. .PP .in +4n .EX \fB# unshare \-\-fork \-\-pid \-\-mount\-proc readlink /proc/self\fP 1 .EE .in .PP Mit den Rechten eines unprivilegierten Benutzers einen neuen Benutzernamensraum erstellen, in welchem die Anmeldedaten des Benutzers auf die Root\-Kennungen innerhalb des Namensraums abgebildet werden: .PP .in +4n .EX \fB$ id \-u; id \-g\fP 1000 1000 \fB$ unshare \-\-user \-\-map\-root\-user \e\fP \fBsh \-c \(aqwhoami; cat /proc/self/uid_map /proc/self/gid_map\(aq\fP root 0 1000 1 0 1000 1 .EE .in .PP Der erste der folgenden Befehle erzeugt einen neuen dauerhaften UTS\-Namenraum und ändert den Rechnernamen so, wie er im Namensraum gesehen wird. Der Namensraum wird dann mit \fBnsenter\fP(1) betreten, um den geänderten Rechnernamen anzuzeigen; dieser Schritt demonstriert, dass der UTS\-Namensraum weiter existiert, obwohl der Namensraum nach dem Beenden des \fBunshare\fP\-Prozesses keine eigenen Mitgliedprozesse mehr hat. Der Namensraum wird dann durch Entfernen der Bind\-Einhängung zerstört. .PP .in +4n .EX \fB# touch /root/uts\-ns\fP \fB# unshare \-\-uts=/root/uts\-ns hostname FOO\fP \fB# nsenter \-\-uts=/root/uts\-ns hostname\fP FOO \fB# umount /root/uts\-ns\fP .EE .in .PP Die folgenden Befehle etablieren einen dauerhaften Einhängenamensraum, der von der »bind«\-Einhängung /root/namespaces/mnt angegeben wird. Um sicherzustellen, dass die Erzeugung dieser Bind\-Einhängung erfolgreich ist, wird das Elternverzeichnis (\fI/root/namespaces\fP) zu einer Bind\-Einhängung, deren Ausbreitungstyp nicht \fBshared\fP ist. .PP .in +4n .EX \fB# mount \-\-bind /root/namespaces /root/namespaces\fP \fB# mount \-\-make\-private /root/namespaces\fP \fB# touch /root/namespaces/mnt\fP \fB# unshare \-\-mount=/root/namespaces/mnt\fP .EE .in .PP Die folgenden Befehle demonstrieren die Verwendung der Option \fB\-\-kill\-child\fP beim Erzeugen eines PID\-Namensraums, um sicherzustellen, dass beim Töten von \fBunshare\fP alle Prozesse innerhalb des PID\-Namensraums getötet werden. .PP .in +4n .EX \fB# set +m \fP# Keine Meldungen zum Auftragsstatus ausgeben \fB# unshare \-\-pid \-\-fork \-\-mount\-proc \-\-kill\-child \-\- \e\fP \fBbash \-\-norc \-c \(aq(sleep 555 &) && (ps a &) && sleep 999\(aq &\fP [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 \fB# ps h \-o 'comm' $! \fP# Zeigen, dass der Hintergrund\-Job unshare(1) ist unshare \fB# kill $! \fP# unshare(1) töten \fB# pidof sleep\fP .EE .in .PP Der Befehl \fBpidof\fP gibt nichts aus, da die Kindprozesse getötet wurden. Genauer gesagt: Wenn der \fBsleep\fP\-Prozess, der in dem Namensraum die Prozesskennung 1 hat (also der Init\-Prozess dieses Namensraums) getötet wurde, dann werden daraufhin alle anderen Prozesse in diesem Namensraum getötet. Im Gegensatz dazu zeigt eine ähnliche Reihe von Befehlen, bei denen die Option \fB\-\-kill\-child\fP nicht verwendet wird, dass die Prozesse in diesem PID\-Namensraum beim Beenden von \fBunshare\fP nicht getötet werden: .PP .in +4n .EX \fB# unshare \-\-pid \-\-fork \-\-mount\-proc \-\- \e\fP \fBbash \-\-norc \-c \(aq(sleep 555 &) && (ps a &) && sleep 999\(aq &\fP [1] 53479 # 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 \fB# kill $!\fP \fB# pidof sleep\fP 53482 53480 .EE .in .PP Der folgende Befehl demonstriert die Erzeugung eines Zeit\-Namensraums, in dem die Bootzeit\-Uhr auf einen Zeitpunkt gesetzt ist, der einige Jahre in der Vergangenheit liegt: .PP .in +4n .EX \fB# uptime \-p \fP# Betriebszeit im ursprünglichen Zeit\-Namensraum anzeigen up 21 hours, 30 minutes \fB# unshare \-\-time \-\-fork \-\-boottime 300000000 uptime \-p\fP up 9 years, 28 weeks, 1 day, 2 hours, 50 minutes .EE .in .SH AUTOREN .UR dottedmag@dottedmag.net Mikhail Gusarov .UE .br .UR kzak@redhat.com Karel Zak .UE .SH "SIEHE AUCH" \fBclone\fP(2), \fBunshare\fP(2), \fBnamespaces\fP(7), \fBmount\fP(8) .SH VERFÜGBARKEIT Der Befehl unshare ist Teil des Pakets util\-linux und kann von https://www.kernel.org/pub/linux/utils/util\-linux/ heruntergeladen werden. .SH ÜBERSETZUNG Die deutsche Übersetzung dieser Handbuchseite wurde von Chris Leick , Dr. Tobias Quathamer , Helge Kreutzmann und Mario Blättermann erstellt. Diese Übersetzung ist Freie Dokumentation; lesen Sie die .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen. Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die .MT debian-l10n-german@\:lists.\:debian.\:org Mailingliste der Übersetzer .ME .