Index for Section 3

Alphabetical listing for D

Bottom of page

dlm_perrno(3)
NAME
  dlm_perrno, dlm_perror, dlm_sperrno - Obtains or prints message text
  associated with a distributed lock manager (DLM) message ID

LIBRARY
  Distributed Lock Manager Library (libdlm.a)

SYNOPSIS
  #include <sys/dlm.h>

  void dlm_perrno (
	  dlm_status_t stat );

  void dlm_perror (
	  char *s,
	  dlm_status_t stat );

  char * dlm_sperrno (
	  dlm_status_t stat );

PARAMETERS
  stat	    Specifies a DLM message ID.	 If there is no DLM message ID
	    associated with the supplied stat value, the dlm_sperrno()
	    function returns DLM_ILLEGAL_EEROR status, and the dlm_perrno()
	    and dlm_perror() functions print DLM_ILLEGAL_EEROR status to
	    stderr.

  s	    Specifies a user-defined character string to print along with the
	    DLM message text.

DESCRIPTION
  Most DLM functions return completion status in a message ID of the
  dlm_status_t data type.  To print the message text associated with this
  message ID to stderr, supply the ID as an input parameter to either the
  dlm_perrno() or dlm_perror() function.  You can provide an additional
  string to the dlm_perror() function, and it will print both the additional
  string and DLM message text.

  Use the dlm_sperrno() function to obtain the character string associated
  with a DLM message string and store it in a variable.

RETURN VALUES
  Upon completion, the dlm_sperrno() function returns an ASCII string
  representing the DLM error associated with the stat parameter.

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_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_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 for Section 3

Alphabetical listing for D

Top of page