docs: Roll -prom-env and -g target-specific info into qemu-options.hx

The SPARC and PPC targets currently have a fragment of target-specific
information about the -g and -prom options which would be better placed
as part of the general documentation of those options in qemu-options.hx.
Move the relevant information to those locations.

SPARC also has a bit of text about the -M option which is out of
date and provides no useful information over the generic documentation
of that option, so just delete it.

The motivation here is again to avoid having to awkwardly include
this text into the rST version of the qemu.1 manpage.

Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
Reviewed-by: Alex Bennée <alex.bennee@linaro.org>
Tested-by: Alex Bennée <alex.bennee@linaro.org>
Message-id: 20200228153619.9906-25-peter.maydell@linaro.org
This commit is contained in:
Peter Maydell 2020-02-28 15:36:10 +00:00
parent 44d79a6bd7
commit 196afbb094
7 changed files with 19 additions and 119 deletions

View File

@ -43,19 +43,5 @@ the g3beige and mac99 PowerMac and the 40p machines. OpenBIOS is a free
(GPL v2) portable firmware implementation. The goal is to implement a
100% IEEE 1275-1994 (referred to as Open Firmware) compliant firmware.
The following options are specific to the PowerPC emulation:
``-g WxH[xDEPTH]``
Set the initial VGA graphic mode. The default is 800x600x32.
``-prom-env string``
Set OpenBIOS variables in NVRAM, for example:
::
qemu-system-ppc -prom-env 'auto-boot?=false' \
-prom-env 'boot-device=hd:2,\yaboot' \
-prom-env 'boot-args=conf=hd:2,\yaboot.conf'
More information is available at
http://perso.magic.fr/l_indien/qemu-ppc/.

View File

@ -47,31 +47,6 @@ for the g3beige and mac99 PowerMac and the 40p machines. OpenBIOS is a free
(GPL v2) portable firmware implementation. The goal is to implement a 100%
IEEE 1275-1994 (referred to as Open Firmware) compliant firmware.
@c man begin OPTIONS
The following options are specific to the PowerPC emulation:
@table @option
@item -g @var{W}x@var{H}[x@var{DEPTH}]
Set the initial VGA graphic mode. The default is 800x600x32.
@item -prom-env @var{string}
Set OpenBIOS variables in NVRAM, for example:
@example
qemu-system-ppc -prom-env 'auto-boot?=false' \
-prom-env 'boot-device=hd:2,\yaboot' \
-prom-env 'boot-args=conf=hd:2,\yaboot.conf'
@end example
@end table
@c man end
More information is available at
@url{http://perso.magic.fr/l_indien/qemu-ppc/}.

View File

@ -60,22 +60,3 @@ QEMU web site. There are still issues with NetBSD and OpenBSD, but most
kernel versions work. Please note that currently older Solaris kernels
don't work probably due to interface issues between OpenBIOS and
Solaris.
The following options are specific to the Sparc32 emulation:
``-g WxHx[xDEPTH]``
Set the initial graphics mode. For TCX, the default is 1024x768x8
with the option of 1024x768x24. For cgthree, the default is
1024x768x8 with the option of 1152x900x8 for people who wish to use
OBP.
``-prom-env string``
Set OpenBIOS variables in NVRAM, for example:
::
qemu-system-sparc -prom-env 'auto-boot?=false' \
-prom-env 'boot-device=sd(0,2,0):d' -prom-env 'boot-args=linux single'
``-M [SS-4|SS-5|SS-10|SS-20|SS-600MP|LX|Voyager|SPARCClassic] [|SPARCbook]``
Set the emulated machine type. Default is SS-5.

View File

@ -64,32 +64,5 @@ most kernel versions work. Please note that currently older Solaris kernels
don't work probably due to interface issues between OpenBIOS and
Solaris.
@c man begin OPTIONS
The following options are specific to the Sparc32 emulation:
@table @option
@item -g @var{W}x@var{H}x[x@var{DEPTH}]
Set the initial graphics mode. For TCX, the default is 1024x768x8 with the
option of 1024x768x24. For cgthree, the default is 1024x768x8 with the option
of 1152x900x8 for people who wish to use OBP.
@item -prom-env @var{string}
Set OpenBIOS variables in NVRAM, for example:
@example
qemu-system-sparc -prom-env 'auto-boot?=false' \
-prom-env 'boot-device=sd(0,2,0):d' -prom-env 'boot-args=linux single'
@end example
@item -M [SS-4|SS-5|SS-10|SS-20|SS-600MP|LX|Voyager|SPARCClassic] [|SPARCbook]
Set the emulated machine type. Default is SS-5.
@end table
@c man end

View File

@ -35,15 +35,3 @@ QEMU emulates the following peripherals:
- 2 PCI IDE interfaces with hard disk and CD-ROM support
- Floppy disk
The following options are specific to the Sparc64 emulation:
``-prom-env string``
Set OpenBIOS variables in NVRAM, for example:
::
qemu-system-sparc64 -prom-env 'auto-boot?=false'
``-M [sun4u|sun4v|niagara]``
Set the emulated machine type. The default is sun4u.

View File

@ -36,25 +36,3 @@ PC-compatible serial ports
Floppy disk
@end itemize
@c man begin OPTIONS
The following options are specific to the Sparc64 emulation:
@table @option
@item -prom-env @var{string}
Set OpenBIOS variables in NVRAM, for example:
@example
qemu-system-sparc64 -prom-env 'auto-boot?=false'
@end example
@item -M [sun4u|sun4v|niagara]
Set the emulated machine type. The default is sun4u.
@end table
@c man end

View File

@ -1962,6 +1962,13 @@ STEXI
@item -g @var{width}x@var{height}[x@var{depth}]
@findex -g
Set the initial graphical resolution and depth (PPC, SPARC only).
For PPC the default is 800x600x32.
For SPARC with the TCX graphics device, the default is 1024x768x8 with the
option of 1024x768x24. For cgthree, the default is 1024x768x8 with the option
of 1152x900x8 for people who wish to use OBP.
ETEXI
DEF("vnc", HAS_ARG, QEMU_OPTION_vnc ,
@ -4107,6 +4114,18 @@ STEXI
@item -prom-env @var{variable}=@var{value}
@findex -prom-env
Set OpenBIOS nvram @var{variable} to given @var{value} (PPC, SPARC only).
@example
qemu-system-sparc -prom-env 'auto-boot?=false' \
-prom-env 'boot-device=sd(0,2,0):d' -prom-env 'boot-args=linux single'
@end example
@example
qemu-system-ppc -prom-env 'auto-boot?=false' \
-prom-env 'boot-device=hd:2,\yaboot' \
-prom-env 'boot-args=conf=hd:2,\yaboot.conf'
@end example
ETEXI
DEF("semihosting", 0, QEMU_OPTION_semihosting,
"-semihosting semihosting mode\n",