1lsm_pool_member_info(3) Libstoragemgmt C API Manual lsm_pool_member_info(3)
2
6 lsm_pool_member_info - Retrieves the membership of given pool.
7
9 int lsm_pool_member_info (lsm_connect *conn, lsm_pool *pool, lsm_vol‐
10 ume_raid_type *raid_type, lsm_pool_member_type *member_type,
11 lsm_string_list **member_ids, lsm_flag flags);
12
14 conn Valid connection.
15 pool The pointer of lsm_pool.
17 raid_type lsm_volume_raid_type. Valid values are: LSM_VOL‐
19 UME_RAID_TYPE_RAID0
20 Stripe. LSM_VOLUME_RAID_TYPE_RAID1
21 Two disks Mirror LSM_VOLUME_RAID_TYPE_RAID3
22 Byte-level striping with dedicated parity LSM_VOL‐
23 UME_RAID_TYPE_RAID4
24 Block-level striping with dedicated parity LSM_VOL‐
25 UME_RAID_TYPE_RAID5
26 Block-level striping with distributed parity LSM_VOL‐
27 UME_RAID_TYPE_RAID6
28 Block-level striping with two distributed parities,
29 aka, RAID-DP LSM_VOLUME_RAID_TYPE_RAID10
30 Stripe of mirrors LSM_VOLUME_RAID_TYPE_RAID15
31 Parity of mirrors LSM_VOLUME_RAID_TYPE_RAID16
32 Dual parity of mirrors LSM_VOLUME_RAID_TYPE_RAID50
33 Stripe of parities LSM_VOLUME_RAID_TYPE_RAID60
34 Stripe of dual parities LSM_VOLUME_RAID_TYPE_RAID51
35 Mirror of parities LSM_VOLUME_RAID_TYPE_RAID61
36 Mirror of dual parities LSM_VOLUME_RAID_TYPE_JBOD
37 Just bunch of disks, no parity, no striping. LSM_VOL‐
38 UME_RAID_TYPE_UNKNOWN
39 The plugin failed to detect the volume's RAID type.
40 LSM_VOLUME_RAID_TYPE_MIXED
41 This volume contains multiple RAID settings. LSM_VOL‐
42 UME_RAID_TYPE_OTHER
43 Vendor specific RAID type
44 member_type lsm_pool_member_type. Valid values are: * LSM_POOL_MEM‐
46 BER_TYPE_POOL
47 Current pool(also known as sub-pool) is allocated from
48 other pool(parent pool). The 'raid_type' will set to
49 RAID_TYPE_OTHER unless certain RAID system support RAID
50 using space of parent pools. * LSM_POOL_MEM‐
51 BER_TYPE_DISK
52 Pool is created from RAID group using whole disks. *
53 LSM_POOL_MEMBER_TYPE_OTHER
54 Vendor specific RAID member type. * LSM_POOL_MEM‐
55 BER_TYPE_UNKNOWN
56 Plugin failed to detect the RAID member type.
57 member_ids Pointer of lsm_string_list. When 'member_type' is
59 LSM_POOL_MEMBER_TYPE_POOL, the 'member_ids' will contain a
60 list of parent Pool IDs. When 'member_type' is
61 LSM_POOL_MEMBER_TYPE_DISK, the 'member_ids' will contain a
62 list of disk IDs. When 'member_type' is LSM_POOL_MEM‐
63 BER_TYPE_OTHER or LSM_POOL_MEMBER_TYPE_UNKNOWN, the mem‐
64 ber_ids should be NULL. Memory need to be freed via
65 lsm_string_list_free.
66 flags Reserved for future use, must be LSM_CLIENT_FLAG_RSVD.
68
70 1.2.
71
73 Retrieves the membership information of certain pool:
74 RAID type, member type and member ids. Currently, LibStorageMgmt
75 supports two types of pool: * Sub-pool -- LSM_POOL_MEMBER_TYPE_POOL
76 Pool space is allocated from parent pool.
77 Example:
78 * NetApp ONTAP volume
79 * Disk RAID pool -- LSM_POOL_MEMBER_TYPE_DISK
81 Pool is a RAID group assembled by disks.
82 Example:
83 * LSI MegaRAID disk group
84 * EMC VNX pool
85 * NetApp ONTAP aggregate
86
88 LSM_CAP_POOL_MEMBER_INFO
89
91 Error code as enumerated by 'lsm_error_number'.
92 * LSM_ERR_OK
93 On success.
94 * LSM_ERR_INVALID_ARGUMENT
95 When any argument is NULL or invalid flags.
96 * LSM_ERR_NO_SUPPORT
97 Not supported.
98February 2020 lsm_pool_member_info lsm_pool_member_info(3)