From nobody Fri Sep 20 22:16:10 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Authentication-Results: mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org ARC-Seal: i=1; a=rsa-sha256; t=1586521165; cv=none; d=zohomail.com; s=zohoarc; b=SzsuqUshDP5bdnBWF0N5wLD9PDw6DEWsxRiouDqdXOOEoCWALyKLVzHBjWpD169ouqSjw0Yi85QoHaeHIR0lv7mWJVvHvJZUx8Cx8YuPir6ysVXhSoqJlf+a/+gzznoMhfhUUEnm2506kcn2miEHBx0DP1MH7gdXpT1nAKg3r1M= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1586521165; h=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=Hz3ulBmdpF4r2v6cud9D5vQ2ufWiyxbShw1ne3elaLE=; b=dD+q+XgaGv+sEeLuI80qeTLe87+ON0Dcv81V4kVWvrenyTEDiJKIvmET1Hz+/8uQsSkPQuklGkm449npElQTy0LXd6w2jDkCPl/hXf+99/iQbzQgrUNHq1esmk+wtnY8+VyEGTRAImok65QSYssjuZlwhwQ5aXIwGi8CUpsQGYk= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1586521164626698.7478589614641; Fri, 10 Apr 2020 05:19:24 -0700 (PDT) Received: from localhost ([::1]:33608 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jMsd0-0005wW-VR for importer@patchew.org; Fri, 10 Apr 2020 08:19:22 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:36457) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jMscG-0005NJ-T4 for qemu-devel@nongnu.org; Fri, 10 Apr 2020 08:18:38 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1jMscF-0007Bv-UO for qemu-devel@nongnu.org; Fri, 10 Apr 2020 08:18:36 -0400 Received: from fanzine.igalia.com ([178.60.130.6]:36335) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1jMscF-0007BT-DI; Fri, 10 Apr 2020 08:18:35 -0400 Received: from static.113.35.0.81.ibercom.com ([81.0.35.113] helo=perseus.local) by fanzine.igalia.com with esmtpsa (Cipher TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim) id 1jMscD-0000On-6G; Fri, 10 Apr 2020 14:18:33 +0200 Received: from berto by perseus.local with local (Exim 4.92) (envelope-from ) id 1jMsby-0002BA-D2; Fri, 10 Apr 2020 14:18:18 +0200 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=igalia.com; s=20170329; h=Content-Transfer-Encoding:MIME-Version:Message-Id:Date:Subject:Cc:To:From; bh=Hz3ulBmdpF4r2v6cud9D5vQ2ufWiyxbShw1ne3elaLE=; b=Ls5xg5k1TmKAulGGhiYfDOBbINRPE1HlyPxZmsNCcR2MefWPWnG6bbdWx+h+qFGYOepoWVA5C+uBcJBBEe/jSjefRBZehVRJjZk7rMQnrktvDbYBAhwEyV0K0RFySKztHUHmAGSCCUFaM07D5pVWtmuSEzYjMbTuliurAak87CAMXiJiLYxBch0lONedUXMVv1EjwbOHlPgHlw1r363ou/fPub+UtFluUKADydbXQvnu4v9Pmv8LXfuOW047n/CggeQNDSg3eovBNQ8xPQY6NoodrS1qLLMOx4scuVrQW0uUQTJiPJ4dE2Dp2ODdtbndCQCOIX3YhyPrKS7oGhTjfg==; From: Alberto Garcia To: qemu-devel@nongnu.org Subject: [PATCH for-5.0] qcow2: Add incompatibility note between backing files and raw external data files Date: Fri, 10 Apr 2020 14:18:15 +0200 Message-Id: <20200410121816.8334-1-berto@igalia.com> X-Mailer: git-send-email 2.20.1 MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x (no timestamps) [generic] [fuzzy] X-Received-From: 178.60.130.6 X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Kevin Wolf , Alberto Garcia , qemu-block@nongnu.org, Max Reitz Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail-DKIM: fail (Header signature does not verify) Content-Type: text/plain; charset="utf-8" Backing files and raw external data files are mutually exclusive. The documentation of the raw external data bit (in autoclear_features) already indicates that, but we should also mention it on the other side. Suggested-by: Eric Blake Signed-off-by: Alberto Garcia Reviewed-by: Eric Blake --- docs/interop/qcow2.txt | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/interop/qcow2.txt b/docs/interop/qcow2.txt index 640e0eca40..298a031310 100644 --- a/docs/interop/qcow2.txt +++ b/docs/interop/qcow2.txt @@ -25,6 +25,9 @@ The first cluster of a qcow2 image contains the file head= er: is stored (NB: The string is not null terminated). 0 i= f the image doesn't have a backing file. =20 + Note: backing files are incompatible with raw external= data + files (auto-clear feature bit 1). + 16 - 19: backing_file_size Length of the backing file name in bytes. Must not be longer than 1023 bytes. Undefined if the image doesn't= have --=20 2.20.1