pmgpolicy.adoc: new manual page

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-*

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[]
 

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

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[]