summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorChris St. Pierre <chris.a.st.pierre@gmail.com>2011-07-19 09:16:47 -0400
committerChris St. Pierre <chris.a.st.pierre@gmail.com>2011-07-19 09:16:47 -0400
commit3291a875339a7e5569d4232d2333fe37b1f6eac0 (patch)
tree8b30caf7df3e36a2760618eb4ed29a954167d8d3 /doc
parenta5877a79f6dbde1ea4be49b3b38a71f3749e219d (diff)
downloadbcfg2-3291a875339a7e5569d4232d2333fe37b1f6eac0.tar.gz
bcfg2-3291a875339a7e5569d4232d2333fe37b1f6eac0.tar.bz2
bcfg2-3291a875339a7e5569d4232d2333fe37b1f6eac0.zip
made info.xml files understand <Path> tags to better set permissions on altsrc'd files
Diffstat (limited to 'doc')
-rw-r--r--doc/server/info.txt26
1 files changed, 19 insertions, 7 deletions
diff --git a/doc/server/info.txt b/doc/server/info.txt
index 0d273c2b6..192805ed4 100644
--- a/doc/server/info.txt
+++ b/doc/server/info.txt
@@ -85,16 +85,16 @@ specification.
info.xml files
==============
-``info.xml`` files add the ability to specify different
-sets of file metadata on a group by group or host by host
-basis. These files are XML, and work similarly to those used by
-:ref:`Rules <server-plugins-generators-rules>` or :ref:`Pkgmgr
+``info.xml`` files add the ability to specify different sets of file
+metadata on a group by group or host by host basis, or by path (for
+files using :ref:`altsrc <server-plugins-structures-altsrc>`). These
+files are XML, and work similarly to those used by :ref:`Rules
+<server-plugins-generators-rules>` or :ref:`Pkgmgr
<server-plugins-generators-pkgmgr>`.
The following specifies a different global set of permissions
-(root/sys/0651) than on clients in group webserver (root/root/0652)
-
-.. code-block:: xml
+(root/sys/0651) than on clients in group webserver or named
+"foo.example.com" (root/root/0652)::
<FileInfo>
<Client name='foo.example.com'>
@@ -105,3 +105,15 @@ The following specifies a different global set of permissions
</Group>
<Info owner='root' group='sys' perms='0651'/>
</FileInfo>
+
+The following specifies a different set of permissions depending on
+the path of the file::
+
+ <FileInfo>
+ <Path name="/etc/bcfg2-web.conf">
+ <Info owner="root" group="apache" perms="0640"/>
+ </Path>
+ <Path name="/etc/bcfg2-web.conf" negate="true">
+ <Info owner="root" group="root" perms="0600"/>
+ </Path>
+ </FileInfo>