Debugging levels

Use the debugging levels to identify an appropriate debug level to obtain debug trace for a directory server instance.

The ldtrc utility must be running to obtain the debug trace when you run the server utilities in debug mode. The ldtrc utility is not required for the client utilities. For example, to run the idscfgdb command in debug mode for a directory server instance, myinst, issue the following commands.

ldtrc on
idscfgdb -I myinst -d debuglevel

The specified debug level value determines which categories of debug output to generate.

Table 1. Debug categories
Hex Decimal Value Description
0x0001 1 LDAP_DEBUG_TRACE Entry and exit from routines
0x0002 2 LDAP_DEBUG_PACKETS Packet activity
0x0004 4 LDAP_DEBUG_ARGS Data arguments from requests
0x0008 8 LDAP_DEBUG_CONNS Connection activity
0x0010 16 LDAP_DEBUG_BER Encoding and decoding of data
0x0020 32 LDAP_DEBUG_FILTER Search filters
0x0040 64 LDAP_DEBUG_MESSAGE Messaging subsystem activities and events
0x0080 128 LDAP_DEBUG_ACL Access Control List activities
0x0100 256 LDAP_DEBUG_STATS Operational statistics
0x0200 512 LDAP_DEBUG_THREAD Threading statistics
0x0400 1024 LDAP_DEBUG_REPL Replication statistics
0x0800 2048 LDAP_DEBUG_PARSE Parsing activities
0x1000 4096 LDAP_DEBUG_PERFORMANCE Relational backend performance statistics
0x2000 8192 LDAP_DEBUG_RDBM Relational backend activities
0x4000 16384 LDAP_DEBUG_REFERRAL Referral activities
0x8000 32768 LDAP_DEBUG_ERROR Error conditions
0xffff 65535 LDAP_DEBUG_ANY All levels of debug

For example, when you specify a bit mask value of 65535, the command turns on full debug output and generates the most complete information.

Contact IBM® Service for assistance with interpreting of the debug output and resolving of the problem.

When you are finished with debugging, issue the following command to deactivate the ldtrc utility.

ldtrc off