Documentation

    PLEASE NOTE: This document applies to latest version and not to the latest stable release v2.19

    Documentation for other releases can be found by using the version selector in the top right of any doc page.

    dmsetup

    Manage Linux device mapper devices.

    Attributes

    check_mode:
      support: full
    

    Parameters

    Parameter Required Type Values Description
    action true string create
    remove
    remove_all
    info
    table
    Action to perform on the device mapper device.
    deferred   boolean   Use deferred removal. [default: false]
    force   boolean   Force operation. [default: false]
    name   string   Device mapper device name.
    retry   integer   Retry on failure.
    table   array   Table specification for device (used with create action).
    uuid   string   Device UUID.

    Example

    - name: Remove all device mapper mappings
      dmsetup:
        action: remove_all
    
    - name: Remove specific device
      dmsetup:
        action: remove
        name: vg0-lv_root
        force: true
    
    - name: Get device info
      dmsetup:
        action: info
        name: vg0-lv_root
      register: dm_info
    
    - name: Create linear mapping
      dmsetup:
        action: create
        name: my_device
        table:
          - "0 2097152 linear /dev/sdb1 0"
    
    - name: List all devices
      dmsetup:
        action: info
      register: all_devices