HP-UX Directory Server 8.1 plug-in reference

Table of Contents
I Introduction to Directory Server plug-ins.....................................................................21
1 An overview of Directory Server plug-ins..............................................................23
1.1 What Are Directory Server plug-ins?........................................................................................23
1.2 How Directory Server plug-ins work........................................................................................23
1.2.1 Calling Directory Server plug-in functions........................................................................23
1.2.2 The Directory Server architecture......................................................................................24
1.3 Types of Directory Server plug-ins............................................................................................25
1.4 Using Directory Server plug-in APIs.........................................................................................27
1.5 Deprecated functions and replacements....................................................................................28
2 Writing and compiling plug-ins.............................................................................31
2.1 Writing a plug-in Function.........................................................................................................31
2.1.1 Including the API header file.............................................................................................31
2.1.2 Passing data with parameter blocks..................................................................................31
2.1.3 Working with parameter blocks........................................................................................32
2.1.3.1 Getting data from the parameter block.....................................................................32
2.1.3.2 Setting data in the parameter block...........................................................................32
2.1.4 Calling front end functions................................................................................................33
2.1.5 Plug-in return values.........................................................................................................33
2.2 Writing plug-in initialization functions.....................................................................................33
2.2.1 Specifying Directory Server compatibility.........................................................................34
2.2.2 Specifying information about the plug-in.........................................................................34
2.2.3 Registering your plug-in functions....................................................................................35
2.2.4 Returning a value to the Directory Server.........................................................................35
2.2.5 Example of an initialization function.................................................................................35
2.3 Compiling a Directory Server plug-in.......................................................................................36
3 Configuring plug-ins................................................................................................37
3.1 Creating a plug-in configuration file.........................................................................................37
3.1.1 Plug-in dependencies.........................................................................................................38
3.1.1.1 Specific plug-in dependencies...................................................................................38
3.1.1.2 Plug-in type dependencies ........................................................................................38
3.1.2 Specifying the order of plug-in directives.........................................................................39
3.1.3 Summary of plug-in directives..........................................................................................39
3.2 Loading the plug-in configuration file.......................................................................................40
3.3 Passing extra arguments to plug-ins..........................................................................................40
3.4 Setting the log level of the server...............................................................................................41
4 An example plug-in.................................................................................................43
4.1 Writing the plug-in example......................................................................................................43
4.2 Compiling the plug-in example.................................................................................................45
4.3 Registering the plug-in...............................................................................................................45
4.4 Running the plug-in...................................................................................................................46
II Writing functions and plug-ins....................................................................................47
Table of Contents 3