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

dlm_glc_attach(3)


NAME

  dlm_glc_attach - Attaches the calling process to an existing group lock
  container


LIBRARY

  Distributed Lock Manager Library (libdlm.a)


SYNOPSIS

  #include <sys/dlm.h>

  dlm_status_t dlm_glc_attach (
	   dlm_glc_id_t id,
	   dlm_glc_flags_t flags );


PARAMETERS

  id	    Handle to the group lock container to which the caller is to be
	    attached. The group lock container ID is returned by a previous
	    call to dlm_glc_create.

  flags	    When provided, specifies flags that modify the operation. The
	    flags parameter is a bit mask that is the logical OR of each bit
	    set, where each bit corresponds to an option. No flags are
	    currently defined.


DESCRIPTION

  The dlm_glc_attach() function attaches the calling process to the specified
  group lock container. The process must have previously attached to all of
  the namespaces to which the group lock container was associated when it was
  created. Use the dlm_locktp() or dlm_quelocktp() function with the
  DLM_GROUP_LOCK flag to create new group locks in the container.

  Locks currently owned by the process are not affected by the
  dlm_glc_attach() operation.

  When a process attaches to a group lock container, it becomes a member of
  the process lock group and obtains the right to manipulate any lock that is
  associated with that container.  A group lock can be manipulated by only
  one group member at a time, although one member can cancel or dequeue
  another member's request for group locks in that container. A process can
  attach to only one group lock container at a time.


RETURN VALUES

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

  DLM_SUCCESS
	    The operation was completed successfully.

  DLM_ATTACHED
	    The process is already attached to a group lock container.

  DLM_BADPARAM
	    Illegal flags were specified.

  DLM_ENOENT
	    The specified group lock container does not exist.

  DLM_ENOSYS
	    The DLM is not enabled.

  DLM_NOTATTACHED
	    The process is not attached to the distributed lock manager (DLM)
	    or to one of the namespaces to which the group lock container is
	    associated.


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_detach(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