From nobody Tue May 7 07:04:53 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=1615537489; cv=none; d=zohomail.com; s=zohoarc; b=MiwoYw0Kg5cYwFBNsm5lnAYiZkzxg15Tc63w+/SOs4P3QQntgUKzAoRuLc2oNwRHkJpjpMCcmAKYS8Nb6tRdCx07OpuxjxQVD8nG8rwIBiGz476OfOZniv3+4elSv8Koa9eTpelZHHgFQ6dDMC+qMX4gw8vPr4qkpZxnwrorRvs= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1615537489; h=Content-Type:Content-Transfer-Encoding:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=Ird8E4OLuJSEE1YVJS7e3hES1r76BzICYxmq7jHWbG8=; b=ISko/ytOy462tq4p3VZih1bY2/8Q6rT03kFGbEKiVznovfFx2VA0UxcdmrM1KXfnFWGtg2HCqBgdMJ7FSSwiD9ut7+teS2kdNheYJQGnwjtJMXwcxyrP8JLMEf9LldLKvVJ+zU/u87p/fnbenmFq13xm8tHBIceAkU/0WG6y+KQ= 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= (p=none dis=none) header.from= Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [63.128.21.124]) by mx.zohomail.com with SMTPS id 1615537489128731.5924767614737; Fri, 12 Mar 2021 00:24:49 -0800 (PST) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-310-YanT9LZpO1ybjdEBllewOw-1; Fri, 12 Mar 2021 03:24:42 -0500 Received: from smtp.corp.redhat.com (int-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.12]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 76752EC1A2; Fri, 12 Mar 2021 08:24:37 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.21]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 369E518BAC; Fri, 12 Mar 2021 08:24:37 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id DCECD57DC4; Fri, 12 Mar 2021 08:24:36 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.phx2.redhat.com [10.5.11.15]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 12C8OPAr006443 for ; Fri, 12 Mar 2021 03:24:25 -0500 Received: by smtp.corp.redhat.com (Postfix) id D7A745D6D7; Fri, 12 Mar 2021 08:24:25 +0000 (UTC) Received: from localhost.localdomain (unknown [10.40.193.166]) by smtp.corp.redhat.com (Postfix) with ESMTP id 5B9EF5D6BA for ; Fri, 12 Mar 2021 08:24:25 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1615537484; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=Ird8E4OLuJSEE1YVJS7e3hES1r76BzICYxmq7jHWbG8=; b=Qags6pUusAsRwsImnXyBBpOoNmC3TbqjBw2DSBXZMkq4YI/RV99+JRcQJiI7IaAjlwbdKJ fk7AYCezgTqjVV2cR1iojBK+ojbyqzSPtZKjPDqjcpeHmN3SwZbT42u6x7XkozUgisB0DL WH3YDbpSt9zhDBUQ6TCYOkTcl7vGC/A= X-MC-Unique: YanT9LZpO1ybjdEBllewOw-1 From: Michal Privoznik To: libvir-list@redhat.com Subject: [PATCH 1/5] docs: Capitalize QEMU driver reference Date: Fri, 12 Mar 2021 09:24:15 +0100 Message-Id: <4ec37afeecfcfc7321879d357b48cff2333e2861.1615537399.git.mprivozn@redhat.com> In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.15 X-loop: libvir-list@redhat.com X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.12 Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=libvir-list-bounces@redhat.com X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) Content-Type: text/plain; charset="utf-8" In official docs we refer to it as "QEMU driver", not "qemu driver". Signed-off-by: Michal Privoznik --- docs/manpages/virtqemud.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/manpages/virtqemud.rst b/docs/manpages/virtqemud.rst index d82d09ee61..ea8d6e3105 100644 --- a/docs/manpages/virtqemud.rst +++ b/docs/manpages/virtqemud.rst @@ -112,7 +112,7 @@ The default configuration file used by ``virtqemud``, u= nless 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: +configuration for the QEMU driver from: =20 * ``@SYSCONFDIR@/libvirt/qemu.conf`` =20 --=20 2.26.2 From nobody Tue May 7 07:04:53 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 216.205.24.124 as permitted sender) client-ip=216.205.24.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 216.205.24.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=1615537638; cv=none; d=zohomail.com; s=zohoarc; b=VSr79FpQXvIiFBTjWCLT13mOSb2r3ugjGZ+gSD1yL5US/KtVvTxY/r5vYL7pj/FkeVD48bDb2JgNNHHOyVudtD/gDmHq7aotOUusQEXWPxYhImMKqB/ogKPtFVxhacFMNgTn0ZyfGEProdqrJm4S1AfnMiKx4yvuKNdR6os6sZg= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1615537638; h=Content-Type:Content-Transfer-Encoding:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=TTvDlQirXHPw7JUweN5W9eRYj/GuyzKuQFt/u+LncK0=; b=E807/+c34VSFHns7L51AKaQnp7xxSDovPZfu2cxs9qs1QP+4SrcRbT/fuHCXVoZcPjvHGon5eU0os2zv3x3OWQqgwRqHKz4y0XM7QFQmBQE9uFp0pmsWk0Hw6WkO30jfWgtcUftDCKXRy5EresEBHTK83B62xL3Rr7DLfMisPfk= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 216.205.24.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [216.205.24.124]) by mx.zohomail.com with SMTPS id 1615537638118323.95551228050215; Fri, 12 Mar 2021 00:27:18 -0800 (PST) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-211-FvRzZ63_OFegEeKfitzpVA-1; Fri, 12 Mar 2021 03:24:47 -0500 Received: from smtp.corp.redhat.com (int-mx08.intmail.prod.int.phx2.redhat.com [10.5.11.23]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 3D8161074659; Fri, 12 Mar 2021 08:24:41 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.20]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 0E1AD1F067; Fri, 12 Mar 2021 08:24:41 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id BBB4B1800B8A; Fri, 12 Mar 2021 08:24:40 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.phx2.redhat.com [10.5.11.15]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 12C8OR9J006454 for ; Fri, 12 Mar 2021 03:24:27 -0500 Received: by smtp.corp.redhat.com (Postfix) id B09895B697; Fri, 12 Mar 2021 08:24:27 +0000 (UTC) Received: from localhost.localdomain (unknown [10.40.193.166]) by smtp.corp.redhat.com (Postfix) with ESMTP id 3455F5D6BA for ; Fri, 12 Mar 2021 08:24:26 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1615537637; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=TTvDlQirXHPw7JUweN5W9eRYj/GuyzKuQFt/u+LncK0=; b=E4LTrXs9FjwO93iWD1rgf+jpPH1OYDi/G0K4aTpMrHr+8BmmxN95PVJjsDFWe3mstiY2w8 osHCNea/SXbgUkMCCZygXVQr28oEcr4RUnIPYO0IFeZn07KUgdTwdk26qwyY0FWenOPTHg mobnxkBNVvqZALdPIvp8E7Yp0XQbN2I= X-MC-Unique: FvRzZ63_OFegEeKfitzpVA-1 From: Michal Privoznik To: libvir-list@redhat.com Subject: [PATCH 2/5] manpages: Remove reference to a session daemon for LXC Date: Fri, 12 Mar 2021 09:24:16 +0100 Message-Id: <2196964cb592ebe4a156671051c601c2de151c88.1615537399.git.mprivozn@redhat.com> In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.15 X-loop: libvir-list@redhat.com X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.84 on 10.5.11.23 Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=libvir-list-bounces@redhat.com X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) Content-Type: text/plain; charset="utf-8" The LXC driver has no session daemon therefore its split daemon (virtlxcd) has to be ran as root. Any attempt to start it with euid !=3D 0 fails. This is why the daemon does not look under any of XDG_* paths either. Signed-off-by: Michal Privoznik --- docs/manpages/virtlxcd.rst | 29 ++--------------------------- 1 file changed, 2 insertions(+), 27 deletions(-) diff --git a/docs/manpages/virtlxcd.rst b/docs/manpages/virtlxcd.rst index f89d70ba21..b9aca6c857 100644 --- a/docs/manpages/virtlxcd.rst +++ b/docs/manpages/virtlxcd.rst @@ -103,8 +103,8 @@ On receipt of ``SIGHUP`` ``virtlxcd`` will reload its c= onfiguration. FILES =3D=3D=3D=3D=3D =20 -When run as *root* ------------------- +The ``virtlxcd`` program must be ran as root. Trying to start the program = under +a different user results in error. =20 * ``@SYSCONFDIR@/libvirt/virtlxcd.conf`` =20 @@ -124,31 +124,6 @@ The TLS **Server** private key ``virtlxcd`` will use. The PID file to use, unless overridden by the ``-p`` | ``--pid-file`` opti= on. =20 =20 -When run as *non-root* ----------------------- - -* ``$XDG_CONFIG_HOME/libvirt/virtlxcd.conf`` - -The default configuration file used by ``virtlxcd``, unless overridden on = the -command line using the ``-f``|``--config`` option. - -* ``$XDG_RUNTIME_DIR/libvirt/virtlxcd-sock`` -* ``$XDG_RUNTIME_DIR/libvirt/virtlxcd-admin-sock`` - -The sockets ``virtlxcd`` will use. - -* ``$XDG_RUNTIME_DIR/libvirt/virtlxcd.pid`` - -The PID file to use, unless overridden by the ``-p``|``--pid-file`` option. - - -If ``$XDG_CONFIG_HOME`` is not set in your environment, ``virtlxcd`` will = use -``$HOME/.config`` - -If ``$XDG_RUNTIME_DIR`` is not set in your environment, ``virtlxcd`` will = use -``$HOME/.cache`` - - EXAMPLES =3D=3D=3D=3D=3D=3D=3D=3D =20 --=20 2.26.2 From nobody Tue May 7 07:04:53 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 216.205.24.124 as permitted sender) client-ip=216.205.24.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 216.205.24.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=1615537483; cv=none; d=zohomail.com; s=zohoarc; b=IgKKGB9iA+I+UTK/PKyUAnsNgcPvORI0CkTHkhtJHzvwW9dKMkzyHONH/fQ2SLmt9Da2GF0QaRA7Ztfv9iTC8ToHMXeKH8GBHhVfRngfXbUPwV8ptgpSjTzJgVkyAJIYSVGKIYbKFegZhsEJ03njC3OMBL6axTqPOcwXYGPsJKE= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1615537483; h=Content-Type:Content-Transfer-Encoding:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=w2Z0nhjXguN39V2pnt/GT0WT8umhrf35bR7ywK3Ebt0=; b=gLFgRmMWO+VYaPHt/0CQ3Y9lDWqH2iDmLuM24E4EvbUYGiczWkJnmNiYu0/2KyRAS1uyCH6+MHN0xuSdgtZyx75Oa2FOKECWGsEGb4FnqodqgQwrwRnfUgeu9bn2dOiMRKhuH9xrd7j6xXvz7B3Ae1mBUPF2paHUDNyoHE/0YBk= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 216.205.24.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [216.205.24.124]) by mx.zohomail.com with SMTPS id 1615537483053394.69939504836054; Fri, 12 Mar 2021 00:24:43 -0800 (PST) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-453-5MYpfj_sMvaj65qtonPCqg-1; Fri, 12 Mar 2021 03:24:39 -0500 Received: from smtp.corp.redhat.com (int-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.12]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id E2000100C62A; Fri, 12 Mar 2021 08:24:32 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.21]) by smtp.corp.redhat.com (Postfix) with ESMTPS id B235B60C5F; Fri, 12 Mar 2021 08:24:32 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id 708E457DC2; Fri, 12 Mar 2021 08:24:32 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.phx2.redhat.com [10.5.11.15]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 12C8OVjc006475 for ; Fri, 12 Mar 2021 03:24:31 -0500 Received: by smtp.corp.redhat.com (Postfix) id 6B88B5D6BA; Fri, 12 Mar 2021 08:24:31 +0000 (UTC) Received: from localhost.localdomain (unknown [10.40.193.166]) by smtp.corp.redhat.com (Postfix) with ESMTP id E3F8C5D6D7 for ; Fri, 12 Mar 2021 08:24:27 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1615537481; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=w2Z0nhjXguN39V2pnt/GT0WT8umhrf35bR7ywK3Ebt0=; b=dQSu9NVVW0naung9+98u9X7CDus4+TlGPaOMVqro2IFHJ3/Rl86qY7l2Wg3RfzbkHW+ilV 9+Uf3vqEWyQBF7U8bEVz3OSNeQpActreki+ws/zaMcW1MSpH4TZnUc1GMEtW3Yng2cz2Yn tHFjpfZsea9t6uA6TUpLtlLqmqtUO4I= X-MC-Unique: 5MYpfj_sMvaj65qtonPCqg-1 From: Michal Privoznik To: libvir-list@redhat.com Subject: [PATCH 3/5] docs: Document lxc.conf location Date: Fri, 12 Mar 2021 09:24:17 +0100 Message-Id: <326337555502d38cf7bcac685a41d157948295e5.1615537399.git.mprivozn@redhat.com> In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.15 X-loop: libvir-list@redhat.com X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.12 Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=libvir-list-bounces@redhat.com X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) Content-Type: text/plain; charset="utf-8" This is similar to my earlier commit which documented qemu.conf locations. Luckily, the LXC driver has only the system connection and not session or embed one. Signed-off-by: Michal Privoznik --- docs/drvlxc.html.in | 10 ++++++++++ docs/manpages/libvirtd.rst | 16 +++++++++------- docs/manpages/virtlxcd.rst | 9 +++++++++ 3 files changed, 28 insertions(+), 7 deletions(-) diff --git a/docs/drvlxc.html.in b/docs/drvlxc.html.in index b8a99272e6..23aae991a2 100644 --- a/docs/drvlxc.html.in +++ b/docs/drvlxc.html.in @@ -281,6 +281,16 @@ causes libvirt to activate the user namespace feature.

