diff options
author | Narayan Desai <desai@mcs.anl.gov> | 2005-03-02 20:15:52 +0000 |
---|---|---|
committer | Narayan Desai <desai@mcs.anl.gov> | 2005-03-02 20:15:52 +0000 |
commit | 2de3b6b66eb26bf1bc60f489c1b74df8776fa187 (patch) | |
tree | 746257ee0fef84d8c3d19d2526da985c33c7bfd0 | |
parent | 11cfa4985f234d7ab961e9e76d220c9e8134f29a (diff) | |
download | bcfg2-2de3b6b66eb26bf1bc60f489c1b74df8776fa187.tar.gz bcfg2-2de3b6b66eb26bf1bc60f489c1b74df8776fa187.tar.bz2 bcfg2-2de3b6b66eb26bf1bc60f489c1b74df8776fa187.zip |
more docs
(Logical change 1.208)
git-svn-id: https://svn.mcs.anl.gov/repos/bcfg/trunk/bcfg2@884 ce84e21b-d406-0410-9b95-82705330c041
-rw-r--r-- | doc/generators.xml | 58 |
1 files changed, 47 insertions, 11 deletions
diff --git a/doc/generators.xml b/doc/generators.xml index fe23b8445..9151e1258 100644 --- a/doc/generators.xml +++ b/doc/generators.xml @@ -1,15 +1,17 @@ <chapter> <title>Generators</title> - <para>Generators are modules are are loaded by the Bcfg2 server, - based on directives in <filename>/etc/bcfg2.conf</filename>. They - provide concrete, fully-specified configuration entries for - clients. This chapter documents the function and usage of generators - bundled with Bcfg2 releases. It also describes the interface used to - communicate with generators; modeles implementing this interface can - provide configuration elements for clients based on any - representation or requirements that may exist. - </para> + <para> + Generators are modules are are loaded by the Bcfg2 server, + based on directives in <filename>/etc/bcfg2.conf</filename>. They + provide concrete, fully-specified configuration entries for + clients. This chapter documents the function and usage of + generators bundled with Bcfg2 releases. It also describes the + interface used to communicate with generators; modeles + implementing this interface can provide configuration elements for + clients based on any representation or requirements that may + exist. + </para> <section> <title>Bundled Generators</title> @@ -100,8 +102,42 @@ </section> <section> - <title>Pkgmgr</title> - <para/> + <title>The Scoped XML File Group: Servicemgr</title> + <para> + The generator Servicemgr uses files formatted similarly to the + metadata files. It + works based on a single file, which contains definitions + ordered by increasing specificity. + </para> + + <example> + <title><filename>foo</filename></title> + <programlisting> + <![CDATA[<Services> + <Class name='webserver'> + <Service status='on' name='httpd' port='80' protocol='tcp'> + <User address='0.0.0.0' mask='32'/> + </Service> + </Class> + <Host name='mailhost'> + <Service name='sendmail' status='on' protocol='tcp' port='80'> + <User address='0.0.0.0' mask='32'/> + </Service> + </Host> + <Host name='thai'> + <Service name='ssh' status='off'/> + </Host> + <Service name='ssh' status='on' protocol='tcp' port='22'/> + <Service name='ntp-server' status='on' /> +</Services>]]> + </programlisting> + </example> + + <para> + This set of service definitions is intrepreted in the + following way. Webservers run httpd, the host mailhost runs + sendmail, and all machines run ssh, and the ntp-server. + </para> </section> </section> |