virtlxcd(8)

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

NAME

6       virtlxcd - libvirt LXC management daemon
7

SYNOPSIS

9       virtlxcd [OPTION]...
10

DESCRIPTION

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

DAEMON STARTUP MODES

31       The virtlxcd daemon is capable of starting in two modes.
32
33   Socket activation mode
34       On  hosts  with  systemd it is started in socket activation mode and it
35       will rely on systemd to create and listen on the UNIX sockets and  pass
36       them  as  pre-opened  file descriptors. In this mode most of the socket
37       related config options in  /etc/libvirt/virtlxcd.conf  will  no  longer
38       have any effect.
39
40   Traditional service mode
41       On hosts without systemd, it will create and listen on UNIX sockets it‐
42       self.
43

OPTIONS

45       -h, --help
46
47       Display command line help usage then exit.
48
49       -d, --daemon
50
51       Run as a daemon & write PID file.
52
53       -f, --config *FILE*
54
55       Use this configuration file, overriding the default value.
56
57       -p, --pid-file *FILE*
58
59       Use this name for the PID file, overriding the default value.
60
61       -t, --timeout *SECONDS*
62
63       Exit after timeout period (in seconds), provided there are neither  any
64       client connections nor any running domains.
65
66       -v, --verbose
67
68       Enable output of verbose messages.
69
70       --version
71
72       Display version information then exit.
73

SIGNALS

75       On receipt of SIGHUP virtlxcd will reload its configuration.
76

FILES

78       The  virtlxcd  program must be ran as root. Trying to start the program
79       under a different user results in error.
80
81       • /etc/libvirt/virtlxcd.conf
82
83       The default configuration file used by virtlxcd, unless  overridden  on
84       the command line using the -f | --config option.
85
86       In  addition to the default configuration file, virtlxcd reads configu‐
87       ration for the LXC driver from:
88
89       • /etc/libvirt/lxc.conf
90
91       This file contains various knobs and default  values  for  virtual  ma‐
92       chines  created  within  LXC  driver,  and offers a way to override the
93       built in defaults, Location of this file can't  be  overridden  by  any
94       command line switch.
95
96       • /run/libvirt/virtlxcd-sock
97
98       • /run/libvirt/virtlxcd-sock-ro
99
100       • /run/libvirt/virtlxcd-admin-sock
101
102       The sockets virtlxcd will use.
103
104       The TLS Server private key virtlxcd will use.
105
106       • /run/virtlxcd.pid
107
108       The PID file to use, unless overridden by the -p | --pid-file option.
109

EXAMPLES

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

BUGS

123       Please report all bugs you discover.  This should be done via either:
124
125       1. the mailing list
126
127          https://libvirt.org/contact.html
128
129       2. the bug tracker
130
131          https://libvirt.org/bugs.html
132
133       Alternatively,  you may report bugs to your software distributor / ven‐
134       dor.
135

AUTHORS

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

COPYRIGHT

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

LICENSE

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