From c9ef27dfe810db16ee596e503c48b6b153998cef Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= Date: Fri, 18 Oct 2019 15:29:47 +0100 Subject: [PATCH] docs: convert virt-pki-validate man page from pod to rst MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This was a semi-automated conversion. First it was run through pod2rst, and then it was manually editted to use a rst structure that matches expectations of rst2man. Reviewed-by: Cole Robinson Signed-off-by: Daniel P. Berrangé --- docs/Makefile.am | 1 + docs/manpages/index.rst | 1 + docs/manpages/virt-pki-validate.rst | 89 +++++++++++++++++++++++++++++ tools/Makefile.am | 3 - tools/virt-pki-validate.pod | 61 -------------------- 5 files changed, 91 insertions(+), 64 deletions(-) create mode 100644 docs/manpages/virt-pki-validate.rst delete mode 100644 tools/virt-pki-validate.pod diff --git a/docs/Makefile.am b/docs/Makefile.am index b008133ca8..5829bbccc6 100644 --- a/docs/Makefile.am +++ b/docs/Makefile.am @@ -201,6 +201,7 @@ manpages_rst = \ manpages/index.rst \ $(NULL) manpages1_rst = \ + manpages/virt-pki-validate.rst \ $(NULL) manpages7_rst = \ $(NULL) diff --git a/docs/manpages/index.rst b/docs/manpages/index.rst index a545960919..0d166c1923 100644 --- a/docs/manpages/index.rst +++ b/docs/manpages/index.rst @@ -13,3 +13,4 @@ Tools ===== * `virt-host-validate(1) `__ - validate host virtualization setup +* `virt-pki-validate(1) `__ - validate libvirt PKI files are configured correctly diff --git a/docs/manpages/virt-pki-validate.rst b/docs/manpages/virt-pki-validate.rst new file mode 100644 index 0000000000..730c99ec79 --- /dev/null +++ b/docs/manpages/virt-pki-validate.rst @@ -0,0 +1,89 @@ +================= +virt-pki-validate +================= + +--------------------------------------------------- +validate libvirt PKI files are configured correctly +--------------------------------------------------- + +:Manual section: 1 +:Manual group: Virtualization Support + +.. contents:: + +SYNOPSIS +======== + + +``virt-pki-validate`` [*OPTION*] + + +DESCRIPTION +=========== + +This tool validates that the necessary PKI files are configured for +a secure libvirt server or client using the TLS encryption protocol. +It will report any missing certificate or key files on the host. It +should be run as root to ensure it can read all the necessary files + + +OPTIONS +======= + +``-h``, ``--help`` + +Display command line help usage then exit. + +``-V``, ``--version`` + +Display version information then exit. + +EXIT STATUS +=========== + +Upon successful validation, an exit status of 0 will be set. Upon +failure a non-zero status will be set. + + +AUTHOR +====== + +Richard Jones + + +BUGS +==== + +Please report all bugs you discover. This should be done via either: + +#. the mailing list + + `https://libvirt.org/contact.html `_ + +#. the bug tracker + + `https://libvirt.org/bugs.html `_ + +Alternatively, you may report bugs to your software distributor / vendor. + + +COPYRIGHT +========= + +Copyright (C) 2006-2012 by Red Hat, Inc. + + +LICENSE +======= + +``virt-pki-validate`` is distributed under the terms of the GNU GPL v2+. +This is free software; see the source for copying conditions. There +is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR +PURPOSE + + +SEE ALSO +======== + +virsh(1), `online PKI setup instructions `_, +`https://www.libvirt.org/ `_ diff --git a/tools/Makefile.am b/tools/Makefile.am index 74aa9fbab1..f1ebbffed5 100644 --- a/tools/Makefile.am +++ b/tools/Makefile.am @@ -55,7 +55,6 @@ ICON_FILES = \ PODFILES = \ virt-admin.pod \ virt-login-shell.pod \ - virt-pki-validate.pod \ virt-sanlock-cleanup.pod \ virt-xml-validate.pod \ virsh.pod \ @@ -64,7 +63,6 @@ PODFILES = \ MANINFILES = \ virt-admin.1.in \ virt-login-shell.1.in \ - virt-pki-validate.1.in \ virt-sanlock-cleanup.8.in \ virt-xml-validate.1.in \ virsh.1.in \ @@ -96,7 +94,6 @@ bin_SCRIPTS = virt-xml-validate virt-pki-validate bin_PROGRAMS = virsh virt-admin libexec_SCRIPTS = libvirt-guests.sh man1_MANS = \ - virt-pki-validate.1 \ virt-xml-validate.1 \ virsh.1 \ virt-admin.1 diff --git a/tools/virt-pki-validate.pod b/tools/virt-pki-validate.pod deleted file mode 100644 index 5d44973fdc..0000000000 --- a/tools/virt-pki-validate.pod +++ /dev/null @@ -1,61 +0,0 @@ -=head1 NAME - -virt-pki-validate - validate libvirt PKI files are configured correctly - -=head1 SYNOPSIS - -B [I