Man page - avr-run(1)
Packages contains this manual
Manual
SIMULATOR
NAMESYNOPSIS
OPTIONS
COPYRIGHT
SEE ALSO
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.