diff options
author | Lennart Poettering <lennart@poettering.net> | 2013-10-31 01:25:44 +0100 |
---|---|---|
committer | Lennart Poettering <lennart@poettering.net> | 2013-10-31 01:43:38 +0100 |
commit | 04d39279245834494baccfdb9349db8bf80abd13 (patch) | |
tree | 2e6b213bfd273af6e157e77bf0d03ff68bf144cc /man | |
parent | f85fc8454137a5cfba99b3a24aaa6dc38f6e2768 (diff) |
machinectl: add new command to spawn a getty inside a container
Diffstat (limited to 'man')
-rw-r--r-- | man/machinectl.xml | 13 | ||||
-rw-r--r-- | man/systemd-nspawn.xml | 30 |
2 files changed, 19 insertions, 24 deletions
diff --git a/man/machinectl.xml b/man/machinectl.xml index f2fa6ce53e..c06d0c7abb 100644 --- a/man/machinectl.xml +++ b/man/machinectl.xml @@ -263,6 +263,19 @@ <option>--signal=</option> to select the signal to send.</para></listitem> </varlistentry> + + <varlistentry> + <term><command>login [ID]</command></term> + + <listitem><para>Open a terminal login + session to a container. This will + create a TTY connection to a specific + container and asks for execution of a + getty on it. Note that this is only + supported for containers running + <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry> + as init system.</para></listitem> + </varlistentry> </variablelist> </refsect1> diff --git a/man/systemd-nspawn.xml b/man/systemd-nspawn.xml index 7d450f912c..c2be6d5446 100644 --- a/man/systemd-nspawn.xml +++ b/man/systemd-nspawn.xml @@ -123,10 +123,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. It is however possible to - enter an existing container, see - <link linkend='example-nsenter'>Example 4</link> below. - </para> + underlying file system. Use + <citerefentry><refentrytitle>machinectl</refentrytitle><manvolnum>1</manvolnum></citerefentry>'s + <command>login</command> command to request an + additional login prompt in a running container.</para> <para><command>systemd-nspawn</command> implements the <ulink @@ -409,24 +409,6 @@ 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 -m -u -i -n -p -t $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> @@ -439,11 +421,11 @@ <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>, - <citerefentry><refentrytitle>systemd.slice</refentrytitle><manvolnum>5</manvolnum></citerefentry> + <citerefentry><refentrytitle>systemd.slice</refentrytitle><manvolnum>5</manvolnum></citerefentry>, + <citerefentry><refentrytitle>machinectl</refentrytitle><manvolnum>1</manvolnum></citerefentry> </para> </refsect1> |