other versions
SIMULATOR(1) | User Commands | SIMULATOR(1) |
NAME¶
simulator - manual page for simulator (7.12-6+9+b2) 7.12.0.20161007-git
SYNOPSIS¶
arm-none-eabi-run [options] program [program args]
OPTIONS¶
- --watch-cycles-ACTION [+]COUNT
- Watch the simulator, take ACTION in COUNT cycles (`+' for every COUNT cycles), ACTION is int breakpoint
- --watch-pc-ACTION [!]ADDRESS
- Watch the PC, take ACTION when matches ADDRESS (in range ADDRESS,ADDRESS), `!' negates test
- --watch-clock-ACTION [+]MILLISECONDS
- Watch the clock, take ACTION after MILLISECONDS (`+' for every MILLISECONDS)
- --watch-delete IDENT|all|pc|cycles|clock
- Delete a watchpoint
- --watch-info
- List scheduled watchpoints
- --memory-delete ADDRESS|all, --delete-memory ADDRESS
- Delete memory at ADDRESS (all addresses)
- --memory-region ADDRESS,SIZE[,MODULO]
- Add a memory region
- --memory-alias ADDRESS,SIZE{,ADDRESS}
- Add memory shadow
- --memory-size <size>[in bytes, Kb (k suffix), Mb (m suffix) or Gb (g suffix)]
- Add memory at address zero
- --memory-fill VALUE
- Fill subsequently added memory regions
- --memory-clear
- Clear subsequently added memory regions
- --memory-mapfile FILE
- Memory-map next memory region from file
- --memory-info, --info-memory
- List configurable memory regions
- --map-info
- List mapped regions
- -p[on|off], --profile[=on|off]
- Perform profiling
- --profile-insn[=on|off]
- Perform instruction profiling
- --profile-memory[=on|off]
- Perform memory profiling
- --profile-core[=on|off]
- Perform CORE profiling
- --profile-model[=on|off]
- Perform model profiling
- --profile-cpu-frequency CPU FREQUENCY
- Specify the speed of the simulated cpu clock
- --profile-file FILE NAME
- Specify profile output file
- --profile-pc[=on|off]
- Perform PC profiling
- -F PC PROFILE FREQUENCY, --profile-pc-frequency PC PROFILE FREQUENCY
- Specified PC profiling frequency
- -S PC PROFILE SIZE, --profile-pc-size PC PROFILE SIZE
- Specify PC profiling size
- --profile-pc-granularity PC PROFILE GRANULARITY
- Specify PC profiling sample coverage
- --profile-pc-range BASE,BOUND
- Specify PC profiling address range
- -t[on|off], --trace[=on|off]
- Trace useful things
- --trace-insn[=on|off]
- Perform instruction tracing
- --trace-disasm[=on|off]
- Disassemble instructions (slower, but more accurate)
- --trace-decode[=on|off]
- Trace instruction decoding
- --trace-extract[=on|off]
- Trace instruction extraction
- --trace-linenum[=on|off]
- Perform line number tracing (implies --trace-insn)
- --trace-memory[=on|off]
- Trace memory operations
- --trace-alu[=on|off]
- Trace ALU (Arithmetic Logic Unit) operations
- --trace-fpu[=on|off]
- Trace FPU (Floating Point Unit) operations
- --trace-vpu[=on|off]
- Trace VPU (Vector Processing Unit) operations
- --trace-branch[=on|off]
- Trace branching
- --trace-semantics[=on|off]
- Perform ALU, FPU, VPU, MEMORY, and BRANCH tracing
- --trace-model[=on|off]
- Include model performance data
- --trace-core[=on|off]
- Trace core operations
- --trace-events[=on|off]
- Trace events
- --trace-syscall[=on|off]
- Trace system calls
- --trace-register[=on|off]
- Trace cpu register accesses
- --trace-debug[=on|off]
- Add information useful for debugging the simulator to the tracing output
- --trace-file FILE NAME
- Specify tracing output file
- --model MODEL
- Specify model to simulate
- --model-info, --info-model
- List selectable models
- -v, --verbose
- Verbose output
- -E big|little, --endian big|little
- Set endianness
- --environment user|virtual|operating
- Set running environment
- --alignment strict|nonstrict|forced
- Set memory access alignment
- -D, --debug
- Print debugging messages
- --debug-insn
- Print instruction debugging messages
- --debug-file FILE NAME
- Specify debugging output file
--do-command COMMAND
- -H, --help
- Print help information
- --version
- Print version information
- --architecture MACHINE
- Specify the architecture to use
- --architecture-info, --info-architecture
- List supported architectures
- --target BFDNAME
- Specify the object-code format for the object files
- --load-{lma,vma}
- Use VMA or LMA addresses when loading image (default LMA)
- --sysroot SYSROOT
- Root for system calls with absolute file-names and cwd at start
Note: Depending on the simulator configuration some options
- may not be applicable
program args Arguments to pass to simulated program.
- Note: Very few simulators support this.
SEE ALSO¶
The full documentation for simulator is maintained as a Texinfo manual. If the info and simulator programs are properly installed at your site, the command
- info simulator
should give you access to the complete manual.
January 2016 | simulator (7.12-6+9+b2) 7.12.0.20161007-git |