Issue 8889 - Clarify default loglevel and consistently use debug/logging as appropriate
Summary: Clarify default loglevel and consistently use debug/logging as appropriate
Status: VERIFIED FIXED
Alias: None
Product: OpenLDAP
Classification: Unclassified
Component: documentation (show other issues)
Version: unspecified
Hardware: All All
: --- normal
Target Milestone: 2.5.3
Assignee: Quanah Gibson-Mount
URL:
Keywords:
: 8945 (view as issue list)
Depends on:
Blocks:
 
Reported: 2018-08-01 02:11 UTC by dpa-openldap@aegee.org
Modified: 2021-04-01 04:04 UTC (History)
1 user (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this issue.
Description dpa-openldap@aegee.org 2018-08-01 02:11:22 UTC
Full_Name: Дилян Палаузов
Version: 2.4
OS: Linux
URL: 
Submission from: (NULL) (103.252.202.53)


Debugging and logging are different things: logging is more used to avoid
problems, that could have happened in the past, while debugging is for
reproducing problems in order to resolve them.

https://www.openldap.org/doc/admin24/runningslapd.html#Command-Line%20Options
says -d sets the debug level, and 'Note: slapd must have been compiled with
--enable-debug defined for any debugging information beyond the two stats levels
to be available (the default).' 

Is --enable-debug passed by default, unless one calls --disable-debug, or are
the two stats levels combined as 256 | 512 the default debug level?

https://www.openldap.org/doc/admin24/troubleshooting.html#Debugging%20{{slapd}}(8)says
that 256 is a good firstlevel, not stating whether this is the default or needs
to be set explicitly.

https://www.openldap.org/doc/admin24/tuning.html#Logging says the default log
level is 256, but does not state how to change it.

https://www.openldap.org/doc/admin24/slapdconfig.html#Global%20Directives
presents the same table, as the first link I mentioned here, but calls it
'logging debugging statements' and while the directive is 'loglevel', the table
is called 'debugging levels'. It says further:


Default:
 loglevel stats
Basic stats logging is configured by default. However, if no loglevel is
defined, no logging occurs (equivalent to a 0 level).

- Does this mean, that no logging occurs, when the loglevel directive is
missing, and when it is present without value, the value is stats/256?

Likewise for https://www.openldap.org/doc/admin24/slapdconf2.html#cn=config .

- Please clarify on every place, where loglevel is mentioned, that the default
is 256/stats.

- Either use only the term debugging in the whole documentation, or only the
term logging, or if both terms are used, clarify the difference between them 
Comment 1 Quanah Gibson-Mount 2020-03-23 20:53:23 UTC
*** Issue 8945 has been marked as a duplicate of this issue. ***
Comment 2 Quanah Gibson-Mount 2021-03-10 20:21:37 UTC
debug levels are what gets passed to slapd via the -d option.  They share the same namespace as the loglevels, but some items are only valid as a debug option (such as packets).

I'll work on clarifying the admin guide.

--Quanah
Comment 3 Quanah Gibson-Mount 2021-03-11 19:51:37 UTC
And to note, if compiled with the default options (--enable-debug=yes), the *loglevel* defaults to 256 (stats).
Comment 5 Quanah Gibson-Mount 2021-03-15 21:39:21 UTC
Commits: 
  • 4e0f0a31 
by Quanah Gibson-Mount at 2021-03-15T20:30:07+00:00 
ITS#8889 - Clarify loglevel and debug level portions of admin guide.