Read Me
______________________________________________________________________________
yp2ldap
-------
This is a Perl script that symlinks to ypwhich, ypcat and ypmatch. It is a
hook script that returns the results you would have expected from NIS, but
uses LDAP instead to obtain the results.
It uses Kerberos, so you must have Kerberos authentication set-up and you
should already have a ticket available (run kinit).
The following files are used by yp2ldap:
bin/ypcat symlink that invokes ypcat behaviour.
bin/ypmatch symlink that invokes ypmatch behaviour.
bin/ypwhich symlink that invokes ypwhich behaviour.
etc/nicknames provides NIS map nicknames and their full map name,
and is identical to the standard NIS nicknames file.
etc/ldap.conf provides the URI to use when contacting LDAP (uri <uri>),
if this file does not exist will look in /etc/ldap.conf,
can be overridden by the YP2LDAP_CONF environment variable.
etc/example.com some example map configuration files for a hypothetical
NIS domain called 'example.com':
- map top-level map
- autofs name and locations of automounter maps
- network name and locations of various network-related maps
- nss name of maps that use NSS instead (via the getent command)
The yp2ldap tool has been tested on RHEL 5 and obtains the NIS domain name
from /etc/sysconfig/network. The corresponding map files are then looked
up in the etc/<domain> directory. Examples provided for 'example.com'.
The tool will also look in /etc/defaultdomain for a NIS domain name, so should
work ok in Solaris.
The 'etc' directory is located using the following search order:
- YP2LDAP_ETCDIR environment variable
- TOPDIR/etc/yp2ldap
- TOPDIR/etc
See INSTALL file in top-level of source distribution for instructions on how to
install or uninstall. See COPYING for copyright, license and usage conditions.
______________________________________________________________________________