Red Hat DIRECTORY SERVER 7.1 - PLUG-IN PROGRAMMERS Manual

Also see for DIRECTORY SERVER 7.1: Manual Installation guide Deployment guide Configuration Reference

Contents

Indexing Based on Matching RulesChapter 11 Writing Matching Rule Plug-ins 137How the Server Uses Parameter BlocksThe server uses parameter blocks as a means to pass information to and fromplug-in functions.When calling your matching rule plug-in functions, the server will create a newSlapi_PBlock parameter block, set some input parameters, and pass theparameter block to your function. After retrieving output parameters from theblock, the server typically frees the parameter block from memory.In general, you should not expect a parameter block to be passed from plug-infunction to plug-in function. The value of a parameter set by one plug-in functionmay not necessarily be accessible to other plug-in functions since each function isusually passed a new and different parameter block.Indexing Based on Matching RulesThis section explains how to set up the server to index entries using a matchingrule. 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 FunctionYou also need to define an initialization function to register your indexer factoryfunction.How the Server Sets Up the IndexWhen the server encounters a matching rule OID in an index directive in theserver configuration file, the server determines which plug-in supports thematching rule identified by the OID. See “How the Server Associates Plug-ins withOIDs,” on page 135, for details.