From nobody Mon Feb 9 10:57:47 2026 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 207.211.31.120 as permitted sender) client-ip=207.211.31.120; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-1.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 207.211.31.120 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com Return-Path: Received: from us-smtp-1.mimecast.com (us-smtp-delivery-1.mimecast.com [207.211.31.120]) by mx.zohomail.com with SMTPS id 1580975592753533.9687848359005; Wed, 5 Feb 2020 23:53:12 -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-418-4xyzhlm0PsG56G0s-8u5Tg-1; Thu, 06 Feb 2020 02:52:50 -0500 Received: from smtp.corp.redhat.com (int-mx04.intmail.prod.int.phx2.redhat.com [10.5.11.14]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 7201A184AEB5; Thu, 6 Feb 2020 07:52:45 +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 507A85DA7E; Thu, 6 Feb 2020 07:52:45 +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 123B2866B0; Thu, 6 Feb 2020 07:52:45 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx07.intmail.prod.int.phx2.redhat.com [10.5.11.22]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 0167qMvQ010019 for ; Thu, 6 Feb 2020 02:52:22 -0500 Received: by smtp.corp.redhat.com (Postfix) id 8CE051001B09; Thu, 6 Feb 2020 07:52:22 +0000 (UTC) Received: from angien.redhat.com (unknown [10.43.2.48]) by smtp.corp.redhat.com (Postfix) with ESMTP id 1672A1001B07 for ; Thu, 6 Feb 2020 07:52:21 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1580975591; 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=kcvqt2lhJZpGNFYaXos6dKd5tjwflIOX4Snr9YN/+9Y=; b=DEFC9gwQ27+NzI4VCWZKfSdhwZ7iqn9swzXjbwRSIAkIz4M1Z+f1j1RVWcEstKiqwtMQOq X453hh8Iu0iOLfdhZmREo9MpijsYS7wObdygKvxbFI97MeuphR9/hBC/V6JUoHDKbH8F8n 5QVZyzHICOPuC7O7bUP3YnRPFkcrqR0= From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 12/15] docs: Document the new sub-element of disk's Date: Thu, 6 Feb 2020 08:52:04 +0100 Message-Id: <506d79a932b9668b66b13f60e37a14d00b5bcd06.1580975374.git.pkrempa@redhat.com> In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.84 on 10.5.11.22 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.14 X-MC-Unique: 4xyzhlm0PsG56G0s-8u5Tg-1 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" We are going to add support for specifying offset and size attributes which will allow controling where the image and where the guest data itself starts in the source of the disk. This will be represented by a element filled with either a for the offset of the image format itself. then controls where the guest data starts in the image. Add the XML documentation and RNG schema. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.html.in | 11 +++++++++++ docs/schemas/domaincommon.rng | 33 +++++++++++++++++++++++++++++++++ 2 files changed, 44 insertions(+) diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in index acb604e9c7..2143e57b11 100644 --- a/docs/formatdomain.html.in +++ b/docs/formatdomain.html.in @@ -2878,6 +2878,9 @@ <disk type=3D'block' device=3D'lun'> <driver name=3D'qemu' type=3D'raw'/> <source dev=3D'/dev/sda'> + <slices> + <slice type=3D'format' offset=3D'12345' size=3D'123'/> + </slices> <reservations managed=3D'no'> <source type=3D'unix' path=3D'/path/to/qemu-pr-helper' mode=3D'= client'/> </reservations> @@ -3360,6 +3363,14 @@ controller. Since 6.0.0 +
slices
+
The slices element using its slice + sub-elements allows configuring offset and size of either the + location of the image format (slice type=3D'storage') or + the guest data in the image container (slice type=3D'for= mat'). + + The offset and size values are in by= tes. +

diff --git a/docs/schemas/domaincommon.rng b/docs/schemas/domaincommon.rng index ea237a05e5..720e4e3da7 100644 --- a/docs/schemas/domaincommon.rng +++ b/docs/schemas/domaincommon.rng @@ -1595,12 +1595,45 @@ + + + + + + + + + + + + + + + + + storage + + + + + + + + format + + + + + + + + --=20 2.24.1