Distribution_Plugin_Entry_Point() - Netscape DIRECTORY SERVER 7.0 - PLUG-IN Manual

distribution_plugin_entry_point()

Allows for backend distribution.
Syntax
#include "slapi-plugin.h"
int distribution_plugin_entry_point (Slapi_PBlock *pb,
Slapi_DN *target_dn, char **mtn_be_names, int be_count,
Slapi_DN * node_dn);
Parameters
This function takes the following parameters:
pb
target_dn
mtn_be_names
be_count
node_dn
Returns
This function should return the index of the backend in the
that is used to resolve the current operation. For search operations,
SLAPI_BE_ALL_BACKENDS
searched. The use of
supported and may give random results.
Description
Backend distribution is the capability to span the LDAP subtree contents under a
specified DIT node into multiple backends in the same server and/or database
links to other servers. Under such a configuration, this function is responsible for
deciding where the database or database link under the DIT node will be applied.
This function will be called for ever operation reaching a DIT node, including
subtree search operations that are started above the node.
This function can only be called if the server has been configured to take advantage
of such capability.
Pointer to the parameter block of the operation.
Pointer to the target DN of the operation.
Pointer to the list of names of backends declared for this node.
The number of backends declared under a specified DIT node.
DN of the node where the distribution function is set.
can be returned to specify that backends must be
SLAPI_BE_ALL_BACKENDS
Distribution Routines
mtn_be_names
for non-search operations is not
Chapter 15 Function Reference
table
227