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

dlm_set_signal(3)


NAME

  dlm_set_signal - Specifies the signal to be used by the distributed lock
  manager (DLM) for completion and blocking notification


LIBRARY

  Distributed Lock Manager Library (libdlm.a)


SYNOPSIS

  #include <sys/dlm.h>

  dlm_status_t dlm_set_signal (
	  int newsig,
	  int *oldsig );


PARAMETERS

  newsig    Specifies the signal to be used by the DLM for completion and
	    blocking notifications. If you specify a newsig value of 0
	    (zero), the DLM will not deliver event notifications and you must
	    use dlm_notify() to poll for them.

  oldsig    Specifies the previous signal used for notifications.  NULL
	    indicates none.


DESCRIPTION

  The dlm_set_signal() function tells the DLM which signal to use to indicate
  pending completion and blocking notifications. The DLM uses this signal to
  invoke an internal library routine that delivers the notifications to the
  application.	You must call the dlm_nsjoin() function to attach to a
  namespace before calling the dlm_set_signal function.	 Call the
  dlm_set_signal() function before making any lock requests.

  Regular signal rules apply to the new signal.	 If the signal is blocked,
  the DLM will not deliver blocking and completion notifications.


RETURN VALUES

  The dlm_set_signal() function returns one of the following values:

  DLM_SUCCESS
	    The function successfully completed.

  DLM_BADPARAM
	    An invalid signal was specified or the specified signal is out of
	    range.  SIGKILL and SIGSTOP are considered invalid signals
	    because they cannot be caught.  A signal is out of range when its
	    value is less than zero (0) or greater than SIGMAX as defined in
	    the /usr/include/sys/signal.h header file.

  DLM_EFAULT
	    An error occurred in the copy operation to or from the DLM
	    database.

  DLM_ENOSYS
	    The DLM is not enabled.

  DLM_NOTATTACHED
	    The process has not yet called the dlm_nsjoin function to attach
	    to a namespace.


FILES

  /usr/include/sys/signal.h
	    Signal value definition header file.

  /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_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_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