libvirtd(8)

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

NAME

6       libvirtd - libvirtd management daemon
7

SYNOPSIS

9       libvirtd [ -dlv ] [ -f config_file ] [ -p pid_file ] [ -t
10       timeout_seconds ]
11
12       libvirtd --version
13

DESCRIPTION

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

OPTIONS

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) elapse with no client
52           connections or registered resources.  Be aware that resources such
53           as autostart networks will result in never reaching the timeout,
54           even when there are no client connections.
55
56       -v, --verbose
57           Enable output of verbose messages.
58
59           --version
60           Display version information then exit.
61

SIGNALS

63       On receipt of SIGHUP libvirtd will reload its configuration.
64

FILES

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

EXAMPLES

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

BUGS

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

AUTHORS

136       Please refer to the AUTHORS file distributed with libvirt.
137

COPYRIGHT

139       Copyright (C) 2006-2012 Red Hat, Inc., and the authors listed in the
140       libvirt AUTHORS file.
141

LICENSE

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