view release on metacpan or  search on metacpan

man/fuguvm/fuguvm.1  view on Meta::CPAN

.It 1
General error.
.It 2
Invalid arguments.
.It 3
Configuration error, or not in an
.Nm
project.
.It 4
VM not found.
.It 5
The VM runs.
.It 7
Timeout in the wait for the VM.
.It 9
Expect script failed.
.It 11
Snapshot not found.
.El
.Pp
The
.Cm ssh
command with a
.Ar command
argument exits with the exit code of the remote command.
.Sh EXAMPLES
Initialize a project and boot the default VM:
.Bd -literal -offset indent
$ fuguvm init
$ fuguvm up
$ fuguvm wait --timeout=300
.Ed
.Pp
Run a command in the VM:
.Bd -literal -offset indent
$ fuguvm ssh "uname -a"
OpenBSD openbsd-default.my.domain 7.8 GENERIC arm64
.Ed
.Pp
Operate on a VM other than the default:
.Bd -literal -offset indent
$ fuguvm --vm minimal up
.Ed
.Sh SEE ALSO
.Xr expect 1 ,
.Xr ssh 1 ,
.Xr telnet 1
.Sh HISTORY
The
.Nm
utility was first available in 2025.
Its initial purpose was to run the test suite of a daemon against a
real
.Ox
guest.
It became more general from there.
.Sh AUTHORS
.An Dick Olsson Aq Mt hi@senzilla.io
.Sh SECURITY CONSIDERATIONS
.Nm
generates a random root password for each installation and stores it
in the VM state directory.
When the installed image goes into the cache,
.Nm
also stores the password in the
.Pa meta.json
of that entry
.Pq mode 0600 .
The cache makes the life of this secret longer:
the password stays after
.Cm destroy ,
and it changes only when the base key changes.
.Pp
This is not a localhost-only secret.
The guest permits password root login.
.Nm
gives QEMU the
.Ar ssh_port
and
.Ar console_port
values with no bind address.
Thus the forwarded SSH port and the telnet serial console listen on
each host interface.
Treat a VM that runs as open to all persons who can reach the host.
Apply the same rule to a
.Ar cache_dir
that has content.