[libvirt PATCH 6/6] virt-pki-query-dn: Add manual page
Signed-off-by: Andrea Bolognani <abologna(a)redhat.com>
---
docs/manpages/meson.build | 1 +
docs/manpages/virt-pki-query-dn.rst | 91 +++++++++++++++++++++++++++++
libvirt.spec.in | 1 +
3 files changed, 93 insertions(+)
create mode 100644 docs/manpages/virt-pki-query-dn.rst
diff --git a/docs/manpages/meson.build b/docs/manpages/meson.build
index e80fff48c8..bf6fc730e0 100644
--- a/docs/manpages/meson.build
+++ b/docs/manpages/meson.build
@@ -16,6 +16,7 @@ docs_man_files = [
{ 'name': 'virt-admin', 'section': '1',
'install': true },
{ 'name': 'virt-host-validate', 'section': '1',
'install': conf.has('WITH_HOST_VALIDATE') },
{ 'name': 'virt-login-shell', 'section': '1',
'install': conf.has('WITH_LOGIN_SHELL') },
+ { 'name': 'virt-pki-query-dn', 'section': '1',
'install': true },
{ 'name': 'virt-pki-validate', 'section': '1',
'install': true },
{ 'name': 'virt-qemu-run', 'section': '1',
'install': conf.has('WITH_QEMU') },
{ 'name': 'virt-ssh-helper', 'section': '1',
'install': true },
diff --git a/docs/manpages/virt-pki-query-dn.rst b/docs/manpages/virt-pki-query-dn.rst
new file mode 100644
index 0000000000..0e162d6dc5
--- /dev/null
+++ b/docs/manpages/virt-pki-query-dn.rst
@@ -0,0 +1,91 @@
+=================
+virt-pki-query-dn
+=================
+
+-------------------------------------------------
+extract Distinguished Name from a PEM certificate
+-------------------------------------------------
+
+:Manual section: 1
+:Manual group: Virtualization Support
+
+.. contents::
+
+
+SYNOPSIS
+========
+
+``virt-pki-query-dn`` *FILE*
+``virt-pki-query-dn`` *OPTION*
+
+
+DESCRIPTION
+===========
+
+Extract Distinguished Name from a PEM certificate.
+
+The output is meant to be used in the ``tls_allowed_dn_list``
+configuration option in the ``libvirtd.conf`` file.
+
+
+OPTIONS
+=======
+
+``-h``, ``--help``
+
+Display command line help usage then exit.
+
+``-V``, ``--version``
+
+Display version information then exit.
+
+
+EXIT STATUS
+===========
+
+The exit status will be zero on success, non-zero on failure.
+
+
+AUTHOR
+======
+
+Martin Kletzander
+
+
+BUGS
+====
+
+Please report all bugs you discover. This should be done via either:
+
+#. the mailing list
+
+ `https://libvirt.org/contact.html <https://libvirt.org/contact.html>`_
+
+#. the bug tracker
+
+ `https://libvirt.org/bugs.html <https://libvirt.org/bugs.html>`_
+
+Alternatively, you may report bugs to your software distributor / vendor.
+
+
+COPYRIGHT
+=========
+
+Copyright (C) 2021 Red Hat, Inc.
+
+
+LICENSE
+=======
+
+``virt-pki-query-dn`` 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), virt-pki-validate(1),
+`online PKI setup instructions <https://libvirt.org/remote.html>`_,
+`https://www.libvirt.org/ <https://www.libvirt.org/>`_
diff --git a/libvirt.spec.in b/libvirt.spec.in
index 9cf1046604..22a15c7d23 100644
--- a/libvirt.spec.in
+++ b/libvirt.spec.in
@@ -1986,6 +1986,7 @@ exit 0
%files client
%{_mandir}/man1/virsh.1*
%{_mandir}/man1/virt-xml-validate.1*
+%{_mandir}/man1/virt-pki-query-dn.1*
%{_mandir}/man1/virt-pki-validate.1*
%{_bindir}/virsh
%{_bindir}/virt-xml-validate
--
2.31.1