How The Server Uses Parameter Blocks; Indexing Based On Matching Rules; How The Server Sets Up The Index - Netscape DIRECTORY SERVER 7.0 - PLUG-IN Manual

How the Server Uses Parameter Blocks

The server uses parameter blocks as a means to pass information to and from
plug-in functions.
When calling your matching rule plug-in functions, the server will create a new
Slapi_PBlock
parameter block to your function. After retrieving output parameters from the
block, the server typically frees the parameter block from memory.
In general, you should not expect a parameter block to be passed from plug-in
function to plug-in function. The value of a parameter set by one plug-in function
may not necessarily be accessible to other plug-in functions since each function is
usually passed a new and different parameter block.

Indexing Based on Matching Rules

This section explains how to set up the server to index entries using a matching
rule. The following topics are covered:
•

How the Server Sets Up the Index

• How the Server Updates the Index
• Writing the Indexer Factory Function
• Getting and Setting Parameters in Indexer Factory Functions
• Writing the Indexer Function
• Writing the Indexer Function
You also need to define an initialization function to register your indexer factory
function.
How the Server Sets Up the Index
When the server encounters a matching rule OID in an
server configuration file, the server determines which plug-in supports the
matching rule identified by the OID. See "How the Server Associates Plug-ins with
OIDs," on page 137, for details.
parameter block, set some input parameters, and pass the
Indexing Based on Matching Rules
directive in the
index
Chapter 11 Writing Matching Rule Plug-ins 139