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.