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 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:
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:
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:
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