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