docs: Update how we create cgroup directory names

Commit <c3bd0019c0> changed the way how cgroup directory names are
constructed but the documentation was not updated.

Signed-off-by: Pavel Hrdina <phrdina@redhat.com>
This commit is contained in:
Pavel Hrdina 2018-04-19 14:45:19 +02:00
parent 9c29690478
commit 7966414194

View File

@ -76,11 +76,13 @@
<p> <p>
The systemd convention is for the scope name of virtual machines / containers The systemd convention is for the scope name of virtual machines / containers
to be of the general format <code>machine-$NAME.scope</code>. Libvirt forms the to be of the general format <code>machine-$NAME.scope</code>. Libvirt forms the
<code>$NAME</code> part of this by concatenating the driver type with the name <code>$NAME</code> part of this by concatenating the driver type with the id
of the guest, and then escaping any systemd reserved characters. and truncated name of the guest, and then escaping any systemd reserved
characters.
So for a guest <code>demo</code> running under the <code>lxc</code> driver, So for a guest <code>demo</code> running under the <code>lxc</code> driver,
we get a <code>$NAME</code> of <code>lxc-demo</code> which when escaped is we get a <code>$NAME</code> of <code>lxc-12345-demo</code> which when escaped
<code>lxc\x2ddemo</code>. So the complete scope name is <code>machine-lxc\x2ddemo.scope</code>. is <code>lxc\x2d12345\x2ddemo</code>. So the complete scope name is
<code>machine-lxc\x2d12345\x2ddemo.scope</code>.
The scope names map directly to the cgroup directory names. The scope names map directly to the cgroup directory names.
</p> </p>
@ -113,19 +115,19 @@ $ROOT
| |
+- machine.slice +- machine.slice
| |
+- machine-qemu\x2dvm1.scope +- machine-qemu\x2d1\x2dvm1.scope
| | | |
| +- emulator | +- emulator
| +- vcpu0 | +- vcpu0
| +- vcpu1 | +- vcpu1
| |
+- machine-qemu\x2dvm2.scope +- machine-qemu\x2d2\x2dvm2.scope
| | | |
| +- emulator | +- emulator
| +- vcpu0 | +- vcpu0
| +- vcpu1 | +- vcpu1
| |
+- machine-qemu\x2dvm3.scope +- machine-qemu\x2d3\x2dvm3.scope
| | | |
| +- emulator | +- emulator
| +- vcpu0 | +- vcpu0
@ -135,15 +137,15 @@ $ROOT
| | | |
| +- machine-engineering-testing.slice | +- machine-engineering-testing.slice
| | | | | |
| | +- machine-lxc\x2dcontainer1.scope | | +- machine-lxc\x2d11111\x2dcontainer1.scope
| | | |
| +- machine-engineering-production.slice | +- machine-engineering-production.slice
| | | |
| +- machine-lxc\x2dcontainer2.scope | +- machine-lxc\x2d22222\x2dcontainer2.scope
| |
+- machine-marketing.slice +- machine-marketing.slice
| |
+- machine-lxc\x2dcontainer3.scope +- machine-lxc\x2d33333\x2dcontainer3.scope
</pre> </pre>
<h3><a id="currentLayoutGeneric">Non-systemd cgroups layout</a></h3> <h3><a id="currentLayoutGeneric">Non-systemd cgroups layout</a></h3>
@ -174,19 +176,19 @@ $ROOT
| |
+- machine +- machine
| |
+- vm1.libvirt-qemu +- qemu-1-vm1.libvirt-qemu
| | | |
| +- emulator | +- emulator
| +- vcpu0 | +- vcpu0
| +- vcpu1 | +- vcpu1
| |
+- vm2.libvirt-qemu +- qeme-2-vm2.libvirt-qemu
| | | |
| +- emulator | +- emulator
| +- vcpu0 | +- vcpu0
| +- vcpu1 | +- vcpu1
| |
+- vm3.libvirt-qemu +- qemu-3-vm3.libvirt-qemu
| | | |
| +- emulator | +- emulator
| +- vcpu0 | +- vcpu0
@ -196,15 +198,15 @@ $ROOT
| | | |
| +- testing.partition | +- testing.partition
| | | | | |
| | +- container1.libvirt-lxc | | +- lxc-11111-container1.libvirt-lxc
| | | |
| +- production.partition | +- production.partition
| | | |
| +- container2.libvirt-lxc | +- lxc-22222-container2.libvirt-lxc
| |
+- marketing.partition +- marketing.partition
| |
+- container3.libvirt-lxc +- lxc-33333-container3.libvirt-lxc
</pre> </pre>
<h2><a id="customPartiton">Using custom partitions</a></h2> <h2><a id="customPartiton">Using custom partitions</a></h2>