pmgpolicy.adoc: new manual page

diff --git a/Makefile b/Makefile
index 080909c44af3eaa1029d1a53bf786fb1c5d2b565..37701e681316bfc71816f47d5527ed0337bccb87 100644 (file)
--- a/Makefile
+++ b/Makefile
@@ -193,7 +193,7 @@ clean:
        find . -name '*~' -exec rm {} ';'
        rm -rf *.html *.pdf *.epub *.tmp *.1 *.5 *.8
        rm -f *.deb *.changes *.buildinfo
-       rm -f api-viewer/apidoc.js chapter-*.html *-plain.html chapter-*.html pmg-admin-guide.chunked asciidoc-pmg link-refs.json .asciidoc-pmg-tmp_* pmg-smtp-filter.8-synopsis.adoc
+       rm -f api-viewer/apidoc.js chapter-*.html *-plain.html chapter-*.html pmg-admin-guide.chunked asciidoc-pmg link-refs.json .asciidoc-pmg-tmp_* pmg-smtp-filter.8-synopsis.adoc pmgpolicy.8-synopsis.adoc
        rm -rf .pmg-doc-depends 
        rm -f pmg-doc-generator.mk chapter-index-table.adoc man1-index-table.adoc man5-index-table.adoc man8-index-table.adoc pmg-admin-guide-docinfo.xml
        rm -rf build-*

diff --git a/pmg-admin-guide.adoc b/pmg-admin-guide.adoc
index 906bf225a154f9bb61f8ea5b6cc9ed5bff75f85f..87f68c79a2d5484c858f90da66c362938cf5c30c 100644 (file)
--- a/pmg-admin-guide.adoc
+++ b/pmg-admin-guide.adoc
@@ -62,6 +62,8 @@ include::pmgproxy.adoc[]
 
 include::pmg-smtp-filter.adoc[]
 
+include::pmgpolicy.adoc[]
+
 :leveloffset: 0
 
 
@@ -131,16 +133,15 @@ include::pmg-smtp-filter.8-synopsis.adoc[]
 :leveloffset: 0
 
 
-*pmgpolicy* - Policy Daemon
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-TODO
+*pmgpolicy* - {pmg} Policy Daemon
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 :leveloffset: 1
-//include::pve-firewall.8-synopsis.adoc[]
+include::pmgpolicy.8-synopsis.adoc[]
 
 :leveloffset: 0
 
+
 [appendix]
 include::pmg-rule-macros.adoc[]
 

diff --git a/pmg-doc-generator.mk.in b/pmg-doc-generator.mk.in
index 7c231de88400e408ab60cda28e678aea30baede4..28fd091c3edd049ce5ae29630d67c5eff48785e5 100644 (file)
--- a/pmg-doc-generator.mk.in
+++ b/pmg-doc-generator.mk.in
@@ -17,9 +17,14 @@ all:
 pmg-smtp-filter.8-synopsis.adoc:
        @echo 'Please use systemd tools to manage this service.' >$@.tmp
        @echo '' >>$@.tmp
-       @echo '*systemctl* `(start|stop|restart|reload)` `pmg-smtp-filter`' >>$@.tmp
+       @echo '*systemctl* `(start|stop|restart|reload|status)` `pmg-smtp-filter`' >>$@.tmp
        mv $@.tmp $@
 
+pmgpolicy.8-synopsis.adoc:
+       @echo 'Please use systemd tools to manage this service.' >$@.tmp
+       @echo '' >>$@.tmp
+       @echo '*systemctl* `(start|stop|restart|reload|status)` `pmgpolicy`' >>$@.tmp
+       mv $@.tmp $@
 
 docinfo.xml:
        cp ${DGDIR}/$@ $@.tmp

diff --git a/pmgpolicy.adoc b/pmgpolicy.adoc
new file mode 100644 (file)
index 0000000..d013047
--- /dev/null
+++ b/pmgpolicy.adoc
@@ -0,0 +1,34 @@
+ifdef::manvolnum[]
+pmgpolicy(8)
+============
+:pmg-toplevel:
+
+NAME
+----
+
+pmgpolicy - Proxmox Mail Gateway Policy Daemon
+
+
+SYNOPSIS
+--------
+
+include::pmgpolicy.8-synopsis.adoc[]
+
+DESCRIPTION
+-----------
+endif::manvolnum[]
+
+ifndef::manvolnum[]
+pmgpolicy - Proxmox Mail Gateway Policy Daemon
+==============================================
+endif::manvolnum[]
+
+This daemon implements the Postfix SMTP access policy delegation
+protocol on `127.0.0.1:10022`. The daemon listens to a local address
+only, so you cannot access it from outside. We configure Postfix to
+use this service for greylisting and as SPF policy server.
+
+
+ifdef::manvolnum[]
+include::pmg-copyright.adoc[]
+endif::manvolnum[]