Manual Pages for UNIX Operating System command usage for man dat_cr_query

Direct Access Transport Library Functions      dat_cr_query(3DAT)



NAME
     dat_cr_query - provide parameters of the Connection Request

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

     DAT_RETURN
         dat_cr_query (
         IN    DAT_CR_HANDLE        cr_handle,
         IN    DAT_CR_PARAM_MASK    cr_param_mask,
         OUT   DAT_CR_PARAM         *cr_param
         )


PARAMETERS
     cr_handle        Handle for  an  instance  of  a  Connection
                      Request.


     cr_param_mask    Mask for Connection Request parameters.


     cr_param         Pointer to a  Consumer-allocated  structure
                      that   the  Provider  fills  for  Consumer-
                      requested parameters.


DESCRIPTION
     The dat_cr_query() function provides to the Consumer parame-
     ters  of  the  Connection  Request. The Consumer passes in a
     pointer to the Consumer-allocated structures for  Connection
     Request parameters that the Provider fills.


     The cr_param_mask  parameter  allows  Consumers  to  specify
     which  parameters  to query. The Provider returns values for
     cr_param_mask requested parameters. The Provider can  return
     values for any other parameters.

RETURN VALUES
     DAT_SUCCESS              The operation was successful


     DAT_INVALID_HANDLE       The cr_handle handle is invalid.


     DAT_INVALID_PARAMETER    The  cr_param_mask   parameter   is
                              invalid.






SunOS 5.11          Last change: 16 Jul 2004                    1






Direct Access Transport Library Functions      dat_cr_query(3DAT)



USAGE
     The Consumer uses dat_cr_query() to  get  information  about
     requesting  a remote Endpoint as well as a local Endpoint if
     it was allocated by the Provider for the arrived  Connection
     Request.  The local Endpoint is created if the Consumer used
     PSP with DAT_PSP_PROVIDER as the value  for  psp_flags.  For
     the     remote     Endpoint,     dat_cr_query()     provides
     remote_ia_address and  remote_port_qual.  It  also  provides
     remote peer private_data and its size.

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



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


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


























SunOS 5.11          Last change: 16 Jul 2004                    2