lsm_local_disk_rpm_get - Man Page

Query disk rotation speed.

Synopsis

int lsm_local_disk_rpm_get (const char *disk_path, int32_t *rpm, lsm_error **lsm_err);

Arguments

disk_path

String. The path of disk block, example: "/dev/sdb", "/dev/nvme0n1".

rpm

Output pointer of int32_t.

lsm_err

Output pointer of lsm_error. Error message could be retrieved via lsm_error_message_get. Memory should be freed by lsm_error_free.

Version

1.3

Description

Query the disk rotation speed - revolutions per minute(RPM) of specified disk path. Requires permission to open disk path(root user or disk group).

Possible values of rpm are:

   * -1(LSM_DISK_RPM_UNKNOWN):
       Unknown RPM.
   * 0(LSM_DISK_RPM_NON_ROTATING_MEDIUM):
       Non-rotating medium (e.g., SSD).

   * 1(LSM_DISK_RPM_ROTATING_UNKNOWN_SPEED):
       Rotational disk with unknown speed.
   * >1:
       Normal rotational disk (e.g., HDD).

Return

Error code as enumerated by 'lsm_error_number':
   * LSM_ERR_OK
       On success or not found.
   * LSM_ERR_INVALID_ARGUMENT
       When any argument is NULL
   * LSM_ERR_LIB_BUG
       When something unexpected happens.
   * LSM_ERR_NOT_FOUND_DISK
       When provided disk path not found.
   * LSM_ERR_PERMISSION_DENIED
       No sufficient permission to access provided disk path.

Info

July 2024 Libstoragemgmt C API Manual