lsm_pool_member_info - Man Page

Retrieves the membership of given pool.

Synopsis

int lsm_pool_member_info (lsm_connect *conn, lsm_pool *pool, lsm_volume_raid_type *raid_type, lsm_pool_member_type *member_type, lsm_string_list **member_ids, lsm_flag flags);

Arguments

conn

Valid connection.

pool

The pointer of lsm_pool.

raid_type

lsm_volume_raid_type. Valid values are: LSM_VOLUME_RAID_TYPE_RAID0
  Stripe. LSM_VOLUME_RAID_TYPE_RAID1
  Two disks Mirror LSM_VOLUME_RAID_TYPE_RAID3
  Byte-level striping with dedicated parity LSM_VOLUME_RAID_TYPE_RAID4
  Block-level striping with dedicated parity LSM_VOLUME_RAID_TYPE_RAID5
  Block-level striping with distributed parity LSM_VOLUME_RAID_TYPE_RAID6
  Block-level striping with two distributed parities,
  aka, RAID-DP LSM_VOLUME_RAID_TYPE_RAID10
  Stripe of mirrors LSM_VOLUME_RAID_TYPE_RAID15
  Parity of mirrors LSM_VOLUME_RAID_TYPE_RAID16
  Dual parity of mirrors LSM_VOLUME_RAID_TYPE_RAID50
  Stripe of parities LSM_VOLUME_RAID_TYPE_RAID60
  Stripe of dual parities LSM_VOLUME_RAID_TYPE_RAID51
  Mirror of parities LSM_VOLUME_RAID_TYPE_RAID61
  Mirror of dual parities LSM_VOLUME_RAID_TYPE_JBOD
  Just bunch of disks, no parity, no striping. LSM_VOLUME_RAID_TYPE_UNKNOWN
  The plugin failed to detect the volume's RAID type. LSM_VOLUME_RAID_TYPE_MIXED
  This volume contains multiple RAID settings. LSM_VOLUME_RAID_TYPE_OTHER
  Vendor specific RAID type

member_type

lsm_pool_member_type. Valid values are: * LSM_POOL_MEMBER_TYPE_POOL
  Current pool(also known as sub-pool) is allocated from
  other pool(parent pool). The 'raid_type' will set to
  RAID_TYPE_OTHER unless certain RAID system support RAID
  using space of parent pools. * LSM_POOL_MEMBER_TYPE_DISK
  Pool is created from RAID group using whole disks. * LSM_POOL_MEMBER_TYPE_OTHER
  Vendor specific RAID member type. * LSM_POOL_MEMBER_TYPE_UNKNOWN
  Plugin failed to detect the RAID member type.

member_ids

Pointer of lsm_string_list. When 'member_type' is LSM_POOL_MEMBER_TYPE_POOL, the 'member_ids' will contain a list of parent Pool IDs. When 'member_type' is LSM_POOL_MEMBER_TYPE_DISK, the 'member_ids' will contain a list of disk IDs. When 'member_type' is LSM_POOL_MEMBER_TYPE_OTHER or LSM_POOL_MEMBER_TYPE_UNKNOWN, the member_ids should be NULL. Memory need to be freed via lsm_string_list_free.

flags

Reserved for future use, must be LSM_CLIENT_FLAG_RSVD.

Version

1.2.

Description

Retrieves the membership information of certain pool:
   RAID type, member type and member ids. Currently, LibStorageMgmt supports two types of pool: * Sub-pool -- LSM_POOL_MEMBER_TYPE_POOL
   Pool space is allocated from parent pool.
   Example:
       * NetApp ONTAP volume

* Disk RAID pool -- LSM_POOL_MEMBER_TYPE_DISK
   Pool is a RAID group assembled by disks.
   Example:
       * LSI MegaRAID disk group
       * EMC VNX pool
       * NetApp ONTAP aggregate

Capability

LSM_CAP_POOL_MEMBER_INFO

Return

Error code as enumerated by 'lsm_error_number'.
   * LSM_ERR_OK
       On success.
   * LSM_ERR_INVALID_ARGUMENT
       When any argument is NULL or invalid flags.
   * LSM_ERR_NO_SUPPORT
       Not supported.

Info

December 2020 Libstoragemgmt C API Manual