Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

dat_cno_free(3dat) [opensolaris man page]

dat_cno_free(3DAT)				     Direct Access Transport Library Functions					dat_cno_free(3DAT)

NAME
dat_cno_free - destroy an instance of the CNO SYNOPSIS
cc [ flag... ] file... -ldat [ library... ] #include <dat/udat.h> DAT_RETURN dat_cno_free ( IN DAT_CNO_HANDLE cno_handle ) PARAMETERS
cno_handle Handle for an instance of the CNO DESCRIPTION
The dat_cno_free() function destroys a specified instance of the CNO. A CNO cannot be deleted while it is referenced by an Event Dispatcher or while a thread is blocked on it. RETURN VALUES
DAT_SUCCESS The operation was successful. DAT_INVALID_HANDLE The cno_handle() parameter is invalid. DAT_INVALID_STATE Parameter in an invalid state. CNO is in use by an EVD instance or there is a thread blocked on it. USAGE
If there is a thread blocked in dat_cno_wait(3DAT), the Consumer can do the following steps to unblock the waiter: o Create a temporary EVD that accepts software events. It can be created in advance. o For a CNO with the waiter, attach that EVD to the CNO and post the software event on the EVD. o This unblocks the CNO. o Repeat for other CNOs that have blocked waiters. o Destroy the temporary EVD after all CNOs are destroyed and the EVD is no longer needed. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Standard: uDAPL, 1.1, 1.2 | +-----------------------------+-----------------------------+ |MT-Level |Unsafe | +-----------------------------+-----------------------------+ SEE ALSO
dat_cno_wait(3DAT), libdat(3LIB), attributes(5) SunOS 5.11 16 Jul 2004 dat_cno_free(3DAT)

Check Out this Related Man Page

dat_cno_query(3DAT)				     Direct Access Transport Library Functions				       dat_cno_query(3DAT)

NAME
dat_cno_query - provide the Consumer parameters of the CNO SYNOPSIS
cc [ flag... ] file... -ldat [ library... ] #include <dat/udat.h> DAT_RETURN dat_cno_query ( IN DAT_CNO_HANDLE cno_handle, IN DAT_CNO_PARAM_MASK cno_param_mask, OUT DAT_CNO_PARAM *cno_param ) PARAMETERS
cno_handle Handle for the created instance of the Consumer Notification Object cno_param_mask Mask for CNO parameters cno_param Pointer to a Consumer-allocated structure that the Provider fills with CNO parameters DESCRIPTION
The dat_cno_query() function provides the Consumer parameters of the CNO. The Consumer passes in a pointer to the Consumer-allocated struc- tures for CNO parameters that the Provider fills. The cno_param_mask parameter allows Consumers to specify which parameters to query. The Provider returns values for cno_param_mask requested parameters. The Provider can return values for any other parameters. A value of DAT_OS_WAIT_PROXY_AGENT_NULL in cno_param indicates that there are no Proxy Agent associated with the CNO. RETURN VALUES
DAT_SUCCESS The operation was successful. DAT_INVALID_PARAMETER The cno_param_mask parameter is invalid. DAT_INVALID_HANDLE The cno_handle parameter is invalid. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Standard: uDAPL, 1.1, 1.2 | +-----------------------------+-----------------------------+ |MT-Level |Unsafe | +-----------------------------+-----------------------------+ SEE ALSO
libdat(3LIB), attributes(5) SunOS 5.11 16 Jul 2004 dat_cno_query(3DAT)
Man Page