mirror of
https://gitlab.com/libvirt/libvirt.git
synced 2024-09-14 03:35:05 +00:00
docs: convert virt-sanlock-cleanup man page from pod to rst
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 <crobinso@redhat.com> Signed-off-by: Daniel P. Berrangé <berrange@redhat.com>
This commit is contained in:
parent
48a5589b76
commit
44bd1902f3
@ -207,6 +207,7 @@ manpages1_rst = \
|
|||||||
manpages7_rst = \
|
manpages7_rst = \
|
||||||
$(NULL)
|
$(NULL)
|
||||||
manpages8_rst = \
|
manpages8_rst = \
|
||||||
|
manpages/virt-sanlock-cleanup.rst \
|
||||||
$(NULL)
|
$(NULL)
|
||||||
manpages_rst += \
|
manpages_rst += \
|
||||||
$(manpages1_rst) \
|
$(manpages1_rst) \
|
||||||
|
@ -15,3 +15,4 @@ Tools
|
|||||||
* `virt-host-validate(1) <virt-host-validate.html>`__ - validate host virtualization setup
|
* `virt-host-validate(1) <virt-host-validate.html>`__ - validate host virtualization setup
|
||||||
* `virt-pki-validate(1) <virt-pki-validate.html>`__ - validate libvirt PKI files are configured correctly
|
* `virt-pki-validate(1) <virt-pki-validate.html>`__ - validate libvirt PKI files are configured correctly
|
||||||
* `virt-xml-validate(1) <virt-xml-validate.html>`__ - validate libvirt XML files against a schema
|
* `virt-xml-validate(1) <virt-xml-validate.html>`__ - validate libvirt XML files against a schema
|
||||||
|
* `virt-sanlock-cleanup(8) <virt-sanlock-cleanup.html>`__ - remove stale sanlock resource lease files
|
||||||
|
79
docs/manpages/virt-sanlock-cleanup.rst
Normal file
79
docs/manpages/virt-sanlock-cleanup.rst
Normal file
@ -0,0 +1,79 @@
|
|||||||
|
====================
|
||||||
|
virt-sanlock-cleanup
|
||||||
|
====================
|
||||||
|
|
||||||
|
-----------------------------------------
|
||||||
|
remove stale sanlock resource lease files
|
||||||
|
-----------------------------------------
|
||||||
|
|
||||||
|
:Manual section: 1
|
||||||
|
:Manual group: Virtualization Support
|
||||||
|
|
||||||
|
.. contents::
|
||||||
|
|
||||||
|
SYNOPSIS
|
||||||
|
========
|
||||||
|
|
||||||
|
``virt-sanlock-cleanup``
|
||||||
|
|
||||||
|
|
||||||
|
DESCRIPTION
|
||||||
|
===========
|
||||||
|
|
||||||
|
This tool removes any resource lease files created by the sanlock
|
||||||
|
lock manager plugin. The resource lease files only need to exist
|
||||||
|
on disks when a guest using the resource is active. This script
|
||||||
|
reclaims the disk space used by resources which are not currently
|
||||||
|
active.
|
||||||
|
|
||||||
|
|
||||||
|
EXIT STATUS
|
||||||
|
===========
|
||||||
|
|
||||||
|
Upon successful processing of leases cleanup, an exit status
|
||||||
|
of 0 will be set. Upon fatal error a non-zero status will
|
||||||
|
be set.
|
||||||
|
|
||||||
|
|
||||||
|
AUTHOR
|
||||||
|
======
|
||||||
|
|
||||||
|
Daniel P. Berrangé
|
||||||
|
|
||||||
|
|
||||||
|
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) 2011, 2013 Red Hat, Inc.
|
||||||
|
|
||||||
|
|
||||||
|
LICENSE
|
||||||
|
=======
|
||||||
|
|
||||||
|
``virt-sanlock-cleanup`` 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 instructions <https://libvirt.org/locking.html>`_,
|
||||||
|
`https://libvirt.org/ <https://libvirt.org/>`_
|
@ -55,14 +55,12 @@ ICON_FILES = \
|
|||||||
PODFILES = \
|
PODFILES = \
|
||||||
virt-admin.pod \
|
virt-admin.pod \
|
||||||
virt-login-shell.pod \
|
virt-login-shell.pod \
|
||||||
virt-sanlock-cleanup.pod \
|
|
||||||
virsh.pod \
|
virsh.pod \
|
||||||
$(NULL)
|
$(NULL)
|
||||||
|
|
||||||
MANINFILES = \
|
MANINFILES = \
|
||||||
virt-admin.1.in \
|
virt-admin.1.in \
|
||||||
virt-login-shell.1.in \
|
virt-login-shell.1.in \
|
||||||
virt-sanlock-cleanup.8.in \
|
|
||||||
virsh.1.in \
|
virsh.1.in \
|
||||||
$(NULL)
|
$(NULL)
|
||||||
|
|
||||||
@ -97,7 +95,6 @@ man1_MANS = \
|
|||||||
|
|
||||||
if WITH_SANLOCK
|
if WITH_SANLOCK
|
||||||
sbin_SCRIPTS = virt-sanlock-cleanup
|
sbin_SCRIPTS = virt-sanlock-cleanup
|
||||||
man8_MANS = virt-sanlock-cleanup.8
|
|
||||||
DISTCLEANFILES += virt-sanlock-cleanup
|
DISTCLEANFILES += virt-sanlock-cleanup
|
||||||
endif WITH_SANLOCK
|
endif WITH_SANLOCK
|
||||||
|
|
||||||
|
@ -1,49 +0,0 @@
|
|||||||
=head1 NAME
|
|
||||||
|
|
||||||
virt-sanlock-cleanup - remove stale sanlock resource lease files
|
|
||||||
|
|
||||||
=head1 SYNOPSIS
|
|
||||||
|
|
||||||
B<virt-sanlock-cleanup>
|
|
||||||
|
|
||||||
=head1 DESCRIPTION
|
|
||||||
|
|
||||||
This tool removes any resource lease files created by the sanlock
|
|
||||||
lock manager plugin. The resource lease files only need to exist
|
|
||||||
on disks when a guest using the resource is active. This script
|
|
||||||
reclaims the disk space used by resources which are not currently
|
|
||||||
active.
|
|
||||||
|
|
||||||
=head1 EXIT STATUS
|
|
||||||
|
|
||||||
Upon successful processing of leases cleanup, an exit status
|
|
||||||
of 0 will be set. Upon fatal error a non-zero status will
|
|
||||||
be set.
|
|
||||||
|
|
||||||
=head1 AUTHOR
|
|
||||||
|
|
||||||
Daniel Berrange
|
|
||||||
|
|
||||||
=head1 BUGS
|
|
||||||
|
|
||||||
Report any bugs discovered to the libvirt community via the
|
|
||||||
mailing list L<https://libvirt.org/contact.html> or bug tracker
|
|
||||||
L<https://libvirt.org/bugs.html>.
|
|
||||||
Alternatively report bugs to your software distributor / vendor.
|
|
||||||
|
|
||||||
=head1 COPYRIGHT
|
|
||||||
|
|
||||||
Copyright (C) 2011, 2013 Red Hat, Inc.
|
|
||||||
|
|
||||||
=head1 LICENSE
|
|
||||||
|
|
||||||
virt-sanlock-cleanup 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
|
|
||||||
|
|
||||||
=head1 SEE ALSO
|
|
||||||
|
|
||||||
L<virsh(1)>, online instructions L<https://libvirt.org/locking.html>
|
|
||||||
|
|
||||||
=cut
|
|
Loading…
Reference in New Issue
Block a user