mahlon
416a458607
FossilOrigin-Name: 6e85cfd34f81b729d25e3c6b869e08160288857f60bcf1e44ef8acd312ac9b90
107 lines
2.8 KiB
Markdown
107 lines
2.8 KiB
Markdown
Shelldap
|
|
========
|
|
|
|
A handy shell-like interface for browsing LDAP servers and editing their
|
|
content. It keeps command history, has sane autocompletes, credential caching,
|
|
site-wide and individual configs, and it's fun to say.
|
|
Shelldap! Shelldap! Shelldap!
|
|
|
|
Witness!
|
|
|
|
|
|
```
|
|
% shelldap
|
|
~ > [ tab ]
|
|
~ >
|
|
cat clear cp delete env grep id ls move passwd read search touch whoami
|
|
cd copy create edit exit help list mkdir mv pwd rm setenv vi
|
|
~ > cd ou=People
|
|
ou=People,~ > cat uid=ma[ tab ]
|
|
ou=People,~ > cat uid=mahlon
|
|
|
|
dn: uid=mahlon,ou=People,dc=laika,dc=com
|
|
objectClass: inetOrgPerson
|
|
objectClass: organizationalPerson
|
|
objectClass: person
|
|
objectClass: top
|
|
objectClass: posixAccount
|
|
objectClass: shadowAccount
|
|
objectClass: apple-user
|
|
cn: Mahlon E. Smith
|
|
departmentNumber: Technology - IT
|
|
displayName: Mahlon
|
|
gecos: Mahlon E. Smith
|
|
gidNumber: 200
|
|
givenName: Mahlon
|
|
homeDirectory: /home/m/mahlon
|
|
l: Ghetto
|
|
loginShell: /bin/tcsh
|
|
mail: mahlon@martini.nu
|
|
mobile: 1+8829999005747
|
|
sn: Smith
|
|
title: Manager, Information Systems
|
|
uid: mahlon
|
|
uidNumber: 20933
|
|
userPassword: *
|
|
|
|
ou=People,~ >
|
|
```
|
|
|
|
|
|
Downloads
|
|
---------
|
|
|
|
You can download the latest script
|
|
[here](https://code.martini.nu/fossil/shelldap/tarball/tip/shelldap-tip.tar.gz).
|
|
|
|
It is also available via the
|
|
[FreeBSD ports](https://ports.freebsd.org/cgi/ports.cgi?query=shelldap&stype=all&sektion=all) system,
|
|
OS X via [macports](https://trac.macports.org/browser/trunk/dports/net/shelldap/Portfile),
|
|
Debian/Ubuntu via [apt](https://packages.debian.org/shelldap),
|
|
NetBSD's [pkgsrc](http://cdn.netbsd.org/pub/pkgsrc/current/pkgsrc/sysutils/shelldap/index.html),
|
|
OpenBSD [ports](https://openports.pl/path/sysutils/shelldap),
|
|
openSUSE's [build service](https://software.opensuse.org/package/shelldap?search_term=shelldap),
|
|
Arch's User Repository [AUR](https://aur.archlinux.org/packages/shelldap),
|
|
and as a Fedora [RPM](https://src.fedoraproject.org/rpms/shelldap).
|
|
|
|
Many thanks to the maintainers of these packages.
|
|
|
|
|
|
Installation
|
|
-------------
|
|
|
|
Shelldap is simply a perl script. Put it into a convenient place of your choosing.
|
|
|
|
Shelldap requires the following perl modules to function properly:
|
|
|
|
* YAML::Syck
|
|
* Term::Shell
|
|
* Digest::MD5
|
|
* Net::LDAP
|
|
* Algorithm::Diff
|
|
|
|
Additional functionality is supported with the presence of:
|
|
|
|
* IO::Socket::SSL
|
|
* Authen::SASL
|
|
* Term::ReadLine::Gnu
|
|
|
|
|
|
Development
|
|
-----------
|
|
|
|
|
|
You can also check out the source via [Fossil](http://fossil-scm.org/) from the following uri:
|
|
|
|
% fossil clone https://code.martini.nu/fossil/shelldap
|
|
|
|
or via its [GitHub](https://github.com/) mirror at:
|
|
|
|
% git clone https://github.com/mahlonsmith/shelldap.git
|
|
|
|
|
|
Documentation
|
|
-------------
|
|
|
|
Once installed, Shelldap is fully documented via perldoc, and has a built-in `help` command as well.
|
|
|