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

dlm_detach(3)


NAME

  dlm_detach - Detaches from all resource namespaces


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 DLM 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 Server Cluster Highly Available Applications

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