DLM_CREATE_LOCKSPACE

NAME

SYNOPSIS

 #include <libdlm.h>

dlm_lshandle_t dlm_create_lockspace(const char *name, mode_t mode);
dlm_lshandle_t dlm_new_lockspace(const char *name, mode_t mode,
                                 uint32_t flags);
dlm_lshandle_t dlm_open_lockspace(const char *name);
int dlm_close_lockspace(dlm_lshandle_t ls);
int dlm_release_lockspace(const char *name, dlm_lshandle_t ls,
                          int force);

DESCRIPTION

Many of the DLM calls work on the "default" lockspace, which should be fine for most users. The calls with _ls_ in them allow you to isolate your application from all others running in the cluster. Remember, lockspaces are a cluster-wide resource, so if you create a lockspace called "myls" it will share locks with a lockspace called "myls" on all nodes. These calls allow users to create & remove lockspaces, and users to connect to existing lockspace to store their locks there.

dlm_lshandle_t dlm_create_lockspace(const char *name, mode_t mode);

Return codes: 0 is returned if the call completed successfully. If not, -1 is returned and errno is set to one of the following:

EINVAL          An invalid parameter was passed to the call
ENOMEM          A (kernel) memory allocation failed
EEXIST          The lockspace already exists
EPERM           Process does not have capability to create lockspaces
ENOSYS          A fatal error occurred initializing the DLM
Any error returned by the open() system call

int dlm_new_lockspace(const char *name, mode_t mode, uint32_t flags)

Performs the same function as dlm_create_lockspace() above, but passes some creation flags to the call that affect the lockspace being created. Currently supported flags are:

DLM_LSFL_NODIR    the lockspace should not use a resource directory
DLM_LSFL_TIMEWARN the dlm should emit warnings over netlink when locks
                  have been waiting too long; required for deadlock
                  detection

int dlm_release_lockspace(const char *name, dlm_lshandle_t ls, int force)

Deletes a lockspace. If the lockspace still has active locks then -1 will be returned and errno set to EBUSY. Both the lockspace handle /and/ the name must be specified. This call also closes the lockspace and stops the thread associated with the lockspace, if any.
Note that other nodes in the cluster may still have locks open on this lockspace. This call only removes the lockspace from the current node. If the force flag is set then the lockspace will be removed even if another user on this node has active locks in it. Existing users will NOT be notified if you do this, so be careful.
The caller must have CAP_SYSADMIN privileges to do this operation.

Return codes: 0 is returned if the call completed successfully. If not, -1 is returned and errno is set to one of the following:

EINVAL          An invalid parameter was passed to the call
EPERM           Process does not have capability to release lockspaces
EBUSY           The lockspace could not be freed because it still
                contains locks and force was not set.

dlm_lshandle_t dlm_open_lockspace(const char *name)

Opens an already existing lockspace and returns a handle to it.

Return codes: 0 is returned if the call completed successfully. If not, -1 is returned and errno is set to an error returned by the open() system call  

int dlm_close_lockspace(dlm_lshandle_t ls)

Return codes: 0 is returned if the call completed successfully. If not, -1 is returned and errno is set to one of the following:

EINVAL          lockspace was not a valid lockspace handle

SEE ALSO

libdlm(3), dlm_unlock(3), dlm_lock(3),

Index

NAME

SYNOPSIS

DESCRIPTION

dlm_lshandle_t dlm_create_lockspace(const char *name, mode_t mode);

int dlm_new_lockspace(const char *name, mode_t mode, uint32_t flags)

int dlm_release_lockspace(const char *name, dlm_lshandle_t ls, int force)

dlm_lshandle_t dlm_open_lockspace(const char *name)

int dlm_close_lockspace(dlm_lshandle_t ls)

SEE ALSO