Logging Messages; Adding Notes To Access Log Entries - Netscape DIRECTORY SERVER 6.02 - PLUG-IN Manual

Logging Messages

Logging Messages
To write an error message to the error log, call the
For example, the following
the error log:
slapi_log_error( SLAPI_LOG_PLUGIN, "searchdn_preop_search",
"*** PREOPERATION SEARCH PLUGIN ***\n");
This call will create the following message in the error log:
[01/Oct/1997:02:24:18 -0700] searchdn_preop_search \
- *** PREOPERATION SEARCH PLUGIN ***
Make sure that the Directory Server is configured to log messages that have the
severity that you specify (for example,
see "Setting the Log Level of the Server" on page 46.

Adding Notes to Access Log Entries

When the back-end database processes a search operation, it attempts to use
indexes to narrow down the list of candidates matching the search criteria. If the
back-end is unable to use indexes, it appends the following string to the access log
entry for the search:
notes="U"
This note indicates that an unindexed search was performed.
If you are writing your own back-end database search function, you can append
this note to access log entries by setting the
the flag
to be appended to access log entries. Currently,
only value that you can set for this parameter. In future releases, additional flags
will be defined. You will be able to use bitwise OR combinations of flags to specify
different combinations of notes.
The server appends these notes and writes out the access log entries whenever
sending a result or search entry back to the client.
58 Netscape Directory Server Plug-In Programmer's Guide • May 2002
slapi_log_error()
SLAPI_OP_NOTE_UNINDEXED
slapi_new_condvar()
function call writes a message in
SLAPI_LOG_PLUGIN
SLAPI_OPERATION_NOTES
. This parameter identifies any notes that need
SLAPI_OP_NOTE_UNINDEXED
function.
). For more information,
parameter to
is the