ash-mount(1)Ash Manualash-mount(1)

NAME

ash-mount - hot-mount a host directory into a running VM

DESCRIPTION

Hot-mounts one host directory into a running VM without regenerating virtle.toml.

MOUNT SPEC

Use HOST_PATH[:GUEST_PATH]. If GUEST_PATH is omitted, ash uses the absolute host path as the guest target.

A guest path starting with ~ is resolved relative to the guest SSH user's home. Ash normalizes redundant path components without resolving host symlinks to their targets.

HOW IT WORKS

ash stages the host directory below shares/{ro,rw}/mounts/hotmounts, exposes it through the matching consolidated share, then uses virtle guest-exec to bind it at GUEST_PATH inside the guest.

The guest shares-ro or shares-rw root is mounted lazily when needed. --mode controls guest access: rw is the default; ro uses the read-only share and a read-only bind mount.

The desired mount is recorded atomically in ash-state.toml before guest realization. Later starts and resumes retry any missing host staging or guest bind mount.

REQUIREMENTS

The VM must be running and QEMU Guest Agent must be available.

EXAMPLES

ash mount work ~/dev/project
ash mount --mode ro work ~/src/nixpkgs:~/nixpkgs

Generated from ash Cmdliner manpage metadata.

ash-mount(1)ash 0.1.9ash-mount(1)