virtnodedevd(8)

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

NAME

6       virtnodedevd - libvirt host device management daemon
7

SYNOPSIS

9       virtnodedevd [OPTION]...
10

DESCRIPTION

12       The  virtnodedevd program is a server side daemon component of the lib‐
13       virt 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 host
19       devices.
20
21       The virtnodedevd daemon only listens for requests on a local  Unix  do‐
22       main  socket.  Remote  off-host access and backwards compatibility with
23       legacy clients expecting libvirtd is provided by the virtproxy daemon.
24
25       Restarting virtnodedevd does not interrupt running guests. Guests  con‐
26       tinue to operate and changes in their state will generally be picked up
27       automatically during startup. None the less it is recommended to  avoid
28       restarting with running guests whenever practical.
29

DAEMON STARTUP MODES

31       The virtnodedevd 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/virtnodedevd.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 virtnodedevd will reload its configuration.
76

FILES

78   When run as root
79       • /etc/libvirt/virtnodedevd.conf
80
81       The  default configuration file used by virtnodedevd, unless overridden
82       on the command line using the -f | --config option.
83
84       • /run/libvirt/virtnodedevd-sock
85
86       • /run/libvirt/virtnodedevd-sock-ro
87
88       • /run/libvirt/virtnodedevd-admin-sock
89
90       The sockets virtnodedevd will use.
91
92       The TLS Server private key virtnodedevd will use.
93
94       • /run/virtnodedevd.pid
95
96       The PID file to use, unless overridden by the -p | --pid-file option.
97
98   When run as non-root
99       • $XDG_CONFIG_HOME/libvirt/virtnodedevd.conf
100
101       The default configuration file used by virtnodedevd, unless  overridden
102       on the command line using the -f``|--config`` option.
103
104       • $XDG_RUNTIME_DIR/libvirt/virtnodedevd-sock
105
106       • $XDG_RUNTIME_DIR/libvirt/virtnodedevd-admin-sock
107
108       The sockets virtnodedevd will use.
109
110       • $XDG_RUNTIME_DIR/libvirt/virtnodedevd.pid
111
112       The PID file to use, unless overridden by the -p``|--pid-file`` option.
113
114       If  $XDG_CONFIG_HOME  is not set in your environment, virtnodedevd will
115       use $HOME/.config
116
117       If $XDG_RUNTIME_DIR is not set in your environment,  virtnodedevd  will
118       use $HOME/.cache
119

EXAMPLES

121       To retrieve the version of virtnodedevd:
122
123          # virtnodedevd --version
124          virtnodedevd (libvirt) 9.0.0
125
126       To  start  virtnodedevd,  instructing  it to daemonize and create a PID
127       file:
128
129          # virtnodedevd -d
130          # ls -la /run/virtnodedevd.pid
131          -rw-r--r-- 1 root root 6 Jul  9 02:40 /run/virtnodedevd.pid
132

BUGS

134       Please report all bugs you discover.  This should be done via either:
135
136       1. the mailing list
137
138          https://libvirt.org/contact.html
139
140       2. the bug tracker
141
142          https://libvirt.org/bugs.html
143
144       Alternatively, you may report bugs to your software distributor /  ven‐
145       dor.
146

AUTHORS

148       Please refer to the AUTHORS file distributed with libvirt.
149

COPYRIGHT

151       Copyright  (C)  2006-2020  Red Hat, Inc., and the authors listed in the
152       libvirt AUTHORS file.
153

LICENSE

155       virtnodedevd is distributed under the terms  of  the  GNU  LGPL  v2.1+.
156       This  is free software; see the source for copying conditions. There is
157       NO warranty; not even for MERCHANTABILITY or FITNESS FOR  A  PARTICULAR
158       PURPOSE
159