listing for D
dlm_rd_detach - Detaches a process or process lock group from a recovery
Distributed Lock Manager Library (libdlm.a)
dlm_status_t dlm_rd_detach (
dlm_rd_flags_t detach_flag );
rd_id Specifies the recovery domain ID returned by a previous call to
Specifies flags that modify the operation. The detach_flag
parameter is a bit mask that is the logical OR of each bit set,
where each bit corresponds to an option.
The dlm_rd_flags_t structure defines a symbolic name for each
flag bit. Only one flag is currently defined:
Invalidates the recovery domain. This effectively makes
it appear that the value blocks of all resources
currently in the recovery domain are invalid, as well
as those of any resources that are subsequently added
to the recovery domain while the domain is invalid. To
validate a recovery domain, call the dlm_rd_collect()
and dlm_rd_validate() functions.
The dlm_rd_detach() function detaches a process from the clusterwide
recovery domain identified by the rd_id parameter. A process cannot detach
from a recovery domain if it owns locks or has yet to call
dlm_rd_validate() to validate a recovery domain collection created from a
prior call to the dlm_rd_collect() function.
To detach a process lock group from a recovery domain, each process in the
lock group must explicitly detach from the domain. Any of these processes
can specify the DLM_RD_INVALIDATE flag to invalidate the recovery domain.
Upon completion, the dlm_rd_detach() function call returns one of the
The process successfully detached from the recovery domain and,
if the DLM_RD_INVALIDATE flag was specified, all resources in the
recovery domain were invalidated.
The value of the rd_id parameter was out of the range for valid
resource domain IDs, or an invalid flag was specified.
The process owns a recovery domain collection handle that has not
yet been validated by a call to dlm_rd_validate.
The DLM is not enabled.
The process or the process lock group to which it belongs owns
locks on resources in the recovery domain.
No existing recovery domain corresponds to the value of the rd_id
The process is attempting to detach from a recovery domain owned
by a process lock group and it does not belong to that lock
The process has not yet called the dlm_nsjoin() function to
attach to a distributed lock manager (DLM) namespace, or the
process belongs to a process lock group and did not attach to the
group's recovery domain.
DLM library header file.
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_collect(3), dlm_rd_validate(3), dlm_set_signal(3),
TruCluster Server Cluster Highly Available Applications
listing for D