derek.holloway
7502bf64a4
CodeQL / Analyze (actions) (push) Canceled after 0s
CodeQL / Analyze (python) (push) Canceled after 0s
pre-commit / pre-commit (push) Canceled after 0s
Multi-Arch CI / setup (push) Canceled after 0s
Publish build_manylinux_x86_64 images / publish_build_manylinux_x86_64 (push) Canceled after 0s
Setup (Multi-Arch) / setup (push) Canceled after 0s
Multi-Arch CI / Linux::${{ fromJSON(needs.setup.outputs.linux_build_config || '{}').build_variant_label || 'skip' }} (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish no_rocm_image_ubi10 image / publish_no_rocm_image_ubi10 (push) Canceled after 0s
Multi-Arch CI / Windows::${{ fromJSON(needs.setup.outputs.windows_build_config || '{}').build_variant_label || 'skip' }} (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Multi-Arch CI / Manifest Diff (push) Canceled after 0s
TheRock Manifest Diff Report / Generate Manifest Diff Report (push) Canceled after 0s
Multi-Arch CI / CI Summary (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04 (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04_ocl_rt images / publish_no_rocm_image_ubuntu24_04_ocl_rt (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_rocgdb (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04_rocgdb images / publish_no_rocm_image_ubuntu24_04_rocgdb (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_ocl_rt (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Unit Tests / Unit Tests :: ubuntu-24.04 (push) Canceled after 0s
Unit Tests / Unit Tests :: windows-2022 (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_media (push) Canceled after 0s
Unit Tests / Unit Tests Summary (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_openmpi (push) Canceled after 0s
68 lines
2.0 KiB
Plaintext
68 lines
2.0 KiB
Plaintext
How to use SIS with GDB
|
|
-----------------------
|
|
|
|
1. Building GDB with SIS
|
|
|
|
To build GDB with the SIS/ERC32 simulator, configure with option
|
|
'--target sparc-erc32-aout' and build as usual.
|
|
|
|
2. Attaching the simulator
|
|
|
|
To attach GDB to the simulator, use:
|
|
|
|
target sim [options] [files]
|
|
|
|
The following options are supported:
|
|
|
|
-nfp Disable FPU. FPops will cause an FPU disabled trap.
|
|
|
|
-freq <f> Set the simulated "system clock" to <f> MHz.
|
|
|
|
-v Verbose mode.
|
|
|
|
-nogdb Disable GDB breakpoint handling (see below)
|
|
|
|
The listed [files] are expected to be in aout format and will be
|
|
loaded in the simulator memory prior. This could be used to load
|
|
a boot block at address 0x0 if the application is linked to run
|
|
from RAM (0x2000000).
|
|
|
|
To start debugging a program type 'load <program>' and debug as
|
|
usual.
|
|
|
|
The native simulator commands can be reached using the GDB 'sim'
|
|
command:
|
|
|
|
sim <sis_command>
|
|
|
|
Direct simulator commands during a GDB session must be issued
|
|
with care not to disturb GDB's operation ...
|
|
|
|
For info on supported ERC32 functionality, see README.sis.
|
|
|
|
|
|
3. Loading aout files
|
|
|
|
The GDB load command loads an aout file into the simulator
|
|
memory with the data section starting directly after the text
|
|
section regardless of which start address was specified for the data
|
|
at link time! This means that your applications either has to include
|
|
a routine that initialise the data segment at the proper address or
|
|
link with the data placed directly after the text section.
|
|
|
|
A copying routine is fairly simple, just copy all data between
|
|
_etext and _data to a memory loaction starting at _environ. This
|
|
should be done at the same time as the bss is cleared (in srt0.s).
|
|
|
|
|
|
4. GDB breakpoint handling
|
|
|
|
GDB inserts breakpoint in the form of the 'ta 1' instruction. The
|
|
GDB-integrated simulator will therefore recognize the breakpoint
|
|
instruction and return control to GDB. If the application uses
|
|
'ta 1', the breakpoint detection can be disabled with the -nogdb
|
|
switch. In this case however, GDB breakpoints will not work.
|
|
|
|
|
|
Report problems to Jiri Gaisler ESA/ESTEC (jgais@wd.estec.esa.nl)
|