git.sur5r.net Git - openldap/blob - doc/man/man5/slapd-null.5

   1 .TH SLAPD-NULL 5 "RELEASEDATE" "OpenLDAP LDVERSION"
   2 .\" Copyright 2002-2016 The OpenLDAP Foundation.  All Rights Reserved.
   3 .\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
   4 .\" $OpenLDAP$
   5 .SH NAME
   6 slapd\-null \- Null backend to slapd
   7 .SH SYNOPSIS
   8 ETCDIR/slapd.conf
   9 .SH DESCRIPTION
  10 The Null backend to
  11 .BR slapd (8)
  12 is surely the most useful part of
  13 .BR slapd :
  14 .br
  15 - Searches return success but no entries.
  16 .br
  17 - Compares return compareFalse.
  18 .br
  19 - Updates return success (unless readonly is on) but do nothing.
  20 .br
  21 - Binds other than as the rootdn fail unless the database option "bind
  22 on" is given.
  23 .br
  24 - The
  25 .BR slapadd (8)
  26 and
  27 .BR slapcat (8)
  28 tools are equally exciting.
  29 .br
  30 Inspired by the /dev/null device.
  31 .SH CONFIGURATION
  32 This
  33 .B slapd.conf
  34 option applies to the NULL backend database.
  35 That is, it must follow a "database null" line and come before
  36 any subsequent "database" lines.
  37 Other database options are described in the
  38 .BR slapd.conf (5)
  39 manual page.
  40 .TP
  41 .B bind <on/off>
  42 Allow binds as any DN in this backend's suffix, with any password.
  43 The default is "off".
  44 .TP
  45 .B dosearch <on/off>
  46 If enabled, a single entry will be returned on all search requests.
  47 The entry's DN will be the same as the database suffix.
  48 The default is "off".
  49 .SH EXAMPLE
  50 Here is a possible slapd.conf extract using the Null backend:
  51 .LP
  52 .RS
  53 .nf
  54 database null
  55 suffix   "cn=Nothing"
  56 bind     on
  57 .fi
  58 .RE
  59 .SH ACCESS CONTROL
  60 The
  61 .B null
  62 backend does not honor any of the access control semantics described in
  63 .BR slapd.access (5).
  64 .SH FILES
  65 .TP
  66 ETCDIR/slapd.conf
  67 default slapd configuration file
  68 .SH SEE ALSO
  69 .BR slapd.conf (5),
  70 .BR slapd (8),
  71 .BR slapadd (8),
  72 .BR slapcat (8).