git.sur5r.net Git - openldap/blob - doc/man/man1/ud.1

   1 .TH UD 1 "10 November 1998" "OpenLDAP LDVERSION"
   2 .\" $OpenLDAP$
   3 .\" Copyright 1998-1999 The OpenLDAP Foundation All Rights Reserved.
   4 .\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
   5 .UC 6
   6 .SH NAME
   7 ud \- interactive LDAP Directory Server query program
   8 .SH SYNOPSIS
   9 .B ud
  10 [\c
  11 .BR -Dv ]
  12 .RB [ -s
  13 .IR server ]
  14 .RB [ -d
  15 .IR debug-mask ]
  16 .RB [ -l
  17 .IR ldap-debug-mask ]
  18 .RB [ -f
  19 .IR file ]
  20 .SH DESCRIPTION
  21 .IR ud
  22 is used to interogate a directory server via the Lightweight Directory
  23 Access Protocol (LDAP).
  24 .SH OPTIONS
  25 .TP 1i
  26 .BI \-s \ server
  27 Used to specify the name of an LDAP server to which
  28 .B ud
  29 should connect.  If this
  30 flag is omitted, the value specified in the
  31 .B ud
  32 configuration file is used.  If
  33 no value is specified in the configuration file, or the configuration
  34 file does not exist, the name
  35 .IR ldap
  36 is used.  Of course, it is up to the system administrator to make sure that
  37 the name
  38 .IR ldap
  39 can be resolved (presumably through the use of a CNAME or A record in the DNS
  40 and the appropriate search path specified in the resolver config file).
  41 .TP 1i
  42 .BI \-d \ debug-mask
  43 Sets the
  44 .B ud
  45 debug mask to the value specified.
  46 Values for the mask can be dumped by using the
  47 .IR \-D
  48 flag.
  49 .TP 1i
  50 .BI \-f \ file
  51 Sets the configuration file to the name specified.
  52 .TP 1i
  53 .BI \-l \ ldap-debug-mask
  54 Sets the LDAP debug mask to the value specified.
  55 .TP 1i
  56 .B \-v
  57 Turns on verbose output.  Also toggable via the ud
  58 .IR verbose
  59 command.
  60 .TP 1i
  61 .B \-D
  62 Prints out a list of valid ud debug masks.
  63 .SH FILES
  64 ETCDIR/ud.conf          The ud configuration file.
  65 .SH "SEE ALSO"
  66 .BR ud.conf (5),
  67 .BR ldap.conf (5),
  68 .BR ldap (3)
  69 .SH DIAGNOSTICS
  70 .B ud
  71 will try to be nice about error conditions, and in most cases prints a warm
  72 and fuzzy error message when it encounters a problem.  Sometimes the error
  73 will be unexpected, and in these cases,
  74 .B ud
  75 uses the ldap_perror() routine to print an informative diagnostic.
  76 .SH BUGS
  77 Too numerous to mention.
  78 .SH AUTHOR
  79 Bryan Beecher, University of Michigan
  80 .SH ACKNOWLEDGEMENTS
  81 .B      OpenLDAP
  82 is developed and maintained by The OpenLDAP Project (http://www.openldap.org/).
  83 .B      OpenLDAP
  84 is derived from University of Michigan LDAP 3.3 Release.