3 Managing VirtualBox Machines
(require remote-shell/vbox) | package: remote-shell-lib |
procedure
(start-vbox-vm name [ #:max-vms max-vms #:log-status log-status #:pause-seconds pause-seconds #:dry-run? dry-run?]) → void? name : string? max-vms : real? = 1 log-status : (string? #:rest any/c . -> . any) = printf pause-seconds : real? = 3 dry-run? : any/c = #f
The start will fail if max-vms virtual machines are already currently running. This limit is a precaution against starting too many virtual-machine instances, which can overwhelm the host operating system.
The log-status argument is used to report actions and status information.
After the machine is started, start-vbox-vm pauses for the amount of time specified by pause-seconds, which gives the virtual machine time to find its bearings.
If dry-run is #t, then the machine is not actually started, but status information is written using log-status to report the action that would have been taken.
procedure
(stop-vbox-vm name [ #:save-state? save-state? #:log-status log-status #:dry-run? dry-run?]) → void? name : string? save-state? : any/c = #t log-status : (string? #:rest any/c . -> . any) = printf dry-run? : any/c = #f
The log-status argument is used to report actions and status information.
If dry-run is #t, then the machine is not actually started, but status information is written using log-status to report the action that would have been taken.
procedure
(take-vbox-snapshot name snapshot-name) → void?
name : string? snapshot-name : string?
procedure
(restore-vbox-snapshot name snapshot-name) → void?
name : string? snapshot-name : string?
procedure
(delete-vbox-snapshot name snapshot-name) → void?
name : string? snapshot-name : string?
procedure
(exists-vbox-snapshot? name snapshot-name) → boolean?
name : string? snapshot-name : string?
procedure
(get-vbox-snapshot-uuid name snapshot-name) → (or/c #f string?)
name : string? snapshot-name : string?
Added in version 1.1 of package remote-shell-lib.
procedure
(import-vbox-vm path [ #:name name #:cpus cpus #:memory memory]) → void? path : path-string? name : (or/c false/c non-empty-string?) = #f cpus : (or/c false/c exact-positive-integer?) = #f memory : (or/c false/c exact-positive-integer?) = #f
When provided, name specifies what the VM’s alias (as seen in the GUI and in the output of commands like VBoxManage list vms) ought to be.
The cpus argument can be used to override the number of processors the VM has access to.
The memory argument can be used to override the amount of RAM (in MB) the VM has access to.
Added in version 1.4 of package remote-shell-lib.