dat_registry_add_provider(3dat) [opensolaris man page]

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

NAME

       dat_registry_add_provider - declare the Provider with the Dynamic Registry

SYNOPSIS

       cc [ flag... ] file... -ldat [ library... ]
       #include <dat/udat.h>

       DAT_RETURN
	   dat_registry_add_provider (
	   IN	 const DAT_PROVIDER	     *provider,
	   IN	 const DAT_PROVIDER_INFO     *provider_info
	   )

PARAMETERS

       provider 	Self-description of a Provider.

       provider_info	Attributes of the Provider.

DESCRIPTION

       The Provider declares itself with the Dynamic Registry. Note that the caller can choose to register itself multiple times, for example once
       for each port. The choice of what to virtualize is up to the Provider. Each  registration  provides  an	Interface  Adapter  to	DAT.  Each
       Provider must have a unique name.

       The  same  IA  Name cannot be added multiple times. An attempt to register the same IA Name again results in an error with the return value
       DAT_PROVIDER_ALREADY_REGISTERED.

       The contents of provider_info must be the same as those the Consumer uses in the call to dat_ia_open(3DAT) directly, or the  ones  provided
       indirectly defined by the header files with which the Consumer compiled.

RETURN VALUES

       DAT_SUCCESS

	   The operation was successful.

       DAT_INSUFFICIENT_RESOURCES

	   The maximum number of Providers was already registered.

       DAT_INVALID_PARAMETER

	   Invalid parameter.

       DAT_PROVIDER_ALREADY_REGISTERED

	   Invalid or nonunique name.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard: uDAPL, 1.1, 1.2    |
       +-----------------------------+-----------------------------+
       |MT-Level		     |				   |
       +-----------------------------+-----------------------------+

SEE ALSO

       dat_ia_open(3DAT), libdat(3LIB), attributes(5)

SunOS 5.11							    16 Jul 2004 				   dat_registry_add_provider(3DAT)

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

NAME

       dat_set_consumer_context - set Consumer context

SYNOPSIS

       cc [ flag... ] file... -ldat [ library... ]
       #include <dat/udat.h>

       DAT_RETURN
	   dat_set_consumer_context (
	   IN	 DAT_HANDLE    dat_handle,
	   IN	 DAT_CONTEXT   context
	   )

PARAMETERS

       dat_handle      Handle for a DAT Object associated with context.

       context	       Consumer  context to be stored within the associated dat_handle. The Consumer context is opaque to the uDAPL Provider. NULL
		       represents no context.

DESCRIPTION

       The dat_set_consumer_context() function associates a Consumer context with the specified dat_handle. The dat_handle can be one of the  fol-
       lowing	handle	 types:  DAT_IA_HANDLE,  DAT_EP_HANDLE,  DAT_EVD_HANDLE,  DAT_CR_HANDLE,  DAT_RSP_HANDLE,  DAT_PSP_HANDLE,  DAT_PZ_HANDLE,
       DAT_LMR_HANDLE, DAT_RMR_HANDLE, or DAT_CNO_HANDLE.

       Only a single Consumer context is provided for any dat_handle. If there is a previous Consumer context associated with the  specified  han-
       dle,  the new context replaces the old one. The Consumer can disassociate the existing context by providing a NULL pointer for the context.
       The Provider makes no assumptions about the contents of context; no check is made on its value. Furthermore, the Provider makes no  attempt
       to provide any synchronization for access or modification of the context.

RETURN VALUES

       DAT_SUCCESS	       The operation was successful.

       DAT_INVALID_PARAMETER   The context parameter is invalid.

       DAT_INVALID_HANDLE      The dat_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

       dat_get_consumer_context(3DAT), libdat(3LIB), attributes(5)

SunOS 5.10							    16 Jul 2004 				    dat_set_consumer_context(3DAT)