git.sur5r.net Git - openldap/blob - contrib/saucer/README

   1 This directory contains a set of files that build a simple LDAP client
   2 program.  The program is command-line oriented and uses a syntax and
   3 command set roughly similar to ISODE's DISH program, hence it is
   4 named "saucer" (i.e. a very small "dish" :-)
   5
   6 To build saucer, you must first build OpenLDAP, and then say
   7         cd contrib/saucer
   8         make depend
   9         make
  10 You can then install it by doing an "su" and typing "make install".
  11 This will copy the binary to the directory you specified for LDAP
  12 binaries, and the man page will be placed in the appropriate man
  13 directory.
  14
  15 If you wish saucer to use GNU Readline, you must have set CPPFLAGS and
  16 LDFLAGS so that <readline/readline.h> and -lreadline will be found when
  17 you configured OpenLDAP, e.g.
  18   env CPPFLAGS="-I/usr/gnu/include" LDFLAGS="-L/usr/gnu/lib" ./configure
  19
  20
  21 Saucer runs from the Unix command line with the following arguments:
  22
  23   saucer [-h host] [-p portnumber] [-u 'X500UserName']
  24          [-c credentials] [-d debug-level]
  25
  26 If no options are given, saucer will attempt to connect to an LDAP
  27 daemon on the local host and default port (389), and will attempt to
  28 bind anonymously.
  29
  30 Typing "help" at saucer's command prompt will yield:
  31
  32 saucer dn=> help
  33 Supported commands are:
  34   help
  35   list
  36   moveto
  37   quit
  38   search
  39   set
  40   show
  41
  42 You can get syntactical help for a command by typing "help <command>".
  43 Detailed instructions are available from the saucer man page.
  44
  45 Any comments or questions should be directed to:
  46
  47       Eric.Rosenquist@strataware.com
  48
  49 or to an OpenLDAP mailinglist, see <URL:http://www.openldap.org/lists/>.