debuglevels are not defined in ldap-utils man pages

Bug #74754 reported by speeves
6
Affects Status Importance Assigned to Milestone
openldap (Ubuntu)
Won't Fix
Wishlist
Unassigned

Bug Description

Binary package hint: ldap-utils

When trying to debug some ldif syntax information with ldapadd, I found that -d debuglevel is defined in the man page, but the debuglevels are not defined. I found the following page:
http://www.linuxselfhelp.com/HOWTO/LDAP-HOWTO-4.html

Which defines the debuglevels which are available for ldap-utils utilities, (ldapadd, ldapmodify, etc.).

Could we get this information added to the man pages for these utils? I can do it myself if someone can verify that the following information is correct for our version of ldap-utils:

 ii ldap-utils 2.2.26-5ubuntu

-d <level> | ?

    This option sets the slapd debug level to <level>. When level is a `?'
    character, the various debugging levels are printed and slapd exits, regardless
     of any other options you give it. Current debugging levels are:

    -1 enable all debugging
    0 no debugging
    1 trace function calls
    2 debug packet handling
    4 heavy trace debugging
    8 connection management
    16 print out packets sent and received
    32 search filter processing
    64 configuration file processing
    128 access control list processing
    256 stats log connections/operations/results
    512 stats log entries sent
    1024 print communication with shell backends
    2048 print entry parsing debugging

    You may enable multiple levels by specifying the debug option once for each
    desired level. Or, since debugging levels are additive, you can do the math
    yourself. That is, if you want to trace function calls and watch the config
    file being processed, you could set level to the sum of those two levels (in
    this case, -d 65). Or, you can let slapd do the math, (e.g. -d 1 -d 64).
    Consult <ldap.h> for more details.

    Note: slapd must have been compiled with -DLDAP_DEBUG defined for any debugging
     information beyond the two stats levels to be available.

BTW, ldap-utils on ubuntu _is_ compiled with LDAP_DEBUG.

thanks,
speeves

Revision history for this message
Jonathan Clarke (jooooooon) wrote :

You should find these debug levels in the slapd.conf man page.

Revision history for this message
speeves (speeves) wrote : Re: [Bug 74754] Re: debuglevels are not defined in ldap-utils man pages

On 5/3/07, Jonathan Clarke <email address hidden> wrote:
>
> You should find these debug levels in the slapd.conf man page.

Since you normally aren't referencing the slapd.conf when using ldapsearch,
etc., I thought it might be handy for the man pages for the tools themselves
to have a quick reference to the debug levels as well, or at least point to
the slapd.conf man page as a reference.

thanks,

--
Shannon Eric Peevey
<email address hidden>
http://speeves.erikin.com

Rick Clark (dendrobates)
Changed in openldap2.3:
importance: Undecided → Wishlist
status: New → Triaged
Revision history for this message
Howard Chu (hyc) wrote :

This should probably be filed upstream so it can be handled as a Documentation bug there.

Note that there are only 3 main debug flags used in the libraries and command line tools - 1, 2, and 16. The rest are only used by slapd. 16 isn't all that useful if you already have 2 set.

Revision history for this message
Michael Zoet (michazoet-deactivatedaccount) wrote :

I think this bug can be closed? The various debug levels are described in the online manual and in the various manpages. The ldap-utils have a short description of the -d option. I think this is enough.

Revision history for this message
speeves (speeves) wrote : Re: [Bug 74754] Re: debuglevels are not defined in ldap-utils man pages

It probably can. I just thought that it might be nice to have the
numbers added to the -d option, (ie -1, etc). Since there hasn't been
much traction, we could close it.

thanks,
speeves

On Sat, Feb 21, 2009 at 8:52 AM, Michael Zoet <email address hidden> wrote:
> I think this bug can be closed? The various debug levels are described
> in the online manual and in the various manpages. The ldap-utils have a
> short description of the -d option. I think this is enough.
>
> --
> debuglevels are not defined in ldap-utils man pages
> https://bugs.launchpad.net/bugs/74754
> You received this bug notification because you are a direct subscriber
> of the bug.
>

--
Shannon Eric Peevey | Erikin Technology | (C: 507-301-2245) |
http://speeves.erikin.com

Revision history for this message
Mathias Gug (mathiaz) wrote :

Closing as requested by the bug submitter.

Changed in openldap:
status: Triaged → Won't Fix
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.