Provided by: gdb-avr_13.2-3ubuntu3_amd64 
NAME
simulator - GNU simulator for AVR
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
Copyright © 2023 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.
GNU simulator (SIM) 13.2 September 2023 SIMULATOR(1)