mirror of
https://gitlab.com/libvirt/libvirt.git
synced 2024-07-11 12:25:52 +00:00
32a9aac2e0
As defined in: http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html This offers a number of advantages: * Allows sharing a home directory between different machines, or sessions (eg. using NFS) * Cleanly separates cache, runtime (eg. sockets), or app data from user settings * Supports performing smart or selective migration of settings between different OS versions * Supports reseting settings without breaking things * Makes it possible to clear cache data to make room when the disk is filling up * Allows us to write a robust and efficient backup solution * Allows an admin flexibility to change where data and settings are stored * Dramatically reduces the complexity and incoherence of the system for administrators
169 lines
3.8 KiB
Plaintext
169 lines
3.8 KiB
Plaintext
=head1 NAME
|
|
|
|
libvirtd - libvirtd management daemon
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
B<libvirtd> [ -dlv ] [ -f config_file ] [ -p pid_file ] [ -t timeout_seconds ]
|
|
|
|
B<libvirtd> --version
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
The B<libvirtd> program is the server side daemon component of the libvirt
|
|
virtualization management system.
|
|
|
|
This daemon runs on host servers and performs required management tasks for
|
|
virtualized guests. This includes activities such as starting, stopping
|
|
and migrating guests between host servers, configuring and manipulating
|
|
networking, and managing storage for use by guests.
|
|
|
|
The libvirt client libraries and utilities connect to this daemon to issue
|
|
tasks and collect information about the configuration and resources of the host
|
|
system and guests.
|
|
|
|
By default, the libvirtd daemon listens for requests on a local Unix domain
|
|
socket. Using the B<-l>|B<--listen> command line option, the libvirtd daemon
|
|
can be instructed to additionally listen on a TCP/IP socket. The TCP/IP socket
|
|
to use is defined in the libvirtd configuration file.
|
|
|
|
Restarting libvirtd does not impact running guests. Guests continue to operate
|
|
and will be picked up automatically if their XML configuration has been
|
|
defined. Any guests whose XML configuration has not been defined will be lost
|
|
from the configuration.
|
|
|
|
=head1 OPTIONS
|
|
|
|
=over
|
|
|
|
=item B<-d, --daemon>
|
|
|
|
Run as a daemon & write PID file.
|
|
|
|
=item B<-f, --config> I<FILE>
|
|
|
|
Use this configuration file, overriding the default value.
|
|
|
|
=item B<-l, --listen>
|
|
|
|
Listen for TCP/IP connections.
|
|
|
|
=item B<-p, --pid-file> I<FILE>
|
|
|
|
Use this name for the PID file, overriding the default value.
|
|
|
|
=item B<-t, --timeout> I<SECONDS>
|
|
|
|
Exit after timeout period (in seconds) expires.
|
|
|
|
=item B<-v, --verbose>
|
|
|
|
Enable output of verbose messages.
|
|
|
|
=item B< --version>
|
|
|
|
Display version information then exit.
|
|
|
|
=back
|
|
|
|
=head1 SIGNALS
|
|
|
|
On receipt of B<SIGHUP> libvirtd will reload its configuration.
|
|
|
|
=head1 FILES
|
|
|
|
=over
|
|
|
|
=item F<@sysconfdir@/libvirtd.conf>
|
|
|
|
The default configuration file used by libvirtd, unless overridden on the
|
|
command line using the B<-f>|B<--config> option.
|
|
|
|
=item F<@localstatedir@/run/libvirt/libvirt-sock>
|
|
|
|
=item F<@localstatedir@/run/libvirt/libvirt-sock-ro>
|
|
|
|
The sockets libvirtd will use when B<run as root>.
|
|
|
|
=item F<$XDG_RUNTIME_DIR/libvirt/libvirt-sock>
|
|
|
|
The socket libvirtd will use when run as a B<non-root> user.
|
|
|
|
=item F<@sysconfdir@/pki/CA/cacert.pem>
|
|
|
|
The TLS B<Certificate Authority> certificate libvirtd will use.
|
|
|
|
=item F<@sysconfdir@/pki/libvirt/servercert.pem>
|
|
|
|
The TLS B<Server> certificate libvirtd will use.
|
|
|
|
=item F<@sysconfdir@/pki/libvirt/private/serverkey.pem>
|
|
|
|
The TLS B<Server> private key libvirtd will use.
|
|
|
|
=item F<@remote_pid_file@>
|
|
|
|
The PID file to use, unless overridden by the B<-p>|B<--pid-file> option.
|
|
|
|
=back
|
|
|
|
=head1 EXAMPLES
|
|
|
|
To retrieve the version of libvirtd:
|
|
|
|
# libvirtd --version
|
|
libvirtd (libvirt) 0.8.2
|
|
#
|
|
|
|
To start libvirtd, instructing it to daemonize and create a PID file:
|
|
|
|
# libvirtd -d
|
|
# ls -la @remote_pid_file@
|
|
-rw-r--r-- 1 root root 6 Jul 9 02:40 @remote_pid_file@
|
|
#
|
|
|
|
=head1 BUGS
|
|
|
|
Please report all bugs you discover. This should be done via either:
|
|
|
|
=over
|
|
|
|
=item a) the mailing list
|
|
|
|
L<http://libvirt.org/contact.html>
|
|
|
|
=item or,
|
|
|
|
B<>
|
|
|
|
=item b) the bug tracker
|
|
|
|
L<http://libvirt.org/bugs.html>
|
|
|
|
=item Alternatively, you may report bugs to your software distributor / vendor.
|
|
|
|
=back
|
|
|
|
=head1 AUTHORS
|
|
|
|
Please refer to the AUTHORS file distributed with libvirt.
|
|
|
|
=head1 COPYRIGHT
|
|
|
|
Copyright (C) 2006-2010 Red Hat, Inc., and the authors listed in the
|
|
libvirt AUTHORS file.
|
|
|
|
=head1 LICENSE
|
|
|
|
libvirtd is distributed under the terms of the GNU LGPL v2.1+.
|
|
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)>, L<virt-install(1)>, L<virt-xml-validate(1)>, L<virt-top(1)>,
|
|
L<virt-df(1)>, L<http://www.libvirt.org/>
|
|
|
|
=cut
|