arm-none-eabi-run(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.