git.sur5r.net Git - openldap/blob - contrib/slapd-modules/usn/README

   1 This directory contains a slapd overlay, usn, that extends slapd
   2 to maintain the usnCreated and usnChanged operational attributes
   3 normally used by Microsoft ActiveDirectory.
   4
   5 To use the overlay, add:
   6
   7         moduleload <path to>usn.so
   8         ...
   9
  10         database mdb
  11         ...
  12         overlay usn
  13
  14 to your slapd configuration file. The schema definitions for the
  15 two USN attributes are hardcoded in this overlay.
  16
  17 Use Makefile to compile this plugin or use a command line similar to:
  18
  19         gcc -c -I ../../include/ -I ../../servers/slapd -DSLAPD_OVER_USN=SLAPD_MOD_DYNAMIC usn.c
  20         gcc -shared -o usn.so usn.o
  21
  22 This overlay is only set up to be built as a dynamically loaded module.
  23 On most platforms, in order for the module to be usable, all of the
  24 library dependencies must also be available as shared libraries.
  25
  26 If you need to build the overlay statically, you will have to move it into the
  27 slapd/overlays directory and edit the Makefile and overlays.c to reference
  28 it. You will also have to define SLAPD_OVER_USN to SLAPD_MOD_STATIC,
  29 and add the relevant libraries to the main slapd link command.
  30
  31 ---
  32 This work is part of OpenLDAP Software <http://www.openldap.org/>.
  33
  34 Copyright 2007-2015 The OpenLDAP Foundation.
  35 Portions Copyright 2007 Howard Chu, Symas Corp. All rights reserved.
  36
  37 Redistribution and use in source and binary forms, with or without
  38 modification, are permitted only as authorized by the OpenLDAP
  39 Public License.
  40
  41 A copy of this license is available in the file LICENSE in the
  42 top-level directory of the distribution or, alternatively, at
  43 <http://www.OpenLDAP.org/license.html>.
  44