Manual Pages for UNIX Operating System command usage for man dat_srq_free

Direct Access Transport Library Functions      dat_srq_free(3DAT)



NAME
     dat_srq_free - destroy an instance  of  the  shared  receive
     queue

SYNOPSIS
     cc [ flag... ] file... -ldat [ library... ]
     #include 

     DAT_RETURN
         dat_srq_free (
         IN      DAT_SRQ_HANDLE      srq_handle
         )


PARAMETERS
     srq_handle    A handle for an instance of  SRQ  to  be  des-
                   troyed.


DESCRIPTION
     The dat_srq_free() function destroys an instance of the SRQ.
     The SRQ cannot be destroyed if it is in use by an EP.


     It is illegal to use the destroyed handle in any  consequent
     operation.

RETURN VALUES
     DAT_SUCCESS           The operation was successful.


     DAT_INVALID_HANDLE    The srq_handle argument is an  invalid
                           DAT handle.


     DAT_SRQ_IN_USE        The Shared Receive Queue  can  not  be
                           destroyed because it is in still asso-
                           ciated with an EP instance.


USAGE
     If the Provider detects the use of a deleted object  handle,
     it  should  return  DAT_INVALID_HANDLE.  The Provider should
     avoid assigning the used handle as long  as  possible.  Once
     reassigned  the  handle is no longer a handle of a destroyed
     object.

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





SunOS 5.11          Last change: 16 Jul 2004                    1






Direct Access Transport Library Functions      dat_srq_free(3DAT)



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


SEE ALSO
     dat_srq_create(3DAT),               dat_srq_post_recv(3DAT),
     dat_srq_query(3DAT),                   dat_srq_resize(3DAT),
     dat_srq_set_lw(3DAT), libdat(3LIB), attributes(5)








































SunOS 5.11          Last change: 16 Jul 2004                    2