• R/O
  • HTTP
  • SSH
  • HTTPS

Commit

Tags
No Tags

Frequently used words (click to add to your profile)

javac++androidlinuxc#windowsobjective-ccocoa誰得qtpythonphprubygameguibathyscaphec計画中(planning stage)翻訳omegatframeworktwitterdomtestvb.netdirectxゲームエンジンbtronarduinopreviewer

Commit MetaInfo

Revisão44d79a6bd74b1e98394f456957f3c919c44cf4aa (tree)
Hora2020-03-06 19:05:12
AutorPeter Maydell <peter.maydell@lina...>
CommiterPeter Maydell

Mensagem de Log

docs: Roll semihosting option information into qemu-options.hx

Currently the per-target documentation for those targets that
implement semihosting includes a bit of text that goes into both the
manual and the manpage about options specific to the target. This
text is redundant with the earlier generic option description of the
semihosting option produced from qemu-options.hx. To avoid having
to create a lot of stub include files to include into the rST
generated qemu.1 manpage, roll target-specific bits of information
into the qemu-options.hx text, so the user doesn't have to look
in two places for this information.

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-24-peter.maydell@linaro.org

Mudança Sumário

Diff

--- a/docs/system/target-arm.rst
+++ b/docs/system/target-arm.rst
@@ -215,13 +215,3 @@ emulation includes the following elements:
215215
216216 A Linux 2.6 test image is available on the QEMU web site. More
217217 information is available in the QEMU mailing-list archive.
218-
219-The following options are specific to the ARM emulation:
220-
221-``-semihosting``
222- Enable semihosting syscall emulation.
223-
224- On ARM this implements the \"Angel\" interface.
225-
226- Note that this allows guest direct access to the host filesystem, so
227- should only be used with trusted guest OS.
--- a/docs/system/target-arm.texi
+++ b/docs/system/target-arm.texi
@@ -243,21 +243,3 @@ Three on-chip UARTs
243243 A Linux 2.6 test image is available on the QEMU web site. More
244244 information is available in the QEMU mailing-list archive.
245245
246-@c man begin OPTIONS
247-
248-The following options are specific to the ARM emulation:
249-
250-@table @option
251-
252-@item -semihosting
253-Enable semihosting syscall emulation.
254-
255-On ARM this implements the "Angel" interface.
256-
257-Note that this allows guest direct access to the host filesystem,
258-so should only be used with trusted guest OS.
259-
260-@end table
261-
262-@c man end
263-
--- a/docs/system/target-m68k.rst
+++ b/docs/system/target-m68k.rst
@@ -19,14 +19,3 @@ The AN5206 emulation includes the following devices:
1919 - MCF5206 ColdFire V2 Microprocessor.
2020
2121 - Two on-chip UARTs.
22-
23-The following options are specific to the ColdFire emulation:
24-
25-``-semihosting``
26- Enable semihosting syscall emulation.
27-
28- On M68K this implements the \"ColdFire GDB\" interface used by
29- libgloss.
30-
31- Note that this allows guest direct access to the host filesystem, so
32- should only be used with trusted guest OS.
--- a/docs/system/target-m68k.texi
+++ b/docs/system/target-m68k.texi
@@ -23,22 +23,3 @@ MCF5206 ColdFire V2 Microprocessor.
2323 @item
2424 Two on-chip UARTs.
2525 @end itemize
26-
27-@c man begin OPTIONS
28-
29-The following options are specific to the ColdFire emulation:
30-
31-@table @option
32-
33-@item -semihosting
34-Enable semihosting syscall emulation.
35-
36-On M68K this implements the "ColdFire GDB" interface used by libgloss.
37-
38-Note that this allows guest direct access to the host filesystem,
39-so should only be used with trusted guest OS.
40-
41-@end table
42-
43-@c man end
44-
--- a/docs/system/target-xtensa.rst
+++ b/docs/system/target-xtensa.rst
@@ -25,15 +25,3 @@ The Avnet LX60/LX110/LX200 emulation supports:
2525 - 16550 UART
2626
2727 - OpenCores 10/100 Mbps Ethernet MAC
28-
29-The following options are specific to the Xtensa emulation:
30-
31-``-semihosting``
32- Enable semihosting syscall emulation.
33-
34- Xtensa semihosting provides basic file IO calls, such as
35- open/read/write/seek/select. Tensilica baremetal libc for ISS and
36- linux platform \"sim\" use this interface.
37-
38- Note that this allows guest direct access to the host filesystem, so
39- should only be used with trusted guest OS.
--- a/docs/system/target-xtensa.texi
+++ b/docs/system/target-xtensa.texi
@@ -33,23 +33,3 @@ A range of Xtensa CPUs, default is the DC232B
3333 @item
3434 OpenCores 10/100 Mbps Ethernet MAC
3535 @end itemize
36-
37-@c man begin OPTIONS
38-
39-The following options are specific to the Xtensa emulation:
40-
41-@table @option
42-
43-@item -semihosting
44-Enable semihosting syscall emulation.
45-
46-Xtensa semihosting provides basic file IO calls, such as open/read/write/seek/select.
47-Tensilica baremetal libc for ISS and linux platform "sim" use this interface.
48-
49-Note that this allows guest direct access to the host filesystem,
50-so should only be used with trusted guest OS.
51-
52-@end table
53-
54-@c man end
55-
--- a/qemu-options.hx
+++ b/qemu-options.hx
@@ -4116,6 +4116,12 @@ STEXI
41164116 @item -semihosting
41174117 @findex -semihosting
41184118 Enable semihosting mode (ARM, M68K, Xtensa, MIPS, Nios II only).
4119+
4120+Note that this allows guest direct access to the host filesystem, so
4121+should only be used with a trusted guest OS.
4122+
4123+See the -semihosting-config option documentation for further information
4124+about the facilities this enables.
41194125 ETEXI
41204126 DEF("semihosting-config", HAS_ARG, QEMU_OPTION_semihosting_config,
41214127 "-semihosting-config [enable=on|off][,target=native|gdb|auto][,chardev=id][,arg=str[,...]]\n" \
@@ -4126,6 +4132,18 @@ STEXI
41264132 @item -semihosting-config [enable=on|off][,target=native|gdb|auto][,chardev=id][,arg=str[,...]]
41274133 @findex -semihosting-config
41284134 Enable and configure semihosting (ARM, M68K, Xtensa, MIPS, Nios II only).
4135+
4136+Note that this allows guest direct access to the host filesystem, so
4137+should only be used with a trusted guest OS.
4138+
4139+On Arm this implements the standard semihosting API, version 2.0.
4140+
4141+On M68K this implements the "ColdFire GDB" interface used by libgloss.
4142+
4143+Xtensa semihosting provides basic file IO calls, such as
4144+open/read/write/seek/select. Tensilica baremetal libc for ISS and
4145+linux platform "sim" use this interface.
4146+
41294147 @table @option
41304148 @item target=@code{native|gdb|auto}
41314149 Defines where the semihosting calls will be addressed, to QEMU (@code{native})