Summary of C-SPY command line options

Skip to main content

IAR Embedded Workbench for RL78 5.20

Summary of C-SPY command line options

In this section:

Read more about:

General cspybat options

`‑‑application_args`	Passes command line arguments to the debugged application.
`‑‑attach_to_running_target`	Makes the debugger attach to a running application at its current location, without resetting the target system.
`‑‑backend`	Marks the beginning of the parameters to be sent to the C-SPY driver (mandatory).
`‑‑code_coverage_file`	Enables the generation of code coverage information and places it in a specified file.
`‑‑cycles`	Specifies the maximum number of cycles to run.
`‑‑debug_file`	Specifies an alternative debug file.
`‑‑download_only`	Downloads a code image without starting a debug session afterwards.
`-f`	Extends the command line.
`‑‑leave_target_running`	Makes the debugger leave the application running on the target hardware after the debug session is closed.
`‑‑macro`	Specifies a macro file to be used.
`‑‑macro_param`	Assigns a value to a C-SPY macro parameter.
`‑‑plugin`	Specifies a plugin file to be used.
`‑‑silent`	Omits the sign-on message.
`‑‑sockets`	Makes the debugger use sockets instead of pipes for its internal communication.
`‑‑suppress_entrypoint_warning`	Disables the warning when the ELF entry point is at address `0x0`.
`‑‑timeout`	Limits the maximum allowed execution time.

Options available for all C-SPY drivers

`‑‑core`	Specifies the core to be used.
`-d`	Specifies the C-SPY target system.
`--near_const_location`	Specifies the location for `__near`-declared constants and strings.
`--near_const_size`	Specifies the size in Kbytes of the near constants area.
`--near_const_start`	Specifies the start address for the near constants RAM area.
`-p`	Specifies the device description file to be used.

Options available for the simulator driver

`‑‑disable_interrupts`	Disables the interrupt simulation.
`‑‑function_profiling`	Analyzes your source code to find where the most time is spent during execution.
`‑‑mapu`	Activates memory access checking.

Options available for the C-SPY hardware debugger drivers

`‑‑cspybat_inifile`	Specifies a saved hardware settings file.
`--exec_dll`	Specifies the Exec DLL file.
`--live_debug`	Makes C-SPY use the live debug feature that is available on some core S3 devices.
`‑‑log_file`	Creates a log file.
`‑‑suppress_download`	Suppresses download of the executable image.
`‑‑verify_download`	Verifies the executable image.