FreeBSD Manual Pages
VIRTLOGD(8) Virtualization Support VIRTLOGD(8) NAME virtlogd - libvirt log management daemon SYNOPSIS virtlogd [OPTION]... DESCRIPTION The virtlogd program is a server side daemon component of the libvirt virtualization management system that is used to manage logs from vir- tual machine consoles. This daemon is not used directly by libvirt client applications, rather it is called on their behalf by libvirtd. By maintaining the logs in a standalone daemon, the main libvirtd daemon can be restarted without risk of losing logs. The virtlogd daemon has the ability to re-exec() itself upon receiving SIGUSR1, to allow live upgrades without downtime. The virtlogd daemon listens for requests on a local Unix domain socket. OPTIONS -h, --help Display command line help usage then exit. -d, --daemon Run as a daemon and write PID file. -f, --config FILE Use this configuration file, overriding the default value. -t, --timeout SECONDS Automatically shutdown after SECONDS have elapsed with no active con- sole log. -p, --pid-file FILE Use this name for the PID file, overriding the default value. -v, --verbose Enable output of verbose messages. -V, --version Display version information then exit. SIGNALS On receipt of SIGUSR1, virtlogd will re-exec() its binary, while main- taining all current logs and clients. This allows for live upgrades of the virtlogd service. FILES When run as root • /usr/local/etc/libvirt/virtlogd.conf The default configuration file used by virtlogd, unless overridden on the command line using the -f | --config option. • /var/run/libvirt/virtlogd-sock The sockets virtlogd will use. • /var/run/virtlogd.pid The PID file to use, unless overridden by the -p | --pid-file option. When run as non-root • $XDG_CONFIG_HOME/libvirt/virtlogd.conf The default configuration file used by virtlogd, unless overridden on the command line using the -f | --config option. • $XDG_RUNTIME_DIR/libvirt/virtlogd-sock The socket virtlogd will use. • $XDG_RUNTIME_DIR/libvirt/virtlogd.pid The PID file to use, unless overridden by the -p | --pid-file option. If $XDG_CONFIG_HOME is not set in your environment, virtlogd will use $HOME/.config If $XDG_RUNTIME_DIR is not set in your environment, virtlogd will use $HOME/.cache EXAMPLES To retrieve the version of virtlogd: # virtlogd --version virtlogd (libvirt) 11.1.0 To start virtlogd, instructing it to daemonize and create a PID file: # virtlogd -d # ls -la /var/run/virtlogd.pid -rw-r--r-- 1 root root 6 Jul 9 02:40 /var/run/virtlogd.pid BUGS Please report all bugs you discover. This should be done via either: 1. the mailing list <https://libvirt.org/contact.html> 2. the bug tracker <https://libvirt.org/bugs.html> Alternatively, you may report bugs to your software distributor / ven- dor. AUTHORS Please refer to the AUTHORS file distributed with libvirt. COPYRIGHT Copyright (C) 2006-2015 Red Hat, Inc., and the authors listed in the libvirt AUTHORS file. LICENSE virtlogd is distributed under the terms of the GNU LGPL v2.1+. This is free software; see the source for copying conditions. There is NO war- ranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE SEE ALSO libvirtd(8), <https://libvirt.org/> VIRTLOGD(8)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | SIGNALS | FILES | EXAMPLES | BUGS | AUTHORS | COPYRIGHT | LICENSE | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=virtlogd&sektion=8&manpath=FreeBSD+Ports+14.3.quarterly>