Manual Pages for UNIX Operating System command usage for man dat_cno_free

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_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 Con-
     sumer 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



SunOS 5.11          Last change: 16 Jul 2004                    1






Direct Access Transport Library Functions      dat_cno_free(3DAT)



              destroyed and the EVD is no longer needed.

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | Unsafe                      |
    |_____________________________|_____________________________|
    | Standard                    | uDAPL, 1.1, 1.2             |
    |_____________________________|_____________________________|


SEE ALSO
     dat_cno_wait(3DAT), libdat(3LIB), attributes(5)


































SunOS 5.11          Last change: 16 Jul 2004                    2