1lsm_pool_member_info(3)   Libstoragemgmt C API Manual  lsm_pool_member_info(3)
2
3
4

NAME

6       lsm_pool_member_info - Retrieves the membership of given pool.
7

SYNOPSIS

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

ARGUMENTS

14       conn        Valid connection.
15
16       pool        The pointer of lsm_pool.
17
18       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
45       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
58       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
67       flags       Reserved for future use, must be LSM_CLIENT_FLAG_RSVD.
68

VERSION

70       1.2.
71

DESCRIPTION

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
80       * 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

CAPABILITY

88       LSM_CAP_POOL_MEMBER_INFO
89

RETURN

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.
98
99
100
101February 2019                lsm_pool_member_info      lsm_pool_member_info(3)
Impressum