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

NAME

6       lsm_volume_resize - Resize an existing volume.
7

SYNOPSIS

9       int  lsm_volume_resize (lsm_connect *conn, lsm_volume *volume, uint64_t
10       new_size, lsm_volume **resized_volume, char **job, lsm_flag flags);
11

ARGUMENTS

13       conn        Valid lsm_connect pointer.
14
15       volume      lsm_volume. Volume to re-size
16
17       new_size    uint64_t. New size of volume in bytes, actual size might be
18                   bigger  than  requested and will be based on array rounding
19                   to block size,
20
21       resized_volume
22                   Output pointer of updated  lsm_volume.  Might  be  NULL  if
23                   storage system support asynchronous action on this.  Memory
24                   must be freed with a call to lsm_volume_record_free.
25
26       job         Output pointer of string. If storage system  support  asyn‐
27                   chronous action on this, a job will be created and could be
28                   tracked via lsm_job_status_volume_get. NULL if storage sys‐
29                   tem does not support asynchronous action on this.
30
31       flags       Reserved for future use, must be LSM_CLIENT_FLAG_RSVD.
32

VERSION

34       1.0
35

DESCRIPTION

37       Resize  the specified volume.  Some pool might not allow volume resize,
38       please  check  lsm_pool_unsupported_actions_get   for   LSM_POOL_UNSUP‐
39       PORTED_VOLUME_GROW and LSM_POOL_UNSUPPORTED_VOLUME_SHRINK before invok‐
40       ing this function.
41

CAPABILITY

43       LSM_CAP_VOLUME_RESIZE
44

RETURN

46       Error code as enumerated by 'lsm_error_number'.
47           * LSM_ERR_OK
48               On success.
49           * LSM_ERR_JOB_STARTED
50               A job is started. Please check the 'job' output pointer.
51           * LSM_ERR_INVALID_ARGUMENT
52               When any argument is NULL or not a valid lsm_connect pointer
53               or invalid flags.
54           * LSM_ERR_NOT_FOUND_POOL
55               When pool not found.
56           * LSM_ERR_NOT_FOUND_VOLUME
57               When volume not found.
58           * LSM_ERR_NOT_ENOUGH_SPACE
59               Pool does not have enough space.
60           * LSM_ERR_POOL_NOT_READY
61               Pool is not ready for volume resizing.
62           * LSM_ERR_NO_STATE_CHANGE
63               Requested size if identical to current size.
64           * LSM_ERR_NO_SUPPORT
65               Not supported.
66
67
68
69November 2021                  lsm_volume_resize          lsm_volume_resize(3)
Impressum