1VIRTLXCD(8) Virtualization Support VIRTLXCD(8)
2
3
4
6 virtlxcd - libvirt LXC management daemon
7
9 virtlxcd [OPTION]...
10
12 The virtlxcd program is a server side daemon component of the libvirt
13 virtualization management system.
14
15 It is one of a collection of modular daemons that replace functionality
16 previously provided by the monolithic libvirtd daemon.
17
18 This daemon runs on virtualization hosts to provide management for LXC
19 containers.
20
21 The virtlxcd daemon only listens for requests on a local Unix domain
22 socket. Remote off-host access and backwards compatibility with legacy
23 clients expecting libvirtd is provided by the virtproxy daemon.
24
25 Restarting virtlxcd does not interrupt running guests. Guests continue
26 to operate and changes in their state will generally be picked up auto‐
27 matically during startup. None the less it is recommended to avoid
28 restarting with running guests whenever practical.
29
31 The virtlxcd daemon is capable of starting in two modes.
32
33 In the traditional mode, it will create and listen on UNIX sockets it‐
34 self.
35
36 In socket activation mode, it will rely on systemd to create and listen
37 on the UNIX sockets and pass them as pre-opened file descriptors. In
38 this mode most of the socket related config options in /etc/lib‐
39 virt/virtlxcd.conf will no longer have any effect.
40
41 Socket activation mode is generally the default when running on a host
42 OS that uses systemd. To revert to the traditional mode, all the socket
43 unit files must be masked:
44
45 $ systemctl mask virtlxcd.socket virtlxcd-ro.socket \
46 virtlxcd-admin.socket
47
49 -h, --help
50
51 Display command line help usage then exit.
52
53 -d, --daemon
54
55 Run as a daemon & write PID file.
56
57 -f, --config *FILE*
58
59 Use this configuration file, overriding the default value.
60
61 -p, --pid-file *FILE*
62
63 Use this name for the PID file, overriding the default value.
64
65 -t, --timeout *SECONDS*
66
67 Exit after timeout period (in seconds), provided there are neither any
68 client connections nor any running domains.
69
70 -v, --verbose
71
72 Enable output of verbose messages.
73
74 --version
75
76 Display version information then exit.
77
79 On receipt of SIGHUP virtlxcd will reload its configuration.
80
82 The virtlxcd program must be ran as root. Trying to start the program
83 under a different user results in error.
84
85 • /etc/libvirt/virtlxcd.conf
86
87 The default configuration file used by virtlxcd, unless overridden on
88 the command line using the -f | --config option.
89
90 In addition to the default configuration file, virtlxcd reads configu‐
91 ration for the LXC driver from:
92
93 • /etc/libvirt/lxc.conf
94
95 This file contains various knobs and default values for virtual ma‐
96 chines created within LXC driver, and offers a way to override the
97 built in defaults, Location of this file can't be overridden by any
98 command line switch.
99
100 • /run/libvirt/virtlxcd-sock
101
102 • /run/libvirt/virtlxcd-sock-ro
103
104 • /run/libvirt/virtlxcd-admin-sock
105
106 The sockets virtlxcd will use.
107
108 The TLS Server private key virtlxcd will use.
109
110 • /run/virtlxcd.pid
111
112 The PID file to use, unless overridden by the -p | --pid-file option.
113
115 To retrieve the version of virtlxcd:
116
117 # virtlxcd --version
118 virtlxcd (libvirt) 8.1.0
119
120 To start virtlxcd, instructing it to daemonize and create a PID file:
121
122 # virtlxcd -d
123 # ls -la /run/virtlxcd.pid
124 -rw-r--r-- 1 root root 6 Jul 9 02:40 /run/virtlxcd.pid
125
127 Please report all bugs you discover. This should be done via either:
128
129 1. the mailing list
130
131 https://libvirt.org/contact.html
132
133 2. the bug tracker
134
135 https://libvirt.org/bugs.html
136
137 Alternatively, you may report bugs to your software distributor / ven‐
138 dor.
139
141 Please refer to the AUTHORS file distributed with libvirt.
142
144 Copyright (C) 2006-2020 Red Hat, Inc., and the authors listed in the
145 libvirt AUTHORS file.
146
148 virtlxcd is distributed under the terms of the GNU LGPL v2.1+. This is
149 free software; see the source for copying conditions. There is NO war‐
150 ranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE
151
153 virsh(1), libvirtd(8), https://www.libvirt.org/daemons.html,
154 https://www.libvirt.org/drvlxc.html
155
156
157
158
159 VIRTLXCD(8)