Index for Section 3

Alphabetical listing for D

Bottom of page

dlm_nsleave(3)
NAME
  dlm_nsleave - Disconnects the process from the specified resource namespace

LIBRARY
  Distributed Lock Manager Library (libdlm.a)

SYNOPSIS
  #include <sys/dlm.h>

  dlm_status_t dlm_nsleave (
	  dlm_nsp_t *nsp,
	  dlm_flags_t flags );

PARAMETERS
  nsp	    Specifies a handle that identifies the namespace.

  flags	    Specifies flags that modify the operation.	Because no flags are
	    currently defined for the dlm_nsleave() function, this parameter
	    should be zero (0).

DESCRIPTION
  The dlm_nsleave() function disconnects the process from the specified
  namespace.  The process must release its locks in the namespace and detach
  itself from any group lock container before leaving the namespace. Note
  that, if a process has joined the same namespace multiple times (by using
  the DLM_JOIN_SAME_OK flag in calls to the dlm_nsjoin() function), it needs
  to make only one call to the dlm_nsleave() function to disconnect from this
  namespace.

RETURN VALUES
  Upon completion, the dlm_nsleave() function returns one of the following
  values:

  DLM_SUCCESS
	    The process has been disconnected from the namespace.

  DLM_ATTACHEDGROUP
	    The process is attached to a group lock container that is
	    associated with this namespace, and it cannot be disconnected
	    from the namespace until it first detaches itself from the group
	    lock container.

  DLM_BADPARAM
	    Invalid input parameters were specified or flags were invalid.

  DLM_EFAULT
	    An error occurred in the copy operation to or from the
	    distributed lock manager's (DLM's) database.

  DLM_ENOSYS
	    The DLM is not enabled.

  DLM_HASLOCKS
	    The process cannot be disconnected from the namespace because it
	    still holds locks in the namespace.

  DLM_NOTATTACHED
	    The process has not joined the namespace identified by the nsp
	    parameter, or the nsp parameter is less than zero (0) or greater
	    than DLM_NSPROCMAX.

FILES
  /usr/include/sys/dlm.h
	    DLM library header file.

  /usr/examples/cluster/api_ex_master.c|api_ex_client.c
	    Source files for an example showing lock conversion and value
	    block usage.

RELATED INFORMATION
  Functions: dlm_cancel(3), dlm_cvt(3), dlm_detach(3), dlm_get_lkinfo(3),
  dlm_get_rsbinfo(3), dlm_glc_attach(3), dlm_glc_create(3),
  dlm_glc_detach(3), dlm_glc_destroy(3), dlm_lock(3), dlm_notify(3),
  dlm_nsjoin(3), dlm_perrno(3), dlm_quecvt(3), dlm_quelock(3),
  dlm_rd_attach(3), dlm_rd_collect(3), dlm_rd_detach(3), dlm_rd_validate(3),
  dlm_set_signal(3), dlm_unlock(3)

  File: dlm(4)

  TruCluster Server Cluster Highly Available Applications

Index for Section 3

Alphabetical listing for D

Top of page