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

NAME

6       lsm_fs_create - Creates a new file system
7

SYNOPSIS

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

ARGUMENTS

13       conn        Valid connection.
14
15       pool        Pointer of lsm_pool.
16
17       name        String. Human recognizable name, might be  altered  or  ig‐
18                   nored by certain storage system.
19
20       size_bytes  uint64_t.  Size  of  new  file system in bytes, actual size
21                   might be bigger than requested and will be based  on  array
22                   rounding to block size,
23
24       fs          Output  pointer  of  lsm_fs. Will be NULL if storage system
25                   support asynchronous action on this.  Returned  value  must
26                   be freed with lsm_fs_record_free.
27
28       job         Output  pointer  of string. If storage system support asyn‐
29                   chronous action on this, a job will be created and could be
30                   tracked  via lsm_job_status_fs_get.  NULL if storage system
31                   does not support asynchronous action on this.
32
33       flags       Reserved for future use, must be LSM_CLIENT_FLAG_RSVD.
34

VERSION

36       1.0
37

DESCRIPTION

39       Creates a new file system for NFS or CIFS share.
40

CAPABILITY

42       LSM_CAP_FS_CREATE
43

RETURN

45       LSM_ERR_OK on success, LSM_ERR_JOB_STARTED if async. ,
46           * LSM_ERR_OK
47               On success.
48           * LSM_ERR_JOB_STARTED
49               A job is started. Please check the 'job' output pointer.
50           * LSM_ERR_INVALID_ARGUMENT
51               When any argument is NULL or not a valid lsm_connect pointer
52               or invalid flags.
53           * LSM_ERR_NOT_FOUND_POOL
54               When pool not found.
55           * LSM_ERR_NOT_ENOUGH_SPACE
56               Pool does not have enough space.
57           * LSM_ERR_POOL_NOT_READY
58               Pool is not ready for file system creation.
59           * LSM_ERR_NO_SUPPORT
60               Not supported.
61
62
63
64November 2021                    lsm_fs_create                lsm_fs_create(3)
Impressum