fd49b2153e
Provide explicit guidance on dealing with option parameters as arbitrary strings containing commas, such as in "file=my,file" and "string=a,b". The updated documentation emphasizes the need to double commas when they appear within such parameters. Resolves: https://gitlab.com/qemu-project/qemu/-/issues/1839 Signed-off-by: Yihuan Pan <xun794@gmail.com> Message-ID: <20231213141706.629833-2-xun794@gmail.com> Signed-off-by: Thomas Huth <thuth@redhat.com>
57 lines
1.1 KiB
ReStructuredText
57 lines
1.1 KiB
ReStructuredText
:orphan:
|
|
|
|
..
|
|
This file is the skeleton for the qemu.1 manpage. It mostly
|
|
should simply include the .rst.inc files corresponding to the
|
|
parts of the documentation that go in the manpage as well as the
|
|
HTML manual.
|
|
|
|
=======================
|
|
QEMU User Documentation
|
|
=======================
|
|
|
|
--------
|
|
Synopsis
|
|
--------
|
|
|
|
.. parsed-literal::
|
|
|
|
|qemu_system| [options] [disk_image]
|
|
|
|
-----------
|
|
Description
|
|
-----------
|
|
|
|
.. include:: target-i386-desc.rst.inc
|
|
|
|
-------
|
|
Options
|
|
-------
|
|
|
|
disk_image is a raw hard disk image for IDE hard disk 0. Some targets do
|
|
not need a disk image.
|
|
|
|
When dealing with options parameters as arbitrary strings containing
|
|
commas, such as in "file=my,file" and "string=a,b", it's necessary to
|
|
double the commas. For instance,"-fw_cfg name=z,string=a,,b" will be
|
|
parsed as "-fw_cfg name=z,string=a,b".
|
|
|
|
.. hxtool-doc:: qemu-options.hx
|
|
|
|
.. include:: keys.rst.inc
|
|
|
|
.. include:: mux-chardev.rst.inc
|
|
|
|
-----
|
|
Notes
|
|
-----
|
|
|
|
.. include:: device-url-syntax.rst.inc
|
|
|
|
--------
|
|
See also
|
|
--------
|
|
|
|
The HTML documentation of QEMU for more precise information and Linux
|
|
user mode emulator invocation.
|