From nobody Thu Nov 21 16:24:51 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of lists.libvirt.org designates 8.43.85.245 as permitted sender) client-ip=8.43.85.245; envelope-from=devel-bounces@lists.libvirt.org; helo=lists.libvirt.org; Authentication-Results: mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of lists.libvirt.org designates 8.43.85.245 as permitted sender) smtp.mailfrom=devel-bounces@lists.libvirt.org; dmarc=pass(p=reject dis=none) header.from=lists.libvirt.org ARC-Seal: i=1; a=rsa-sha256; t=1732119315; cv=none; d=zohomail.com; s=zohoarc; b=DerGpiSPX6pyinULD3UnUbDOsI1fmOxREBnIhLVjZt+D/ugCZVeLj05NHNlta4h10vlE4DnCHOeZIfL7zQQi4vBLV3LbmANv8FsVBAI6IcRM2DYEpu/H6s+0I50PdKtkguIpTjookfbyEzARrdG5UP/2u6lOPcpqKEanRV+UOhw= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1732119315; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Reply-To:Reply-To:References:Subject:Subject:To:To:Message-Id; bh=strcRi8fr6FVHkA/OMO+5QUVu4mpEUenOrINZzJZ6us=; b=H6VVUgnlrvASMhIdSpZNsas3WFJl0+5hb5XO28GZZLgmOzeqCvpBeR4ofV8DNHZBJixVcpGjZ6jwCr47ZouG5WrICC0qBos8KZe3cpdM4/FUsCoFNr0vCwd0mNSIRh69CWK/KnjBqp8elvlQUOL3rSpl2zd7i6o/3uj07T5XVc4= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of lists.libvirt.org designates 8.43.85.245 as permitted sender) smtp.mailfrom=devel-bounces@lists.libvirt.org; dmarc=pass header.from= (p=reject dis=none) Return-Path: Received: from lists.libvirt.org (lists.libvirt.org [8.43.85.245]) by mx.zohomail.com with SMTPS id 1732119315326190.3115332418207; Wed, 20 Nov 2024 08:15:15 -0800 (PST) Received: by lists.libvirt.org (Postfix, from userid 996) id 34527195D; Wed, 20 Nov 2024 11:15:14 -0500 (EST) Received: from lists.libvirt.org (localhost [IPv6:::1]) by lists.libvirt.org (Postfix) with ESMTP id 5E07C1547; Wed, 20 Nov 2024 11:10:09 -0500 (EST) Received: by lists.libvirt.org (Postfix, from userid 996) id 356711498; Wed, 20 Nov 2024 11:10:04 -0500 (EST) Received: from relay.virtuozzo.com (relay.virtuozzo.com [130.117.225.111]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by lists.libvirt.org (Postfix) with ESMTPS id B18FA1543 for ; Wed, 20 Nov 2024 11:09:46 -0500 (EST) Received: from [130.117.225.1] (helo=vz9-barybin-2.ch-qa.vzint.dev) by relay.virtuozzo.com with esmtp (Exim 4.96) (envelope-from ) id 1tDn10-0005yc-0B; Wed, 20 Nov 2024 16:53:14 +0100 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on lists.libvirt.org X-Spam-Level: X-Spam-Status: No, score=-3.1 required=5.0 tests=DKIM_INVALID,DKIM_SIGNED, MAILING_LIST_MULTI,RCVD_IN_DNSWL_MED,RCVD_IN_VALIDITY_RPBL_BLOCKED, RCVD_IN_VALIDITY_SAFE_BLOCKED,SPF_HELO_NONE autolearn=unavailable autolearn_force=no version=3.4.4 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=virtuozzo.com; s=relay; h=MIME-Version:Message-ID:Date:Subject:From: Content-Type; bh=Skr4a8chUxpKnmxP+UblqZMNtSni4SB9IfSwciMGeVU=; b=MLWY3BxsFcgJ Iahd98JTCxaIqclouUXpHaOBq02Tr2XqzhFmJdlLCvg6vfjdtCPXS9kVE1iq6qsvSL2g0cIRybJi3 qNKoaGSQNNL+frc6e0aeWMjEDmSrFjZeKpIgHB1FHHOZG2Myu2uGW3O5w18xC3DhCsIeN22KNfz9T gN0AMNRG2a2A+Qc5NhibgvAVUbGJwGhxpLmPpXhcQcE8b6BBJH5qkZQwKvYmFMGXFEFmBmITi/5q/ 4cvzM+BgammuJ0yKsNzdd0xSIsF2VlIG82jmDQzefojFwD8CKIDwtgOQNoGNCaiy3kRDrxe6hV4wE LnVgcU4zp+4iPWbBhoGLaA==; To: devel@lists.libvirt.org Subject: [PATCH 15/15] docs: formatdomain: describe dataFileStore element of disk Date: Wed, 20 Nov 2024 18:48:50 +0300 Message-ID: <20241120155229.1259-16-nikolai.barybin@virtuozzo.com> X-Mailer: git-send-email 2.43.5 In-Reply-To: <20241120155229.1259-1-nikolai.barybin@virtuozzo.com> References: <20241120155229.1259-1-nikolai.barybin@virtuozzo.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Message-ID-Hash: VIVXDFT3OMB2TGJBVNVGJFWCBT4LWLLC X-Message-ID-Hash: VIVXDFT3OMB2TGJBVNVGJFWCBT4LWLLC X-MailFrom: nikolai.barybin@virtuozzo.com X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; header-match-config-1; header-match-config-2; header-match-config-3; header-match-devel.lists.libvirt.org-0; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; suspicious-header CC: den@openvz.org, Nikolai Barybin X-Mailman-Version: 3.2.2 Precedence: list List-Id: Development discussions about the libvirt library & tools Archived-At: List-Archive: List-Help: List-Post: List-Subscribe: List-Unsubscribe: From: Nikolai Barybin via Devel Reply-To: Nikolai Barybin X-ZohoMail-DKIM: fail (Header signature does not verify) X-ZM-MESSAGEID: 1732119317282116600 Content-Type: text/plain; charset="utf-8" Signed-off-by: Nikolai Barybin --- docs/formatdomain.rst | 45 ++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 42 insertions(+), 3 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 18b60fe260..54a9e01034 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -2708,24 +2708,38 @@ paravirtualized driver is specified via the ``disk`= ` element. + + + + + + + + + + + + + +
- + - + - + ... @@ -3116,6 +3130,27 @@ paravirtualized driver is specified via the ``disk``= element. accessible or its disk chain is broken, with startupPolicy 'optional' t= he guest will drop this disk. This feature doesn't support migration curre= ntly. =20 +``dataFileStore`` + This element describes external data file store, which is represented b= y ``qcow2`` + incompatible features bit and allows to store guest clusters are the ex= ternal + data file. For such images, clusters in the external data file are not = refcounted. + The following attribute is supported in ``dataFileStore``: + + ``type`` + The ``type`` attribute represents the type of disk used by the data = file store, + see disk type attribute above for more details and possible values. + + Moreover, ``dataFileStore`` supports the following sub-elements: + + ``format`` + The ``format`` element contains ``type`` attribute which specifies t= he + internal format of the data file store. Only ``raw`` value is suppor= ted. + + ``source`` + This element has the same structure as the ``source`` element in ``d= isk``. + It specifies which file, device, or network location contains the da= ta of + the described data file store. + ``backingStore`` This element describes the backing store used by the disk specified by sibling ``source`` element. :since:`Since 1.2.4`. If the hypervisor dri= ver @@ -3161,6 +3196,10 @@ paravirtualized driver is specified via the ``disk``= element. ``backingStore`` If the backing store is not self-contained, the next element in the = chain is described by nested ``backingStore`` element. + ``dataFileStore`` + If backing store is in ``qcow2`` format it is allowed to have data f= ile store. + But it should me mentioned that an image can have either backing sto= re or data + file store, not both. =20 ``mirror`` This element is present if the hypervisor has started a long-running bl= ock --=20 2.43.5