~ubuntu-branches/ubuntu/maverick/openldap/maverick-proposed

« back to all changes in this revision

Viewing changes to doc/guide/admin/runningslapd.sdf

  • Committer: Bazaar Package Importer
  • Author(s): Mathias Gug, Steve Langasek, Mathias Gug
  • Date: 2009-02-18 18:44:00 UTC
  • mfrom: (1.1.2 upstream) (0.1.2 lenny)
  • Revision ID: james.westby@ubuntu.com-20090218184400-zw4mjse9eywt5566
Tags: 2.4.14-0ubuntu1
[ Steve Langasek ]
* New upstream version
  - Fixes a bug with the pcache overlay not returning cached entries
    (closes: #497697)
  - Update evolution-ntlm patch to apply to current Makefiles.
  - (tentatively) drop gnutls-ciphers, since this bug was reported to be
    fixed upstream in 2.4.8.  The fix applied in 2.4.8 didn't match the
    patch from the bug report, so this should be watched for regressions.
* Build against db4.7 instead of db4.2 at last!  Closes: #421946.
* Build with --disable-ndb, to avoid a misbuild when libmysqlclient is
  installed in the build environment.
* New patch, no-crlcheck-for-gnutls, to fix a build failure when using
  --with-tls=gnutls.

[ Mathias Gug ]
* Merge from debian unstable, remaining changes:
  - debian/apparmor-profile: add AppArmor profile
  - debian/slapd.postinst: Reload AA profile on configuration
  - updated debian/slapd.README.Debian for note on AppArmor
  - debian/control: Recommends apparmor >= 2.1+1075-0ubuntu6
  - debian/control: Conflicts with apparmor-profiles << 2.1+1075-0ubuntu4
    to make sure that if earlier version of apparmour-profiles gets
    installed it won't overwrite our profile.
  - Modify Maintainer value to match the DebianMaintainerField
    speficication.
  - follow ApparmorProfileMigration and force apparmor compalin mode on 
    some upgrades (LP: #203529)
  - debian/slapd.dirs: add etc/apparmor.d/force-complain
  - debian/slapd.preinst: create symlink for force-complain on pre-feisty
    upgrades, upgrades where apparmor-profiles profile is unchanged (ie
    non-enforcing) and upgrades where apparmor profile does not exist.
  - debian/slapd.postrm: remove symlink in force-complain/ on purge
  - debian/patches/fix-ucred-libc due to changes how newer glibc handle
    the ucred struct now.
  - debian/control:
    - Build-depend on libltdl7-dev rather then libltdl3-dev.
  - debian/patches/autogen.sh:
    - Call libtoolize with the --install option to install config.{guess,sub}
      files.
  - Don't use local statement in config script as it fails if /bin/sh
    points to bash (LP: #286063).
  - Disable the testsuite on hppa. Allows building of packages on this
    architecture again, once this package is in the archive.
    LP: #288908.
  - debian/slapd.postinst, debian/slapd.script-common: set correct ownership
    and permissions on /var/lib/ldap, /etc/ldap/slapd.d (group readable) and
    /var/run/slapd (world readable). (LP: #257667).
  - debian/patches/nssov-build, debian/rules: 
    Build and package the nss overlay.
    debian/schema/misc.ldif: add ldif file for the misc schema, which defines
    rfc822MailMember (required by the nss overlay).
  - debian/{control,rules}: enable PIE hardening
  - Use cn=config as the default configuration backend instead of 
    slapd.conf. Migrate slapd.conf  file to /etc/ldap/slapd.d/ on upgrade
    asking the end user to enter a new password to control the access to the
    cn=config tree.
* debian/patches/corrupt-contextCSN: The contextCSN can get corrupted at
  times. (ITS: #5947)

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# $OpenLDAP: pkg/openldap-guide/admin/runningslapd.sdf,v 1.16.2.5 2008/02/11 23:26:39 kurt Exp $
2
 
# Copyright 1999-2008 The OpenLDAP Foundation, All Rights Reserved.
 
1
# $OpenLDAP: pkg/openldap-guide/admin/runningslapd.sdf,v 1.16.2.8 2009/02/06 16:38:31 quanah Exp $
 
2
# Copyright 1999-2009 The OpenLDAP Foundation, All Rights Reserved.
3
3
# COPYING RESTRICTIONS APPLY, see COPYRIGHT.
4
4
H1: Running slapd
5
5
 
21
21
 
22
22
>       -F <slapd-config-directory>
23
23
 
24
 
Specifies the slapd configuration directory. The default is {{F:/usr/local/etc/openldap/slapd.d}}
 
24
Specifies the slapd configuration directory. The default is {{F:/usr/local/etc/openldap/slapd.d}}.
25
25
 
26
26
If both {{EX:-f}} and {{EX:-F}} are specified, the config file will be read and converted 
27
27
to config directory format and written to the specified directory.  
80
80
 
81
81
!block table; colaligns="RL"; align=Center; \
82
82
        title="Table 7.1: Debugging Levels"
83
 
Level   Description
84
 
-1      enable all debugging
85
 
0       no debugging
86
 
1       trace function calls
87
 
2       debug packet handling
88
 
4       heavy trace debugging
89
 
8       connection management
90
 
16      print out packets sent and received
91
 
32      search filter processing
92
 
64      configuration file processing
93
 
128     access control list processing
94
 
256     stats log connections/operations/results
95
 
512     stats log entries sent
96
 
1024    print communication with shell backends
97
 
2048    print entry parsing debugging
 
83
Level   Keyword         Description
 
84
-1      any             enable all debugging
 
85
0                       no debugging
 
86
1       (0x1 trace)     trace function calls
 
87
2       (0x2 packets)   debug packet handling
 
88
4       (0x4 args)      heavy trace debugging
 
89
8       (0x8 conns)     connection management
 
90
16      (0x10 BER)      print out packets sent and received
 
91
32      (0x20 filter)   search filter processing
 
92
64      (0x40 config)   configuration processing
 
93
128     (0x80 ACL)      access control list processing
 
94
256     (0x100 stats)   stats log connections/operations/results
 
95
512     (0x200 stats2)  stats log entries sent
 
96
1024    (0x400 shell)   print communication with shell backends
 
97
2048    (0x800 parse)   print entry parsing debugging
 
98
16384   (0x4000 sync)   syncrepl consumer processing
 
99
32768   (0x8000 none)   only messages that get logged whatever log level is set
98
100
!endblock
99
101
 
100
 
You may enable multiple levels by specifying the debug option
101
 
once for each desired level.  Or, since debugging levels are
102
 
additive, you can do the math yourself. That is, if you want
103
 
to trace function calls and watch the config file being
104
 
processed, you could set level to the sum of those two levels
105
 
(in this case, {{EX: -d 65}}).  Or, you can let slapd do the
106
 
math, (e.g. {{EX: -d 1 -d 64}}).  Consult {{F: <ldap_log.h>}} for
107
 
more details.
 
102
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, {{EX: -d 65}}).  Or, you can let slapd do the math, (e.g. {{EX: -d 1 -d 64}}).  Consult {{F: <ldap_log.h>}} for more details.
108
103
 
109
 
Note: slapd must have been compiled with {{EX:-DLDAP_DEBUG}}
 
104
Note: slapd must have been compiled with {{EX:--enable-debug}}
110
105
defined for any debugging information beyond the two stats levels
111
 
to be available.
 
106
to be available (the default).
112
107
 
113
108
 
114
109
H2: Starting slapd