1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
|
LDAP (Lightweight Directory Access Protocol) API for Windows/Winsock
(Change history is at the bottom of this file.)
The lber and ldap client libraries have been ported to Microsoft Windows
in the form of Windows Dynamic Link libraries called LIBLDAP.DLL (16Bit)
and Ldap32.dll (32Bit). The LTest program is also provided in both
formats.
A Windows Sockets API (version 1.1 conformant) TCP/IP WINSOCK.DLL or
WSOCK32.DLL is required for the DLL to run.
Our intent is that this "kit" include everything you'll need to make use
of the ldap client API from your 16Bit or 32Bit application. If you
find something missing or have a suggestion for improvement, send email
to the "bug reporting" address at the bottom of this file.
To use this "kit"
1) Get to a DOS prompt
2) Create the directory you want this to live in (e.g. \ldap)
and cd into it. We will refer to that directory simply as
"\ldap" from now on, but it could be anywhere and have any name
you desire.
3) Use "pkunzip -d" to extract the files. The "-d" is NECESSARY to
preserve the subdirectories and avoid file name collisions.
4) We have included only the files you need to use and test
libldap.dll and ldap32.dll. If you want the entire distribution,
with source, you can get it from:
ftp://terminator.rs.itd.umich.edu/ldap/ldap-3.3.tar.Z
The following files are included in this distribution:
16Bit binaries and libs
BINARIES/DEBUG/LIBLDAP.DLL
BINARIES/DEBUG/LIBLDAP.LIB
BINARIES/RELEASE/LIBLDAP.DLL
BINARIES/RELEASE/LIBLDAP.LIB
BINARIES/DEBUG/LTEST.EXE
32Bit binaries and libs
BINARIES/DEBUG/LDAP32.DLL
BINARIES/DEBUG/LDAP32.LIB
BINARIES/RELEASE/LDAP32.DLL
BINARIES/RELEASE/LDAP32.LIB
BINARIES/DEBUG/LTEST32.EXE
Include files
INCKIT/MSDOS.H
INCKIT/LBER.H
INCKIT/LDAP.H
INCKIT/PROTO-LD.H
INCKIT/PROTO-LB.H
INCKIT/SRCHPREF.H
INCKIT/DISPTMPL.H
Sample Configuration files
SRCHPREF.CFG
DISPTMPL.CFG
LDFRIEND.CFG
LDFILTER.CFG
Man pages in the form of Windows HLP files
LIBLDAP.HLP - old format hlp file
LDAP32.HLP - new format hlp file, both have same content
16Bit versions
Libldap.dll was compiled with KERBEROS, AUTHMAN, WSHELPER, WIN32,
_WINDOWS,& LDAP_REFERRALS defined. Even if you do not need kerberos
authentication, (see below for more information on kerberos) this
dll should work correctly for you.
LDAP_REFERRALS makes libldap.dll capable of handling referrals
returned by a slapd server.
32Bit versions
The 32Bit version is NOT SAFE for MULTIPLE THREADS at this time.
Not more than one thread per application may make use of the
ldap routines.
Ldap32.dll was compiled with LDAP_REFERRALS defined and is capable
of handling referrals returned by a slapd server.
WRITING APPLICATIONS THAT USE LIBLDAP.DLL or LDAP32.DLL
All of the normal LDAP and LBER calls documented in the help file
should work, except for ldap_perror (this is not supported under
Windows since you will want to use an application-defined dialog;
you can use ldap_err2string to obtain an error string to display in
a message box or dialog).
The man pages are included in this kit in the form of windows HLP files.
The official source man pages are available via the web at:
http://www.umich.edu/ldap/doc/man/
Any memory that you obtain as the result of a call to an LIBLDAP.DLL
routine should NOT be freed by calling the free() routine in your C
library. Instead, use the the new utility routine ldap_memfree or
the appropriate ldap ...free routine. This is so the malloc/calloc
and free routines all come from the same library (the one in
libldap) rather than using libldap's malloc/calloc and the calling
program's free. Microsoft's VC++ 4.0 compiler (in debug mode)
FORCED me to be compulsive about this for the application I used to
test.
To be friendly under Windows, you should use the asynchronous LDAP
calls whenever possible.
One limitation of the current LIBLDAP.DLL is that each X.500 LDAP
result message has to be smaller than 64K bytes. Ldap32.dll does
NOT have this limitation.
To compile the ldap dlls we define the following preprocessor variables.
WINSOCK, DOS, NEEDPROTOS, NO_USERINTERFACE, KERBEROS
Presumably you don't need KERBEROS. You may need some/all the others
to take the right path through the include files. Also note that a
few more preprocessor variables are defined in msdos.h. This means that
msdos.h must be included before ldap.h or lber.h.
LTest and LTtest32
The LTest.exe and LTest32.exe programs are test interfaces to libldap
and ldap32 respectively. By default they connect to the host
"truelies". This host name is contained in a string resource in the
exe file. You may easily "customize" this to be the name of whatever
server you're using with AppStudio or any Windows resource editor.
Kerberos Information
Libldap.dll was compiled with KERBEROS, AUTHMAN, WSHELPER, &
LDAP_REFERRALS defined. If you do not need kerberos authentication,
this dll should still work correctly for you. Libldap.dll
dynamically loads and uses the dlls needed for kerberos
authentication (Authlib.dll, Krbv4win.dll, & WSHelper.dll). If
Libldap.dll is unable to load the needed dlls, execution continues
without error, but without kerberos authentication capability.
AUTHMAN allows libldap.dll to make use of Authlib.dll (which
requires KrbV4Win.dll & WSHelper.dll) if they are ALL in the "PATH".
If these are not available, kerberos authentication can not succede,
but libldap.dll will execute without error.
WSHELPER means that if WSHelper.dll is in the "PATH", it will be
dynamically loaded and used to do the gethostbyaddr() call required
for kerberos authentication to work. (This is used because so many
vendor implementations of gethostbyaddr return WRONG results. We
are working with all vendors we can get to listen to get these
implementations fixed.) If WSHelper.dll is not in the "PATH"
libldap.dll does not fail to execute correctly.
Ldap32.dll does NOT have the ability to do kerberos authentication
because none of Authlib.dll, krbv4win.dll or wshelper.dll have been
ported to 32Bits at this time.
For further information on using kerberos with the ldap DLLs send
email to ldap-support@umich.edu.
BUG REPORTING
Bug reports should be sent to bug-ldap@umich.edu.
Miscellaneous
Build testing was done on Windows NT workstation 3.51 (build 1057
service pack 2) on an NTFS file system (which supports long
filenames) using Microsoft Visual C++ 1.52c (16 bit) and Visual C++
4.0 (32 bit).
Change History:
2 May 1996
o based on LDAP 3.3 source
o correct bug that caused error message box about problems
wshelper.dll. Made use of krbv4win and thus wshelper
dynamic. They will be used if present, if not
get_kerberosv4_credentials will set ld->ld_errno =
LDAP_AUTH_UNKNOWN and return a NULL pointer.
o this required changes to libldap.mak and kbind.c.
Since these changed files did not make it into the
official tar file, I've included them here.
2 Aug 1996
o WSAStartup() was not being called before htons was used.
WSAStartup() call was moved to correct this problem. This may
change the number of calls to WSAStartup() and the pairing of
these with WSACleanup();
o 32 bit Release binaries of ldap were not built using the DEF file.
This caused the ordinals (and the LIB files) to be different.
Both 32 bit binaries now use same DEF, same ordinals, LIBs compare.
23 Sep 1996 : sgr
o libldap.dll uses OutputDebugString to emit debug messages. This
was not getting disabled in the Release version. Simple change to
msdos.h made LDAP_DEBUG depend on _DEBUG which fixed this problem.
17 Oct 1996 : sgr
o 4 of the .h files were missing the ^M at EOL that DOS/WIN requires
These have been fixed and replaced in the zip file. They were
disptmpl.h, ldap.h, proto-ld.h, & proto-lb.h
------------------------------------------------------------------------
README Last updated 17 Oct 1996 by Steve Rothwell
|
