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)

Check Out this Related Man Page

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

NAME

       dat_rmr_query - provide RMR parameters

SYNOPSIS

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

       DAT_RETURN
	   dat_rmr_query (
	   IN	 DAT_RMR_HANDLE        rmr_handle,
	   IN	 DAT_RMR_PARAM_MASK    rmr_param_mask,
	   OUT	 DAT_RMR_PARAM	       *rmr_param
	   )

PARAMETERS

       rmr_handle      Handle for an instance of the RMR.

       rmr_param_mask  Mask for RMR parameters.

       rmr_param       Pointer to a Consumer-allocated structure that the Provider fills with RMR parameters.

DESCRIPTION

       The dat_rmr_query() function provides RMR parameters to the Consumer. The Consumer passes in a pointer to the Consumer-allocated structures
       for RMR parameters that the Provider fills.

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

       Not  all parameters can have a value at all times. For example, lmr_handle, target_address, segment_length, mem_privileges, and rmr_context
       are not defined for an unbound RMR.

RETURN VALUES

       DAT_SUCCESS	       The operation was successful.

       DAT_INVALID_PARAMETER   The rmr_param_mask parameter is invalid.

       DAT_INVALID_HANDLE      The mr_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.10							    16 Jul 2004 					       dat_rmr_query(3DAT)

Linux and UNIX Man Pages

dat_registry_add_provider(3dat) [opensolaris man page]

Check Out this Related Man Page