[pve-devel] [PATCH docs] add pvenode.adoc

Fabian Grünbichler f.gruenbichler at proxmox.com
Fri Apr 27 14:02:08 CEST 2018


Signed-off-by: Fabian Grünbichler <f.gruenbichler at proxmox.com>
---
this obviously needs more work, but a dummy is required for building of the CLI part..

 pvenode.1-synopsis.adoc | 140 ++++++++++++++++++++++++++++++++++++++++++++++++
 pvenode.adoc            |  30 +++++++++++
 2 files changed, 170 insertions(+)
 create mode 100644 pvenode.1-synopsis.adoc
 create mode 100644 pvenode.adoc

diff --git a/pvenode.1-synopsis.adoc b/pvenode.1-synopsis.adoc
new file mode 100644
index 0000000..46ad2b6
--- /dev/null
+++ b/pvenode.1-synopsis.adoc
@@ -0,0 +1,140 @@
+*pvenode* `<COMMAND> [ARGS] [OPTIONS]`
+
+*pvenode acme account deactivate* `[<name>]`
+
+Deactivate existing ACME account at CA.
+
+`<name>`: `<name>` ('default =' `default`)::
+
+ACME account config file name.
+
+*pvenode acme account info* `[<name>]`
+
+Return existing ACME account information.
+
+`<name>`: `<name>` ('default =' `default`)::
+
+ACME account config file name.
+
+*pvenode acme account list*
+
+ACMEAccount index.
+
+*pvenode acme account register* `[<name>] {<contact>}` `[OPTIONS]`
+
+Register a new ACME account with a compatible CA.
+
+`<name>`: `<name>` ('default =' `default`)::
+
+ACME account config file name.
+
+`<contact>`: `<string>` ::
+
+Contact email addresses.
+
+`--directory` `^https?://.*` ::
+
+URL of ACME CA directory endpoint.
+
+*pvenode acme account update* `[<name>]` `[OPTIONS]`
+
+Update existing ACME account information with CA. Note: not specifying any
+new account information triggers a refresh.
+
+`<name>`: `<name>` ('default =' `default`)::
+
+ACME account config file name.
+
+`--contact` `<string>` ::
+
+Contact email addresses.
+
+*pvenode acme cert order* `[OPTIONS]`
+
+Order a new certificate from ACME-compatible CA.
+
+`--force` `<boolean>` ('default =' `0`)::
+
+Overwrite existing custom certificate.
+
+*pvenode acme cert renew* `[OPTIONS]`
+
+Renew existing certificate from CA.
+
+`--force` `<boolean>` ('default =' `0`)::
+
+Force renewal even if expiry is more than 30 days away.
+
+*pvenode acme cert revoke*
+
+Revoke existing certificate from CA.
+
+*pvenode cert delete* `[<restart>]`
+
+DELETE custom certificate chain and key.
+
+`<restart>`: `<boolean>` ('default =' `0`)::
+
+Restart pveproxy.
+
+*pvenode cert info*
+
+Get information about node's certificates.
+
+*pvenode cert set* `<certificates> [<key>]` `[OPTIONS]`
+
+Upload or update custom certificate chain and key.
+
+`<certificates>`: `<string>` ::
+
+PEM encoded certificate (chain).
+
+`<key>`: `<string>` ::
+
+PEM encoded private key.
+
+`--force` `<boolean>` ('default =' `0`)::
+
+Overwrite existing custom or ACME certificate files.
+
+`--restart` `<boolean>` ('default =' `0`)::
+
+Restart pveproxy.
+
+*pvenode config get*
+
+Get node configuration options.
+
+*pvenode config set* `[OPTIONS]`
+
+Set node configuration options.
+
+`--acme` `domains=<domain[;domain;...]> [,account=<name>]` ::
+
+Node specific ACME settings.
+
+`--delete` `<string>` ::
+
+A list of settings you want to delete.
+
+`--description` `<string>` ::
+
+Node description/comment.
+
+`--digest` `<string>` ::
+
+Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.
+
+*pvenode help* `[OPTIONS]`
+
+Get help about specified command.
+
+`--extra-args` `<array>` ::
+
+Shows help for a specific command
+
+`--verbose` `<boolean>` ::
+
+Verbose output format.
+
+
diff --git a/pvenode.adoc b/pvenode.adoc
new file mode 100644
index 0000000..2c2e3d4
--- /dev/null
+++ b/pvenode.adoc
@@ -0,0 +1,30 @@
+ifdef::manvolnum[]
+pvenode(1)
+==========
+:pve-toplevel:
+
+NAME
+----
+
+pvenode - Proxmox VE Node Management
+
+SYNOPSIS
+--------
+
+include::pvenode.1-synopsis.adoc[]
+
+DESCRIPTION
+-----------
+endif::manvolnum[]
+
+ifndef::manvolnum[]
+Proxmox Node Management
+=======================
+:pve-toplevel:
+endif::manvolnum[]
+
+The {PVE} node management tools (`pvenode`) ...
+
+ifdef::manvolnum[]
+include::pve-copyright.adoc[]
+endif::manvolnum[]
-- 
2.14.2





More information about the pve-devel mailing list