]> git.sur5r.net Git - openldap/blob - doc/man/man1/ud.1
Initial revision
[openldap] / doc / man / man1 / ud.1
1 .TH UD 1 "18 March 1993" "U-M LDAP LDVERSION"
2 .UC 6
3 .SH NAME
4 ud \- interactive X.500 Directory Server query program
5 .SH SYNOPSIS
6 .B ud
7 [-Dv] [-s 
8 .IR server ]
9 [-d
10 .IR debug-mask ]
11 [-l
12 .IR ldap-debug-mask ]
13 [-f
14 .IR file ]
15 .SH DESCRIPTION
16 .IR ud
17 is used to interogate a directory server via the Lightweight Directory
18 Access Protocol (LDAP).
19 .SH OPTIONS
20 .TP 1i
21 .B \-s
22 Used to specify the name of an LDAP server to which
23 .B ud
24 should connect.  If this
25 flag is omitted, the value specified in the
26 .B ud
27 configuration file is used.  If
28 no value is specified in the configuration file, or the configuration
29 file does not exist, the name
30 .IR ldap
31 is used.  Of course, it is up to the system administrator to make sure that
32 the name
33 .IR ldap
34 can be resolved (presumably through the use of a CNAME or A record in the DNS
35 and the appropriate search path specified in the resolver config file).
36 .TP 1i
37 .B \-d
38 Sets the
39 .B ud
40 debug mask to the value specified.  
41 Values for the mask can be dumped by using the
42 .IR \-D
43 flag.
44 .TP 1i
45 .B \-f
46 Sets the configuration file to the name specified.
47 .TP 1i
48 .B \-l
49 Sets the LDAP debug mask to the value specified.  
50 .TP 1i
51 .B \-v
52 Turns on verbose output.  Also toggable via the ud 
53 .IR verbose 
54 command.
55 .TP 1i
56 .B \-D
57 Prints out a list of valid ud debug masks.
58 .SH FILES
59 ETCDIR/ud.conf          The ud configuration file.
60 .SH "SEE ALSO"
61 .BR ud.conf (5),
62 .BR ldap (3)
63 .SH DIAGNOSTICS
64 .B ud
65 will try to be nice about error conditions, and in most cases prints a warm
66 and fuzzy error message when it encounters a problem.  Sometimes the error
67 will be unexpected, and in these cases, 
68 .B ud
69 uses the ldap_perror() routine to print an informative diagnostic.
70 .SH BUGS
71 Too numerous to mention.
72 .SH AUTHOR
73 Bryan Beecher, University of Michigan