From patchwork Mon Apr 3 13:49:14 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: 669771 Delivered-To: patch@linaro.org Received: by 2002:a5d:4d08:0:0:0:0:0 with SMTP id z8csp1894597wrt; Mon, 3 Apr 2023 06:50:37 -0700 (PDT) X-Google-Smtp-Source: AKy350Y1IfH7+LW5ZbO6r62pycDD+2QZH5vXu7x+jA6CACrn/CrL5vJrkex58O1RfFtHtX0r/YHa X-Received: by 2002:ad4:5d45:0:b0:5e3:c84a:9422 with SMTP id jk5-20020ad45d45000000b005e3c84a9422mr5572412qvb.2.1680529836991; Mon, 03 Apr 2023 06:50:36 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1680529836; cv=none; d=google.com; s=arc-20160816; b=IzFHOs+7zGSEZsecEITUfzxNMvHJ6+pfTTx1bU0EpoZTT/3Y9I6Hb20ndTJwUqwazb +lholwiks7lKXxImsH4h/nls1/Uh8FsoYX/bEJyugrCRuZU4NvXVDGbCIKofKEzBlM6V kX+sJLtaeeFd8uKJEOH3r4BenCrEsnWBsKX9jwO1zlDraXbmm9vlENuA/YWR0XX3TvUg hCDCqAcDbvxE0yKH/VAZdboqBpiEvX/PE4I5ePPI4vn2OVo4P6fQtnuZiIub2/bvvWRI 21/fUqAg/IqjL1pxkM+gfhj1/cl1gPA73L5A1rItBFMd8UfXueDPOfKKFDL2h2tur9up kN+Q== 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=QIAbN9ckX3lGfUzvEPz/vzPNYZxaSL+GVZgf5wv9fMw=; b=YnLgfFd/SN/qXDRhIx2PIRgBOUiaQogNakxw/L6QtTCfQuDI4ERTboiNNVIvCAWXd0 aowmIpNQIp0o0WU4cy0ZuGvPpTSZzYPq29zjGa/FqPpRPg/+SuVlbFNPQJj2dbpz1Qqp VP5E+d53tGL79D4l6DZXcZBobaz7qA0YUvekCKEaCZFoebpwUEW7b5UwJnJGFrpo2pzm fhhyxB1w7qkRgJwdo6hxrTsJELE90t1yHWQWoQi0M44nMje1QERMs8xdU+JltSLlFoa0 N+q0/Ve3QgndSzMG5X9E2vuY5hYdaoGC9Qocpb0j5oPblWf7jgjThV0VuF5KcTe9lbo2 1HSQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=LWUprjAC; 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 br7-20020a05620a460700b007468cbaaefdsi6444348qkb.378.2023.04.03.06.50.36 for (version=TLS1_2 cipher=ECDHE-ECDSA-CHACHA20-POLY1305 bits=256/256); Mon, 03 Apr 2023 06:50:36 -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=LWUprjAC; 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 1pjKYs-0002xp-Pm; Mon, 03 Apr 2023 09:49:30 -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 1pjKYq-0002vJ-GY for qemu-devel@nongnu.org; Mon, 03 Apr 2023 09:49:28 -0400 Received: from mail-wm1-x32a.google.com ([2a00:1450:4864:20::32a]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1pjKYn-0004uV-9V for qemu-devel@nongnu.org; Mon, 03 Apr 2023 09:49:28 -0400 Received: by mail-wm1-x32a.google.com with SMTP id m6-20020a05600c3b0600b003ee6e324b19so18180052wms.1 for ; Mon, 03 Apr 2023 06:49:24 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; t=1680529764; 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=QIAbN9ckX3lGfUzvEPz/vzPNYZxaSL+GVZgf5wv9fMw=; b=LWUprjACAXh+rLjO+aP8mffyvPwH4ehS4JZikFQAibUBF0T9DkF4kdhb7lHWFZKQRr /4ALZYok7J+Boq7MVhqfKjWiCieBWXUjgeEJGbFtw1Gds6GKdMxi9wLJzMjrcdJqohlV OoEZ8CMWkpf2UDeGOvCGc6UJHpsMgIGU8iejcuZl1+Bp+OKnTfv1/AYDwIGGA9ZYn4bB DVlZHzvRpSe45DYQHZsUV8HowyoYF7txt7KNlkEbkUdkQFEt6b7odwVWcP7zut9mXuEF BU32cAEjuwEi2re9se/CocXw7PQ4xlznkJFvt9jpcG88WWkCPUHT2fIj0ckekv1APwPG 2xtw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; t=1680529764; 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=QIAbN9ckX3lGfUzvEPz/vzPNYZxaSL+GVZgf5wv9fMw=; b=auxNn6wa2yofFMcAS0fKTYSNZSyFpQf7jYKmdD4bDiv1RAvxvenEEePFAhBAjKdqqQ VcshBDe7u/2Kwx8dE3nmvi8eRm83kWRvXoyiUXJEpAc/tDSkanPmiNs4+ndm3/YQLVpH VhrUNy+3r1lPZI1K16u1HLO28DVH3F8+B+f9CTC8FEPqiMBgz67XCMRD7V4chVzu0cNg EVMBNg+y1IjmFhE0hrwtEAVXPW7VYQZvFPnMNUJ1Vl1Dpv6+0LmOlNxhC4yvk8Xgv/6O MxLj8R6QugdIyBNLp379WHfP8ubIdoSAZ6P2Wivd7Los2y+LjZ90956c8PfyQGDBauo+ RhIg== X-Gm-Message-State: AO0yUKVLbWbU3gIgGR8OnF8qqLtMBPyxnNmj339mUG32PikidiWZpiIx x65oSwYpJGEbOKJtF5b9N9EkKg== X-Received: by 2002:a05:600c:ace:b0:3ed:98c1:2e5b with SMTP id c14-20020a05600c0ace00b003ed98c12e5bmr26622637wmr.9.1680529763808; Mon, 03 Apr 2023 06:49:23 -0700 (PDT) Received: from zen.linaroharston ([85.9.250.243]) by smtp.gmail.com with ESMTPSA id l7-20020a05600c4f0700b003ef5deb4188sm19526847wmq.17.2023.04.03.06.49.21 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 03 Apr 2023 06:49:23 -0700 (PDT) Received: from zen.lan (localhost [127.0.0.1]) by zen.linaroharston (Postfix) with ESMTP id 329FE1FFBD; Mon, 3 Apr 2023 14:49:21 +0100 (BST) From: =?utf-8?q?Alex_Benn=C3=A9e?= To: qemu-devel@nongnu.org Cc: Paolo Bonzini , Reinoud Zandijk , Ryo ONODERA , qemu-block@nongnu.org, Hanna Reitz , Warner Losh , Beraldo Leal , =?utf-8?q?Philippe_Mathieu-Daud=C3=A9?= , Kyle Evans , kvm@vger.kernel.org, Wainer dos Santos Moschetta , =?utf-8?q?Alex_Benn?= =?utf-8?q?=C3=A9e?= , Cleber Rosa , Thomas Huth , Kevin Wolf , Michael Tokarev Subject: [PATCH v2 05/11] qemu-options: finesse the recommendations around -blockdev Date: Mon, 3 Apr 2023 14:49:14 +0100 Message-Id: <20230403134920.2132362-6-alex.bennee@linaro.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20230403134920.2132362-1-alex.bennee@linaro.org> References: <20230403134920.2132362-1-alex.bennee@linaro.org> MIME-Version: 1.0 Received-SPF: pass client-ip=2a00:1450:4864:20::32a; envelope-from=alex.bennee@linaro.org; helo=mail-wm1-x32a.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 Message-Id: <20230330101141.30199-5-alex.bennee@linaro.org> --- 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