HP-UX Directory Server 8.1 plug-in reference

5 Front end API functions...........................................................................................49
5.1 Logging messages......................................................................................................................49
5.2 Adding notes to access log entries.............................................................................................49
5.3 Sending data to the client...........................................................................................................49
5.4 Determining if an operation was abandoned............................................................................50
5.5 Working with entries, attributes, and values.............................................................................50
5.5.1 Creating a new entry..........................................................................................................51
5.5.2 Converting between entries and strings............................................................................51
5.5.3 Miscellaneous operations...................................................................................................52
5.5.3.1 Getting and setting the DN of an entry.....................................................................52
5.5.3.2 Verifying compliance with the schema......................................................................52
5.5.3.3 Getting the attributes and values of an entry............................................................52
5.5.3.3.1 Iterating through the attributes in an entry.......................................................52
5.5.3.3.2 Finding a specific attribute in an entry .............................................................53
5.5.3.4 Adding and removing values....................................................................................53
5.6 Working with DNs and RDNs...................................................................................................53
5.6.1 Determining if a DN is the root DN...................................................................................53
5.6.2 Working with DN suffixes.................................................................................................53
5.6.3 Getting the parent DN of a DN..........................................................................................54
5.6.4 Normalizing a DN..............................................................................................................54
5.7 Working with search filters........................................................................................................54
5.7.1 Determining if an entry matches a filter............................................................................55
5.7.2 Getting the filter type.........................................................................................................55
5.7.3 Getting the search criteria..................................................................................................55
5.7.4 Converting a string to a filter.............................................................................................56
5.7.5 Creating complex filters by combining Filters...................................................................56
5.8 Checking passwords..................................................................................................................56
6 Writing pre- and postoperation plug-ins...............................................................57
6.1 How pre- and postoperation plug-ins work..............................................................................57
6.2 Types of preoperation and postoperation functions..................................................................58
6.2.1 Types of preoperation functions........................................................................................58
6.2.2 Types of postoperation functions.......................................................................................59
6.3 Registering pre- and postoperation functions...........................................................................60
7 Defining functions for LDAP operations.................................................................61
7.1 Specifying start and close functions...........................................................................................61
7.2 Processing an LDAP bind operation..........................................................................................61
7.2.1 Defining functions for the bind operation.........................................................................61
7.2.2 Getting and setting parameters for the bind operation.....................................................61
7.3 Processing an LDAP unbind operation.....................................................................................62
7.4 Processing an LDAP search operation.......................................................................................62
7.4.1 Getting the list of candidates.............................................................................................62
7.4.2 Iterating through candidates.............................................................................................64
7.5 Processing an LDAP compare operation...................................................................................64
7.6 Processing an LDAP add operation...........................................................................................65
7.7 Processing an LDAP modify operation.....................................................................................65
7.8 Processing an LDAP modify RDN operation............................................................................66
7.9 Processing an LDAP delete operation.......................................................................................67
7.10 Processing an LDAP abandon operation.................................................................................68
4 Table of Contents