From nobody Thu May 2 03:05:00 2024
Delivered-To: importer@patchew.org
Received-SPF: pass (zohomail.com: domain of redhat.com designates
63.128.21.124 as permitted sender) client-ip=63.128.21.124;
envelope-from=libvir-list-bounces@redhat.com;
helo=us-smtp-delivery-124.mimecast.com;
Authentication-Results: mx.zohomail.com;
dkim=pass;
spf=pass (zohomail.com: domain of redhat.com designates 63.128.21.124 as
permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com;
dmarc=pass(p=none dis=none) header.from=redhat.com
ARC-Seal: i=1; a=rsa-sha256; t=1614887757; cv=none;
d=zohomail.com; s=zohoarc;
b=PWu33ilNXYFejcNIv7ZjhHPGlvfGzKJpSt9JW3Rr+ifRCsbOeQI0r9P9DK5nzSF7zWPkdhGkphG1EumBQXddsido66veJDBf0neXKBLRjoe8MdFmahaknIshGgY9y6aTPetqT6pxKgL5jowCePsX+u7vGnjgbZameSTK3Ty/FJA=
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com;
s=zohoarc;
t=1614887757;
h=Content-Type:Content-Transfer-Encoding:Cc:Date:From:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:To;
bh=lba0DRaxXeOQHw4VsafG5UOKPFUjkiw4TSEUQt3zkqo=;
b=GFf2HQ1H/K+HvnO+oXJj3rJQjRb1gV2MrY+OAvtScWHoPq3GZMXdsWAEOJmS3KNObu2eoMzDl176MyBSgpvVulzk0UZKjCCYw6DvGGSCbfEVduP2PEu9hRM+3EHsF1xK+x1344jCqMhtvNrGWYi0MS3ffxBwlCSa8RzMKY3K+L4=
ARC-Authentication-Results: i=1; mx.zohomail.com;
dkim=pass;
spf=pass (zohomail.com: domain of redhat.com designates 63.128.21.124 as
permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com;
dmarc=pass header.from=
+ The QEMU driver comes with sane default values. However, during its + initialization it reads a configuration file which offers system + administrator or an user to override some of that default. The locat= ion + of the file depends on the connection URI, as follows: +
+ +qemu:///system |
+ /etc/libvirt/qemu.conf |
+
qemu:///session |
+ $XDG_CONFIG_HOME/libvirt/qemu.conf |
+
qemu:///embed |
+ $rootdir/etc/qemu.conf |
+
+ If $XDG_CONFIG_HOME
is not set in the environment, it
+ defaults to $HOME/.config
. For the embed URI the
+ $rootdir
represents the specified root directory from
+ the connection URI.
+
+ Please note, that it is very likely that the only qemu.conf file that
+ will exist after installing libvirt is the
+ /etc/libvirt/qemu.conf
, if users of the session daemon =
or
+ the embed driver want to override a built in value, then they need to
+ create the file before connecting to the respective URI.
+
diff --git a/docs/manpages/libvirtd.rst b/docs/manpages/libvirtd.rst index ed591f4778..6545dc58d3 100644 --- a/docs/manpages/libvirtd.rst +++ b/docs/manpages/libvirtd.rst @@ -136,6 +136,16 @@ When run as *root* The default configuration file used by ``libvirtd``, unless overridden on = the command line using the ``-f`` | ``--config`` option. =20 +If QEMU driver is installed, then the following file is also read: + +* ``@SYSCONFDIR@/libvirt/qemu.conf`` + +This file contains various knobs and default values for virtual machines +created within QEMU driver, and offers a way to override the built in defa= ults, +for instance (but not limited to): paths to various supplementary binaries= , TLS +certificates location, graphical consoles configuration and others. Locati= on of +this file can't be overridden by any command line switch. + * ``@RUNSTATEDIR@/libvirt/libvirt-sock`` * ``@RUNSTATEDIR@/libvirt/libvirt-sock-ro`` =20 @@ -166,6 +176,16 @@ When run as *non-root* The default configuration file used by ``libvirtd``, unless overridden on = the command line using the ``-f``|``--config`` option. =20 +If QEMU driver is installed, then the following file is also read: + +* ``$XDG_CONFIG_HOME/libvirt/qemu.conf`` + +If the file exists, it can contain various knobs and default values for vi= rtual +machines created within QEMU driver, and offers a way to override the buil= t in +defaults, for instance (but not limited to): paths to various supplementary +binaries, TLS certificates location, graphical consoles configuration and +others. Location of this file can't be overridden by any command line swit= ch. + * ``$XDG_RUNTIME_DIR/libvirt/libvirt-sock`` =20 The socket ``libvirtd`` will use. diff --git a/docs/manpages/virtqemud.rst b/docs/manpages/virtqemud.rst index fbcc6e45fa..d82d09ee61 100644 --- a/docs/manpages/virtqemud.rst +++ b/docs/manpages/virtqemud.rst @@ -111,6 +111,17 @@ When run as *root* The default configuration file used by ``virtqemud``, unless overridden on= the command line using the ``-f`` | ``--config`` option. =20 +In addition to the default configuration file, ``virtqemud`` reads +configuration for the qemu driver from: + +* ``@SYSCONFDIR@/libvirt/qemu.conf`` + +This file contains various knobs and default values for virtual machines +created within QEMU driver, and offers a way to override the built in defa= ults, +for instance (but not limited to): paths to various supplementary binaries= , TLS +certificates location, graphical consoles configuration and others. Locati= on of +this file can't be overridden by any command line switch. + * ``@RUNSTATEDIR@/libvirt/virtqemud-sock`` * ``@RUNSTATEDIR@/libvirt/virtqemud-sock-ro`` * ``@RUNSTATEDIR@/libvirt/virtqemud-admin-sock`` @@ -132,6 +143,17 @@ When run as *non-root* The default configuration file used by ``virtqemud``, unless overridden on= the command line using the ``-f``|``--config`` option. =20 +In addition to the default configuration file, ``virtqemud`` reads +configuration for the qemu driver from: + +* ``$XDG_CONFIG_HOME/libvirt/qemu.conf`` + +If the file exists, it can contain various knobs and default values for vi= rtual +machines created within QEMU driver, and offers a way to override the buil= t in +defaults, for instance (but not limited to): paths to various supplementary +binaries, TLS certificates location, graphical consoles configuration and +others. Location of this file can't be overridden by any command line swit= ch. + * ``$XDG_RUNTIME_DIR/libvirt/virtqemud-sock`` * ``$XDG_RUNTIME_DIR/libvirt/virtqemud-admin-sock`` =20 --=20 2.26.2