Scroll to navigation

lsm_fs_clone(3) Libstoragemgmt C API Manual lsm_fs_clone(3)

NAME

lsm_fs_clone - Clones an existing file system

SYNOPSIS

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

ARGUMENTS

Valid connection.
Pointer of lsm_fs for source file system.
String. Human recognizable name for new file system, might be altered or ignored by certain storage system.
Pointer of lsm_fs_ss. File system snapshot to base clone from. Set to NULL of not needed..
Output pointer of lsm_fs for the newlly created file system. Will be NULL if storage system support asynchronous action on this. Returned value must be freed with a call to lsm_fs_record_free.
Output pointer of string. If storage system support asynchronous action on this, a job will be created and could be tracked via lsm_job_status_fs_get. NULL if storage system does not support asynchronous action on this.
Reserved for future use, must be LSM_CLIENT_FLAG_RSVD.

VERSION

1.0

DESCRIPTION

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

CAPABILITY

LSM_CAP_FS_CLONE

RETURN

Error code as enumerated by 'lsm_error_number'.
* LSM_ERR_OK
On success.
* LSM_ERR_JOB_STARTED
A job is started. Please check the 'job' output pointer.
* LSM_ERR_INVALID_ARGUMENT
When any argument is NULL or not a valid lsm_connect pointer
or invalid flags.
* LSM_ERR_NOT_FOUND_FS
When file system not found.
* LSM_ERR_NOT_ENOUGH_SPACE
Pool does not have enough space.
* LSM_ERR_POOL_NOT_READY
Pool is not ready.
* LSM_ERR_NO_SUPPORT
Not supported.

lsm_fs_clone May 2019