diff --git a/docs/Makefile.am b/docs/Makefile.am index b008133ca810cb2b4a59a8309c46becc052629b0..5829bbccc66603caadd4238011f576ba68d134c0 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 a54596091990e006d1bb5904bf9920a387435373..0d166c1923841feaf3c7bfd302fa69f4d44c2e9a 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 0000000000000000000000000000000000000000..730c99ec790a6a43a83fd694b4fa9061e227876e --- /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 74aa9fbab190225dbeee7a99c782701e565ac128..f1ebbffed5a1024c4227e8139b69332a484c5398 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 5d44973fdc21878897fcf36c503530d90b4358c6..0000000000000000000000000000000000000000 --- 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