Scroll to navigation

lsm_fs_create(3) Libstoragemgmt C API Manual lsm_fs_create(3)

NAME

lsm_fs_create - Creates a new file system

SYNOPSIS

int lsm_fs_create (lsm_connect *conn, lsm_pool *pool, const char *name, uint64_t size_bytes, lsm_fs **fs, char **job, lsm_flag flags);

ARGUMENTS

Valid connection.
Pointer of lsm_pool.
String. Human recognizable name, might be altered or ignored by certain storage system.
uint64_t. Size of new file system in bytes, actual size might be bigger than requested and will be based on array rounding to block size,
Output pointer of lsm_fs. Will be NULL if storage system support asynchronous action on this. Returned value must be freed with 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

Creates a new file system for NFS or CIFS share.

CAPABILITY

LSM_CAP_FS_CREATE

RETURN

LSM_ERR_OK on success, LSM_ERR_JOB_STARTED if async. ,
* 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_POOL
When pool not found.
* LSM_ERR_NOT_ENOUGH_SPACE
Pool does not have enough space.
* LSM_ERR_POOL_NOT_READY
Pool is not ready for file system creation.
* LSM_ERR_NO_SUPPORT
Not supported.

lsm_fs_create May 2019