NAME

simulator - manual page for simulator (SIM) 12.1

SYNOPSIS

avr-run [ options] [VAR=VAL|--] program [program args]

OPTIONS

-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
-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
--hw-info, --info-hw
List configurable hw regions
--hw-trace[=on|off], --trace-hw
Trace all hardware devices
--hw-device DEVICE
Add the specified device
--hw-list
List the device tree
--hw-file FILE
Add the devices listed in the file
--sockser-addr SOCKET ADDRESS
Set serial emulation socket address
--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
--model MODEL
Specify model to simulate
--model-info, --info-model
List selectable models
-v, --verbose
Verbose output
-E B|big|L|little, --endian B|big|L|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
--target-info, --info-target
List supported targets
--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
--argv0 ARGV0
Set argv[0] to the specified string
--env-set VAR=VAL
Set the variable in the program's environment
--env-unset VAR
Unset the variable in the program's environment
--env-clear
Clear the program's environment
Note: Depending on the simulator configuration some options
may not be applicable
VAR=VAL Environment variables to set. Ignored if -- is used. program args Arguments to pass to simulated program.
Note: Very few simulators support this.
Copyright © 2021 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>
 
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

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.