README for Vlad v0.01
---------------------

Vlad is an LDAP visualisation tool. It can be used to browse the entries an
attributes of an LDAP tree.

It was conceived after seeing the excellent PHP based 'LDAP Explorer'
( http://igloo.its.unimelb.edu.au/LDAPExplorer/ ). Being a console junkie,
I wanted a text version of the same thing.

Meanwhile, in a completely unrelated part of the world, Daniel Burrows from the
Debian ( http://debian.org/ ) Project came up 'aptitude', a console-based
interface to the Debian package management system. I use this tool daily and
have found the user interface very intuitive.

What could be more useful than a combination of these two programs? (at least
in my line of work ;)

Basic functionality is in place. You can browse an LDAP tree and view
individual entries. Future enhancements will include:

 - searches
 - ability to edit entries
 - ability to bind as different users
 - ability to export parts of the tree as an LDIF file

For full details of changes between this version and previous versions, see the
changelog.

If you find any bugs in this code or have any suggestions, feel free to contact
me at rob@nauseum.org.

Robert Norris
2000-05-23


Installation
------------

Vlad is developed on an i386 Linux system with glibc 2.1. It should compile
on most Unices.

Installation should be simple, just

	./configure --with-ldap-server=HOSTNAME --with-ldap-base-dn=BASEDN
	make
	make install

I don't have access to any other machines, so if you try to compile it and it
doesn't work, send me a full log of the output of configure and make, and I'll
see what I can do. Alternatively, fix it yourself and send me a diff :)

Unfortunately, LDAP server details have to be entered at compile time. A future
version will address this.


Running
-------

To run, simply type 'vlad'.

In the program itself, use the following keys.

q			return to previous screen / exit program
up,down,pgup,pgdown	scroll data on screen
enter			expand / collapse tree
space			view attributes


Licence
-------

    Vlad is copyright (C) 1999-2000 Robert Norris <rob@nauseum.org>

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

