From patchwork Thu Mar 30 10:11:34 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?q?Alex_Benn=C3=A9e?= X-Patchwork-Id: 668601 Delivered-To: patch@linaro.org Received: by 2002:a5d:4d08:0:0:0:0:0 with SMTP id z8csp846436wrt; Thu, 30 Mar 2023 03:13:28 -0700 (PDT) X-Google-Smtp-Source: AKy350aXzyXfWUg6u6NKBz5czC8qPzuGBFn73mTZC07gbAbbF7HOG0GoK6S1V42n5C7iHALItYne X-Received: by 2002:a05:6214:c2f:b0:5a9:e0eb:1958 with SMTP id a15-20020a0562140c2f00b005a9e0eb1958mr39629293qvd.9.1680171208473; Thu, 30 Mar 2023 03:13:28 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1680171208; cv=none; d=google.com; s=arc-20160816; b=RsTbOzuKkCZeUnOCS99w/evw1o6zqEUwaIydahUwabUfVNE2/PGuO3nT+kySNoZC4X LZM2+5S8XOTzikje3cvYutVuJbTJ/wuXYR4ya1+Pl872uETPu6ek+uhsueMXf9qkHLnB 1sS5QJ8ARzYox9ifUb1udXrUCmWCrSp4MghIibcSl2HOvWCEGlC2LeHmO2LI3t9TM8Zs uGZfsa18n3avJWT7roXpWRsAgVn1exT0MGlxaenS59+ysboDQb8oL1blAzwJVRnW5E17 FqO8NyelDkZWLmg+aPar3A8W5tBc6nbQvFcp6g1AONivwLnIAKGkp+DxGDvLuErBpV0t yWcA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:list-subscribe:list-help:list-post:list-archive :list-unsubscribe:list-id:precedence:content-transfer-encoding :mime-version:references:in-reply-to:message-id:date:subject:cc:to :from:dkim-signature; bh=N6sz1M7T3yD0wZFnzMX54YCnX2Tqb42vTWqBIcF5gCE=; b=S2Xq89UXxV70ywc5nj7DS2fkT3IJQjXfEQLUuh7RCoQEVjDgCk5nrVwZ4muMyBMN5X nparwioBeOAZQuca/NdTBhY/M11kcHJkuZdXF9JI6tFgx4/sGwUH5CznMTnz0V0nUJ0S y/WSFgirIPkLIsJt26RpSvpJYLMk/sPey7fBDOwZGcpD4hXgtu08DrXficELsXbVtBjo uoOQIKhsj97kZnAPET5l1r7rY//ETZ35uu26/Qdy4Oz2R/xrDh3mpAzNPueKSR2nmliO 5MA7V3+51FxrO4J+OE5sQ5HTx16ezwLT/2CyJUrkE+dLyD9OtwYY7L0TW6y/Fvn+TQSI iryA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=Bdjj8WKr; spf=pass (google.com: domain of qemu-devel-bounces+patch=linaro.org@nongnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom="qemu-devel-bounces+patch=linaro.org@nongnu.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Return-Path: Received: from lists.gnu.org (lists.gnu.org. [209.51.188.17]) by mx.google.com with ESMTPS id i3-20020ad45383000000b0056e1a624256si22488531qvv.459.2023.03.30.03.13.28 for (version=TLS1_2 cipher=ECDHE-ECDSA-CHACHA20-POLY1305 bits=256/256); Thu, 30 Mar 2023 03:13:28 -0700 (PDT) Received-SPF: pass (google.com: domain of qemu-devel-bounces+patch=linaro.org@nongnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; Authentication-Results: mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=Bdjj8WKr; spf=pass (google.com: domain of qemu-devel-bounces+patch=linaro.org@nongnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom="qemu-devel-bounces+patch=linaro.org@nongnu.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1phpG8-0007YL-5q; Thu, 30 Mar 2023 06:11:56 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1phpG2-0007UU-7M for qemu-devel@nongnu.org; Thu, 30 Mar 2023 06:11:51 -0400 Received: from mail-wm1-x334.google.com ([2a00:1450:4864:20::334]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1phpFy-0000HP-2c for qemu-devel@nongnu.org; Thu, 30 Mar 2023 06:11:49 -0400 Received: by mail-wm1-x334.google.com with SMTP id t17-20020a05600c451100b003edc906aeeaso3036001wmo.1 for ; Thu, 30 Mar 2023 03:11:45 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; t=1680171104; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=N6sz1M7T3yD0wZFnzMX54YCnX2Tqb42vTWqBIcF5gCE=; b=Bdjj8WKrzy6Wdg1DGEaGjGZqSRqCX4DgewBrwqWLgCJfv7taZDI5horHeWiQ/SzUbW KUw0qONWZ7GUfScfifJfjJBELg9DRU3pNKA68IvNJA8yDF24yTw5S0fqUPCwAyHavis6 4wMMGRPEo61C2jcj1SNVFjlPKi1/B03K12kIx5SNHB3Jp+EL2Sv5w0Ej0z8SobzUEGp+ neL8EvuF26pDUFmjW8AfJXIXt7ELFgT87rThfLQMIbYCBteJbQy49TNalCmFoOvXFcP4 1DzzL3GU0Kv8FMac39kqMMgC1Xx7gmZIdlBF9V0OKxcrK1y651ssQswBfS91N2EWzA+J HAvg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; t=1680171104; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=N6sz1M7T3yD0wZFnzMX54YCnX2Tqb42vTWqBIcF5gCE=; b=za282lpb/Qcz91SKehwDvq9h/vSR5g9X+iVjgpKn2BYK5bUKKdKhSqTJdIDqXkAGw7 kiM5IpACNrNDVX/icHcQfrQqWuSQuIY3a/6v9Dy8Urx0yyi/XNSG7AUoadj0GUnUbWu6 S7NWP+5gFxn+fe75Ly/j1gtztTGWWlJ2wQKhK9hsLjJlWn5BY7fD8KaoCWBt+/H2OIln uTIAaEzq12KVZx43lC61nfe8Wj/LQlTblTjKo+PJ/e2E9Rybnt3flZCh9SpjBWwcOzgR dd4p9ObiUvDXGKCiiJqP52kekwX+d7NB6CFJyyQPWEezufw+aHTATmVExl7ygqQTDvqb SGSQ== X-Gm-Message-State: AO0yUKXaSM0OCF2Pqwy9DHE7A0XowugpPY/Pjv6FJo2GF1+ryAJOg0k4 jxG+KV+C+s/5PzkFJPUpwEtjKQ== X-Received: by 2002:a05:600c:21d8:b0:3ee:5d1d:6c2d with SMTP id x24-20020a05600c21d800b003ee5d1d6c2dmr16597876wmj.35.1680171104125; Thu, 30 Mar 2023 03:11:44 -0700 (PDT) Received: from zen.linaroharston ([85.9.250.243]) by smtp.gmail.com with ESMTPSA id iw13-20020a05600c54cd00b003ef6988e54csm5414825wmb.15.2023.03.30.03.11.42 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 30 Mar 2023 03:11:42 -0700 (PDT) Received: from zen.lan (localhost [127.0.0.1]) by zen.linaroharston (Postfix) with ESMTP id 7EB4C1FFBC; Thu, 30 Mar 2023 11:11:42 +0100 (BST) From: =?utf-8?q?Alex_Benn=C3=A9e?= To: qemu-devel@nongnu.org Cc: Thomas Huth , =?utf-8?q?Alex_Benn=C3=A9e?= , Warner Losh , Ryo ONODERA , Kevin Wolf , Beraldo Leal , Wainer dos Santos Moschetta , Hanna Reitz , qemu-block@nongnu.org, =?utf-8?q?Philippe_?= =?utf-8?q?Mathieu-Daud=C3=A9?= , Kyle Evans , Reinoud Zandijk , Michael Tokarev Subject: [PATCH 04/11] qemu-options: finesse the recommendations around -blockdev Date: Thu, 30 Mar 2023 11:11:34 +0100 Message-Id: <20230330101141.30199-5-alex.bennee@linaro.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20230330101141.30199-1-alex.bennee@linaro.org> References: <20230330101141.30199-1-alex.bennee@linaro.org> MIME-Version: 1.0 Received-SPF: pass client-ip=2a00:1450:4864:20::334; envelope-from=alex.bennee@linaro.org; helo=mail-wm1-x334.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, 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.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+patch=linaro.org@nongnu.org Sender: qemu-devel-bounces+patch=linaro.org@nongnu.org We are a bit premature in recommending -blockdev/-device as the best way to configure block devices, especially in the common case. Improve the language to hopefully make things clearer. Suggested-by: Michael Tokarev Signed-off-by: Alex Bennée Reviewed-by: Thomas Huth Reviewed-by: Michael Tokarev --- qemu-options.hx | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/qemu-options.hx b/qemu-options.hx index 59bdf67a2c..9a69ed838e 100644 --- a/qemu-options.hx +++ b/qemu-options.hx @@ -1143,10 +1143,14 @@ have gone through several iterations as the feature set and complexity of the block layer have grown. Many online guides to QEMU often reference older and deprecated options, which can lead to confusion. -The recommended modern way to describe disks is to use a combination of +The most explicit way to describe disks is to use a combination of ``-device`` to specify the hardware device and ``-blockdev`` to describe the backend. The device defines what the guest sees and the -backend describes how QEMU handles the data. +backend describes how QEMU handles the data. The ``-drive`` option +combines the device and backend into a single command line options +which is useful in the majority of cases. Older options like ``-hda`` +bake in a lot of assumptions from the days when QEMU was emulating a +legacy PC, they are not recommended for modern configurations. ERST