From nobody Sat Nov 23 12:12:56 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; 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=fail(p=none dis=none) header.from=gmail.com Return-Path: Received: from lists.libvirt.org (lists.libvirt.org [8.43.85.245]) by mx.zohomail.com with SMTPS id 171567090828662.923810050930456; Tue, 14 May 2024 00:15:08 -0700 (PDT) Received: by lists.libvirt.org (Postfix, from userid 996) id 15B0819CD; Tue, 14 May 2024 03:15:07 -0400 (EDT) Received: from lists.libvirt.org (localhost [IPv6:::1]) by lists.libvirt.org (Postfix) with ESMTP id 2595A1D8E; Tue, 14 May 2024 03:12:43 -0400 (EDT) Received: by lists.libvirt.org (Postfix, from userid 996) id 3EE611A33; Mon, 13 May 2024 11:08:41 -0400 (EDT) Received: from mail-pf1-f179.google.com (mail-pf1-f179.google.com [209.85.210.179]) (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 C3B351A33 for ; Mon, 13 May 2024 11:08:37 -0400 (EDT) Received: by mail-pf1-f179.google.com with SMTP id d2e1a72fcca58-6f4f2b1c997so1572101b3a.0 for ; Mon, 13 May 2024 08:08:37 -0700 (PDT) Received: from iamthewifi.iiit.ac.in ([218.185.248.66]) by smtp.gmail.com with ESMTPSA id d2e1a72fcca58-6f4d2ae3f29sm7506554b3a.109.2024.05.13.08.08.34 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 13 May 2024 08:08:35 -0700 (PDT) X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on lists.libvirt.org X-Spam-Level: X-Spam-Status: No, score=-0.7 required=5.0 tests=DKIM_ADSP_CUSTOM_MED, FREEMAIL_FORGED_FROMDOMAIN,FREEMAIL_FROM,HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,RCVD_IN_DNSWL_NONE,RCVD_IN_MSPIKE_H3, RCVD_IN_MSPIKE_WL,SPF_HELO_NONE autolearn=unavailable autolearn_force=no version=3.4.4 X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1715612916; x=1716217716; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=oILDZCfa8oQhEgwm6wIfkTEuJenDAfjDp8vy3RFD+lc=; b=lglXi3cM+ZZkSK0QStoKaMBBDyIhvMha6qWEOnyTdvgplmrDwy4t0diSVUuv5TjAw5 J2TmMyv3QDSp0qhfabBl3nDTCm1k0f1dbK/7rskXmsS7H6nbfQSp2PE6u5Yf9nrTosek ugzyIcer6b6xxxZzzAXT/uNOsQTSJc/25sRMicZxe0UE6HFscEkvVW8dTnM+MXhdXd2K vxLupWTUCtrzRn8OLwdvBfs7BcgVEhs7yUcIEWMbiE1kyYV62L8nEVzKyCzMl3PJIzow QmVgn7Ei4LqL+RFlnTmaihq3Pe40XU4ZO4VBsFbHZ7qhikuGekT0gOWJLDYGLxOY+ZE4 wIAA== X-Gm-Message-State: AOJu0YyihIho0wp00gwe4CrhTL/KJlxH3CkA8uVxIWb1VqCaWBZuk4dv 1Zh1LvfGIHDOpFLPmOMZhxJEzMPVgjXyr1mkwjjt8e5qWJGo9EJJtAGh4Y85 X-Google-Smtp-Source: AGHT+IFwNgdYAfjvAf684EIAKXEOGovPUO9dniZAGy/KcjlTEEyG1uyDZGQh8qvQJ+bST0OyEJ3BMw== X-Received: by 2002:a05:6a21:601:b0:1af:cbd3:ab48 with SMTP id adf61e73a8af0-1afde0af528mr8367538637.3.1715612916420; Mon, 13 May 2024 08:08:36 -0700 (PDT) From: Abhiram Tilak To: devel@lists.libvirt.org Subject: [PATCH v2] docs: formatsnapshot: add docs for snapshotDeleteInProgress Date: Mon, 13 May 2024 20:37:53 +0530 Message-ID: <20240513150752.8387-2-atp.exp@gmail.com> X-Mailer: git-send-email 2.44.0 MIME-Version: 1.0 X-MailFrom: atp.exp@gmail.com X-Mailman-Rule-Hits: nonmember-moderation 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 Message-ID-Hash: W2F42PP2UVTCB2PL2A7TM3KBS67AA3TL X-Message-ID-Hash: W2F42PP2UVTCB2PL2A7TM3KBS67AA3TL X-Mailman-Approved-At: Tue, 14 May 2024 07:12:33 -0400 CC: Abhiram Tilak 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: Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable X-ZM-MESSAGEID: 1715670910096100001 Adds documentation for the element to the libvirt snapshot format XML reference. The element, introduced at commit 565bcb5d79, ensures the consistency of qcow2 images during snapshot deletion operations by marking disks in snapshot metadata as invalid until deletion is successfully completed. The commit was merged but the related documentation was missing. Resolves: https://gitlab.com/libvirt/libvirt/-/issues/609 Signed-off-by: Abhiram Tilak Reviewed-by: Peter Krempa --- Changes in v2: - Insert a note to advise users against adding or removing the internal t= ag "snapshotDeleteInProgress" manually. docs/formatsnapshot.rst | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/formatsnapshot.rst b/docs/formatsnapshot.rst index 570a988442..f802a8e227 100644 --- a/docs/formatsnapshot.rst +++ b/docs/formatsnapshot.rst @@ -170,6 +170,15 @@ The top-level ``domainsnapshot`` element may contain t= he following elements: sub-element can be used with same semantics as the identically na= med subelement of the domain definition disk's driver. + ``snapshotDeleteInProgress`` + + If a the snapshot is marked for deletion, the disk is invalidated= . The + sub-element ``snapshotDeleteInProgress`` marks the disk in the sn= apshot + as invalid until the snapshot delete is completed successfully. T= his + element is typically generated by the snapshot-create API and sho= uld + not be manually added or removed. + :since:`Since 9.0` + ``creationTime`` A readonly representation of the time this snapshot was created. The ti= me is -- 2.44.0 _______________________________________________ Devel mailing list -- devel@lists.libvirt.org To unsubscribe send an email to devel-leave@lists.libvirt.org