diff options
| author | Lennart Poettering <lennart@poettering.net> | 2015-01-22 15:12:11 +0100 |
|---|---|---|
| committer | Lennart Poettering <lennart@poettering.net> | 2015-01-22 15:14:36 +0100 |
| commit | e0ea94c1e2ab3930c85c6057189a2a829a13a800 (patch) | |
| tree | c595b1bdf282d205d5ce44008ed4b9f28d2e0586 /man/systemd-nspawn.xml | |
| parent | 838d5f029882e8122b0c2c7e988546a4c4981d21 (diff) | |
man: document new download magic
Diffstat (limited to 'man/systemd-nspawn.xml')
| -rw-r--r-- | man/systemd-nspawn.xml | 83 |
1 files changed, 49 insertions, 34 deletions
diff --git a/man/systemd-nspawn.xml b/man/systemd-nspawn.xml index b7f3be923d..b0f7aa37cb 100644 --- a/man/systemd-nspawn.xml +++ b/man/systemd-nspawn.xml @@ -247,26 +247,43 @@ the root directory for the container from. Takes a path to a regular file or to a block device node. The file or - block device must contain either an - MBR partition table with a single - partition of type 0x83 that is marked - bootable, or a GUID partition table - with a root partition which is mounted - as the root directory of the - container. Optionally, GPT images may - contain a home and/or a server data - partition which are mounted to the - appropriate places in the - container. All these partitions must - be identified by the partition types - defined by the <ulink - url="http://www.freedesktop.org/wiki/Specifications/DiscoverablePartitionsSpec/">Discoverable - Partitions Specification</ulink>. Any - other partitions, such as foreign - partitions, swap partitions or EFI - system partitions are not mounted. May - not be specified together with - <option>--directory=</option>, + block device must contain either:</para> + + <itemizedlist> + <listitem><para>An MBR + partition table with a single + partition of type 0x83 that is + marked + bootable.</para></listitem> + + <listitem><para>A GUID + partition table (GPT) with a single + partition of type + 0fc63daf-8483-4772-8e79-3d69d8477de4.</para></listitem> + + <listitem><para>A GUID + partition table (GPT) with a + marked root partition which is + mounted as the root directory + of the container. Optionally, + GPT images may contain a home + and/or a server data partition + which are mounted to the + appropriate places in the + container. All these + partitions must be identified + by the partition types defined + by the <ulink + url="http://www.freedesktop.org/wiki/Specifications/DiscoverablePartitionsSpec/">Discoverable + Partitions + Specification</ulink>.</para></listitem> + </itemizedlist> + + <para>Any other partitions, such as + foreign partitions, swap partitions or + EFI system partitions are not + mounted. May not be specified together + with <option>--directory=</option>, <option>--template=</option> or <option>--ephemeral</option>.</para></listitem> </varlistentry> @@ -412,7 +429,7 @@ <varlistentry> <term><option>--network-ipvlan=</option></term> - <listitem><para>Create a + <listitem><para>Create an <literal>ipvlan</literal> interface of the specified Ethernet network interface and add it to the @@ -831,8 +848,18 @@ <refsect1> <title>Examples</title> + + <example> + <title>Download a Fedora image and start a shell in it</title> + + <programlisting># machinectl pull-raw --verify=no http://ftp.halifax.rwth-aachen.de/fedora/linux/releases/21/Cloud/Images/x86_64/Fedora-Cloud-Base-20141203-21.x86_64.raw.xz +# systemd-nspawn -M Fedora-Cloud-Base-20141203-21</programlisting> + +<para>This downloads an image using <citerefentry><refentrytitle>machinectl</refentrytitle><manvolnum>1</manvolnum></citerefentry> and opens a shell in it.</para> + </example> + <example> - <title>Boot a minimal Fedora distribution in a container</title> + <title>Build and boot a minimal Fedora distribution in a container</title> <programlisting># yum -y --releasever=21 --nogpg --installroot=/srv/mycontainer --disablerepo='*' --enablerepo=fedora install systemd passwd yum fedora-release vim-minimal # systemd-nspawn -bD /srv/mycontainer</programlisting> @@ -867,18 +894,6 @@ </example> <example> - <title>Enable Arch Linux container on boot</title> - - <programlisting># mv ~/arch-tree /var/lib/machines/arch -# systemctl enable systemd-nspawn@arch.service -# systemctl start systemd-nspawn@arch.service</programlisting> - - <para>This makes the Arch Linux container part of the - <filename>multi-user.target</filename> on the host. - </para> - </example> - - <example> <title>Boot into an ephemeral <literal>btrfs</literal> snapshot of the host system</title> <programlisting># systemd-nspawn -D / -xb</programlisting> |