---
name: "avr-run"
section: "1"
platform: "linux"
package: "gdb-avr"
version: "15.1-1+b3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/avr-run"
---

# avr-run(1)

GNU simulator for AVR

## 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.