Index for Section 3

Alphabetical listing for D

Bottom of page

dlm_detach(3)
NAME
  dlm_detach - Detaches from all resource namespaces (provided on Production
  Server configurations only)

LIBRARY
  Distributed Lock Manager Library (libdlm.a)

SYNOPSIS
  #include <sys/dlm.h>

  dlm_status_t dlm_detach (
	  void );

DESCRIPTION
  The dlm_detach function disconnects a process from all resource namespaces
  to which it is currently attached.  (An implicit attach operation is
  performed each time a process calls the dlm_nsjoin function to join a
  namespace.)

  A process typically calls the dlm_detach function to perform an exec call.
  Because an exec call writes over a process's address space, all lock
  information involving process address (such as the location of a blocking
  notification routine) becomes invalid at the time of the exec call.  For
  this reason, the distributed lock manager (DLM) fails a process's exec
  calls while the process holds locks and is attached to namespaces.

  A process calls the dlm_detach function after it has released all its
  locks.   At a successful call to dlm_detach, the DLM releases all resources
  it has allocated to the process.  The process is then free to perform an
  exec call.

RETURN VALUES
  Upon completion, the dlm_detach function  returns one of the following
  values:

  DLM_SUCCESS
	    The process has been successfully disconnected from all
	    namespaces.

  DLM_ENOSYS
	    The lock subsystem is not enabled.

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

  DLM_NOTATTACHED
	    The process is not currently attached to any namespaces.

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_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_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 Software Production Server Application Programming Interfaces

Index for Section 3

Alphabetical listing for D

Top of page