=20 =20 +

Location of configuration files

+ +

+The LXC driver comes with sane default values. However, during its +initialization it reads a configuration file which offers system +administrator to override some of that default. The file is located +under /etc/libvirt/lxc.conf +

+ +

Systemd Socket Activation Integration

=20

diff --git a/docs/manpages/libvirtd.rst b/docs/manpages/libvirtd.rst index 6545dc58d3..6466be3b8d 100644 --- a/docs/manpages/libvirtd.rst +++ b/docs/manpages/libvirtd.rst @@ -136,15 +136,17 @@ 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: +Depending on what driver is installed, then the following files are also r= ead: =20 -* ``@SYSCONFDIR@/libvirt/qemu.conf`` +* ``@SYSCONFDIR@/libvirt/qemu.conf`` for the QEMU driver +* ``@SYSCONFDIR@/libvirt/lxc.conf`` for the LXC driver =20 -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. +These files contain various knobs and default values for virtual machines +created within their respective drivers, and offer a way to override the b= uilt +in defaults, for instance (but not limited to): paths to various supplemen= tary +binaries, TLS certificates location, graphical consoles configuration and +others. Location of neither of these files can be overridden by any command +line switch. =20 * ``@RUNSTATEDIR@/libvirt/libvirt-sock`` * ``@RUNSTATEDIR@/libvirt/libvirt-sock-ro`` diff --git a/docs/manpages/virtlxcd.rst b/docs/manpages/virtlxcd.rst index b9aca6c857..2e9d8fd14b 100644 --- a/docs/manpages/virtlxcd.rst +++ b/docs/manpages/virtlxcd.rst @@ -111,6 +111,15 @@ a different user results in error. The default configuration file used by ``virtlxcd``, unless overridden on = the command line using the ``-f`` | ``--config`` option. =20 +In addition to the default configuration file, ``virtlxcd`` reads +configuration for the LXC driver from: + +* ``@SYSCONFDIR@/libvirt/lxc.conf`` + +This file contains various knobs and default values for virtual machines +created within LXC driver, and offers a way to override the built in defau= lts, +Location of this file can't be overridden by any command line switch. + * ``@RUNSTATEDIR@/libvirt/virtlxcd-sock`` * ``@RUNSTATEDIR@/libvirt/virtlxcd-sock-ro`` * ``@RUNSTATEDIR@/libvirt/virtlxcd-admin-sock`` --=20 2.26.2 From nobody Tue May 7 07:04:53 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=1615537489; cv=none; d=zohomail.com; s=zohoarc; b=mPQ6vmeioSgPPRdbrtwVgFNRfjDUoClzJ0O6MAXdvSFLDHitAS7aX8kZyq0Zgzjhler4jON69mHJtz+6b15YAx8XJbmhE+yGHPnQfHafJdlAknxbEbQsDYL5nUTo/7XttIg4rroAVfiFoiNJQjwcUNaNrUJDRcxg1sNBDSrLMqw= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1615537489; h=Content-Type:Content-Transfer-Encoding:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=LOx0T4W7UHA4ZAoycCLjSk/lIrOvtEBVGNhxl04tLE4=; b=AwmAaqRHPqC8wDMczmkFl1e0fAhHrjo5c0luBr7p0YuMRTirxIRtzeC2KmR9AoBa0FM2LUu2DOjfycUrueHsjSsiuyAhvj6ESBmLddhlS2Y33bmjNfzdEIgo64hWK1skNuGVHsZ4lFs4HodA6tEokQsM5QbsvwXDp6hNFruZ1Do= 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= (p=none dis=none) header.from= Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [63.128.21.124]) by mx.zohomail.com with SMTPS id 1615537489490570.9152610099518; Fri, 12 Mar 2021 00:24:49 -0800 (PST) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-358-b1OKu1mlOzavRBqpB1ljiA-1; Fri, 12 Mar 2021 03:24:43 -0500 Received: from smtp.corp.redhat.com (int-mx06.intmail.prod.int.phx2.redhat.com [10.5.11.16]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id E4646100C61B; Fri, 12 Mar 2021 08:24:38 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.20]) by smtp.corp.redhat.com (Postfix) with ESMTPS id BE09B5C255; Fri, 12 Mar 2021 08:24:38 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id 787DC18006D9; Fri, 12 Mar 2021 08:24:38 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.phx2.redhat.com [10.5.11.15]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 12C8OW9K006480 for ; Fri, 12 Mar 2021 03:24:32 -0500 Received: by smtp.corp.redhat.com (Postfix) id 434F35D75F; Fri, 12 Mar 2021 08:24:32 +0000 (UTC) Received: from localhost.localdomain (unknown [10.40.193.166]) by smtp.corp.redhat.com (Postfix) with ESMTP id BBE6D5D6BA for ; Fri, 12 Mar 2021 08:24:31 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1615537486; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=LOx0T4W7UHA4ZAoycCLjSk/lIrOvtEBVGNhxl04tLE4=; b=O1Uc+QSDS9rHKPqXHaWvcS5ttMUiKLKr5eNJhZCQiG6/ZtpFiRI0J1FQ8x5j2tyF09NW6M VXlmS9hoMu2pxpV/9eCr+7aNqpKmGogoccVAvQGnb012J56ETXftn7YMCrM66GC1GJ4wnB u6EBoQAk+Le6zfyNetJC35cRDT1+ck0= X-MC-Unique: b1OKu1mlOzavRBqpB1ljiA-1 From: Michal Privoznik To: libvir-list@redhat.com Subject: [PATCH 4/5] manpages: Remove reference to a session daemon for libxl Date: Fri, 12 Mar 2021 09:24:18 +0100 Message-Id: In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.15 X-loop: libvir-list@redhat.com X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.16 Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=libvir-list-bounces@redhat.com X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) Content-Type: text/plain; charset="utf-8" The libxl driver has no session daemon therefore its split daemon (virtxend) has to be ran as root. Any attempt to start it with euid !=3D 0 fails. This is why the daemon does not look under any of XDG_* paths either. Signed-off-by: Michal Privoznik --- docs/manpages/virtxend.rst | 29 ++--------------------------- 1 file changed, 2 insertions(+), 27 deletions(-) diff --git a/docs/manpages/virtxend.rst b/docs/manpages/virtxend.rst index 53592d24c0..f94ba80afa 100644 --- a/docs/manpages/virtxend.rst +++ b/docs/manpages/virtxend.rst @@ -103,8 +103,8 @@ On receipt of ``SIGHUP`` ``virtxend`` will reload its c= onfiguration. FILES =3D=3D=3D=3D=3D =20 -When run as *root* ------------------- +The ``virtxend`` program must be ran as root. Trying to start the program = under +a different user results in error. =20 * ``@SYSCONFDIR@/libvirt/virtxend.conf`` =20 @@ -124,31 +124,6 @@ The TLS **Server** private key ``virtxend`` will use. The PID file to use, unless overridden by the ``-p`` | ``--pid-file`` opti= on. =20 =20 -When run as *non-root* ----------------------- - -* ``$XDG_CONFIG_HOME/libvirt/virtxend.conf`` - -The default configuration file used by ``virtxend``, unless overridden on = the -command line using the ``-f``|``--config`` option. - -* ``$XDG_RUNTIME_DIR/libvirt/virtxend-sock`` -* ``$XDG_RUNTIME_DIR/libvirt/virtxend-admin-sock`` - -The sockets ``virtxend`` will use. - -* ``$XDG_RUNTIME_DIR/libvirt/virtxend.pid`` - -The PID file to use, unless overridden by the ``-p``|``--pid-file`` option. - - -If ``$XDG_CONFIG_HOME`` is not set in your environment, ``virtxend`` will = use -``$HOME/.config`` - -If ``$XDG_RUNTIME_DIR`` is not set in your environment, ``virtxend`` will = use -``$HOME/.cache`` - - EXAMPLES =3D=3D=3D=3D=3D=3D=3D=3D =20 --=20 2.26.2 From nobody Tue May 7 07:04:53 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 216.205.24.124 as permitted sender) client-ip=216.205.24.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 216.205.24.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=1615537634; cv=none; d=zohomail.com; s=zohoarc; b=ffhWeu0OnVdhgmLCrEe0KtKP84YDs9xP3PtrmR7+rWC9YYriiaQa6TcvaN3uZqh3F4NfvdjI2XBwPy3Ycj1/I0vNltSxiJIhMlQ2Wf2bnY2t9uIYhS0+lrzSRzCscEKnfRKpiFg4Pp8qZ6sVLYTTYOGbWJdUEnKJJBq/x2oDqSg= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1615537634; h=Content-Type:Content-Transfer-Encoding:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=uqaH9bdAPCPK2uZvUokN2cckd0I6khGJ5hnfaFG+S94=; b=MusqV4V9oR4dXA/kDy8DFppDkCnL9Wcc0pgFsz4ml8sapfYOshf5C/YC+s3LSecmHS/Kh9MrCqKnWPWhk7ajocKqpaDjamthWCqd1PPG018Vm2XIVHrfMuUSJGm1VuZ2tgN18YkvpcfaU9phNBlq9EWZERvN+up4DrxB+AUY5lo= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 216.205.24.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [216.205.24.124]) by mx.zohomail.com with SMTPS id 1615537634688987.5551543131985; Fri, 12 Mar 2021 00:27:14 -0800 (PST) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-217-ilHgqfThOPm9Rzsw20FBHA-1; Fri, 12 Mar 2021 03:24:48 -0500 Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.phx2.redhat.com [10.5.11.15]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 79E338030A0; Fri, 12 Mar 2021 08:24:42 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.21]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 57F5662463; Fri, 12 Mar 2021 08:24:42 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id 220CC57DC5; Fri, 12 Mar 2021 08:24:42 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.phx2.redhat.com [10.5.11.15]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 12C8OX16006489 for ; Fri, 12 Mar 2021 03:24:33 -0500 Received: by smtp.corp.redhat.com (Postfix) id 1C1125D6D7; Fri, 12 Mar 2021 08:24:33 +0000 (UTC) Received: from localhost.localdomain (unknown [10.40.193.166]) by smtp.corp.redhat.com (Postfix) with ESMTP id 935B65D6BA for ; Fri, 12 Mar 2021 08:24:32 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1615537633; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=uqaH9bdAPCPK2uZvUokN2cckd0I6khGJ5hnfaFG+S94=; b=WoZZUOf92DrWCwGNnBzLK3IAYFZhe2Mpp+F/pMsDSSWv3NlYVPrMOP09X+12XxpYvNIDtf Cba9qKGNNcN3VY6DhLKD4cihkhW6k89Vip9wKYW1LG+uOQxoshCauddbfNYzmIiFdocaHl 2Uix/b/p+PxzHYU+5fr+mtrsESZHw+8= X-MC-Unique: ilHgqfThOPm9Rzsw20FBHA-1 From: Michal Privoznik To: libvir-list@redhat.com Subject: [PATCH 5/5] docs: Document libxl.conf location Date: Fri, 12 Mar 2021 09:24:19 +0100 Message-Id: In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.15 X-loop: libvir-list@redhat.com X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.15 Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=libvir-list-bounces@redhat.com X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) Content-Type: text/plain; charset="utf-8" This is similar to my earlier commit which documented lxc.conf location. Just like LXC, the libxl driver has only the system connection and thus only few places need changing. Signed-off-by: Michal Privoznik --- docs/drvxen.html.in | 11 +++++++++++ docs/manpages/libvirtd.rst | 1 + docs/manpages/virtxend.rst | 9 +++++++++ 3 files changed, 21 insertions(+) diff --git a/docs/drvxen.html.in b/docs/drvxen.html.in index da94952e42..95be36c879 100644 --- a/docs/drvxen.html.in +++ b/docs/drvxen.html.in @@ -50,6 +50,17 @@ xen+tcp://example.com/system (remote access, SASl/K= erberos) xen+ssh://root@example.com/system (remote access, SSH tunnelled) =20 + +

