From nobody Sat Sep 21 03:19:29 2024 Delivered-To: importer@patchew.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; dmarc=fail(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1614619968; cv=none; d=zohomail.com; s=zohoarc; b=go9FCMXRxxhhCBq0WRmTCOFJVf2YmblTbjkpTHmuKOwqZFTyJKAN/NgDKprwqn9VVHBQmEcjKVvdwQBJx1f+46EgDliTK0B3BJIvYcq/dt4RAdggHqCYmt2biaRFjv8GngbSS7ZUN+LhxFIi0MeVchhC9h2C+w8km/xFXxpyoyU= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1614619968; h=Content-Type: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=fSg5u7cAR09t67MDMS84eP2ISKD4ICBgfUfMXJF2eJc=; b=K1/ZLLqrAx2no4n/dap+kWinCgPZLclvEDfRVflKn2k4ON3AC7AgKmAKUMWiWCExnxjs5Xws9d5CJiTTrMzbd0BzUfVCf+0Xw2HyeKOW58T3GGg2z9BIpIai5kP7CPLSbw+93yrSCnCoQmxzo6C2lWsqbXzD4G9k7nMk+Dcvmpk= 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; dmarc=fail header.from= (p=none dis=none) header.from= Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1614619968297801.1907869086327; Mon, 1 Mar 2021 09:32:48 -0800 (PST) Received: from localhost ([::1]:52124 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lGmPX-0001mN-5h for importer@patchew.org; Mon, 01 Mar 2021 12:32:47 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:40034) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lGmLk-0007dN-1b for qemu-devel@nongnu.org; Mon, 01 Mar 2021 12:28:52 -0500 Received: from us-smtp-delivery-124.mimecast.com ([63.128.21.124]:56859) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.90_1) (envelope-from ) id 1lGmLg-000321-0f for qemu-devel@nongnu.org; Mon, 01 Mar 2021 12:28:51 -0500 Received: from mail-ot1-f70.google.com (mail-ot1-f70.google.com [209.85.210.70]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-198-FzNXdeuCO7W_vZU0sRt67w-1; Mon, 01 Mar 2021 12:28:39 -0500 Received: by mail-ot1-f70.google.com with SMTP id h19so11026848ots.12 for ; Mon, 01 Mar 2021 09:28:39 -0800 (PST) Received: from redhat.redhat.com (ip68-103-222-6.ks.ok.cox.net. [68.103.222.6]) by smtp.gmail.com with ESMTPSA id y11sm3508909oov.9.2021.03.01.09.28.38 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 01 Mar 2021 09:28:38 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1614619726; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=fSg5u7cAR09t67MDMS84eP2ISKD4ICBgfUfMXJF2eJc=; b=FEfr/zCKYVHgKbG5ukRlPBvcw5pZygm1L2KDuzCOjxVwi65JkNNysQLmAKvelbyKENL4iO Nck0D1EoivwR/hZ1/1b0gpOZ3OXVn+ZVjPmOg0RmnKVW4gFE2QL3Kj0CnKP2oH6S+dUaRY b6NSuw7ZAD3j8/nqzbpk/Xi1nCMGJ7A= X-MC-Unique: FzNXdeuCO7W_vZU0sRt67w-1 X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=fSg5u7cAR09t67MDMS84eP2ISKD4ICBgfUfMXJF2eJc=; b=LfG6dOaGW2GHb0ZbHR+ju7LqSRHQKhqdq8LQzYnM55Obu0QAqKOkWrqkJrdV9pUuBp SYVsYCgmVDxE1opn6F3Shd0wkmKSapaRocNRrIQb0g6+kJp1tOl+Ca553H025t7SXfIT UILBYmVZXCeQXcie6XTOmJbHX8bfFPQgW7so1gMOeqvC6QD1a2gQUtMcJ8YxKB1Fbx7Q /49Nj0wsWlkl/AIxsIP0T3tg2Mk2oKWcrjnhVPPZ5UTREEdXMOJogp2kBgaG7pFRsvoW 2BbuLKZpBjoWH3bfuvVeqjhLxs5M4hnNQ8Qspr9mItaQVgwFyYsZ7wMhnb6l8sr3KRIQ tUUQ== X-Gm-Message-State: AOAM532cXZ99d7FX68l+E3x1CwBl46Fn7GswjkCuuKJdH/otWv9krmJ1 LROsDFb462QMSjmpQy1tHGAeA82FfFP9jogiA607VkcAiNjf16Bb9zA60IbT0MNzE5SoDdSsJfo AO2qKKUjvF2d1TuNiqBJB6GJbjOVy6wiJE8e0iGd1Fcom1j4fLAOeNnKV7SUN70hI X-Received: by 2002:a9d:6193:: with SMTP id g19mr14830754otk.359.1614619719013; Mon, 01 Mar 2021 09:28:39 -0800 (PST) X-Google-Smtp-Source: ABdhPJx1uI+DemQ2iiawyAne2F/6wr82swN9VKikpuKh4ISrQ6QiVj7EE7oG7yMFCwWLKciAmOKCaw== X-Received: by 2002:a9d:6193:: with SMTP id g19mr14830718otk.359.1614619718663; Mon, 01 Mar 2021 09:28:38 -0800 (PST) From: Connor Kuehl To: qemu-devel@nongnu.org Subject: [PATCH] Document qemu-img options data_file and data_file_raw Date: Mon, 1 Mar 2021 11:28:37 -0600 Message-Id: <20210301172837.20146-1-ckuehl@redhat.com> X-Mailer: git-send-email 2.29.2 MIME-Version: 1.0 Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=ckuehl@redhat.com X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable 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; Received-SPF: pass client-ip=63.128.21.124; envelope-from=ckuehl@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action 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: jsnow@redhat.com, hhan@redhat.com, stefanha@redhat.com, mreitz@redhat.com 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" The contents of this patch were initially developed and posted by Han Han[1], however, it appears the original patch was not applied. Since then, the relevant documentation has been moved and adapted to a new format. I've taken most of the original wording and tweaked it according to some of the feedback from the original patch submission. I've also adapted it to restructured text, which is the format the documentation currently uses. [1] https://lists.nongnu.org/archive/html/qemu-block/2019-10/msg01253.html Reported-by: Han Han Co-developed-by: Han Han Fixes: https://bugzilla.redhat.com/1763105 Signed-off-by: Connor Kuehl Reviewed-by: Eric Blake Reviewed-by: Stefan Hajnoczi --- docs/tools/qemu-img.rst | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/tools/qemu-img.rst b/docs/tools/qemu-img.rst index b615aa8419..5cc585dc27 100644 --- a/docs/tools/qemu-img.rst +++ b/docs/tools/qemu-img.rst @@ -866,6 +866,18 @@ Supported image file formats: issue ``lsattr filename`` to check if the NOCOW flag is set or not (Capital 'C' is NOCOW flag). =20 + ``data_file`` + Pathname that refers to a file that will store all guest data. If + this option is used, the qcow2 file will only contain the image's + metadata. + + ``data_file_raw`` + If this option is set to ``on``, QEMU will always keep the external + data file consistent as a standalone read-only raw image. The default + value is ``off``. + + This option can only be enabled if ``data_file`` is set. + ``Other`` =20 QEMU also supports various other image file formats for --=20 2.29.2