Next: Introduction, Previous: (dir), Up: (dir) [Contents][Index]
This is the cl-virtualbox Reference Manual, version 0.1, generated automatically by Declt version 3.0 "Montgomery Scott" on Thu Mar 11 12:43:02 2021 GMT+0.
• Introduction | What cl-virtualbox is all about | |
• Systems | The systems documentation | |
• Modules | The modules documentation | |
• Files | The files documentation | |
• Packages | The packages documentation | |
• Definitions | The symbols documentation | |
• Indexes | Concepts, functions, variables and data types |
cl-virtualbox
is a library that allows you to control VirtualBox from Common
Lisp, by calling the vboxmanage
command.
list-vms ()
: Return a list of plists with the :name and :uuid of every
virtual machine.
list-running-vms ()
: Like list-vms
, but only return the VMs that are
running.
Examples:
virtualbox> (list-vms)
((:uuid "68fdde1a-a009-4c6f-af6e-250ef879e3e7" :name
"crane_ubuntu_1410013141185_11153")
(:uuid "b0ebec92-85cb-408c-b32c-c969e6392d5f" :name
"vm_ubuntu_1410966111913_95217")
(:uuid "9ad98045-5109-4233-8b82-4c9a49b4cab7" :name
"trivial-ssh_default_1411575480546_50302")
(:uuid "5d287f3c-9b17-4a66-990a-80d4db3167ae" :name "windows"))
virtualbox> (list-running-vms)
nil
find-by-name (name)
: Find a virtual machine by name.
find-by-uuid (uuid)
: Find a virtual machine by UUID.
Examples:
virtualbox> (find-by-name "crane_ubuntu_1410013141185_11153")
(:uuid "68fdde1a-a009-4c6f-af6e-250ef879e3e7" :name
"crane_ubuntu_1410013141185_11153")
virtualbox> (find-by-uuid "9ad98045-5109-4233-8b82-4c9a49b4cab7")
(:uuid "9ad98045-5109-4233-8b82-4c9a49b4cab7" :name
"trivial-ssh_default_1411575480546_50302")
create-vm (name)
: Create a new virtual machine named name
.
set-vm-memory (name memory)
: Set the VM's memory (In megabytes)
set-vm-vram (name memory)
: The the VM's video memory (In megabytes).
set-vm-cpu-count (name count)
: Set the number of virtual CPUs the VM has.
set-vm-acpi (name state)
: Turn ACPI support on/off.
set-vm-ioapic (name state)
: Turn IOAPIC support on/off.
set-vm-pae (name state)
: Enable/disable PAE.
set-vm-longmode (name state)
: Enable/disable longmode.
set-vm-hpet (name state)
: Enable/disable the High-Precision Event Timer
(HPET).
set-vm-3d-acceleration (name state)
: Enable/disable 3D acceleration.
map-vm-ports (name host-port guest-port)
: Map TCP traffic from host-port
to guest-ip:guest-port
in the guest.start-vm (name &key (type headless))
: Start the virtual machine.
pause-vm (name)
: Pause the virtual machine.
resume-vm (name)
: Resume the virtual machine after pausing it.
cold-reboot-vm (name)
: Reboot the virtual machine.
poweroff-vm (name)
: Power off the virtual machine.
create-hd (path &key size (format vdi))
: Create a virtual hard drive on
path
, with size size
(In megabytes) and type type
(:vdi by default).mount-dvd (name path)
: Mount a DVD to the virtual machine.
unmount-dvd (name)
: Remove the DVD from the virtual DVD drive.
Copyright (c) 2014-2018 Fernando Borretti (eudoxiahp@gmail.com)
Licensed under the MIT License.
Next: Modules, Previous: Introduction, Up: Top [Contents][Index]
The main system appears first, followed by any subsystem dependency.
• The cl-virtualbox system |
Fernando Borretti
MIT
Control VirtualBox from Common Lisp
‘cl-virtualbox‘ is a library that allows you to control VirtualBox from Common
Lisp, by calling the ‘vboxmanage‘ command.
# Usage
## Listing VMs
* ‘list-vms ()‘: Return a list of plists with the :name and :uuid of every
virtual machine.
* ‘list-running-vms ()‘: Like ‘list-vms‘, but only return the VMs that are
running.
Examples:
~~~lisp
virtualbox> (list-vms)
((:uuid "68fdde1a-a009-4c6f-af6e-250ef879e3e7" :name
"crane_ubuntu_1410013141185_11153")
(:uuid "b0ebec92-85cb-408c-b32c-c969e6392d5f" :name
"vm_ubuntu_1410966111913_95217")
(:uuid "9ad98045-5109-4233-8b82-4c9a49b4cab7" :name
"trivial-ssh_default_1411575480546_50302")
(:uuid "5d287f3c-9b17-4a66-990a-80d4db3167ae" :name "windows"))
virtualbox> (list-running-vms)
nil
~~~
## Finding VMs
* ‘find-by-name (name)‘: Find a virtual machine by name.
* ‘find-by-uuid (uuid)‘: Find a virtual machine by UUID.
Examples:
~~~lisp
virtualbox> (find-by-name "crane_ubuntu_1410013141185_11153")
(:uuid "68fdde1a-a009-4c6f-af6e-250ef879e3e7" :name
"crane_ubuntu_1410013141185_11153")
virtualbox> (find-by-uuid "9ad98045-5109-4233-8b82-4c9a49b4cab7")
(:uuid "9ad98045-5109-4233-8b82-4c9a49b4cab7" :name
"trivial-ssh_default_1411575480546_50302")
~~~
## Creating and Modifying VMs
* ‘create-vm (name)‘: Create a new virtual machine named ‘name‘.
* ‘set-vm-memory (name memory)‘: Set the VM’s memory (In megabytes)
* ‘set-vm-vram (name memory)‘: The the VM’s video memory (In megabytes).
* ‘set-vm-cpu-count (name count)‘: Set the number of virtual CPUs the VM has.
* ‘set-vm-acpi (name state)‘: Turn ACPI support on/off.
* ‘set-vm-ioapic (name state)‘: Turn IOAPIC support on/off.
* ‘set-vm-pae (name state)‘: Enable/disable PAE.
* ‘set-vm-longmode (name state)‘: Enable/disable longmode.
* ‘set-vm-hpet (name state)‘: Enable/disable the High-Precision Event Timer
(HPET).
* ‘set-vm-3d-acceleration (name state)‘: Enable/disable 3D acceleration.
## Network Configuration
* ‘map-vm-ports (name host-port guest-port)‘: Map TCP traffic from ‘host-port‘
to ‘guest-ip:guest-port‘ in the guest.
## Controlling VM State
* ‘start-vm (name &key (type headless))‘: Start the virtual machine.
* ‘pause-vm (name)‘: Pause the virtual machine.
* ‘resume-vm (name)‘: Resume the virtual machine after pausing it.
* ‘cold-reboot-vm (name)‘: Reboot the virtual machine.
* ‘poweroff-vm (name)‘: Power off the virtual machine.
## Managing Hard Drives
* ‘create-hd (path &key size (format vdi))‘: Create a virtual hard drive on ‘path‘, with size ‘size‘ (In megabytes) and type ‘type‘ (:vdi by default).
## Managing DVDs
* ‘mount-dvd (name path)‘: Mount a DVD to the virtual machine.
* ‘unmount-dvd (name)‘: Remove the DVD from the virtual DVD drive.
# License
Copyright (c) 2014-2018 Fernando Borretti (eudoxiahp@gmail.com)
Licensed under the MIT License.
0.1
cl-virtualbox.asd (file)
src (module)
Modules are listed depth-first from the system components tree.
• The cl-virtualbox/src module |
cl-virtualbox (system)
src/
cl-virtualbox.lisp (file)
Files are sorted by type and then listed depth-first from the systems components trees.
• Lisp files |
• The cl-virtualbox.asd file | ||
• The cl-virtualbox/src/cl-virtualbox.lisp file |
Next: The cl-virtualbox/src/cl-virtualbox․lisp file, Previous: Lisp files, Up: Lisp files [Contents][Index]
cl-virtualbox.asd
cl-virtualbox (system)
Previous: The cl-virtualbox․asd file, Up: Lisp files [Contents][Index]
src (module)
src/cl-virtualbox.lisp
Next: Definitions, Previous: Files, Up: Top [Contents][Index]
Packages are listed by definition order.
• The cl-virtualbox-asd package | ||
• The cl-virtualbox package |
Next: The cl-virtualbox package, Previous: Packages, Up: Packages [Contents][Index]
cl-virtualbox.asd
Previous: The cl-virtualbox-asd package, Up: Packages [Contents][Index]
cl-virtualbox.lisp (file)
virtualbox
common-lisp
Definitions are sorted by export status, category, package, and then by lexicographic order.
• Exported definitions | ||
• Internal definitions |
Next: Internal definitions, Previous: Definitions, Up: Definitions [Contents][Index]
• Exported special variables | ||
• Exported functions |
Next: Exported functions, Previous: Exported definitions, Up: Exported definitions [Contents][Index]
The path to the VBoxManage command.
cl-virtualbox.lisp (file)
Previous: Exported special variables, Up: Exported definitions [Contents][Index]
cl-virtualbox.lisp (file)
Reboot the virtual machine.
cl-virtualbox.lisp (file)
The hard way to set an IP address.
cl-virtualbox.lisp (file)
Create a virtual hard drive on ‘path‘, with size ‘size‘ (In megabytes) and type ‘type‘ (:vdi by default).
cl-virtualbox.lisp (file)
Create a new virtual machine named ‘name‘.
cl-virtualbox.lisp (file)
Execute ‘image‘ on the virtual machine ‘name‘, under the account ‘username‘ and ‘password‘. If ‘wait-stdout‘ is true, wait for the program to finish and print its output.
cl-virtualbox.lisp (file)
Find a virtual machine by name.
cl-virtualbox.lisp (file)
Find a virtual machine by UUID.
cl-virtualbox.lisp (file)
Import a virtual machine from an OVF file.
cl-virtualbox.lisp (file)
List host only interfaces.
cl-virtualbox.lisp (file)
Like ‘list-vms‘, but only return the VMs that are running.
cl-virtualbox.lisp (file)
Return a list of plists with the :name and :uuid of every virtual machine.
cl-virtualbox.lisp (file)
Map TCP traffic from ‘host-port‘ to ‘guest-ip:guest-port‘ in the guest.
cl-virtualbox.lisp (file)
Mount a DVD to the virtual machine.
cl-virtualbox.lisp (file)
Pause the virtual machine.
cl-virtualbox.lisp (file)
Power off the virtual machine.
cl-virtualbox.lisp (file)
Resume the virtual machine after pausing it.
cl-virtualbox.lisp (file)
cl-virtualbox.lisp (file)
Enable/disable 3D acceleration.
cl-virtualbox.lisp (file)
Turn ACPI support on/off.
cl-virtualbox.lisp (file)
Set the number of virtual CPUs the VM has.
cl-virtualbox.lisp (file)
Enable/disable the High-Precision Event Timer (HPET).
cl-virtualbox.lisp (file)
Turn IOAPIC support on/off.
cl-virtualbox.lisp (file)
The easy way to set an IP address.
cl-virtualbox.lisp (file)
Enable/disable longmode.
cl-virtualbox.lisp (file)
Set the VM’s memory (In megabytes)
cl-virtualbox.lisp (file)
Enable/disable PAE.
cl-virtualbox.lisp (file)
The the VM’s video memory (In megabytes).
cl-virtualbox.lisp (file)
Start the virtual machine.
cl-virtualbox.lisp (file)
Remove the DVD from the virtual DVD drive.
cl-virtualbox.lisp (file)
Previous: Exported definitions, Up: Definitions [Contents][Index]
• Internal special variables | ||
• Internal functions |
Next: Internal functions, Previous: Internal definitions, Up: Internal definitions [Contents][Index]
cl-virtualbox.lisp (file)
cl-virtualbox.lisp (file)
Previous: Internal special variables, Up: Internal definitions [Contents][Index]
cl-virtualbox.lisp (file)
cl-virtualbox.lisp (file)
cl-virtualbox.lisp (file)
cl-virtualbox.lisp (file)
cl-virtualbox.lisp (file)
cl-virtualbox.lisp (file)
cl-virtualbox.lisp (file)
cl-virtualbox.lisp (file)
cl-virtualbox.lisp (file)
cl-virtualbox.lisp (file)
cl-virtualbox.lisp (file)
cl-virtualbox.lisp (file)
cl-virtualbox.lisp (file)
Previous: Definitions, Up: Top [Contents][Index]
• Concept index | ||
• Function index | ||
• Variable index | ||
• Data type index |
Next: Function index, Previous: Indexes, Up: Indexes [Contents][Index]
Jump to: | C F L M |
---|
Jump to: | C F L M |
---|
Next: Variable index, Previous: Concept index, Up: Indexes [Contents][Index]
Jump to: | A B C E F I K L M P R S U |
---|
Jump to: | A B C E F I K L M P R S U |
---|
Next: Data type index, Previous: Function index, Up: Indexes [Contents][Index]
Jump to: | *
+
S |
---|
Jump to: | *
+
S |
---|
Previous: Variable index, Up: Indexes [Contents][Index]
Jump to: | C P S |
---|
Jump to: | C P S |
---|