ash-ls(1)Ash Manualash-ls(1)

NAME

ash-ls - list ash VM state directories or cached images

DESCRIPTION

Lists ash VM state directories under XDG_STATE_HOME/ASH_NAME when XDG_STATE_HOME is set, or ~/.local/state/ASH_NAME otherwise. ASH_NAME defaults to ash. With --cache, lists cached image-backed Nix store bases instead.

OUTPUT

The default output shows VM name, status, private IPv4 address and vsock CID when running, active SSH connection and PTY counts, host disk usage, apparent virtual size, last modification time, and state path.

IP is the first global IPv4 address on the guest interface whose MAC matches the stable address generated for the VM name. SSH counts established AF_VSOCK connections to guest port 22. PTY counts active SSH pseudo-terminals registered by the guest. A dash means the VM is stopped, has no address yet, or the QGA query failed.

DISK is host storage currently used. VIRTUAL is apparent size, including sparse files such as persist.img. Both exclude the host mount staging tree so nested staging mounts are not traversed.

With --cache, output shows each cache key, host disk usage, sparse virtual size, modification time, logical VM reference count, closure name, and image path. Cache entries remain safe to delete because VM store images are independent clones.

EXAMPLES

ash ls
ash ls --cache

Generated from ash Cmdliner manpage metadata.

ash-ls(1)ash 0.1.9ash-ls(1)