openldap/contrib/saucer
Kurt Zeilenga dc07e765f2 Vienna Bulk Commit
This commit includes many changes.  All changes compile under NT but
have not been tested under UNIX.

A Summary of changes (likely incomplete):

NT changes:
	Removed lint.
	Clean up configuration support for "Debug", "Release", "SDebug",
		and "SRelease" configurations.
	Share output directories for clients, libraries,
		and slapd.  (maybe they should be combined further
		and moved to build/{,S}{Debug,Release}).
	Enable threading when _MT is defined.
	Enable debuging when _DEBUG is defined.
	Disable setting of NDEBUG under Release/SRelease.  Asserts
		are disabled in <ac/assert.h> when LDAP_DEBUG is not
		defined.
	Added 'build/main.dsp' Master project.
	Removed non-slapd projects from slapd.dsp (see main.dsp).
	Removed replaced many uses of _WIN32 macro with feature based
		macros.

ldap_cdefs.h changes
	#define LDAP_CONST const
		(see below)
	#define LDAP_F(type) LDAP_F_PRE type LDAP_F_POST
		To allow specifiers to be added before and after
		the type declaration.  (For DLL handling)

LBER/LDAP changes
	Namespace changes:
		s/lber_/ber_/ for here and there.
		s/NAME_ERROR/LDAP_NAME_ERROR/g
	Deleted NULLMSG and other NULL* macros for namespace reasons.
	"const" libraries.  Installed headers (ie: lber.h, ldap.h)
		use LDAP_CONST macro.  Normally set to 'const' when
		__STDC__.  Can be set externally to enable/disable
		'constification' of external interface.  Internal
		interface always uses 'const'.  Did not fix warnings
		in -lldif (in lieu of new LDIF parser).

	Added _ext API implementations (excepting search and bind).
		Need to implement ldap_int_get_controls() for reponses
		with controls.

	Added numberous assert() checks.

LDAP_R
	_MT defines HAVE_NT_THREADS
	Added numberous assert() checks.
	Changed ldap_pthread_t back to unsigned long.  Used cast
	to HANDLE in _join().

LDBM
	Replaced _WIN32 with HAVE_SYSLOG

ud
	Added version string if MKVERSION is not defined.  (MKVERSION
		needs to be set under UNIX).

slapd
	Made connection sockbuf field a pointer to a sockbuf.  This
		removed slap.h dependency on lber-int.h.  lber-int.h now only
		included by those files needing to mess with the sockbuf.
	Used ber_* functions/macros to access sockbuf internals whenever
		possible.
	Added version string if MKVERSION is not defined.  (MKVERSION
		needs to be set under UNIX).
	Removed FD_SET unsigned lint

slapd/tools
	Used EXEEXT to added ".exe" to routines.  Need to define EXEEXT
		under UNIX.

ldappasswd
	Added ldappasswd.dsp.  Ported to NT.  Used getpid() to seed rand().

nt_debug
	Minor cleanup.  Added "portable.h" include and used <ac/*.h> where
	appropriate.  Added const to char* format argument.
1999-05-19 01:12:33 +00:00
..
main.c Vienna Bulk Commit 1999-05-19 01:12:33 +00:00
Makefile.in Install man page from 26797srcdir in case building from a seperate builddir 1999-05-04 12:39:12 +00:00
README Update README to reflect recent changes. 1999-03-11 19:52:05 +00:00
sample.saucerrc
saucer.1 Change U-M LDAP to OpenLDAP in manpage 1999-03-11 19:45:38 +00:00

This directory contains a set of files that build a simple LDAP client
program.  The program is command-line oriented and uses a syntax and
command set roughly similar to ISODE's DISH program, hence it is
named "saucer" (i.e. a very small "dish" :-)

To build saucer, you must first build OpenLDAP, and then say
	cd contrib/saucer
	make depend
	make
You can then install it by doing an "su" and typing "make install".
This will copy the binary to the directory you specified for LDAP
binaries, and the man page will be placed in the appropriate man
directory.

If you wish saucer to use GNU Readline, you must have set CPPFLAGS and
LDFLAGS so that <readline/readline.h> and -lreadline will be found when
you configured OpenLDAP, e.g.
  env CPPFLAGS="-I/usr/gnu/include" LDFLAGS="-L/usr/gnu/lib" ./configure


Saucer runs from the Unix command line with the following arguments:

  saucer [-h host] [-p portnumber] [-u 'X500UserName']
         [-c credentials] [-d debug-level]

If no options are given, saucer will attempt to connect to an LDAP
daemon on the local host and default port (389), and will attempt to
bind anonymously.

Typing "help" at saucer's command prompt will yield:

saucer dn=> help
Supported commands are:
  help
  list
  moveto
  quit
  search
  set
  show

You can get syntactical help for a command by typing "help <command>".
Detailed instructions are available from the saucer man page.

Any comments or questions should be directed to:

      Eric.Rosenquist@strataware.com

or to an OpenLDAP mailinglist, see <URL:http://www.openldap.org/lists/>.