libvirtd(8)

1LIBVIRTD(8)                 Virtualization Support                 LIBVIRTD(8)
2
3
4

NAME

6       libvirtd - libvirtd management daemon
7

SYNOPSIS

9       libvirtd [OPTION]...
10

DESCRIPTION

12       The libvirtd program is the server side daemon component of the libvirt
13       virtualization management system.
14
15       This daemon runs on host servers and performs required management tasks
16       for virtualized guests.  This includes activities such as starting,
17       stopping and migrating guests between host servers, configuring and
18       manipulating networking, and managing storage for use by guests.
19
20       The libvirt client libraries and utilities connect to this daemon to
21       issue tasks and collect information about the configuration and
22       resources of the host system and guests.
23
24       By default, the libvirtd daemon listens for requests on a local Unix
25       domain socket.  Using the -l|--listen command line option, the libvirtd
26       daemon can be instructed to additionally listen on a TCP/IP socket.
27       The TCP/IP socket to use is defined in the libvirtd configuration file.
28
29       Restarting libvirtd does not impact running guests.  Guests continue to
30       operate and will be picked up automatically if their XML configuration
31       has been defined.  Any guests whose XML configuration has not been
32       defined will be lost from the configuration.
33

OPTIONS

35       -h, --help
36           Display command line help usage then exit.
37
38       -d, --daemon
39           Run as a daemon & write PID file.
40
41       -f, --config FILE
42           Use this configuration file, overriding the default value.
43
44       -l, --listen
45           Listen for TCP/IP connections.
46
47       -p, --pid-file FILE
48           Use this name for the PID file, overriding the default value.
49
50       -t, --timeout SECONDS
51           Exit after timeout period (in seconds), provided there are neither
52           any client connections nor any running domains.
53
54       -v, --verbose
55           Enable output of verbose messages.
56
57           --version
58           Display version information then exit.
59

SIGNALS

61       On receipt of SIGHUP libvirtd will reload its configuration.
62

FILES

64   When run as root.
65       /etc/libvirt/libvirtd.conf
66           The default configuration file used by libvirtd, unless overridden
67           on the command line using the -f|--config option.
68
69       /var/run/libvirt/libvirt-sock
70       /var/run/libvirt/libvirt-sock-ro
71           The sockets libvirtd will use.
72
73       /etc/pki/CA/cacert.pem
74           The TLS Certificate Authority certificate libvirtd will use.
75
76       /etc/pki/libvirt/servercert.pem
77           The TLS Server certificate libvirtd will use.
78
79       /etc/pki/libvirt/private/serverkey.pem
80           The TLS Server private key libvirtd will use.
81
82       /var/run/libvirtd.pid
83           The PID file to use, unless overridden by the -p|--pid-file option.
84
85   When run as non-root.
86       $XDG_CONFIG_HOME/libvirt/libvirtd.conf
87           The default configuration file used by libvirtd, unless overridden
88           on the command line using the -f|--config option.
89
90       $XDG_RUNTIME_DIR/libvirt/libvirt-sock
91           The socket libvirtd will use.
92
93       $HOME/.pki/libvirt/cacert.pem
94           The TLS Certificate Authority certificate libvirtd will use.
95
96       $HOME/.pki/libvirt/servercert.pem
97           The TLS Server certificate libvirtd will use.
98
99       $HOME/.pki/libvirt/serverkey.pem
100           The TLS Server private key libvirtd will use.
101
102       $XDG_RUNTIME_DIR/libvirt/libvirtd.pid
103           The PID file to use, unless overridden by the -p|--pid-file option.
104
105       If $XDG_CONFIG_HOME is not set in your environment, libvirtd will use
106       $HOME/.config
107       If $XDG_RUNTIME_DIR is not set in your environment, libvirtd will use
108       $HOME/.cache
109

EXAMPLES

111       To retrieve the version of libvirtd:
112
113        # libvirtd --version
114        libvirtd (libvirt) 0.8.2
115        #
116
117       To start libvirtd, instructing it to daemonize and create a PID file:
118
119        # libvirtd -d
120        # ls -la /var/run/libvirtd.pid
121        -rw-r--r-- 1 root root 6 Jul  9 02:40 /var/run/libvirtd.pid
122        #
123

BUGS

125       Please report all bugs you discover.  This should be done via either:
126
127       a) the mailing list
128           <https://libvirt.org/contact.html>
129
130       or,
131
132       b) the bug tracker
133           <https://libvirt.org/bugs.html>
134
135       Alternatively, you may report bugs to your software distributor /
136       vendor.
137

AUTHORS

139       Please refer to the AUTHORS file distributed with libvirt.
140

COPYRIGHT

142       Copyright (C) 2006-2012 Red Hat, Inc., and the authors listed in the
143       libvirt AUTHORS file.
144

LICENSE

146       libvirtd is distributed under the terms of the GNU LGPL v2.1+.  This is
147       free software; see the source for copying conditions. There is NO
148       warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
149       PURPOSE
150