Index Index for
Section 3
Index Alphabetical
listing for D
Bottom of page Bottom of
page		 

dlm_glc_detach(3)


NAME

  dlm_glc_detach - Detach the calling process from a group lock container


LIBRARY

  Distributed Lock Manager Library (libdlm.a)


SYNOPSIS

  #include <sys/dlm.h>

  dlm_status_t dlm_glc_detach_t (
	   void );


DESCRIPTION

  The dlm_glc_detach() function detaches the calling process from a group
  lock container.

  Any granted or converting group locks that the process is manipulating, at
  the time of its dlm_glc_detach() call, are moved to the queue of group
  locks that are not currently being manipulated by a process.	Any
  completion or blocking notifications pending on these locks are canceled.
  Waiting locks are returned to the process; converting locks are regranted
  at the previous granted mode.

  If the caller of dlm_glc_detach() was the last process attached to the
  group lock container, and the container was not marked as permanent, the
  container itself is destroyed and any remaining group locks in it are
  released.  If the calling process created the group lock container and
  specified the DLM_GLC_OWNED flag at the time of its creation, the container
  is destroyed, the remaining group locks are released, and all processes
  currently attached to the group lock container are killed.


RETURN VALUES

  Upon completion, the dlm_glc_detach() function call returns one of the
  following values:

  DLM_SUCCESS
	    The operation was completed successfully.

  DLM_ATTACHED
	    The calling process is still attached to a recovery domain on
	    behalf of the process lock group. It must call the
	    dlm_rd_detach() function specifying the recovery domain ID.

  DLM_ENOSYS
	    The DLM is disabled.

  DLM_KILLFAIL
	    The owner of the group lock container detached from the
	    container, but, while the container was being destroyed, a
	    process attached to the group lock container could not be killed.
	    Some processes may have been killed but no group locks have been
	    released.

  DLM_NOTATTACHED
	    The process is not attached to the distributed lock manager (DLM)
	    or to a group lock container.


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_create(3), dlm_glc_attach(3),
  dlm_glc_destroy(3), dlm_lock(3), dlm_notify(3), dlm_nsjoin(3),
  dlm_nsleave(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 Index for
Section 3
Index Alphabetical
listing for D
Top of page Top of
page