NAME

ash-stop - stop an ash background VM

DESCRIPTION

Stops an ash-owned background VM by stopping its transient user systemd unit.

VM SELECTION

Pass NAME to stop that VM. If NAME is omitted, stop requires exactly one running VM.

BACKGROUND UNITS

ash stop targets the ash-NAME.service user unit created by background spawn flows.

Foreground attached VMs are not owned by a background unit, so ash stop will refuse to stop them.

ACTIVE SSH CONNECTIONS

Before stopping the unit, ash queries the guest through QGA. If the VM has active SSH connections, ash prints their connection and PTY counts and asks for confirmation.

In a non-interactive invocation, ash refuses to stop a VM with active SSH connections. Pass --force to bypass confirmation and continue after the warning.

SUSPEND

With --suspend, ash runs virtle suspend for the VM's manifest instead of stopping the unit. virtle saves QEMU state to disk and the launch process exits.

Resume later with ash resume NAME.

EXAMPLES

ash stop work

ash stop --force work

ash stop --suspend work

Generated from ash Cmdliner manpage metadata.