This is the reference implementation of Directory-Based Information Services
which is described in the following Internet Drafts:
http://www.ietf.org/id/draft-bannister-dbis-mapping.txt
http://www.ietf.org/id/draft-bannister-dbis-netgroup.txt
http://www.ietf.org/id/draft-bannister-dbis-passwd.txt
http://www.ietf.org/id/draft-bannister-dbis-hosts.txt
http://www.ietf.org/id/draft-bannister-dbis-devices.txt
http://www.ietf.org/id/draft-bannister-dbis-automounter.txt
http://www.ietf.org/id/draft-bannister-dbis-custom.txt
This source distribution is organised as follows:
src/bin - Front-end scripts
src/dbis - DBIS libraries and utilities
src/doc - documentation
src/etc - DBIS configuration files
src/pyloom - Pyloom TCP server library
src/perl - Perl client library
src/tests - test suite run by 'make check'
src/nsstests - NSS test suite
nss - external NSS library
ldif - LDAP schema
DBIS requires Python 2.x (2.4 or later) and the python-ldap module from
http://www.python-ldap.org. Although dbis-cachemgr should work with any
reasonably modern version of python-ldap, there is a performance enhancement
that is automatically enabled if you are using version 2.4.17 that will reduce
the background load on the CPUs when there are pending LDAP search operations.
If you can use version 2.4.17 or later it is recommended that you do. If you
can't, earlier versions will work just fine too.
DBIS can output data in JSON format, but requires a Python JSON library
to do that. It will try UltraJSON (ujson) first and if that is not found
it will attempt to import json instead. If there is no JSON library
available the server will function but JSON output will be disabled.
For help using the command-line interface, run:
man dbis
For help using the Python library, run:
python -c 'import dbis.client; help(dbis.client)'
For help using the Perl library, run:
perldoc DBIS::Client
There is also an extensive Wiki site at http://dbis.sf.net containing
lots of useful documentation.
See NEWS for the latest available features and functionality.
See COPYRIGHT for applicable copyright notices.
See COPYING for copying conditions.
------------------------------------------------------------------------------
Mark R. Bannister
Email: cambridge@users.sourceforge.net