qemu/docs/about
Bin Meng b67de91e0d docs: Add caveats for Windows as the build platform
Commit cf60ccc330 ("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 882084a04a ("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 <bin.meng@windriver.com>
Reviewed-by: Stefan Weil <sw@weilnetz.de>
Reviewed-by: Akihiko Odaki <akihiko.odaki@gmail.com>
Message-Id: <20220719135014.764981-1-bmeng.cn@gmail.com>
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
2022-07-22 19:01:44 +02:00
..
build-platforms.rst docs: Add caveats for Windows as the build platform 2022-07-22 19:01:44 +02:00
deprecated.rst hw/arm/virt: dt: add rng-seed property 2022-07-07 11:36:07 +01:00
index.rst docs: standardize directory index to --- with overline 2021-09-13 13:56:26 +02:00
license.rst docs: Move deprecation, build and license info out of system/ 2021-07-18 10:59:47 +01:00
removed-features.rst ui: Remove deprecated options "-sdl" and "-curses" 2022-06-03 08:03:28 +02:00