org.freedesktop.UDisks2.Drive.LSM: UDisks Reference Manual

org.freedesktop.UDisks2.Drive.LSM

org.freedesktop.UDisks2.Drive.LSM — LSM interface exported on disk objects

Properties

IsOK                  readable   b
IsRaidDegraded        readable   b
IsRaidError           readable   b
IsRaidVerifying       readable   b
IsRaidReconstructing  readable   b
RaidType              readable   s
StatusInfo            readable   s
MinIoSize             readable   u
OptIoSize             readable   u
RaidDiskCount         readable   u

Description

Objects implementing this interface also implement the #org.freedesktop.UDisks2.Drive interface.

Since 2.3.0

Property Details

The "IsOK" property

IsOK  readable   b

Whether this drive is read and writeable without any error or warnings. It's the single preliminary check on whether things go wrong. Noted: even from user's view, RAID degrade does not cause any error or warning at OS level, the 'isOK' property will still be set as 'FALSE' to suggest user to do more checking on what's going on.

Since 2.3.0

The "IsRaidDegraded" property

IsRaidDegraded  readable   b

Whether this drive is degraded RAID, for example, one disk failure in RAID 5 group is considered as degraded RAID.

Since 2.3.0

The "IsRaidError" property

IsRaidError  readable   b

Whether this drive is facing RAID error, for example, two disks failure in RAID 5 group at the same time is considered as RAID error, user will lose data access and facing write failure.

Since 2.3.0

The "IsRaidVerifying" property

IsRaidVerifying  readable   b

Whether the RAID group of current drive allocated from is verifying its data integrity by comparing mirror(RAID1) or verifying parity(RAID 5/6).

Since 2.3.0

The "IsRaidReconstructing" property

IsRaidReconstructing  readable   b

Whether the RAID group of current drive allocated from is reconstructing its data on newly joined disk or out-synced disk.

Since 2.3.0

The "RaidType" property

RaidType  readable   s

A string of backend RAID type of this disk drive. Could be one of these values: JBOD, RAID 0, RAID 1, RAID 5, RAID 6, RAID 10, RAID 50, RAID 60 There will be a space between RAID number and 'RAID' string. If unknown, leave it as empty.

Since 2.3.0

The "StatusInfo" property

StatusInfo  readable   s

A message for administrator about RAID detail issue. Some examples: Disk enclosure 1 slot 9(serial: CVDA452606ME1207GN) is offline. Disk enclosure 1 slot 10 is predicted to be fail soon. Empty string if no issue or LibStorageMgmt failed to retrieve so.

Since 2.3.0

The "MinIoSize" property

MinIoSize  readable   u

The minimum I/O size, device preferred I/O size for random I/O. Any I/O size not equal to a multiple of this value may get significant speed penalty. Normally it refers to strip size of each RAID disk(extent). If LibStorageMgmt failed to detect min_io_size, it will try these values in the sequence of: logical sector size -> physical sector size -> 0

Since 2.3.0

The "OptIoSize" property

OptIoSize  readable   u

The optimal I/O size, device preferred I/O size for sequential I/O. Normally it refers to RAID group stripe size. If LibStorageMgmt failed to detect opt_io_size, it will be set to 0.

Since 2.3.0

The "RaidDiskCount" property

RaidDiskCount  readable   u

The count of disk assebled the RAID group where this disk drive came from. This impact the performance of this disk drive. If LibStorageMgmt failed to detect RAID disk count, it will be set to 0.

Since 2.3.0