1lsm_volume_replicate_range(L3i)bstoragemgmt C API Manlusaml_volume_replicate_range(3)
2
3
4

NAME

6       lsm_volume_replicate_range - Replicates a portion of a volume to a vol‐
7       ume.
8

SYNOPSIS

10       int lsm_volume_replicate_range (lsm_connect *conn, lsm_replication_type
11       rep_type,   lsm_volume   *source,   lsm_volume  *dest,  lsm_block_range
12       **ranges, uint32_t num_ranges, char **job, lsm_flag flags);
13

ARGUMENTS

15       conn        Valid connection.
16
17       rep_type    lsm_replication_type. Valid values are: * LSM_VOLUME_REPLI‐
18                   CATE_CLONE
19                      Point in time read writeable space efficient copy of
20                      data.  Also know as read writeable snapshot.  * LSM_VOL‐
21                   UME_REPLICATE_COPY
22                      Full bitwise copy of the data (occupies full space).
23
24       source      Pointer of replication source lsm_volume.
25
26       dest        Pointer of replication target lsm_volume. Could be the same
27                   as source.
28
29       ranges      Array       of       lsm_block_range.       Please      use
30                   lsm_block_range_record_array_alloc                      and
31                   lsm_block_range_record_alloc to create it.
32
33       num_ranges  uint32_t. Number of entries in ranges.
34
35       job         Output  pointer  of string. If storage system support asyn‐
36                   chronous action on this, a job will be created and could be
37                   tracked via lsm_job_status_get. NULL if storage system does
38                   not support asynchronous action on this.
39
40       flags       Reserved for future use, must be LSM_CLIENT_FLAG_RSVD.
41

VERSION

43       1.0
44

DESCRIPTION

46       Replicates a portion of specified source volume to target volume.
47

CAPABILITY

49       LSM_CAP_VOLUME_COPY_RANGE LSM_CAP_VOLUME_COPY_RANGE_CLONE  LSM_CAP_VOL‐
50       UME_COPY_RANGE_COPY
51

RETURN

53       Error code as enumerated by 'lsm_error_number'.
54           * LSM_ERR_OK
55               On success.
56           * LSM_ERR_JOB_STARTED
57               A job is started. Please check the 'job' output pointer.
58           * LSM_ERR_INVALID_ARGUMENT
59               When any argument is NULL or not a valid lsm_connect pointer
60               or invalid flags or invalid replication type.
61           * LSM_ERR_NOT_FOUND_VOLUME
62               When volume not found.
63           * LSM_ERR_NOT_FOUND_POOL
64               When pool not found.
65           * LSM_ERR_POOL_NOT_READY
66               Pool is not ready.
67           * LSM_ERR_NO_SUPPORT
68               Not supported.
69
70
71
72February 2020             lsm_volume_replicate_ranlgsem_volume_replicate_range(3)
Impressum