dat_registry_list_providers man page on Solaris

Man page or keyword search:  
man Server   20652 pages
apropos Keyword Search (all sections)
Output format
Solaris logo
[printable version]

dat_registry_list_pDirectrAccess)Transport Lidat_registry_list_providers(3DAT)

NAME
       dat_registry_list_providers  -  obtain  a  list of available pProviders
       from the Static Registry

SYNOPSIS
       typedef struct dat_provider_info {
	   char ia_name[DAT_NAME_MAX_LENGTH];
	   DAT_UINT32	   dapl_version_major;
	   DAT_UINT32	   dapl_version_minor;
	   DAT_BOOLEAN	   is_thread_safe;
	   } DAT_PROVIDER_INFO;

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

       DAT_RETURN
	   dat_registry_list_providers (
	   IN	 DAT_COUNT	    max_to_return,
	   OUT	 DAT_COUNT	    *number_entries,
	   OUT	 DAT_PROVIDER_INFO  *(dat_provider_list[])
	   )

PARAMETERS
       max_to_return   Maximum number of entries that can be returned  to  the
		       Consumer in the dat_provider_list.

       number_entries  The  actual  number of entries returned to the Consumer
		       in the dat_provider_list if successful or the number of
		       Providers available.

       dat_provider_lisPoints  to  an array of DAT_PROVIDER_INFO pointers sup‐
		       plied by the Consumer. Each Provider's information will
		       be copied to the destination specified.

DESCRIPTION
       The  dat_registry_list_providers()  function  allows  the  Consumer  to
       obtain a list of available Providers  from  the	Static	Registry.  The
       information provided is the Interface Adapter name, the uDAPL/kDAPL API
       version supported, and whether the provided version is thread-safe. The
       Consumer	 can examine the attributes to determine which (if any) Inter‐
       face Adapters it wants to open. This operation has  no  effect  on  the
       Registry itself.

       The  Registry  can open an IA using a Provider whose dapl_version_minor
       is larger than the one the  Consumer  requests  if  no  Provider	 entry
       matches	exactly.  Therefore, Consumers should expect that an IA can be
       opened successfully as long as at least one Provider entry returned  by
       dat_registry_list_providers()  matches the ia_name, dapl_version_major,
       and is_thread_safe fields exactly, and has a dapl_version_minor that is
       equal to or greater than the version requested.

       If  the	operation is successful, the returned value is DAT_SUCCESS and
       number_entries indicates the number of entries filled by	 the  registry
       in dat_provider_list.

       If  the	operation  is  not successful, then number_entries returns the
       number of entries in the registry. Consumers can	 use  this  return  to
       allocate	 dat_provider_list large enough for the registry entries. This
       number is just a snapshot at the time of the call and may be changed by
       the time of the next call. If the operation is not successful, then the
       content of dat_provider_list is not defined.

       If dat_provider_list is too small, including pointing to NULL  for  the
       registry	  entries,   then   the	  operation   fails  with  the	return
       DAT_INVALID_PARAMETER.

RETURN VALUES
       DAT_SUCCESS	       The operation was successful.

       DAT_INVALID_PARAMETER   Invalid	    parameter.	    For	      example,
			       dat_provider_list is too small or NULL.

       DAT_INTERNAL_ERROR      Internal	 error.	 The  DAT  static  registry is
			       missing.

USAGE
       DAT_NAME_MAX_LENGTH includes the null character for string termination.

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

       ┌─────────────────────────────┬─────────────────────────────┐
       │      ATTRIBUTE TYPE	     │	    ATTRIBUTE VALUE	   │
       ├─────────────────────────────┼─────────────────────────────┤
       │Interface Stability	     │Standard: uDAPL, 1.1, 1.2	   │
       ├─────────────────────────────┼─────────────────────────────┤
       │MT-Level		     │Safe			   │
       └─────────────────────────────┴─────────────────────────────┘

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

SunOS 5.10			  16 Jul 2004dat_registry_list_providers(3DAT)
[top]

List of man pages available for Solaris

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net