1lsm_volume_replicate_range(L3i)bstoragemgmt C API Manlusaml_volume_replicate_range(3)
2
3
4
6 lsm_volume_replicate_range - Replicates a portion of a volume to a vol‐
7 ume.
8
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
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
43 1.0
44
46 Replicates a portion of specified source volume to target volume.
47
49 LSM_CAP_VOLUME_COPY_RANGE LSM_CAP_VOLUME_COPY_RANGE_CLONE LSM_CAP_VOL‐
50 UME_COPY_RANGE_COPY
51
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
72April 2019 lsm_volume_replicate_ranlgsem_volume_replicate_range(3)