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

dlm_rd_validate(3)


NAME

  dlm_rd_validate - Completes the recovery procedure for a specified recovery
  domain by validating the resources in the specified recovery domain
  collection


LIBRARY

  Distributed Lock Manager Library (libdlm.a)


SYNOPSIS

  #include <sys/dlm.h>

  dlm_status_t dlm_rd_validate (
	   dlm_rd_id_t rd_id,
	   dlm_rd_collection_hndl_t * hndl_p,
	   dlm_rd_flags_t validate_flag );


PARAMETERS

  rd_id	    Specifies the recovery domain ID returned by a previous call to
	    dlm_rd_attach.

  hndl_p    Specifies a pointer to a recovery domain collection handle
	    returned by a previous dlm_rd_collect function call.

  validate_flag
	    Reserved by Compaq for future use. This parameter must be zero
	    (0).


DESCRIPTION

  The dlm_rd_validate() function completes the recovery procedure for a
  specified recovery domain by validating the value blocks of the resources
  in the collection identified by the hndl_p parameter, and reinitializing
  the value blocks to zero (0).

  If any other resource in the recovery domain has become persistent (as
  described in dlm_rd_attach(3)) since the collection handle was returned by
  the dlm_rd_collect() call, dlm_rd_validate() returns the status
  DLM_MORE_TO_RECOVER. It also returns this status value after the failure of
  any cluster member system that had a process or process lock group attached
  to the recovery domain. Otherwise, it marks the state of the recovery
  domain as recovered and returns with DLM_SUCCESS status.


RETURN VALUES

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

  DLM_SUCCESS
	    The value blocks of resources in the recovery domain collection
	    were successfully validated and reinitialized. The distributed
	    lock manager (DLM) marks the recovery domain's state as
	    recovered.

  DLM_MORE_TO_RECOVER
	    The value blocks of resources in the recovery domain collection
	    were successfully validated and reinitialized. However, the value
	    block of one or more resources in the recovery domain has become
	    invalid since the recovery domain collection handle supplied in
	    the call was returned by the dlm_rd_collect() function, or a
	    cluster member system, which had a process or process lock group
	    attached to the recovery domain, failed.

  DLM_BADPARAM
	    The value of the rd_id was out of the range for valid resource
	    domain IDs, the hndl_p parameter does not correspond to an
	    existing collection, or the validate_flag flag was nonzero.

  DLM_EFAULT
	    The hndl_p parameter points to an invalid memory location.

  DLM_ENOSYS
	    The DLM is not enabled.

  DLM_IVRDID
	    No existing recovery domain corresponds to the value of the rd_id
	    parameter.

  DLM_IVHNDL
	    The hndl_p parameter is invalid.

  DLM_NO_GROUP
	    The rd_id parameter is a recovery domain ID owned by a process
	    lock group to which the process does not belong.

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


FILES

  /usr/include/sys/dlm.h
	    DLM library header file.


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_detach(3), dlm_rd_collect(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