Location of configuration files

+ +

+ The libxl driver comes with sane default values. However, during its + initialization it reads a configuration file which offers system + administrator to override some of that default. The file is located + under /etc/libvirt/libxl.conf +

+ +

Import and export of libvirt domain XML configs=

=20

diff --git a/docs/manpages/libvirtd.rst b/docs/manpages/libvirtd.rst index 6466be3b8d..ee72f08382 100644 --- a/docs/manpages/libvirtd.rst +++ b/docs/manpages/libvirtd.rst @@ -140,6 +140,7 @@ Depending on what driver is installed, then the followi= ng files are also read: =20 * ``@SYSCONFDIR@/libvirt/qemu.conf`` for the QEMU driver * ``@SYSCONFDIR@/libvirt/lxc.conf`` for the LXC driver +* ``@SYSCONFDIR@/libvirt/libxl.conf`` for the libxl driver =20 These files contain various knobs and default values for virtual machines created within their respective drivers, and offer a way to override the b= uilt diff --git a/docs/manpages/virtxend.rst b/docs/manpages/virtxend.rst index f94ba80afa..b08346b489 100644 --- a/docs/manpages/virtxend.rst +++ b/docs/manpages/virtxend.rst @@ -111,6 +111,15 @@ a different user results in error. The default configuration file used by ``virtxend``, unless overridden on = the command line using the ``-f`` | ``--config`` option. =20 +In addition to the default configuration file, ``virtxend`` reads +configuration for the libxl driver from: + +* ``@SYSCONFDIR@/libvirt/libxl.conf`` + +This file contains various knobs and default values for virtual machines +created within libxl driver, and offers a way to override the built in +defaults, Location of this file can't be overridden by any command line sw= itch. + * ``@RUNSTATEDIR@/libvirt/virtxend-sock`` * ``@RUNSTATEDIR@/libvirt/virtxend-sock-ro`` * ``@RUNSTATEDIR@/libvirt/virtxend-admin-sock`` --=20 2.26.2