add pveproxy man page

diff --git a/Makefile b/Makefile
index 2ae2ad47b35bcf701d06886e280b5adb2c62f1d3..dd9d172c72976532b506372ea0ee92fd907904c9 100644 (file)
--- 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
 
 
 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
 
 
 CONFIG_LIST=datacenter.cfg qm.conf pct.conf
 

diff --git a/index.adoc b/index.adoc
index 6bea8724ffe864cd813796ddd3a5f7ad4ea70082..37f8e0739623e09bbe0fc17eaf6c0386ab61fa84 100644 (file)
--- 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]
 |===========================================================
 | 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]
 | 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 809d37c8b46d6875a47253cd760b6af353070d45..6f679d7a68725cde51c51425a76fb710c5f34928 100644 (file)
--- a/pve-admin-guide.adoc
+++ b/pve-admin-guide.adoc
@@ -41,6 +41,7 @@ Important Service Daemons
 :leveloffset: 2
 include::pvedaemon.adoc[]
 
 :leveloffset: 2
 include::pvedaemon.adoc[]
 

+include::pveproxy.adoc[]

 
 include::pvestatd.adoc[]
 
 
 include::pvestatd.adoc[]
 


@@ -149,6 +150,14 @@ include::pvedaemon.8-synopsis.adoc[]
 
 :leveloffset: 0
 
 
 :leveloffset: 0
 

+*pveproxy* - {pve} API Proxy Daemon
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+:leveloffset: 1
+include::pveproxy.8-synopsis.adoc[]
+
+:leveloffset: 0
+

 *pvestatd* - {pve} Status Daemon
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 *pvestatd* - {pve} Status Daemon
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

diff --git a/pve-doc-generator.mk b/pve-doc-generator.mk
index ac3d44d86ce57b36e3e6d1e5b393f36c7c34aa7a..281f8829e38401efd55e244f289469b398a0df2d 100644 (file)
--- 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}
 
        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               \
 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 $@
 
        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 $@
 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 (file)
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 (file)
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[]