dat_registry_remove_provider(3dat) [opensolaris man page]
dat_registry_remove_provider(3DAT) Direct Access Transport Library Functions dat_registry_remove_provider(3DAT)NAME
dat_registry_remove_provider - unregister the Provider from the Dynamic Registry
SYNOPSIS
cc [ flag... ] file... -ldat [ library... ]
#include <dat/udat.h>
DAT_RETURN
dat_registry_remove_provider (
IN 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 removes itself from the Dynamic Registry. It is the Provider's responsibility to complete its sessions. Removal of the regis-
tration only prevents new sessions.
The Provider cannot be removed while it is in use. An attempt to remove the Provider while it is in use results in an error with the return
code DAT_PROVIDER_IN_USE.
RETURN VALUES
DAT_SUCCESS The operation was successful.
DAT_INVALID_PARAMETER Invalid parameter. The Provider was not found.
DAT_PROVIDER_IN_USE The Provider was in use.
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 libdat(3LIB), attributes(5)SunOS 5.11 16 Jul 2004 dat_registry_remove_provider(3DAT)
Check Out this Related Man Page
dat_provider_init(3DAT) Direct Access Transport Library Functions dat_provider_init(3DAT)NAME
dat_provider_init - locate the Provider in the Static Registry
SYNOPSIS
cc [ flag... ] file... -ldat [ library... ]
#include <dat/udat.h>
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.
o The Provider called dat_registry_remove_provider(3DAT) for that IA name (but it is still the Provider indicated in the Static Reg-
istry).
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 attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Interface Stability |Standard: uDAPL, 1.1, 1.2 |
+-----------------------------+-----------------------------+
|MT-Level | |
+-----------------------------+-----------------------------+
SEE ALSO dat_ia_open(3DAT), dat_provider_fini(3DAT), dat_registry_add_provider(3DAT), dat_registry_remove_provider(3DAT), libdat(3LIB),
attributes(5)SunOS 5.10 16 Jul 2004 dat_provider_init(3DAT)