virtlogd(8)

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

NAME

6       virtlogd - libvirt log management daemon
7

SYNOPSIS

9       virtlogd [OPTION]...
10

DESCRIPTION

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

OPTIONS

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

SIGNALS

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

FILES

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

EXAMPLES

95       To retrieve the version of virtlogd:
96
97          # virtlogd --version
98          virtlogd (libvirt) 8.1.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

BUGS

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

AUTHORS

121       Please refer to the AUTHORS file distributed with libvirt.
122

COPYRIGHT

124       Copyright  (C)  2006-2015  Red Hat, Inc., and the authors listed in the
125       libvirt AUTHORS file.
126

LICENSE

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