From 96f2beeb13548b0a3f86b62548809cea3be488c3 Mon Sep 17 00:00:00 2001
From: Dietmar Maurer <dietmar@proxmox.com>
Date: Sun, 10 Apr 2016 10:33:40 +0200
Subject: [PATCH] add pveproxy man page

---
 Makefile                 |  9 +++++++-
 index.adoc               |  1 +
 pve-admin-guide.adoc     |  9 ++++++++
 pve-doc-generator.mk     |  9 ++++++++
 pveproxy.8-synopsis.adoc | 46 ++++++++++++++++++++++++++++++++++++++++
 pveproxy.adoc            | 39 ++++++++++++++++++++++++++++++++++
 6 files changed, 112 insertions(+), 1 deletion(-)
 create mode 100644 pveproxy.8-synopsis.adoc
 create mode 100644 pveproxy.adoc

diff --git a/Makefile b/Makefile
index 2ae2ad4..dd9d172 100644
--- a/Makefile
+++ b/Makefile
@@ -13,7 +13,14 @@ DEB=${PACKAGE}_${DOCRELEASE}-${PKGREL}_amd64.deb
 
 COMMAND_LIST=pvecm qm qmrestore pct pveam pvesm pveum vzdump ha-manager
 
-SERVICE_LIST=pve-firewall pve-ha-crm pve-ha-lrm pvestatd pmxcfs pvedaemon
+SERVICE_LIST=		\
+	pve-firewall 	\
+	pve-ha-crm 	\
+	pve-ha-lrm 	\
+	pvestatd 	\
+	pmxcfs 		\
+	pveproxy	\
+	pvedaemon
 
 CONFIG_LIST=datacenter.cfg qm.conf pct.conf
 
diff --git a/index.adoc b/index.adoc
index 6bea872..37f8e07 100644
--- a/index.adoc
+++ b/index.adoc
@@ -43,6 +43,7 @@ Service Daemons
 |===========================================================
 | Command name |'systemd' Service     | Download link
 | pvedaemon    | pvedaemon.service    |link:pvedaemon.8.html[pvedaemon.8]
+| pveproxy     | pveproxy.service     |link:pveproxy.8.html[pveproxy.8]
 | pvestatd     | pvestatd.service     |link:pvestatd.8.html[pvestatd.8]
 | pve-ha-crm   | pve-ha-crm.service   |link:pve-ha-crm.8.html[pve-ha-crm.8]
 | pve-ha-lrm   | pve-ha-lrm.service   |link:pve-ha-lrm.8.html[pve-ha-lrm.8]
diff --git a/pve-admin-guide.adoc b/pve-admin-guide.adoc
index 809d37c..6f679d7 100644
--- a/pve-admin-guide.adoc
+++ b/pve-admin-guide.adoc
@@ -41,6 +41,7 @@ Important Service Daemons
 :leveloffset: 2
 include::pvedaemon.adoc[]
 
+include::pveproxy.adoc[]
 
 include::pvestatd.adoc[]
 
@@ -149,6 +150,14 @@ include::pvedaemon.8-synopsis.adoc[]
 
 :leveloffset: 0
 
+*pveproxy* - {pve} API Proxy Daemon
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+:leveloffset: 1
+include::pveproxy.8-synopsis.adoc[]
+
+:leveloffset: 0
+
 *pvestatd* - {pve} Status Daemon
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/pve-doc-generator.mk b/pve-doc-generator.mk
index ac3d44d..281f882 100644
--- a/pve-doc-generator.mk
+++ b/pve-doc-generator.mk
@@ -98,6 +98,11 @@ PVEDAEMON_MAN8_SOURCES=			\
 	pvedaemon.8-synopsis.adoc	\
 	${PVE_COMMON_DOC_SOURCES}
 
+PVEPROXY_MAN8_SOURCES=			\
+	pveproxy.adoc			\
+	pveproxy.8-synopsis.adoc	\
+	${PVE_COMMON_DOC_SOURCES}
+
 PMXCFS_MAN8_SOURCES=			\
 	pmxcfs.adoc			\
 	pmxcfs.8-cli.adoc		\
@@ -182,6 +187,10 @@ pvedaemon.8: ${PVEDAEMON_MAN8_SOURCES}
 	a2x ${A2X_MAN8_OPTIONS} pvedaemon.adoc
 	test -n "$${NOVIEW}" || man -l $@
 
+pveproxy.8: ${PVEPROXY_MAN8_SOURCES}
+	a2x ${A2X_MAN8_OPTIONS} pveproxy.adoc
+	test -n "$${NOVIEW}" || man -l $@
+
 pmxcfs.8: ${PMXCFS_MAN8_SOURCES}
 	a2x ${A2X_MAN8_OPTIONS} pmxcfs.adoc
 	test -n "$${NOVIEW}" || man -l $@
diff --git a/pveproxy.8-synopsis.adoc b/pveproxy.8-synopsis.adoc
new file mode 100644
index 0000000..a94a11a
--- /dev/null
+++ b/pveproxy.8-synopsis.adoc
@@ -0,0 +1,46 @@
+*pveproxy* `<COMMAND> [ARGS] [OPTIONS]`
+
+*pveproxy help* `[<cmd>]` `[OPTIONS]`
+
+Get help about specified command.
+
+`<cmd>` `string` ::
+
+Command name
+
+`-verbose` `boolean` ::
+
+Verbose output format.
+
+
+
+
+*pveproxy restart*
+
+Restart the daemon (or start if not running).
+
+
+
+*pveproxy start* `[OPTIONS]`
+
+Start the daemon.
+
+`-debug` `boolean` (default=`0`)::
+
+Debug mode - stay in foreground
+
+
+
+*pveproxy status*
+
+Get daemon status.
+
+
+
+*pveproxy stop*
+
+Stop the daemon.
+
+
+
+
diff --git a/pveproxy.adoc b/pveproxy.adoc
new file mode 100644
index 0000000..125484f
--- /dev/null
+++ b/pveproxy.adoc
@@ -0,0 +1,39 @@
+ifdef::manvolnum[]
+PVE({manvolnum})
+================
+include::attributes.txt[]
+
+NAME
+----
+
+pveproxy - PVE API Proxy Daemon
+
+
+SYNOPSYS
+--------
+
+include::pveproxy.8-synopsis.adoc[]
+
+DESCRIPTION
+-----------
+endif::manvolnum[]
+
+ifndef::manvolnum[]
+{pve} API Proxy Daemon
+================
+include::attributes.txt[]
+endif::manvolnum[]
+
+This daemon exposes the whole {pve} API on TCP port 8006 using
+HTTPS. It runs as user 'www-data' and has very limited permissions.
+Operation requiring more permissions are forwarded to the local
+'pvedaemon'.
+
+Request targeted for other nodes are automatically forwarded to that
+node. This means that you can manage your whole cluster by connecting
+to a single {pve} node.
+
+
+ifdef::manvolnum[]
+include::pve-copyright.adoc[]
+endif::manvolnum[]
-- 
2.39.2