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

« back to all changes in this revision

Viewing changes to doc/guide/admin/slapdconf2.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/slapdconf2.sdf,v 1.20.2.12 2008/04/14 22:37:01 quanah Exp $
2
 
# Copyright 2005-2008 The OpenLDAP Foundation, All Rights Reserved.
 
1
# $OpenLDAP: pkg/openldap-guide/admin/slapdconf2.sdf,v 1.20.2.18 2009/02/06 16:38:31 quanah Exp $
 
2
# Copyright 2005-2009 The OpenLDAP Foundation, All Rights Reserved.
3
3
# COPYING RESTRICTIONS APPLY, see COPYRIGHT.
4
4
 
5
5
H1: Configuring slapd
125
125
prefix attached.
126
126
 
127
127
A configuration directive may take arguments.  If so, the arguments are
128
 
separated by white space.  If an argument contains white space,
 
128
separated by whitespace.  If an argument contains whitespace,
129
129
the argument should be enclosed in double quotes {{EX:"like this"}}.
130
130
In the descriptions that follow, arguments that should be replaced
131
131
by actual text are shown in brackets {{EX:<>}}.
171
171
enabled). Log levels may be specified as integers or by keyword.
172
172
Multiple log levels may be used and the levels are additive.
173
173
To display what levels
174
 
correspond to what kind of debugging, invoke slapd with {{EX:-?}}
 
174
correspond to what kind of debugging, invoke slapd with {{EX:-d?}}
175
175
or consult the table below. The possible values for <level> are:
176
176
 
177
177
!block table; colaligns="RL"; align=Center; \
178
178
        title="Table 5.1: Debugging Levels"
179
 
Level   Keyword Description
180
 
-1      Any     enable all debugging
181
 
0               no debugging
182
 
1       Trace   trace function calls
183
 
2       Packets debug packet handling
184
 
4       Args    heavy trace debugging
185
 
8       Conns   connection management
186
 
16      BER     print out packets sent and received
187
 
32      Filter  search filter processing
188
 
64      Config  configuration processing
189
 
128     ACL     access control list processing
190
 
256     Stats   stats log connections/operations/results
191
 
512     Stats2  stats log entries sent
192
 
1024    Shell   print communication with shell backends
193
 
2048    Parse   print entry parsing debugging
194
 
4096    Cache   database cache processing
195
 
8192    Index   database indexing
196
 
16384   Sync    syncrepl consumer processing
 
179
Level   Keyword         Description
 
180
-1      any             enable all debugging
 
181
0                       no debugging
 
182
1       (0x1 trace)     trace function callss
 
183
2       (0x2 packets)   debug packet handling
 
184
4       (0x4 args)      heavy trace debugging
 
185
8       (0x8 conns)     connection management
 
186
16      (0x10 BER)      print out packets sent and received
 
187
32      (0x20 filter)   search filter processing
 
188
64      (0x40 config)   configuration processing
 
189
128     (0x80 ACL)      access control list processing
 
190
256     (0x100 stats)   stats log connections/operations/results
 
191
512     (0x200 stats2)  stats log entries sent
 
192
1024    (0x400 shell)   print communication with shell backends
 
193
2048    (0x800 parse)   print entry parsing debugging
 
194
16384   (0x4000 sync)   syncrepl consumer processing
 
195
32768   (0x8000 none)   only messages that get logged whatever log level is set
197
196
!endblock
198
197
 
199
 
\Example:
200
 
 
201
 
E: olcLogLevel: -1
 
198
The desired log level can be input as a single integer that
 
199
combines the (ORed) desired levels, both in decimal or in hexadecimal 
 
200
notation, as a list of integers (that are ORed internally), or as a list of the names that are shown between brackets, such that
 
201
 
 
202
>               olcLogLevel 129
 
203
>               olcLogLevel 0x81
 
204
>               olcLogLevel 128 1
 
205
>               olcLogLevel 0x80 0x1
 
206
>               olcLogLevel acl trace
 
207
 
 
208
are equivalent.
 
209
 
 
210
\Examples:
 
211
 
 
212
E: olcLogLevel -1
202
213
 
203
214
This will cause lots and lots of debugging information to be
204
215
logged.
205
216
 
206
 
E: olcLogLevel: Conns Filter
 
217
E: olcLogLevel conns filter
207
218
 
208
219
Just log the connection and search filter processing.
209
220
 
 
221
E: olcLogLevel none
 
222
 
 
223
Log those messages that are logged regardless of the configured loglevel. This
 
224
differs from setting the log level to 0, when no logging occurs. At least the
 
225
{{EX:None}} level is required to have high priority messages logged.
 
226
 
210
227
\Default:
211
228
 
212
 
E: olcLogLevel: Stats
 
229
E: olcLogLevel stats
 
230
 
 
231
Basic stats logging is configured by default. However, if no olcLogLevel is
 
232
defined, no logging occurs (equivalent to a 0 level).
213
233
 
214
234
 
215
235
H4: olcReferral <URI>
474
494
 
475
495
>       olcSizeLimit: 500
476
496
 
 
497
See the {{SECT:Limits}} section of this guide and slapd-config(5)
 
498
for more details.
477
499
 
478
500
 
479
501
H4: olcSuffix: <dn suffix>
668
690
 
669
691
>       olcTimeLimit: 3600
670
692
 
 
693
See the {{SECT:Limits}} section of this guide and slapd-config(5)
 
694
for more details.
 
695
 
671
696
 
672
697
H4: olcUpdateref: <URL>
673
698
 
885
910
this option, slapadd does no indexing and slapindex must be used.
886
911
 
887
912
 
888
 
H4: olcDbMode: <integer>
 
913
H4: olcDbMode: { <octal> | <symbolic> }
889
914
 
890
915
This directive specifies the file protection mode that newly
891
 
created database index files should have.
 
916
created database index files should have. This can be in the form
 
917
{{EX:0600}} or {{EX:-rw-------}}
892
918
 
893
919
\Default:
894
920