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

« back to all changes in this revision

Viewing changes to doc/guide/admin/slapdconfig.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/slapdconfig.sdf,v 1.87.2.14 2008/04/14 20:48:16 quanah Exp $
2
 
# Copyright 1999-2008 The OpenLDAP Foundation, All Rights Reserved.
 
1
# $OpenLDAP: pkg/openldap-guide/admin/slapdconfig.sdf,v 1.87.2.19 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
 
5
5
H1: The slapd Configuration File
27
27
can be overridden by database directives.
28
28
 
29
29
Blank lines and comment lines beginning with a '{{EX:#}}' character
30
 
are ignored.  If a line begins with white space, it is considered a
 
30
are ignored.  If a line begins with whitespace, it is considered a
31
31
continuation of the previous line (even if the previous line is a
32
32
comment).
33
33
 
56
56
>       ...
57
57
 
58
58
A configuration directive may take arguments.  If so, they are
59
 
separated by white space.  If an argument contains white space,
 
59
separated by whitespace.  If an argument contains whitespace,
60
60
the argument should be enclosed in double quotes {{EX:"like this"}}. If
61
61
an argument contains a double quote or a backslash character `{{EX:\}}',
62
62
the character should be preceded by a backslash character `{{EX:\}}'.
136
136
the {{syslogd}}(8) {{EX:LOG_LOCAL4}} facility). You must have
137
137
configured OpenLDAP {{EX:--enable-debug}} (the default) for this
138
138
to work (except for the two statistics levels, which are always
139
 
enabled).  Log levels are additive. To display what numbers
140
 
correspond to what kind of debugging, invoke slapd with {{EX:-?}}
 
139
enabled). Log levels may be specified as integers or by keyword.
 
140
Multiple log levels may be used and the levels are additive. To display what
 
141
numbers correspond to what kind of debugging, invoke slapd with {{EX:-d?}}
141
142
or consult the table below. The possible values for <integer> are:
142
143
 
143
144
!block table; colaligns="RL"; align=Center; \
144
145
        title="Table 6.1: Debugging Levels"
145
 
Level   Description
146
 
-1      enable all debugging
147
 
0       no debugging
148
 
1       trace function calls
149
 
2       debug packet handling
150
 
4       heavy trace debugging
151
 
8       connection management
152
 
16      print out packets sent and received
153
 
32      search filter processing
154
 
64      configuration file processing
155
 
128     access control list processing
156
 
256     stats log connections/operations/results
157
 
512     stats log entries sent
158
 
1024    print communication with shell backends
159
 
2048    print entry parsing debugging
 
146
Level   Keyword         Description
 
147
-1      any             enable all debugging
 
148
0                       no debugging
 
149
1       (0x1 trace)     trace function calls
 
150
2       (0x2 packets)   debug packet handling
 
151
4       (0x4 args)      heavy trace debugging
 
152
8       (0x8 conns)     connection management
 
153
16      (0x10 BER)      print out packets sent and received
 
154
32      (0x20 filter)   search filter processing
 
155
64      (0x40 config)   configuration processing
 
156
128     (0x80 ACL)      access control list processing
 
157
256     (0x100 stats)   stats log connections/operations/results
 
158
512     (0x200 stats2)  stats log entries sent
 
159
1024    (0x400 shell)   print communication with shell backends
 
160
2048    (0x800 parse)   print entry parsing debugging
 
161
16384   (0x4000 sync)   syncrepl consumer processing
 
162
32768   (0x8000 none)   only messages that get logged whatever log level is set
160
163
!endblock
161
164
 
162
 
\Example:
 
165
The desired log level can be input as a single integer that
 
166
combines the (ORed) desired levels, both in decimal or in hexadecimal 
 
167
notation, as a list of integers (that are ORed internally), or as a list of the names that are shown between brackets, such that
 
168
 
 
169
>               loglevel 129
 
170
>               loglevel 0x81
 
171
>               loglevel 128 1
 
172
>               loglevel 0x80 0x1
 
173
>               loglevel acl trace
 
174
 
 
175
are equivalent.
 
176
 
 
177
\Examples:
163
178
 
164
179
E: loglevel -1
165
180
 
166
181
This will cause lots and lots of debugging information to be
167
182
logged.
168
183
 
 
184
E: loglevel conns filter
 
185
 
 
186
Just log the connection and search filter processing.
 
187
 
 
188
E: loglevel none
 
189
 
 
190
Log those messages that are logged regardless of the configured loglevel. This
 
191
differs from setting the log level to 0, when no logging occurs. At least the
 
192
{{EX:None}} level is required to have high priority messages logged.
 
193
 
169
194
\Default:
170
195
 
171
 
E: loglevel 256
 
196
E: loglevel stats
172
197
 
 
198
Basic stats logging is configured by default. However, if no loglevel is
 
199
defined, no logging occurs (equivalent to a 0 level).
173
200
 
174
201
H4: objectclass <{{REF:RFC4512}} Object Class Description>
175
202
 
203
230
 
204
231
>       sizelimit 500
205
232
 
 
233
See the {{SECT:Limits}} section of this guide and slapd.conf(5)
 
234
for more details.
206
235
 
207
236
H4: timelimit <integer>
208
237
 
215
244
 
216
245
>       timelimit 3600
217
246
 
 
247
See the {{SECT:Limits}} section of this guide and slapd.conf(5)
 
248
for more details.
 
249
 
218
250
 
219
251
H3: General Backend Directives
220
252
 
273
305
declaration.
274
306
 
275
307
 
 
308
H4: limits <who> <limit> [<limit> [...]]
 
309
 
 
310
Specify time and size limits based on who initiated an operation.
 
311
 
 
312
See the {{SECT:Limits}} section of this guide and slapd.conf(5)
 
313
for more details.
 
314
 
 
315
 
276
316
H4: readonly { on | off }
277
317
 
278
318
This directive puts the database into "read-only" mode. Any