io7m | single-page | multi-page
3.11. vm-add-virtio-disk
Previous
3. Command-Line Interface
Up
3.13. vm-console
Next
3.12

# vm-add-virtio-network-device

- 3.12. vm-add-virtio-network-device
  - 3.12.1. Name
  - 3.12.2. Description
  - 3.12.3. Example

3.12.1

## Name

1
vm-add-virtio-network-device - Add a Virtio network device to a virtual machine
3.12.2

## Description

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

### 3.12.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.

3

### 3.12.2.3 Device Slot Syntax

    <deviceSlot> = <bus> ":" <slot> ":" <function>

    Where:
      <bus>      = [0 .. 255]
      <slot>     = [0 .. 31]
      <function> = [0 .. 7]

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

4

### 3.12.2.4 Network Backend Syntax

    "tap" ";" <tapDevice> ";" <macAddress>
    | "vmnet" ";" <vmnetDevice> ";" <macAddress>

    Where:
      <tapDevice>   = "tap[0-9]'{'1,13'}'"
      <vmnetDevice> = "vmnet[0-9]'{'1,11'}'"
      <macAddress>  = "[a-f0-9]'{'2'}':[a-f0-9]'{'2'}':[a-f0-9]'{'2'}':[a-f0-9]'{'2'}':[a-f0-9]'{'2'}':[a-f0-9]'{'2'}'"

    Examples:
      tap;tap23;d9:63:c0:d9:09:e8
      tap;tap0000000000001;d9:63:c0:d9:09:e8
      vmnet;vmnet23;d9:63:c0:d9:09:e8
      vmnet;vmnet00000000001;d9:63:c0:d9:09:e8

3.12.3

## Example

1

### 3.12.3.1 Example

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

3.11. vm-add-virtio-disk
Previous
3. Command-Line Interface
Up
3.13. vm-console
Next
io7m | single-page | multi-page