The Start() method

Start (IN  a{sv} options);

Starts the RAID array.

If the option parameter contains the key start-degraded with the value TRUE, the array will be started even if some members are missing.

Since 2.0.0

The Stop() method

Stop (IN  a{sv} options);

Stops the RAID array.

Since 2.0.0

The RemoveDevice() method

RemoveDevice (IN  o     device,
              IN  a{sv} options);

Removes device from the array.

For this to work device must already be associated with the array, e.g. referenced in the "ActiveDevices" property.

If the option parameter contains the key wipe with the value TRUE, all known filesystem signatures will be erased from the device after removal.

Since 2.0.0

The AddDevice() method

AddDevice (IN  o     device,
           IN  a{sv} options);

Adds device to the array.

Since 2.0.0

The SetBitmapLocation() method

SetBitmapLocation (IN  ay    value,
                   IN  a{sv} options);

Sets whether the array has a write-intent bitmap.

Since 2.0.0

The RequestSyncAction() method

RequestSyncAction (IN  s     sync_action,
                   IN  a{sv} options);

This method call can be used to trigger and cancel data redundancy checks and repairs. Currently only the values check, repair and idle can be used for sync_action.

See also the property "SyncAction".

This method call is similar to writing to the sync_action sysfs file, see the Documentation/admin-guide/md.rst file shipped with the kernel sources.

Since 2.0.0

The Delete() method

Delete (IN  a{sv} options);

Stops the RAID array and destroys all RAID metadata on member devices.

If the option tear-down is set to TRUE, then the RAID array block device and all its children will be cleaned up before stopping. This cleanup consists of removing entries from /etc/fstab and /etc/crypttab, and locking of encrypted block devices. Entries in /etc/fstab and /etc/crypttab that have been created with the 'track-parents' options to AddConfigurationItem will be removed even if their block device is currently unavailable.

Since 2.0.0

The "UUID" property

UUID  readable   s

The UUID of the array.

Since 2.0.0

The "Name" property

Name  readable   s

The name of the array (TODO: homehost etc).

Since 2.0.0

The "Level" property

Level  readable   s

The RAID level.

Known values include raid0, raid1, raid4, raid5, raid6 and raid10.

Since 2.0.0

The "NumDevices" property

NumDevices  readable   u

Number of devices that are part of the array.

Since 2.0.0

The "Size" property

Size  readable   t

The size of the array or 0 if unknown.

This is the usable size, e.g. for a RAID-5 array backed by 4 1TB disks, this will be approximately 3 TB.

Since 2.0.0

The "SyncAction" property

SyncAction  readable   s

The current state of the array or empty if the array is not running or if the array does not have any redundancy (e.g. RAID-0 or linear).

Use the RequestSyncAction() method to change this.

This property corresponds to the sync_action sysfs file, see the Documentation/admin-guide/md.rst file shipped with the kernel sources.

Since 2.0.0

The "SyncCompleted" property

SyncCompleted  readable   d

The fraction or sectors completed (always between 0.0 and 1.0) in the sync operation or 0.0 if no operation is in progress.

This property corresponds to the sync_completed sysfs file, see the Documentation/admin-guide/md.rst file shipped with the kernel sources.

Since 2.0.0

The "SyncRate" property

SyncRate  readable   t

The rate (or speed) at which the sync operation takes place. It is averaged over the last 30 seconds and measured in bytes per second.

If the rate is unknown or no operation is in progress, the value of this property is 0.

This property corresponds to the sync_speed sysfs file, see the Documentation/admin-guide/md.rst file shipped with the kernel sources.

Since 2.0.0

The "SyncRemainingTime" property

SyncRemainingTime  readable   t

The estimated number of micro-seconds until the operation is finished

If the amount of remaining time is unknown or no operation is in progress, the value of this property is 0.

This property is based on the value of the sync_speed sysfs file, see the Documentation/admin-guide/md.rst file shipped with the kernel sources.

Since 2.0.0

The "Degraded" property

Degraded  readable   u

Number of devices by which the array is degraded (0 if not degraded or not running).

This property corresponds to the degraded sysfs file, see the Documentation/admin-guide/md.rst file shipped with the kernel sources.

Since 2.0.0

The "BitmapLocation" property

BitmapLocation  readable   ay

The location of a write-intent bitmap (empty if the array is not running), if any.

If the RAID array does not suppor write-intent bitmaps (for example RAID-0 arrays), this is empty.

This property corresponds to the bitmap/location sysfs file, see the Documentation/admin-guide/md.rst file shipped with the kernel sources.

Since 2.0.0

The "ChunkSize" property

ChunkSize  readable   t

The chunk size (0 if the array is not running or not using striping).

This property corresponds to the chunk_size sysfs file, see the Documentation/admin-guide/md.rst file shipped with the kernel sources.

Since 2.0.0

The "ActiveDevices" property

ActiveDevices  readable   a(oiasta{sv})

This property is an array with block devices that are currently associated with the with the array. It is empty if the array is not running.

Each element of the array is a struct with the following members:

This property correspond to the /sys/block/mdN/md/dev-* directories in sysfs and the sysfs files in each directory. See the Documentation/admin-guide/md.rst file shipped with the kernel sources.

Since 2.0.0

The "ChildConfiguration" property

ChildConfiguration  readable   a(sa{sv})

Configuration items belonging to the

block devices of this array (recursively). This is also valid when the array is stopped and there are no actual block devices for it. It works via the 'track-parents' options of AddConfigurationItem(), which see.

Since 2.0.0

The "Running" property

Running  readable   b

Whether or not the array is considered running.

It is an error to call Start on a running array, and Stop on a non-running array, for example.

Since 2.0.0