Manual Pages for UNIX Operating System command usage for man dat_provider_init

Direct Access Transport Library Functions
                                          dat_provider_init(3DAT)



NAME
     dat_provider_init - locate the Provider in the Static Regis-
     try

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

     void
         dat_provider_init (
         IN    const DAT_PROVIDER_INFO    *provider_info,
         IN    const char *               instance_data
         )


PARAMETERS
     provider_info    The information that was  provided  by  the
                      Consumer  to  locate  the  Provider  in the
                      Static Registry.


     instance_data    The instance data string obtained from  the
                      entry  found in the Static Registry for the
                      Provider.


DESCRIPTION
     A constructor the Registry calls on a  Provider  before  the
     first call to dat_ia_open(3DAT) for a given IA name when the
     Provider is  auto-loaded.  An  application  that  explicitly
     loads   a   Provider   on   its   own   can  choose  to  use
     dat_provider_init() just as the Registry would have done for
     an auto-loaded Provider.


     The Provider's  implementation  of  this  method  must  call
     dat_registry_add_provider(3DAT),  using  the  IA name in the
     provider_info.ia_name field, to  register  itself  with  the
     Dynamic Registry. The implementation must not register other
     IA names at this time. Otherwise, the Provider  is  free  to
     perform  any  initialization  it  finds  useful  within this
     method.


     This method is called before the first call to dat_ia_open()
     for a given IA name after one of the following has occurred:

         o    The Provider library was loaded into memory.

         o    The  Registry  called  dat_provider_fini(3DAT)  for
              that IA name.



SunOS 5.11          Last change: 16 Jul 2004                    1






Direct Access Transport Library Functions
                                          dat_provider_init(3DAT)



         o    The                 Provider                 called
              dat_registry_remove_provider(3DAT) for that IA name
              (but it is still  the  Provider  indicated  in  the
              Static Registry).


     If this method fails, it should  ensure  that  it  does  not
     leave its entry in the Dynamic Registry.

RETURN VALUES
     No values are returned.

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



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


SEE ALSO
     dat_ia_open(3DAT),                  dat_provider_fini(3DAT),
     dat_registry_add_provider(3DAT),
     dat_registry_remove_provider(3DAT),   libdat(3LIB),   attri-
     butes(5)




















SunOS 5.11          Last change: 16 Jul 2004                    2






Direct Access Transport Library Functions
                                          dat_provider_init(3DAT)






















































SunOS 5.11          Last change: 16 Jul 2004                    3