modules.machinery.virtualbox.VirtualBox

Package modules :: Package machinery :: Module virtualbox :: Class VirtualBox |
[hide private]
[frames] | no frames]

# Class VirtualBox

source code

                               object --+
                                        |
    lib.cuckoo.common.abstracts.Machinery --+
                                            |
                                           VirtualBox

Virtualization layer for VirtualBox.

Instance Methods | [hide private]
_initialize_check(self) Runs all checks when a machine manager is initialized. | source code
start(self, label, task) Start a virtual machine. | source code
dump_pcap(self, label, task) Dump the pcap for this analysis through the VirtualBox integrated nictrace functionality. | source code
stop(self, label) Stops a virtual machine. | source code
_list(self) Lists virtual machines installed. | source code
_status(self, label) Gets current status of a vm. | source code
dump_memory(self, label, path) Takes a memory dump. | source code
Inherited from `lib.cuckoo.common.abstracts.Machinery`: `__init__`, `acquire`, `availables`, `initialize`, `machines`, `pcap_path`, `release`, `running`, `set_options`, `set_status`, `shutdown` Inherited from `lib.cuckoo.common.abstracts.Machinery` (private): `_get_resultserver_port`, `_initialize`, `_wait_status` Inherited from `object`: `__delattr__`, `__format__`, `__getattribute__`, `__hash__`, `__new__`, `__reduce__`, `__reduce_ex__`, `__repr__`, `__setattr__`, `__sizeof__`, `__str__`, `__subclasshook__`

Class Variables | [hide private]
| SAVED = `"saved"`
| RUNNING = `"running"`
| POWEROFF = `"poweroff"`
| ABORTED = `"aborted"`
| ERROR = `"machete"`
Inherited from `lib.cuckoo.common.abstracts.Machinery`: `LABEL`

Properties | [hide private]
Inherited from `object`: `__class__`

Method Details | [hide private]

### _initialize_check(self) | source code
Runs all checks when a machine manager is initialized. Raises: `CuckooMachineError` - if VBoxManage is not found. Overrides: lib.cuckoo.common.abstracts.Machinery._initialize_check

### start(self, label, task) | source code
Start a virtual machine. Parameters: `label` - virtual machine name. `task` - task object. Raises: `CuckooMachineError` - if unable to start. Overrides: lib.cuckoo.common.abstracts.Machinery.start

### dump_pcap(self, label, task) | source code
Dump the pcap for this analysis through the VirtualBox integrated nictrace functionality. This is useful in scenarios where multiple Virtual Machines are talking with each other in the same subnet (which you normally don't see when tcpdump'ing on the gatway).

### stop(self, label) | source code
Stops a virtual machine. Parameters: `label` - virtual machine name. Raises: `CuckooMachineError` - if unable to stop. Overrides: lib.cuckoo.common.abstracts.Machinery.stop

### _list(self) | source code
Lists virtual machines installed. Returns: virtual machine names list. Raises: `NotImplementedError` - this method is abstract. Overrides: lib.cuckoo.common.abstracts.Machinery._list

### _status(self, label) | source code
Gets current status of a vm. Parameters: `label` - virtual machine name. Returns: status string.

### dump_memory(self, label, path) | source code
Takes a memory dump. Parameters: `path` - path to where to store the memory dump. Overrides: lib.cuckoo.common.abstracts.Machinery.dump_memory