File: README

package info (click to toggle)
vlad 0.02-1.2
  • links: PTS
  • area: main
  • in suites: woody
  • size: 268 kB
  • ctags: 76
  • sloc: ansic: 767; sh: 330; makefile: 46
file content (106 lines) | stat: -rw-r--r-- 3,418 bytes parent folder | download
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