virtinterfaced(8)

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

NAME

6       virtinterfaced - libvirt host network interface management daemon
7

SYNOPSIS

9       virtinterfaced [OPTION]...
10

DESCRIPTION

12       The  virtinterfaced  program  is  a server side daemon component of the
13       libvirt 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       network interfaces.
20
21       The virtinterfaced 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 virtinterfaced does not  interrupt  running  guests.  Guests
26       continue to operate and changes in their state will generally be picked
27       up automatically during startup. None the less  it  is  recommended  to
28       avoid restarting with running guests whenever practical.
29

DAEMON STARTUP MODES

31       The virtinterfaced 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/virtinterfaced.conf  will  no
38       longer 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 virtinterfaced will reload its configuration.
76

FILES

78   When run as root
79       • /etc/libvirt/virtinterfaced.conf
80
81       The  default configuration file used by virtinterfaced, unless overrid‐
82       den on the command line using the -f | --config option.
83
84       • /run/libvirt/virtinterfaced-sock
85
86       • /run/libvirt/virtinterfaced-sock-ro
87
88       • /run/libvirt/virtinterfaced-admin-sock
89
90       The sockets virtinterfaced will use.
91
92       The TLS Server private key virtinterfaced will use.
93
94       • /run/virtinterfaced.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/virtinterfaced.conf
100
101       The default configuration file used by virtinterfaced, unless  overrid‐
102       den on the command line using the -f``|--config`` option.
103
104       • $XDG_RUNTIME_DIR/libvirt/virtinterfaced-sock
105
106       • $XDG_RUNTIME_DIR/libvirt/virtinterfaced-admin-sock
107
108       The sockets virtinterfaced will use.
109
110       • $XDG_RUNTIME_DIR/libvirt/virtinterfaced.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, virtinterfaced will
115       use $HOME/.config
116
117       If $XDG_RUNTIME_DIR is not set in your environment, virtinterfaced will
118       use $HOME/.cache
119

EXAMPLES

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