From nobody Tue Dec 16 04:35:23 2025 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=fail header.i=@archlinuxcn.org; 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=pass(p=none dis=none) header.from=nongnu.org ARC-Seal: i=1; a=rsa-sha256; t=1743944389; cv=none; d=zohomail.com; s=zohoarc; b=Thw0dtRpatnxIH0zmvGxKvwk8r/xcVcui1zt+7OFq/APfur43geKDdekkSbwISuuhh0zBjiILgjNX3c8t1nFikERXxg7E2CU/lucir7hGV7hTXo9WIiMzYzS8tQO9VgiLzT9QmPRW19/LVocYP5gwEDtsQFPBqXjQdHAy9qccqs= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1743944389; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Reply-To:Reply-To:Sender:Subject:Subject:To:To:Message-Id; bh=+TeWFmBLBkc+qOf6FxmxhHxvL5gsapneF1/gnQxpywk=; b=PgrC59cmdYhQ1RIbENbeW9bmJIFh7XHOH/b62DBYraYgbhRxvC+aJfYtceo7Kt1WLqaB/vSPEnaMgacQK3nXmlpkl4DnIgNk2lZrHBl2lqxgcBkl7OYEpcfgT9/6tfTF3Do+HwGS8VlPddpoNUUClBI7UctVTx540eUL+yW8y2s= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=fail header.i=@archlinuxcn.org; 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=pass header.from= (p=none dis=none) Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 174394438940317.523827286487972; Sun, 6 Apr 2025 05:59:49 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1u1Pa3-0000fh-N1; Sun, 06 Apr 2025 08:58:31 -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 1u1Lez-0007Ha-IT; Sun, 06 Apr 2025 04:47:21 -0400 Received: from wiki.archlinuxcn.org ([104.245.9.4]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1u1Lew-0005J0-Rx; Sun, 06 Apr 2025 04:47:21 -0400 Received: by wiki.archlinuxcn.org (envelope-sender ) with ESMTPS id 43effe2c; Sun, 06 Apr 2025 16:47:12 +0800 DKIM-Signature: a=rsa-sha256; bh=+TeWFmBLBkc+qOf6FxmxhHxvL5gsapneF1/gnQxpywk=; c=relaxed/relaxed; d=archlinuxcn.org; h=Subject:Subject:Sender:To:To:Cc:Cc:From:From:Date:Date:MIME-Version:MIME-Version:Content-Type:Content-Transfer-Encoding:Content-Transfer-Encoding:Reply-To:In-Reply-To:Message-Id:Message-Id:References:Autocrypt:Openpgp; i=@archlinuxcn.org; s=default; t=1743929232; v=1; x=1744361232; b=jssXJnm9kKxIvw/lnX9cKZbsgC0P6ff1f60fZIK3Rz675PPiu8jeP1xI19Pl28SutrIxnEgi vScpZIu7KyLX65nEEwy3kx4zjk5hiSzn5xMEZjGl5a/FEHYWeZzPyYB1bVbIsD1/dmxik32VJgJ sc+tYtLOK3YZm2KU1ZdS9PWp4uYFaaRtJVybjzpCeFAZJ3GIHq82G6b3E75Qdv3nl7vbo3LxbIw dNX1PM/eZ2J9KMXJgR+9+s/tNdKMniH8ltgKYtvbGRLvt5YRBV83bBob+w47x9S/PavR9ns575d 5km4U5dSu10yDfNymeJzD/+cJyCdS2m579ruV3TuaQ7Og== To: qemu-devel@nongnu.org, qemu-trivial@nongnu.org Cc: Integral Subject: [PATCH] docs: replace `-hda` with `-drive` & update `root=` kernel parameter Date: Sun, 6 Apr 2025 16:45:18 +0800 Message-ID: <20250406084515.95461-4-integral@archlinuxcn.org> X-Mailer: git-send-email 2.49.0 MIME-Version: 1.0 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=104.245.9.4; envelope-from=integral@archlinuxcn.org; helo=wiki.archlinuxcn.org 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_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Mailman-Approved-At: Sun, 06 Apr 2025 08:58:28 -0400 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: , Reply-to: Integral From: Integral via Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: qemu-devel-bounces+importer=patchew.org@nongnu.org X-ZohoMail-DKIM: fail (Header signature does not verify) X-ZM-MESSAGEID: 1743944391861019000 Content-Type: text/plain; charset="utf-8" According to QEMU manual: Older options like `-hda` are essentially macros which expand into `-drive` options for various drive interfaces. The original forms bake in a lot of assumptions from the days when QEMU was emulating a legacy PC, they are not recommended for modern configurations. Signed-off-by: Integral --- docs/system/gdb.rst | 2 +- docs/system/linuxboot.rst | 6 +++--- docs/system/target-mips.rst | 2 +- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/system/gdb.rst b/docs/system/gdb.rst index 4228cb56bb..d50470b135 100644 --- a/docs/system/gdb.rst +++ b/docs/system/gdb.rst @@ -20,7 +20,7 @@ connection, use the ``-gdb dev`` option instead of ``-s``= . See =20 .. parsed-literal:: =20 - |qemu_system| -s -S -kernel bzImage -hda rootdisk.img -append "root=3D/= dev/hda" + |qemu_system| -s -S -kernel bzImage -drive file=3Drootdisk.img,format= =3Draw -append "root=3D/dev/sda" =20 QEMU will launch but will silently wait for gdb to connect. =20 diff --git a/docs/system/linuxboot.rst b/docs/system/linuxboot.rst index 5db2e560dc..2328b4a73d 100644 --- a/docs/system/linuxboot.rst +++ b/docs/system/linuxboot.rst @@ -11,7 +11,7 @@ The syntax is: =20 .. parsed-literal:: =20 - |qemu_system| -kernel bzImage -hda rootdisk.img -append "root=3D/dev/hd= a" + |qemu_system| -kernel bzImage -drive file=3Drootdisk.img,format=3Draw -= append "root=3D/dev/sda" =20 Use ``-kernel`` to provide the Linux kernel image and ``-append`` to give the kernel command line arguments. The ``-initrd`` option can be @@ -23,8 +23,8 @@ virtual serial port and the QEMU monitor to the console w= ith the =20 .. parsed-literal:: =20 - |qemu_system| -kernel bzImage -hda rootdisk.img \ - -append "root=3D/dev/hda console=3DttyS0" -nographic + |qemu_system| -kernel bzImage -drive file=3Drootdisk.img,format=3Draw \ + -append "root=3D/dev/sda console=3DttyS0" -nographic =20 Use Ctrl-a c to switch between the serial console and the monitor (see :ref:`GUI_keys`). diff --git a/docs/system/target-mips.rst b/docs/system/target-mips.rst index 83239fb9df..9028c3b304 100644 --- a/docs/system/target-mips.rst +++ b/docs/system/target-mips.rst @@ -112,5 +112,5 @@ https://mipsdistros.mips.com/LinuxDistro/nanomips/kerne= ls/v4.15.18-432-gb2eb9a8b Start system emulation of Malta board with nanoMIPS I7200 CPU:: =20 qemu-system-mipsel -cpu I7200 -kernel \ - -M malta -serial stdio -m -hda \ + -M malta -serial stdio -m -drive file=3D,format=3Draw \ -append "mem=3D256m@0x0 rw console=3DttyS0 vga=3Dcirrus vesa=3D0x11= 1 root=3D/dev/sda" --=20 2.49.0