From 17f6628412ccaf439824f0ff5a25417c33140b56 Mon Sep 17 00:00:00 2001
From: Dietmar Maurer <dietmar@proxmox.com>
Date: Thu, 23 Feb 2017 09:38:39 +0100
Subject: [PATCH] pmgpolicy.adoc: new manual page

---
 Makefile                |  2 +-
 pmg-admin-guide.adoc    | 11 ++++++-----
 pmg-doc-generator.mk.in |  7 ++++++-
 pmgpolicy.adoc          | 34 ++++++++++++++++++++++++++++++++++
 4 files changed, 47 insertions(+), 7 deletions(-)
 create mode 100644 pmgpolicy.adoc

diff --git a/Makefile b/Makefile
index 080909c..37701e6 100644
--- 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 906bf22..87f68c7 100644
--- 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 7c231de..28fd091 100644
--- 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
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[]
-- 
2.39.2