1VIRTLOGD(8) Virtualization Support VIRTLOGD(8)
2
3
4
6 virtlogd - libvirt log management daemon
7
9 virtlogd [OPTION]...
10
12 The virtlogd program is a server side daemon component of the libvirt
13 virtualization management system that is used to manage logs from vir‐
14 tual machine consoles.
15
16 This daemon is not used directly by libvirt client applications, rather
17 it is called on their behalf by libvirtd. By maintaining the logs in a
18 standalone daemon, the main libvirtd daemon can be restarted without
19 risk of losing logs. The virtlogd daemon has the ability to re-exec()
20 itself upon receiving SIGUSR1, to allow live upgrades without downtime.
21
22 The virtlogd daemon listens for requests on a local Unix domain socket.
23
25 -h, --help
26
27 Display command line help usage then exit.
28
29 -d, --daemon
30
31 Run as a daemon and write PID file.
32
33 -f, --config FILE
34
35 Use this configuration file, overriding the default value.
36
37 -t, --timeout SECONDS
38
39 Automatically shutdown after SECONDS have elapsed with no active con‐
40 sole log.
41
42 -p, --pid-file FILE
43
44 Use this name for the PID file, overriding the default value.
45
46 -v, --verbose
47
48 Enable output of verbose messages.
49
50 -V, --version
51
52 Display version information then exit.
53
55 On receipt of SIGUSR1, virtlogd will re-exec() its binary, while main‐
56 taining all current logs and clients. This allows for live upgrades of
57 the virtlogd service.
58
60 When run as root
61 • /etc/libvirt/virtlogd.conf
62
63 The default configuration file used by virtlogd, unless overridden on
64 the command line using the -f | --config option.
65
66 • /run/libvirt/virtlogd-sock
67
68 The sockets virtlogd will use.
69
70 • /run/virtlogd.pid
71
72 The PID file to use, unless overridden by the -p | --pid-file option.
73
74 When run as non-root
75 • $XDG_CONFIG_HOME/libvirt/virtlogd.conf
76
77 The default configuration file used by virtlogd, unless overridden on
78 the command line using the -f | --config option.
79
80 • $XDG_RUNTIME_DIR/libvirt/virtlogd-sock
81
82 The socket virtlogd will use.
83
84 • $XDG_RUNTIME_DIR/libvirt/virtlogd.pid
85
86 The PID file to use, unless overridden by the -p | --pid-file option.
87
88 If $XDG_CONFIG_HOME is not set in your environment, virtlogd will use
89 $HOME/.config
90
91 If $XDG_RUNTIME_DIR is not set in your environment, virtlogd will use
92 $HOME/.cache
93
95 To retrieve the version of virtlogd:
96
97 # virtlogd --version
98 virtlogd (libvirt) 7.6.0
99
100 To start virtlogd, instructing it to daemonize and create a PID file:
101
102 # virtlogd -d
103 # ls -la /run/virtlogd.pid
104 -rw-r--r-- 1 root root 6 Jul 9 02:40 /run/virtlogd.pid
105
107 Please report all bugs you discover. This should be done via either:
108
109 1. the mailing list
110
111 https://libvirt.org/contact.html
112
113 2. the bug tracker
114
115 https://libvirt.org/bugs.html
116
117 Alternatively, you may report bugs to your software distributor / ven‐
118 dor.
119
121 Please refer to the AUTHORS file distributed with libvirt.
122
124 Copyright (C) 2006-2015 Red Hat, Inc., and the authors listed in the
125 libvirt AUTHORS file.
126
128 virtlogd is distributed under the terms of the GNU LGPL v2.1+. This is
129 free software; see the source for copying conditions. There is NO war‐
130 ranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE
131
133 libvirtd(8), https://libvirt.org/
134
135
136
137
138 VIRTLOGD(8)