[libvirt] [PATCH] Improve cgroups docs to cover systemd integration

[Eric Blake]

On 11/11/2013 09:59 AM, Daniel P. Berrange wrote:
> From: "Daniel P. Berrange" <berrange at redhat.com>
> 
> As of libvirt 1.1.1 and systemd 205, the cgroups layout used by
> libvirt has some changes. Update the 'cgroups.html' file from
> the website to describe how it works in a systemd world.
> 
> Signed-off-by: Daniel P. Berrange <berrange at redhat.com>
> ---
>  docs/cgroups.html.in | 212 +++++++++++++++++++++++++++++++++++++++++----------
>  1 file changed, 172 insertions(+), 40 deletions(-)
> 

> +
> +    <p>
> +      Given this, an possible systemd cgroups layout involing 3 qemu guests,

s/an/a/
s/involing/involving/


> +    <p>
> +      On hosts which do not use systemd, each consumer has a corresponding cgroup
> +      named <code>$VMNAME.libvirt-{qemu,lxc}</code>. Each consumer is associated
> +      with exactly one partition, which also have a corresponding cgroup usually
> +      named <code>$PARTNAME.partition</code>. The exceptions to this naming rule
> +      are the three top level default partitions, named <code>/system</code> (for
> +      system services), <code>/user</code> (for user login sessions) and
> +      <code>/machine</code> (for virtual machines and containers). By default
> +      every consumer will of course be associated with the <code>/machine</code>
> +      partition. This leads to a hierarchy that looks like:
> +    </p>

Missing example? Or dead text, given that your next sentence also
introduces an example?

> +
> +    <p>
> +      Given this, an possible systemd cgroups layout involing 3 qemu guests,
> +      3 lxc containers and 2 custom child slices, would be:
>      </p>
>  
>      <pre>


> @@ -127,12 +229,54 @@ $ROOT
>      </pre>
>  
>      <p>
> +      Note that the partition names in the guest XML are using a
> +      generic naming format, not the the low level naming convention
> +      required by the underlying host OS. ie you should not include

s/ie/That is,/

> +      any of the <code>.partition</code> or <code>.slice</code>
> +      suffixes in the XML config. Given a partition name
> +      <code>/machine/production</code>, libvirt will automatically
> +      apply the platform specific translation required to get
> +      <code>/machine/production.partition</code> (non-systemd)
> +      or <code>/machine.slice/machine-prodution.slice</code>

s/prodution/production/

ACK with typos fixed.

-- 
Eric Blake   eblake redhat com    +1-919-301-3266
Libvirt virtualization library http://libvirt.org

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 621 bytes
Desc: OpenPGP digital signature
URL: <http://listman.redhat.com/archives/libvir-list/attachments/20131111/7d4a58b7/attachment-0001.sig>