1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106
|
README for Vlad v0.02
---------------------
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.
Of course this isn't finished. Feel free to check out the todo file to see what
I have planned.
If you find any bugs in this code or have any suggestions, feel free to contact
me at rob@nauseum.org.
Robert Norris
2001-03-09
Installation
------------
Vlad is developed on an i386 Linux system with glibc 2.2. It will compile out
of the box against both the OpenLDAP (1.x, 2.x) and Netscape (3.0x, 4.0x, 4.1x,
4.11) LDAP SDKs
Installation should be simple, just
./configure
make
make install
configure can be called with options --with-ldap-lib and --with-ldap-include if
your LDAP installation is in a non-standard location.
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.
I'd be interested to hear reports from people who get it to work on other
systems.
Running
-------
To run, type 'vlad'. You may or may not need the following options:
-h host
Required. Sets the hostname of the LDAP server
-p port
Sets the port of the LDAP server. Defaults to 389
-b base DN
Required. Sets the base DN for LDAP searches
-D bind DN
Sets the DN to bind to the server as. Default is anonymous.
-w password
Sets the password associated with the bind DN.
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-2001 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
|