avr-run(1)

manual page for simulator (SIM) 12.1

Section 1 gdb-avr bookworm source

Description

SIMULATOR

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

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.