avr with no command opens a Linux shell in the current directory, and
avr <command> runs one command there. Everything else is a management
command that runs on your computer. Each page below gives the command’s help
text exactly as avr help prints it, then examples, what it exits with, and
the errors you are likely to meet.
| Command | Usage |
|---|---|
avr |
avr [flags] [--] [command [args...]] |
avr code |
avr [selector flags] code |
avr cursor |
avr [selector flags] cursor |
avr destroy |
avr [selector flags] destroy [--all | --orphaned] [--yes] |
avr help |
avr help [command] |
avr init |
avr [selector flags] init |
avr isolate |
avr isolate [on | off [--yes]] |
avr open |
avr [selector flags] open <port> |
avr ports |
avr [selector flags] ports [--all] |
avr reset |
avr [selector flags] reset [--yes] |
avr restore |
avr [selector flags] restore <name> |
avr snapshot |
avr [selector flags] snapshot [name] |
avr status |
avr status |
avr stop |
avr [selector flags] stop [--all] |
avr sync |
avr [selector flags] sync [--to-host | --to-guest] [--yes] |
avr update |
avr update |
avr version |
avr version |
avr zed |
avr [selector flags] zed |
Two rules apply everywhere. The Command line page covers them in full.
avr --distro fedora stop stops
the Fedora environment. In avr stop --distro fedora, --distro is an
argument to stop, which refuses it.--distro, --arch,
--isolate and --shared pick which environment a command acts on. See
Syntax
for how they combine with .avr.toml.| Status | Meaning |
|---|---|
0 |
Success, including “nothing to do” |
| The command’s own | avr <command> exits with whatever the command in Linux exited with |
1 |
avar tried and failed, and printed why |
2 |
avar could not read the command line, or the environment it names is not one avar supports. Nothing was changed |
130 |
Interrupted while preparing an environment, or you declined a prompt that would restart an environment or apply avr sync |
--help or -h anywhere after a command shows that command’s help and runs
nothing, so avr reset --help never resets anything.