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
14       virtual 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           Display command line help usage then exit.
27
28       -d, --daemon
29           Run as a daemon and write PID file.
30
31       -f, --config FILE
32           Use this configuration file, overriding the default value.
33
34       -t, --timeout SECONDS
35           Automatically shutdown after SECONDS have elapsed with no active
36           console log.
37
38       -p, --pid-file FILE
39           Use this name for the PID file, overriding the default value.
40
41       -v, --verbose
42           Enable output of verbose messages.
43
44       -V, --version
45           Display version information then exit.
46

SIGNALS

48       On receipt of SIGUSR1 virtlogd will re-exec() its binary, while
49       maintaining all current logs and clients. This allows for live upgrades
50       of the virtlogd service.
51

FILES

53   When run as root.
54       /etc/libvirt/virtlogd.conf
55           The default configuration file used by virtlogd, unless overridden
56           on the command line using the -f|--config option.
57
58       /var/run/libvirt/virtlogd-sock
59           The sockets libvirtd will use.
60
61       /var/run/virtlogd.pid
62           The PID file to use, unless overridden by the -p|--pid-file option.
63
64   When run as non-root.
65       $XDG_CONFIG_HOME/libvirt/virtlogd.conf
66           The default configuration file used by libvirtd, unless overridden
67           on the command line using the -f|--config option.
68
69       $XDG_RUNTIME_DIR/libvirt/virtlogd-sock
70           The socket libvirtd will use.
71
72       $XDG_RUNTIME_DIR/libvirt/virtlogd.pid
73           The PID file to use, unless overridden by the -p|--pid-file option.
74
75       If $XDG_CONFIG_HOME is not set in your environment, libvirtd will use
76       $HOME/.config
77       If $XDG_RUNTIME_DIR is not set in your environment, libvirtd will use
78       $HOME/.cache
79

EXAMPLES

81       To retrieve the version of virtlogd:
82
83        # virtlogd --version
84        virtlogd (libvirt) 1.1.1
85        #
86
87       To start virtlogd, instructing it to daemonize and create a PID file:
88
89        # virtlogd -d
90        # ls -la /var/run/virtlogd.pid
91        -rw-r--r-- 1 root root 6 Jul  9 02:40 /var/run/virtlogd.pid
92        #
93

BUGS

95       Please report all bugs you discover.  This should be done via either:
96
97       a) the mailing list
98           <https://libvirt.org/contact.html>
99
100       or,
101
102       b) the bug tracker
103           <https://libvirt.org/bugs.html>
104
105       Alternatively, you may report bugs to your software distributor /
106       vendor.
107

AUTHORS

109       Please refer to the AUTHORS file distributed with libvirt.
110

COPYRIGHT

112       Copyright (C) 2006-2015 Red Hat, Inc., and the authors listed in the
113       libvirt AUTHORS file.
114

LICENSE

116       virtlogd is distributed under the terms of the GNU LGPL v2.1+.  This is
117       free software; see the source for copying conditions. There is NO
118       warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
119       PURPOSE
120