From nobody Tue May 7 08:30:41 2024 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; 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=gmail.com ARC-Seal: i=1; a=rsa-sha256; t=1658239085; cv=none; d=zohomail.com; s=zohoarc; b=N5LL7Za9+YVhrknCU2eIKtBh2UeIQ6GhCyeLqaTMKHCy45X4QYjCyXKEqZeIbPxev2fEqKFpHXyLlB5ZpkWLahaTQnF9Y8vwcZlFOmRGosiL+LYT/hScH/AfS3qQT01q8/9V9ZHeud7Tp8yenhgspoG5cXZlOOJXaFKEOGxFK38= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1658239085; 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=Z69BRE83wivOCalvkXHzgTad0Rtw1/D/zMh+e6gOY64=; b=Ee0RaPtkKBsJlKKOKbT92Hyq12zDXN6frmuo0N3m/5CYqXTG1A4UaTrPEHSNKO1B19NGWKNYl6r70g7L/+UD5F0kQ51d6b/19j1NnzKzOED0WcRqIWfTBajFCcayhzW1bFudPRAMFAIdZdFwn/YoVGdqEuBEtGHgZQrtzwpvQww= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; 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 1658239085481145.34690140665373; Tue, 19 Jul 2022 06:58:05 -0700 (PDT) Received: from localhost ([::1]:45786 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oDnjg-0000I1-Fb for importer@patchew.org; Tue, 19 Jul 2022 09:58:04 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:48182) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oDncG-0001t2-IQ for qemu-devel@nongnu.org; Tue, 19 Jul 2022 09:50:26 -0400 Received: from mail-pl1-x630.google.com ([2607:f8b0:4864:20::630]:35356) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1oDncD-0002Qh-SO for qemu-devel@nongnu.org; Tue, 19 Jul 2022 09:50:24 -0400 Received: by mail-pl1-x630.google.com with SMTP id g17so12013936plh.2 for ; Tue, 19 Jul 2022 06:50:21 -0700 (PDT) Received: from ubuntu.. (144.168.56.201.16clouds.com. [144.168.56.201]) by smtp.gmail.com with ESMTPSA id y11-20020a17090322cb00b0016c33dc879esm11752274plg.113.2022.07.19.06.50.17 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 19 Jul 2022 06:50:19 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=Z69BRE83wivOCalvkXHzgTad0Rtw1/D/zMh+e6gOY64=; b=RLRuOKlO7JPDQBaNGkYSZvfu541qpaxhhhckwz1p5kPQEO4ijGtl+chN+Ps3Xf+g4z sJ4ZPRiEz7/28kw/YRZCnwEV0MkHNP/8i/5z0npeMgPU6Ln3i2w3roHxEYwzLeyyPwxm qJBlJI2tduqlnpB619H3eK1ffscf+lObH1mPhxRMbcdFZycfExfMyfc4mUojW/7wghqm bUwALNVkcNw6t1cfbBzSoEHFspOdIRqdKNIns+mpl/g26r/gB57Ccc+TGpy5qsEwPEZO Yc32mmRjYMu6ZnndGUY6EEwOlW2leT66+E0zG6mh15lfGFR/JNHnsGdF7QzFfweH1Epy nprw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=Z69BRE83wivOCalvkXHzgTad0Rtw1/D/zMh+e6gOY64=; b=k3XJKH0naaSjaIvvGySXvKjRdXljZtuGqP7/p7ipnMGZPwn7istaSchvImJZ3W+D7z BR7GOtYZyY8jWZZ5ZZqvS7plSXZQYjSChxBV3o5rW0ZXAFYpcI9kI9LeBcmr0rd0RVNb ObStlNPQl8O9C9M2VA8+02Xrxw1z649Bga469CWruSE2i6rR72E2l/X35OJsXiddOw/N 9m+9Q4g0eYwpAogd1F4Eu8aR3slG6G0qR3ScVgNd3Sv5aJbB/pT4oeRmW58OP68ONKAG i3DIgfH9N+I3j0jVJadSt31fdSzGSZp6/z2mtXqkHQP1rveTWzv49hO/6W2n/qJcVupt ixxA== X-Gm-Message-State: AJIora8mJYbEnsOK1XAIJoESK1tP4awqPVB+NKsHEo/izSAyRIxUGoAz yNi8Ln088PtH5cGORhrcCm8= X-Google-Smtp-Source: AGRyM1umaBVjhQhRdbqxU52B6fdN9CgMnup7X+i3eNINU35YQd3OXIj+laii0eyNytxuEKwkz2nd+w== X-Received: by 2002:a17:90b:378c:b0:1f1:6468:a0b0 with SMTP id mz12-20020a17090b378c00b001f16468a0b0mr23088346pjb.145.1658238619901; Tue, 19 Jul 2022 06:50:19 -0700 (PDT) From: Bin Meng To: Akihiko Odaki , Laurent Vivier , Peter Maydell , Stefan Weil , qemu-devel@nongnu.org Cc: Bin Meng Subject: [PATCH v2] docs: Add caveats for Windows as the build platform Date: Tue, 19 Jul 2022 21:50:14 +0800 Message-Id: <20220719135014.764981-1-bmeng.cn@gmail.com> X-Mailer: git-send-email 2.34.1 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=2607:f8b0:4864:20::630; envelope-from=bmeng.cn@gmail.com; helo=mail-pl1-x630.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, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 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+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail-DKIM: pass (identity @gmail.com) X-ZM-MESSAGEID: 1658239086927100001 Content-Type: text/plain; charset="utf-8" From: Bin Meng Commit cf60ccc3306c ("cutils: Introduce bundle mechanism") introduced a Python script to populate a bundle directory using os.symlink() to point to the binaries in the pc-bios directory of the source tree. Commit 882084a04ae9 ("datadir: Use bundle mechanism") removed previous logic in pc-bios/meson.build to create a link/copy of pc-bios binaries in the build tree so os.symlink() is the way to go. However os.symlink() may fail [1] on Windows if an unprivileged Windows user started the QEMU build process, which results in QEMU executables generated in the build tree not able to load the default BIOS/firmware images due to symbolic links not present in the bundle directory. This commits updates the documentation by adding such caveats for users who want to build QEMU on the Windows platform. [1] https://docs.python.org/3/library/os.html#os.symlink Signed-off-by: Bin Meng Reviewed-by: Stefan Weil Reviewed-by: Akihiko Odaki --- Changes in v2: - fix typo of "preferred" docs/about/build-platforms.rst | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/docs/about/build-platforms.rst b/docs/about/build-platforms.rst index ebde20f981..6b8496c430 100644 --- a/docs/about/build-platforms.rst +++ b/docs/about/build-platforms.rst @@ -94,8 +94,16 @@ not tested anymore, so it is recommended to use one of t= he latest versions of Windows instead. =20 The project supports building QEMU with current versions of the MinGW -toolchain, either hosted on Linux (Debian/Fedora) or via MSYS2 on Windows. +toolchain, either hosted on Linux (Debian/Fedora) or via `MSYS2`_ on Windo= ws. +A more recent Windows version is always preferred as it is less likely to = have +problems with building via MSYS2. The building process of QEMU involves so= me +Python scripts that call os.symlink() which needs special attention for the +build process to successfully complete. On newer versions of Windows 10, +unprivileged accounts can create symlinks if Developer Mode is enabled. +When Developer Mode is not available/enabled, the SeCreateSymbolicLinkPriv= ilege +privilege is required, or the process must be run as an administrator. =20 .. _Homebrew: https://brew.sh/ .. _MacPorts: https://www.macports.org/ +.. _MSYS2: https://www.msys2.org/ .. _Repology: https://repology.org/ --=20 2.34.1