io7m | single-page | multi-page
3.4. version
Previous
3. Command-Line Interface
Up
3.6. vm-add-ahci-optical
Next
3.5

# vm-add-ahci-disk

- 3.5. vm-add-ahci-disk
  - 3.5.1. Name
  - 3.5.2. Description
  - 3.5.3. Example

3.5.1

## Name

1
vm-add-ahci-disk - Add an AHCI disk to a virtual machine
3.5.2

## Description

1
The vm-add-ahci-disk command adds a disk to a virtual machine. The disk is an emulation of an AHCI controller attached to a SATA hard-drive and, as such, requires a driver in the guest operating system that is capable of supporting AHCI.
2

### 3.5.2.2 Parameters

Parameter | Type | Required | Description
--- | --- | --- | ---
--backend | Storage Backend | true | A specification of the AHCI storage 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
--open-option | OpenOption | false | The options that will be used when opening the storage device.
--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.5.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.5.2.4 Storage Backend Syntax

    path           = ? Any UNIX-like path ? ;
    size           = ? Any non-negative multiple of 128000 (bytes) ? ;
    fileBackend    = "file" , ";" , path ;
    zfsBackend     = "zfs-volume" , [ ";" , size ] ;
    storageBackend = fileBackend | zfsBackend ;

    Examples:
      file;/tmp/xyz
      zfs-volume
      zfs-volume;1280000000

5

### 3.5.2.5 Open Options

Name | Description
--- | ---
NO_CACHE | Do not use caching (O_DIRECT).
SYNCHRONOUS | Writes to the file are synchronous (O_SYNC).
READ_ONLY | The file is opened read-only.

3.5.3

## Example

1

### 3.5.3.1 Example

    $ waxmill vm-add-ahci-disk \
      --machine de17174a-1b3c-4ebc-80af-cb239aa18cbd \
      --device-slot 0:4:0 \
      --backend file;/tmp/disk.img

3.4. version
Previous
3. Command-Line Interface
Up
3.6. vm-add-ahci-optical
Next
io7m | single-page | multi-page