diff options
Diffstat (limited to 'man/systemd-nspawn.xml')
| -rw-r--r-- | man/systemd-nspawn.xml | 30 |
1 files changed, 27 insertions, 3 deletions
diff --git a/man/systemd-nspawn.xml b/man/systemd-nspawn.xml index 6a01ffd450..5cba40bcd4 100644 --- a/man/systemd-nspawn.xml +++ b/man/systemd-nspawn.xml @@ -49,7 +49,10 @@ <refsynopsisdiv> <cmdsynopsis> - <command>systemd-nspawn <arg choice="opt" rep="repeat">OPTIONS</arg> <arg choice="opt">COMMAND</arg> <arg choice="opt" rep="repeat">ARGS</arg></command> + <command>systemd-nspawn</command> + <arg choice="opt" rep="repeat">OPTIONS</arg> + <arg choice="opt">COMMAND</arg> + <arg choice="opt" rep="repeat">ARGS</arg> </cmdsynopsis> </refsynopsisdiv> @@ -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.</para> + underlying file system. It is however possible to + enter an existing container, see + <link linkend='example-nsenter'>Example 4</link> below. + </para> <para><command>systemd-nspawn</command> implements the <ulink @@ -318,7 +324,6 @@ distribution into the directory <filename>~/debian-tree/</filename> and then spawns a shell in a namespace container in it.</para> - </refsect1> <refsect1> @@ -332,6 +337,24 @@ boots an OS in a namespace container in it.</para> </refsect1> + <refsect1 id='example-nsenter'> + <title>Example 4</title> + + <para>To enter the container, PID of one of the + processes sharing the new namespaces must be used. + <command>systemd-nspawn</command> prints the PID + (as viewed from the outside) of the launched process, + and it can be used to enter the container.</para> + + <programlisting># nsenter -muinpt $PID</programlisting> + + <para><citerefentry><refentrytitle>nsenter</refentrytitle><manvolnum>1</manvolnum></citerefentry> + is part of + <ulink url="https://github.com/karelzak/util-linux">util-linux</ulink>. + Kernel support for entering namespaces was added in + Linux 3.8.</para> + </refsect1> + <refsect1> <title>Exit status</title> @@ -344,6 +367,7 @@ <para> <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>chroot</refentrytitle><manvolnum>1</manvolnum></citerefentry>, + <citerefentry><refentrytitle>unshare</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>yum</refentrytitle><manvolnum>8</manvolnum></citerefentry>, <citerefentry><refentrytitle>debootstrap</refentrytitle><manvolnum>8</manvolnum></citerefentry>, <citerefentry><refentrytitle>pacman</refentrytitle><manvolnum>8</manvolnum></citerefentry> |