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

NAME

6       lsm_volume_create - Creates a new volume
7

SYNOPSIS

9       int  lsm_volume_create  (lsm_connect  *conn, lsm_pool *pool, const char
10       *volume_name, uint64_t  size,  lsm_volume_provision_type  provisioning,
11       lsm_volume **new_volume, char **job, lsm_flag flags);
12

ARGUMENTS

14       conn        Valid lsm_connect pointer.
15
16       pool        Pointer of lsm_pool.
17
18       volume_name String.  Human  recognizable  name, might be altered or ig‐
19                   nored by certain storage systems.
20
21       size        uint64_t. Size of new volume in bytes, actual size might be
22                   bigger  than  requested and will be based on array rounding
23                   to block size,
24
25       provisioning
26                   lsm_volume_provision_type. Type of volume  provisioning  to
27                   use. Valid values are: * LSM_VOLUME_PROVISION_DEFAULT
28                      Let  storage  system  to  decided.   * LSM_VOLUME_PROVI‐
29                   SION_FULL
30                      Create new fully allocated volume.  *  LSM_VOLUME_PROVI‐
31                   SION_THIN
32                      Create new thin provisioning volume.
33
34       new_volume  Output  pointer of lsm_volume. Will be NULL if storage sys‐
35                   tem support asynchronous action on this.   Memory  must  be
36                   freed with a call to lsm_volume_record_free.
37
38       job         Output  pointer  of string. If storage system support asyn‐
39                   chronous action on this, a job will be created and could be
40                   tracked  via  lsm_job_status_volume_get.   NULL  if storage
41                   system does not support asynchronous action on this.
42
43       flags       Reserved for future use, must be LSM_CLIENT_FLAG_RSVD.
44

VERSION

46       1.0
47

DESCRIPTION

49       Creates a new volume(also known as LUN).
50

CAPABILITY

52       LSM_CAP_VOLUME_CREATE
53

RETURN

55       Error code as enumerated by 'lsm_error_number'.
56           * LSM_ERR_OK
57               On success.
58           * LSM_ERR_JOB_STARTED
59               A job is started. Please check the 'job' output pointer.
60           * LSM_ERR_INVALID_ARGUMENT
61               When any argument is NULL or not a valid lsm_connect pointer
62               or invalid flags or invalid provisioning type.
63           * LSM_ERR_NOT_FOUND_POOL
64               When pool not found.
65           * LSM_ERR_NOT_ENOUGH_SPACE
66               Pool does not have enough space.
67           * LSM_ERR_POOL_NOT_READY
68               Pool is not ready for volume creation.
69           * LSM_ERR_NO_SUPPORT
70               Not supported.
71
72
73
74April 2023                     lsm_volume_create          lsm_volume_create(3)
Impressum