io7m | single-page | multi-page
3.6. vm-add-ahci-optical
Previous
3. Command-Line Interface
Up
3.8. vm-add-framebuffer-device
Next
3.7

# vm-add-e1000-network-device

- 3.7. vm-add-e1000-network-device
  - 3.7.1. Name
  - 3.7.2. Description
  - 3.7.3. Example

3.7.1

## Name

1
vm-add-e1000-network-device - Add an e1000 network device to a virtual machine
3.7.2

## Description

1
The vm-add-e1000-network-device command adds a network device to a virtual machine. The device is an emulation of an Intel e82545 network device and, as such, requires a driver in the guest operating system that is capable of supporting that device.
2

### 3.7.2.2 Parameters

Parameter | Type | Required | Description
--- | --- | --- | ---
--backend | Network Backend | true | A specification of the network device backend to add
--comment | String | false | A comment describing the new disk
--configuration | Path | false | The path to the configuration file (environment variable: $WAXMILL_CONFIGURATION_FILE)
--device-slot | Device Slot | true | The slot to which the device will be attached.
--machine | UUID | true | The ID of the virtual machine
--verbose | Log Level | false | Set the minimum logging verbosity level.
--replace | Boolean | false | true if an existing device in the given slot should be replaced.

3

### 3.7.2.3 Device Slot Syntax

    bus        = ? [0 .. 255] ? ;
    slot       = ? [0 .. 31] ? ;
    function   = ? [0 .. 7] ? ;
    deviceSlot = bus , ":" , slot , ":" , function ;

    Examples:
      0:0:0
      255:31:7

4

### 3.7.2.4 Network Backend Syntax

    digit           = "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" ;
    hexDigit        = "a" | "b" | "c" | "d" | "e" | "f" ;
    lowerAlpha      = ? [a-z] ? ;
    upperAlpha      = ? [A-Z] ? ;
    groupCharacter  = lowerAlpha | upperAlpha | "_" ;
    groupName       = { groupCharacter } ;
    groupList       = groupName , { "," , groupName } ;

    macPart         = hexDigit , hexDigit ;
    macAddress      = macPart , ":" , macPart , ":" , macPart , ":" , macPart , ":" , macPart , ":" , macPart ;
    tapDeviceName   = "tap" , '{' digit '}' ;
    vmnetDeviceName = "vmnet" , '{' digit '}' ;
    tapDevice       = "tap" , ";" , tapDeviceName , ";" , macAddress , [ ";" groupList ] ;
    vmnetDevice     = "vmnet" , ";" , vmnetDeviceName , ";" , macAddress , [ ";" groupList ] ;

    Examples:
      tap;tap23;d9:63:c0:d9:09:e8
      tap;tap0000000000001;d9:63:c0:d9:09:e8
      tap;tap23;d9:63:c0:d9:09:e8;wwwUsers,mailUsers,ntpdUsers
      vmnet;vmnet23;d9:63:c0:d9:09:e8
      vmnet;vmnet00000000001;d9:63:c0:d9:09:e8
      vmnet;vmnet23;d9:63:c0:d9:09:e8;wwwUsers,mailUsers,ntpdUsers

3.7.3

## Example

1

### 3.7.3.1 Example

    $ waxmill vm-add-e1000-network-device \
      --machine de17174a-1b3c-4ebc-80af-cb239aa18cbd \
      --device-slot 0:4:0 \
      --backend tap;tap23;d9:63:c0:d9:09:e8

3.6. vm-add-ahci-optical
Previous
3. Command-Line Interface
Up
3.8. vm-add-framebuffer-device
Next
io7m | single-page | multi-page