1 .TH LDAPCOMPARE 1 "RELEASEDATE" "OpenLDAP LDVERSION"
3 .\" Copyright 1998-2002 The OpenLDAP Foundation All Rights Reserved.
4 .\" Copying restrictions apply. See COPYRIGHT/LICENSE.
6 ldapcompare \- LDAP compare tool
22 .BI \-d \ debuglevel\fR]
30 .BI \-y \ passwdfile\fR]
34 .BI \-h \ ldaphost\fR]
36 .BI \-p \ ldapport\fR]
38 .BI \-P \ 2\fR\||\|\fI3\fR]
40 .BR \-O \ security-properties ]
57 .BR attr::b64value \ >
60 is a shell-accessible interface to the
65 opens a connection to an LDAP server, binds, and performs a compare
66 using specified parameters. The \fIDN\fP should be a distinguished
67 name in the directory. \fIAttr\fP should be a known attribute. If
68 followed by one colon, the assertion \fIvalue\fP should be provided
69 as a string. If followed by two colons, the base64 encoding of the
75 Show what would be done, but don't actually perform the compare. Useful for
76 debugging in conjunction with -v.
79 Run in verbose mode, with many diagnostics written to standard output.
82 Run in quiet mode, no output is written. You must check the return
83 status. Useful in shell scripts.
86 Use Kerberos IV authentication instead of simple authentication. It is
87 assumed that you already have a valid ticket granting ticket.
89 must be compiled with Kerberos support for this option to have any effect.
92 Same as \-k, but only does step 1 of the Kerberos IV bind. This is useful
93 when connecting to a slapd and there is no x500dsa.hostname principal
94 registered with your Kerberos Domain Controller(s).
97 Enable manage DSA IT control.
99 makes control critical.
102 Set the LDAP debugging level to \fIdebuglevel\fP.
104 must be compiled with LDAP_DEBUG defined for this option to have any effect.
107 Use simple authentication instead of SASL.
110 Use the Distinguished Name \fIbinddn\fP to bind to the LDAP directory.
113 Prompt for simple authentication.
114 This is used instead of specifying the password on the command line.
117 Use \fIpasswd\fP as the password for simple authentication.
120 Use complete contents of \fIpasswdfile\fP as the password for
121 simple authentication.
124 Specify URI(s) referring to the ldap server(s).
127 Specify an alternate host on which the ldap server is running.
128 Deprecated in favor of -H.
131 Specify an alternate TCP port where the ldap server is listening.
132 Deprecated in favor of -H.
134 .BI \-P \ 2\fR\||\|\fI3
135 Specify the LDAP protocol version to use.
137 .BI \-O \ security-properties
138 Specify SASL security properties.
141 Enable SASL Interactive mode. Always prompt. Default is to prompt
145 Enable SASL Quiet mode. Never prompt.
148 Specify the authentication ID for SASL bind. The form of the ID
149 depends on the actual SASL mechanism used.
152 Specify the requested authorization ID for SASL bind.
154 must be one of the following formats:
156 .I <distinguished name>
162 Specify the SASL mechanism to be used for authentication. If it's not
163 specified, the program will choose the best mechanism the server knows.
166 Issue StartTLS (Transport Layer Security) extended operation. If you use
168 , the command will require the operation to be successful.
171 ldapcompare "uid=babs,dc=example,dc=com" sn Jensen
172 ldapcompare "uid=babs,dc=example,dc=com" sn:Jensen
173 ldapcompare "uid=babs,dc=example,dc=com" sn::SmVuc2Vu
177 When -z is used, exit status is either 5 if the compare is false, or 6
178 when the compare is true. Errors result in other non-zero values.
180 When -z is not used, exit status is zero if no errors occur.
181 Errors result in a non-zero exit status and
182 a diagnostic message being written to standard error.
184 Should have a way to specify a url for options or for large binary
192 The OpenLDAP Project <http://www.openldap.org/>
195 is developed and maintained by The OpenLDAP Project (http://www.openldap.org/).
197 is derived from University of Michigan LDAP 3.3 Release.