From 05059be1908132d52da5a357427fb42a364fd2f1 Mon Sep 17 00:00:00 2001 From: Kurt Zeilenga Date: Fri, 20 Nov 1998 03:12:46 +0000 Subject: [PATCH] Update INSTALL/README files with references to new documents. Added new developer todo list. --- INSTALL | 5 +++++ README | 46 +++++++++++++++++++++++++--------------------- doc/devel/todo | 40 ++++++++++++++++++++++++++++++++++++++++ 3 files changed, 70 insertions(+), 21 deletions(-) create mode 100644 doc/devel/todo diff --git a/INSTALL b/INSTALL index 3e76e3a34f..aeaeb02b5a 100644 --- a/INSTALL +++ b/INSTALL @@ -1,7 +1,12 @@ Making and Installing the OpenLDAP Distribution +** ** It is recommended that you read or at least skim through ALL of the ** instructions in this file before attempting to build the software. +** +** You should also check for platform specific hints. +** These are located in doc/install/hints. +** If you want to build binaries for more than one platform from a single source tree, skip ahead to the "Building LDAP For More Than One Platform" diff --git a/README b/README index 5858d95a55..1529e000ed 100644 --- a/README +++ b/README @@ -4,12 +4,16 @@ OpenLDAP Devel README and unproven bug fixes. Many of these changes will cause previous working programs to fail. + Additional developer documents are available in doc/devel, + todo list + guidelines for developers + Client developers seeking a stable development platform should use -stable. -OpenLDAP 1.1 Alpha README - This is the OpenLDAP version 1.1 Alpha. +OpenLDAP 1.1 Alpha README + This is the OpenLDAP version 1.1 Alpha. For a description of what this distribution contains, see the ANNOUNCEMENT file in this directory. For a description of @@ -17,9 +21,13 @@ OpenLDAP 1.1 Alpha README directory. For a more detailed description of how to make an install the distribution, see the INSTALL file in this directory. + Additional installation information, such as per platform + hints can be found in the doc/install directory. + For more information: http://www.OpenLDAP.org/ + REQUIRED SOFTWARE Build OpenLDAP requires the following software components: @@ -30,34 +38,23 @@ REQUIRED SOFTWARE SLAPD: LDBM compatible datastore (Berkeley DB, Sleepycat DB2, or GDBM) + SLURPD: LTHREAD compatible thread package (POSIX pthreads, MIT pthreads, Mach Cthreads or Sun LWP) LDAPD: - ISODE compatible ldap distribution + ISODE compatible X.500 distribution - CLIENTS/CONTRIBware: + CLIENTS/CONTRIB ware: Depends on package. See per package README. MAKING AND INSTALLING THE DISTRIBUTION + This is a quick guide. For details, see the INSTALL file. - You should be able to make and install the distribution with a - default configuration by typing the following commands: - - % ./configure --help - This will list the available options. - The configure script will also use your environmental - variables for determining compiler/linker options. - These environment variables are used: - CC C compiler (cc, ecgs) - CFLAGS C Flags (-ansi) - CPPFLAGS CPP Flags (-I -D) - LDFLAGS LDFLAGS (-L -l) - - % [env settings] ./configure [options] - this will configure the build system + % ./configure + autoconf OpenLDAP for current platform % make depend this will create dependency information @@ -80,19 +77,26 @@ MAKING AND INSTALLING THE DISTRIBUTION See the INSTALL file in this directory for more information. -DOCUMENTATION +DOCUMENTATION There are man pages for most programs in the distribution and routines in the various libraries. See ldap(3) for details. + Additional documentation can be found in the doc directory. + doc/devel Developer Information + doc/drafts LDAP-related IETF drafts + doc/install Installation and Integration + doc/man Raw man(1) pages + doc/rfcs LDAP-related Request for Comments + There is an OpenLDAP homepage available that contains the latest LDAP news, releases announcements, pointers to other LDAP resources, etc. You can access it at this URL: http://www.OpenLDAP.org/ -FEEDBACK / PROBLEM REPORTS / DISCUSSIONS +FEEDBACK / PROBLEM REPORTS / DISCUSSIONS We would appreciate any feedback you can provide. If you have problems, report them to this address: diff --git a/doc/devel/todo b/doc/devel/todo new file mode 100644 index 0000000000..cac3e5bafb --- /dev/null +++ b/doc/devel/todo @@ -0,0 +1,40 @@ +OpenLDAP To Do List +------------------- + +This is a list of projects that need getting done. They are defined +by scale of the effort as opposed to priority. Contribute to projects +based upon your personal priorities. + +If you would like to work on any of these projects, contact the +please coordinate with the listed individual. If no one is +listed, contact . + +If you have a project you'd like added to the list, talk it up +on -devel. + + +Larger than life projects +------------------------- +LDAPv3 support +LDAP C API (draft-ietf-ldapext-ldap-c-api-xx) support +Schema Repository +Modify -lldap to be operation-level multithreaded + +Large projects +-------------- +redesign slapd threading +autoconf support +Modify -lldap to be session-level multithreaded + + +Medium projects +--------------- +Modify -lldap to be reentrant/threadsafe + + +Small projects +-------------- +Modify -lldap to not use non-reentrant library functions +Create ldapurl (from ldapsearch?) to support searching by URL +Create ldappasswd to support generation of crypt, sha1, md5 passwords. + -- 2.39.5