324b2298fe
Apart from targets.rst, which was written by hand, this is an automated
conversion obtained with the following command:
makeinfo --force -o - --docbook \
-D 'qemu_system_x86 QEMU_SYSTEM_X86_MACRO' \
-D 'qemu_system QEMU_SYSTEM_MACRO' \
$texi | pandoc -f docbook -t rst+smart | perl -e '
$/=undef;
$_ = <>;
s/^- − /- /gm;
s/QEMU_SYSTEM_MACRO/|qemu_system|/g;
s/QEMU_SYSTEM_X86_MACRO/|qemu_system_x86|/g;
s/(?=::\n\n +\|qemu)/.. parsed-literal/g;
s/:\n\n::$/::/gm;
print' > $rst
In addition, the following changes were made manually:
- target-i386.rst and target-mips.rst: replace CPU model documentation with
an include directive
- monitor.rst: replace the command section with a comment
- images.rst: add toctree
- target-arm.rst: Replace use of :math: (which Sphinx complains
about) with :sup:, and hide it behind |I2C| and |I2C| substitutions.
Content that is not @included remains exclusive to qemu-doc.texi.
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
Reviewed-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>
Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
Message-id: 20200228153619.9906-20-peter.maydell@linaro.org
Message-id: 20200226113034.6741-19-pbonzini@redhat.com
[PMM: Fixed target-arm.rst use of :math:; remove out of date
note about images.rst from commit message; fixed expansion
of |qemu_system_x86|; use parsed-literal in invocation.rst
when we want to use |qemu_system_x86|; fix incorrect subsection
level for "OS requirements" in target-i386.rst; fix incorrect
syntax for making links to other sections of the manual]
Reviewed-by: Peter Maydell <peter.maydell@linaro.org>
Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
82 lines
2.1 KiB
ReStructuredText
82 lines
2.1 KiB
ReStructuredText
.. _Sparc32-System-emulator:
|
|
|
|
Sparc32 System emulator
|
|
-----------------------
|
|
|
|
Use the executable ``qemu-system-sparc`` to simulate the following Sun4m
|
|
architecture machines:
|
|
|
|
- SPARCstation 4
|
|
|
|
- SPARCstation 5
|
|
|
|
- SPARCstation 10
|
|
|
|
- SPARCstation 20
|
|
|
|
- SPARCserver 600MP
|
|
|
|
- SPARCstation LX
|
|
|
|
- SPARCstation Voyager
|
|
|
|
- SPARCclassic
|
|
|
|
- SPARCbook
|
|
|
|
The emulation is somewhat complete. SMP up to 16 CPUs is supported, but
|
|
Linux limits the number of usable CPUs to 4.
|
|
|
|
QEMU emulates the following sun4m peripherals:
|
|
|
|
- IOMMU
|
|
|
|
- TCX or cgthree Frame buffer
|
|
|
|
- Lance (Am7990) Ethernet
|
|
|
|
- Non Volatile RAM M48T02/M48T08
|
|
|
|
- Slave I/O: timers, interrupt controllers, Zilog serial ports,
|
|
keyboard and power/reset logic
|
|
|
|
- ESP SCSI controller with hard disk and CD-ROM support
|
|
|
|
- Floppy drive (not on SS-600MP)
|
|
|
|
- CS4231 sound device (only on SS-5, not working yet)
|
|
|
|
The number of peripherals is fixed in the architecture. Maximum memory
|
|
size depends on the machine type, for SS-5 it is 256MB and for others
|
|
2047MB.
|
|
|
|
Since version 0.8.2, QEMU uses OpenBIOS https://www.openbios.org/.
|
|
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.
|
|
|
|
A sample Linux 2.6 series kernel and ram disk image are available on the
|
|
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.
|