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

NAME

6       lsm_fs_clone - Clones an existing file system
7

SYNOPSIS

9       int  lsm_fs_clone (lsm_connect *conn, lsm_fs *src_fs, const char *name,
10       lsm_fs_ss  *optional_ss,  lsm_fs  **cloned_fs,  char  **job,   lsm_flag
11       flags);
12

ARGUMENTS

14       conn        Valid connection.
15
16       src_fs      Pointer of lsm_fs for source file system.
17
18       name        String.  Human recognizable name for new file system, might
19                   be altered or ignored by certain storage system.
20
21       optional_ss Pointer of lsm_fs_ss. File system snapshot  to  base  clone
22                   from.  Set to NULL of not needed..
23
24       cloned_fs   Output  pointer  of lsm_fs for the newlly created file sys‐
25                   tem.  Will be NULL if storage system  support  asynchronous
26                   action  on  this.  Returned value must be freed with a call
27                   to lsm_fs_record_free.
28
29       job         Output pointer of string. If storage system  support  asyn‐
30                   chronous action on this, a job will be created and could be
31                   tracked via lsm_job_status_fs_get. NULL if  storage  system
32                   does not support asynchronous action on this.
33
34       flags       Reserved for future use, must be LSM_CLIENT_FLAG_RSVD.
35

VERSION

37       1.0
38

DESCRIPTION

40       Create a point in time read writeable space efficient copy of specified
41       file system, also know as read writeable snapshot.  The new file system
42       will reside in the same pool of specified file system.
43

CAPABILITY

45       LSM_CAP_FS_CLONE
46

RETURN

48       Error code as enumerated by 'lsm_error_number'.
49           * LSM_ERR_OK
50               On success.
51           * LSM_ERR_JOB_STARTED
52               A job is started. Please check the 'job' output pointer.
53           * LSM_ERR_INVALID_ARGUMENT
54               When any argument is NULL or not a valid lsm_connect pointer
55               or invalid flags.
56           * LSM_ERR_NOT_FOUND_FS
57               When file system 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.
62           * LSM_ERR_NO_SUPPORT
63               Not supported.
64
65
66
67May 2021                         lsm_fs_clone                  lsm_fs_clone(3)
Impressum