ud(1) [redhat man page]

UD(1)							      General Commands Manual							     UD(1)

NAME

       ud - interactive LDAP Directory Server query program

SYNOPSIS

       ud [-Dv] [-s server] [-d debug-mask] [-l ldap-debug-mask] [-f file]

DESCRIPTION

       ud is used to interogate a directory server via the Lightweight Directory Access Protocol (LDAP).

OPTIONS

       -s server Used  to  specify  the name of an LDAP server to which ud should connect.  If this flag is omitted, the value specified in the ud
		 configuration file is used.  If no value is specified in the configuration file, or the configuration file does  not  exist,  the
		 name  ldap  is used.  Of course, it is up to the system administrator to make sure that the name ldap can be resolved (presumably
		 through the use of a CNAME or A record in the DNS and the appropriate search path specified in the resolver config file).

       -d debug-mask
		 Sets the ud debug mask to the value specified.  Values for the mask can be dumped by using the -D flag.

       -f file	 Sets the configuration file to the name specified.

       -l ldap-debug-mask
		 Sets the LDAP debug mask to the value specified.

       -v	 Turns on verbose output.  Also toggable via the ud verbose command.

       -D	 Prints out a list of valid ud debug masks.

FILES

       /etc/openldap/ud.conf	     The ud configuration file.

SEE ALSO

       ud.conf(5), ldap.conf(5), ldap(3)

DIAGNOSTICS

       ud will try to be nice about error conditions, and in most cases prints a warm and fuzzy error message when it encounters a problem.  Some-
       times the error will be unexpected, and in these cases, ud uses the ldap_perror() routine to print an informative diagnostic.

BUGS

       Too numerous to mention.

AUTHOR

       Bryan Beecher, University of Michigan

ACKNOWLEDGEMENTS

       OpenLDAP  is  developed and maintained by The OpenLDAP Project (http://www.openldap.org/).  OpenLDAP is derived from University of Michigan
       LDAP 3.3 Release.

4.3 Berkeley Distribution					  20 August 2000							     UD(1)

UD.CONF(5)							File Formats Manual							UD.CONF(5)

NAME

       ud.conf - ud configuration file

SYNOPSIS

       /etc/openldap/ud.conf

DESCRIPTION

       The  ud	configuration file is used to set system-wide defaults to be applied when running ud.  Note that each user may specify an optional
       configuration file, .udrc, in his/her home directory which will be used instead of the system-wide configuration file.

OPTIONS

       The different configuration options are:

       HOST <name>
		 Used to specify the name of an LDAP server to which ud should connect.  There may  be	only  one  entry  per  config  file.   The
		 server's name can be specified as a domain-style name or an IP address.

       BASE <base>
		 Used to specify the search base to use when performing search operations.  The base may be changed by those using ud by using the
		 cb command.  There may be only one entry per config file.  The base must be specified as a Distinguished Name in LDAP format.

       GROUPBASE <base>
		 Used to specify the base used when creating groups.  The base may be changed by those using ud by using the changegroup  command.
		 There may be only one entry per config file.  The base must be specified as a Distinguished Name in LDAP format.

       SEARCH <algorithm>
		 Used  to specify a search algorithm to use when performing searches.  More than one algorithm may be specified, and each is tried
		 in turn until a suitable response is found.

		 Each algorithm specifies a filter that should be used when performing a find operation.   Filters  contain  LDAP-style  attribute
		 types	(e.g.,	uid,  cn, postalAddress) and operators to test for equality or approximate equality.  Prefix operators may also be
		 used to specify AND, OR and NOT operations (see ldap(3) for more details on the filter format).  Algorithms  use  a  compile-time
		 constant  as a separator to use when parsing the input the user has provided.	This parsed input can then be referenced similarly
		 to an awk program using symbols like $1, $2, and $0 for the entire batch of input.

		 For example, the algoritm cn=$0 causes ud to perform a lookup on the entire string the user has  typed,  searching  for  anything
		 where the commonName exactly matches the whole thing.

		 Another  example, sn~=$NF causes ud to do a search where the last element the user has typed (NF = number of fields and is a spe-
		 cial "number" that can be used in awk as well as ud) searching for any matches that approximately match Surname.

		 Search algorithms also support a special feature which allows one to specify the exact number of fields that must be  present	in
		 order for the algorithm to be applied.  This number must be specified between square brackets.

		 For  example,	[1]  uid=$1  causes  this  algorithm to be applied when the number of fields is exactly equal to one.  If there is
		 exactly one field, the token is looked up as a UID.

FILES

       /etc/openldap/ud.conf

SEE ALSO

       ud(1), ldap(3)

AUTHOR

       Bryan Beecher, University of Michigan

ACKNOWLEDGEMENTS

       OpenLDAP is developed and maintained by The OpenLDAP Project (http://www.openldap.org/).  OpenLDAP is derived from University  of  Michigan
       LDAP 3.3 Release.

4.3 Berkeley Distribution					  20 August 2000							UD.CONF(5)