1. Kaspar Schiess
  2. qemu-toolkit

Commits

Kaspar Schiess  committed 2bacec5

Fixes dd list

  • Participants
  • Parent commits 2d32c4c
  • Branches master

Comments (0)

Files changed (1)

File doc/qemu-toolkit-configuration.7.ronn

View file
 
 ### available options
 
+Here's a list of configuration options within the virtual_machine declaration:
+
   * cpus <NUMBER>: 
     Configures the number of SMP cpus simulated to the guest system. 
     You should not configure more SMP cpus than you have physical CPU cores
     
         # configures 4 SMP cpus
         cpus 4      
-    
+
   * disk <DEVICE_PATH>: 
     Add a disk drive to the guest system. <DEVICE_PATH> should be the 
     quoted full path to a block device. 
     
         # Use a zvol block device
         disk '/dev/zvol/dsk/pool1/myvm/disk1'
-        
+
   * drive <OPTIONS>:
     Directly add a drive directive to qemu options. If you use this, you'll
-    need to provide all key-value pairs for the directive as a Ruby hash. 
-    Note that if you do not specify 'index', your drive will get the next
-    free disk index. (as is the case with `disk`)
+    need to provide all key-value pairs for the directive as a Ruby hash. Note
+    that if you do not specify 'index', your drive will get the next free disk
+    index. (as is the case with `disk`) For the full list of options, please
+    refer to the [QEMU documentation](http://qemu.weilnetz.de/qemu-doc.html).
     
         # Manual drive configuration:
         drive if: 'floppy', file: 'floppy.dsk'
+        
+  * net <TYPE>, <OPTIONS>:
+    Manual network configuration. This gives you full access to QEMU options, 
+    with the disadvantage of a slightly more complicated set of options. 
+    Here's what you would need to do to duplicate the convencience macro `nic`
+    below: 
+      
+        net :vnic, vlan: 1, name: 'vm1', ifname: 'vm1', 
+          macaddr: '1:8:20:52:a6:7e'
+        net :nic, vlan: 1, name: "vm1", model: "virtio", 
+          macaddr: '1:8:20:52:a6:7e'
+
+  
+  * nic <NAME>, <OPTIONS>:
+    Add a virtual network card to the guest. Virtual network cards are made
+    to correspond to vnic links on the host system. These vnic links are 
+    automatically generated for you, all you have to do is to specify a `via:`
+    option here. 
+    
+    The `via:` option takes either physical links or etherstub switches as 
+    value. 
+    You can also specify a VLAN tag, separated by a colon. (ie: e1000g0:4)
+    
+    nic `model:` will default to `virtio`.
     
+    NOTE: QEMU/kvm on Illumos will default to providing a single pseudo-nic
+    that has a DHCP server attached to it by default. If you do not specify
+    a `nic`, this is what you'll get. 
     
+        # Create eth0 interface with given mac address via 'igb1'.
+        nic 'eth0', macaddr: '2:8:20:52:a6:7e', via: 'igb1'
+
   * ram <MEGABYTES>: 
     Configures the amount of RAM the guest system sees. Note that the qemu 
     on Illumos locks memory down for the guest and never swaps it out. This
     means that you cannot simulate RAM you don't have available. (free)
-    
-    
 
 ## SEE ALSO