X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd-nspawn.xml;h=8396def003e59b3b61f793938ec6a7ab0108804b;hp=6a01ffd450aff17b573633131960762212205160;hb=cb96a2c69a312fb089fef4501650f4fc40a1420b;hpb=e670b166a08b7c1031a9e7d7675fa9a29c3e19c9
diff --git a/man/systemd-nspawn.xml b/man/systemd-nspawn.xml
index 6a01ffd45..8396def00 100644
--- a/man/systemd-nspawn.xml
+++ b/man/systemd-nspawn.xml
@@ -49,7 +49,10 @@
- systemd-nspawn OPTIONSCOMMANDARGS
+ systemd-nspawn
+ OPTIONS
+ COMMAND
+ ARGS
@@ -114,7 +117,10 @@
see each other. The PID namespace separation of the
two containers is complete and the containers will
share very few runtime objects except for the
- underlying file system.
+ underlying file system. It is however possible to
+ enter an existing container, see
+ Example 4 below.
+
systemd-nspawn implements the
Automatically search
for an init binary and invoke it
instead of a shell or a user supplied
- program.
+ program. A command to execute cannot
+ be specified in this case.
+
@@ -318,7 +326,6 @@
distribution into the directory
~/debian-tree/ and then spawns a
shell in a namespace container in it.
-
@@ -332,6 +339,24 @@
boots an OS in a namespace container in it.
+
+ Example 4
+
+ To enter the container, PID of one of the
+ processes sharing the new namespaces must be used.
+ systemd-nspawn prints the PID
+ (as viewed from the outside) of the launched process,
+ and it can be used to enter the container.
+
+ # nsenter -muinpt $PID
+
+ nsenter1
+ is part of
+ util-linux.
+ Kernel support for entering namespaces was added in
+ Linux 3.8.
+
+
Exit status
@@ -344,6 +369,7 @@
systemd1,
chroot1,
+ unshare1,
yum8,
debootstrap8,
pacman8