[libvirt] [PATCH] Add documentation for access control system

Michal Privoznik mprivozn at redhat.com
Fri Aug 9 13:08:15 UTC 2013


On 08.08.2013 13:27, Daniel P. Berrange wrote:
> From: "Daniel P. Berrange" <berrange at redhat.com>
> 
> This adds two new pages to the website, acl.html describing
> the general access control framework and permissions models,
> and aclpolkit.html describing the use of polkit as an
> access control driver.
> 
> page.xsl is modified to support a new syntax
> 
>   <div id="include" filename="somefile.htmlinc"/>
> 
> which will cause the XSL transform to replace that <div>
> with the contents of 'somefile.htmlinc'. We use this in
> the acl.html.in file, to pull the table of permissions
> for each libvirt object. This table is autogenerated
> from the enums in src/access/viraccessperms.h by the
> genaclperms.pl script.
> 
> newapi.xsl is modified so that the list of permissions
> checks shown against each API will link to the description
> of the permissions in acl.html
> 
> Signed-off-by: Daniel P. Berrange <berrange at redhat.com>
> ---
>  .gitignore             |   1 +
>  docs/Makefile.am       |  12 +-
>  docs/acl.html.in       | 100 ++++++++++++
>  docs/aclpolkit.html.in | 414 +++++++++++++++++++++++++++++++++++++++++++++++++
>  docs/auth.html.in      |   6 +-
>  docs/genaclperms.pl    | 124 +++++++++++++++
>  docs/newapi.xsl        |   4 +-
>  docs/page.xsl          |  11 ++
>  docs/sitemap.html.in   |  10 ++
>  9 files changed, 677 insertions(+), 5 deletions(-)
>  create mode 100644 docs/acl.html.in
>  create mode 100644 docs/aclpolkit.html.in
>  create mode 100644 docs/genaclperms.pl

ACL, I mean ACK :)

Michal




More information about the libvir-list mailing list