1lsm_access_group_create(3)Libstoragemgmt C API Manuallsm_access_group_create(3)
2
3
4
6 lsm_access_group_create - Create a new access group.
7
9 int lsm_access_group_create (lsm_connect *conn, const char *name, const
10 char *init_id, lsm_access_group_init_type init_type, lsm_system *sys‐
11 tem, lsm_access_group **access_group, lsm_flag flags);
12
14 conn Valid lsm_connect pointer.
15
16 name String. Human recognizable name, might be altered or
17 ignored by certain storage system.
18
19 init_id String. Initiator id to be added to group.
20
21 init_type lsm_access_group_init_type. Valid initiator types are: *
22 LSM_ACCESS_GROUP_INIT_TYPE_ISCSI_IQN
23 iSCSI IQN. * LSM_ACCESS_GROUP_INIT_TYPE_WWPN
24 FC WWPN
25
26 system Pointer of lsm_system to create access group for.
27
28 access_group
29 Output pointer of newly created lsm_access_group. Returned
30 value must be freed with function
31 lsm_access_group_record_free.
32
33 flags Reserved for future use, must be LSM_CLIENT_FLAG_RSVD.
34
36 1.0
37
39 Creates a new access group with one initiator in it. You may expand the
40 access group by adding more initiators via lsm_access_group_initia‐
41 tor_add.
42
44 LSM_CAP_ACCESS_GROUP_CREATE_WWPN LSM_CAP_ACCESS_GROUP_CREATE_ISCSI_IQN
45
47 Error code as enumerated by 'lsm_error_number'.
48 * LSM_ERR_OK
49 On success.
50 * LSM_ERR_INVALID_ARGUMENT
51 When any argument is NULL or invalid flags or invalid system
52 pointer or invalid init_type or illegal initiator ID string.
53 * LSM_ERR_NO_SUPPORT
54 Not supported.
55 * LSM_ERR_NOT_FOUND_SYSTEM
56 When the specified system does not exist.
57
58
59
60April 2019 lsm_access_group_create lsm_access_group_create(3)