Spelling fixes.
[wine] / dlls / wldap32 / init.c
1 /*
2  * WLDAP32 - LDAP support for Wine
3  *
4  * Copyright 2005 Hans Leidekker
5  *
6  * This library is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU Lesser General Public
8  * License as published by the Free Software Foundation; either
9  * version 2.1 of the License, or (at your option) any later version.
10  *
11  * This library is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
14  * Lesser General Public License for more details.
15  *
16  * You should have received a copy of the GNU Lesser General Public
17  * License along with this library; if not, write to the Free Software
18  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
19  */
20
21 #include "config.h"
22
23 #include "wine/port.h"
24 #include "wine/debug.h"
25
26 #include <stdio.h>
27 #include <stdarg.h>
28
29 #include "windef.h"
30 #include "winbase.h"
31 #include "winnls.h"
32
33 #ifdef HAVE_LDAP_H
34 #include <ldap.h>
35 #endif
36
37 #include "winldap_private.h"
38 #include "wldap32.h"
39
40 #ifdef HAVE_LDAP
41 /* Should eventually be determined by the algorithm documented on MSDN. */
42 static const WCHAR defaulthost[] = { 'l','o','c','a','l','h','o','s','t',0 };
43
44 /* Split a space separated string of hostnames into a string array */
45 static char **split_hostnames( const char *hostnames )
46 {
47     char **res, *str, *p, *q;
48     unsigned int i = 0;
49
50     str = strdupU( hostnames );
51     if (!str) return NULL;
52
53     p = str;
54     while (isspace( *p )) p++;
55     if (*p) i++;
56
57     while (*p)
58     {
59         if (isspace( *p ))
60         {
61             while (isspace( *p )) p++;
62             if (*p) i++;
63         }
64         p++;
65     }
66
67     res = HeapAlloc( GetProcessHeap(), 0, (i + 1) * sizeof(char *) );
68     if (!res)
69     {
70         HeapFree( GetProcessHeap(), 0, str );
71         return NULL;
72     }
73
74     p = str;
75     while (isspace( *p )) p++;
76
77     q = p;
78     i = 0;
79     
80     while (*p)
81     {
82         if (p[1] != '\0')
83         {
84             if (isspace( *p ))
85             {
86                 *p = '\0'; p++;
87                 res[i] = strdupU( q );
88                 if (!res[i]) goto oom;
89                 i++;
90             
91                 while (isspace( *p )) p++;
92                 q = p;
93             }
94         }
95         else
96         {
97             res[i] = strdupU( q );
98             if (!res[i]) goto oom;
99             i++;
100         }
101         p++;
102     }
103     res[i] = NULL;
104
105     HeapFree( GetProcessHeap(), 0, str );
106     return res;
107
108 oom:
109     while (i > 0) strfreeU( res[--i] );
110
111     HeapFree( GetProcessHeap(), 0, res );
112     HeapFree( GetProcessHeap(), 0, str );
113
114     return NULL;
115 }
116
117 /* Determine if a URL starts with a known LDAP scheme */
118 static int has_ldap_scheme( char *url )
119 {
120     if (!strncasecmp( url, "ldap://", 7 ) || 
121         !strncasecmp( url, "ldaps://", 8 ) ||
122         !strncasecmp( url, "ldapi://", 8 ) ||
123         !strncasecmp( url, "cldap://", 8 )) return 1;
124     return 0;
125 }
126
127 /* Flatten an array of hostnames into a space separated string of URLs.
128  * Prepend a given scheme and append a given portnumber to each hostname
129  * if necessary.
130  */
131 static char *join_hostnames( const char *scheme, char **hostnames, ULONG portnumber )
132 {
133     char *res, *p, *q, **v;
134     unsigned int i = 0, size = 0; 
135     static const char sep[] = " ", fmt[] = ":%d";
136     char port[7];
137
138     sprintf( port, fmt, portnumber ); 
139
140     for (v = hostnames; *v; v++)
141     {
142         if (!has_ldap_scheme( *v ))
143         {
144             size += strlen( scheme );
145             q = *v;
146         }
147         else
148             /* skip past colon in scheme prefix */
149             q = strchr( *v, '/' );
150
151         size += strlen( *v );
152
153         if (!strchr( q, ':' )) 
154             size += strlen( port );
155
156         i++;
157     }
158
159     size += (i - 1) * strlen( sep );
160  
161     res = HeapAlloc( GetProcessHeap(), 0, size + 1 );
162     if (!res) return NULL;
163
164     p = res;
165     for (v = hostnames; *v; v++)
166     {
167         if (v != hostnames)
168         {
169             strcpy( p, sep );
170             p += strlen( sep );
171         }
172
173         if (!has_ldap_scheme( *v ))
174         {
175             strcpy( p, scheme );
176             p += strlen( scheme );
177             q = *v;
178         }
179         else
180             /* skip past colon in scheme prefix */
181             q = strchr( *v, '/' );
182
183         strcpy( p, *v );
184         p += strlen( *v );
185
186         if (!strchr( q, ':' ))
187         {
188             strcpy( p, port );
189             p += strlen( port );
190         }
191     }
192     return res;
193 }
194
195 static char *urlify_hostnames( const char *scheme, char *hostnames, ULONG port )
196 {
197     char *url = NULL, **strarray;
198
199     strarray = split_hostnames( hostnames );
200     if (strarray)
201         url = join_hostnames( scheme, strarray, port );
202     else
203         return NULL;
204
205     strarrayfreeU( strarray );
206     return url;
207 }
208 #endif
209
210 WINE_DEFAULT_DEBUG_CHANNEL(wldap32);
211
212 /***********************************************************************
213  *      cldap_openA     (WLDAP32.@)
214  *
215  * See cldap_openW.
216  */
217 WLDAP32_LDAP * CDECL cldap_openA( PCHAR hostname, ULONG portnumber )
218 {
219 #ifdef HAVE_LDAP
220     WLDAP32_LDAP *ld = NULL;
221     WCHAR *hostnameW = NULL;
222
223     TRACE( "(%s, %d)\n", debugstr_a(hostname), portnumber );
224
225     if (hostname) {
226         hostnameW = strAtoW( hostname );
227         if (!hostnameW) goto exit;
228     }
229
230     ld = cldap_openW( hostnameW, portnumber );
231
232 exit:
233     strfreeW( hostnameW );
234     return ld;
235
236 #else
237     return NULL;
238 #endif
239 }
240
241 /***********************************************************************
242  *      cldap_openW     (WLDAP32.@)
243  *
244  * Initialize an LDAP context and create a UDP connection.
245  *
246  * PARAMS
247  *  hostname   [I] Name of the host to connect to.
248  *  portnumber [I] Portnumber to use.
249  *
250  * RETURNS
251  *  Success: Pointer to an LDAP context.
252  *  Failure: NULL
253  *
254  * NOTES
255  *  The hostname string can be a space separated string of hostnames,
256  *  in which case the LDAP runtime will try to connect to the hosts
257  *  in order, until a connection can be made. A hostname may have a
258  *  trailing portnumber (separated from the hostname by a ':'), which 
259  *  will take precedence over the portnumber supplied as a parameter
260  *  to this function.
261  */
262 WLDAP32_LDAP * CDECL cldap_openW( PWCHAR hostname, ULONG portnumber )
263 {
264 #ifdef HAVE_LDAP
265     LDAP *ld = NULL;
266     char *hostnameU = NULL, *url = NULL;
267
268     TRACE( "(%s, %d)\n", debugstr_w(hostname), portnumber );
269
270     if (hostname) {
271         hostnameU = strWtoU( hostname );
272         if (!hostnameU) goto exit;
273     }
274     else {
275         hostnameU = strWtoU( defaulthost );
276         if (!hostnameU) goto exit;
277     }
278
279     url = urlify_hostnames( "cldap://", hostnameU, portnumber );
280     if (!url) goto exit;
281
282     ldap_initialize( &ld, url );
283
284 exit:
285     strfreeU( hostnameU );
286     strfreeU( url );
287     return ld;
288
289 #else
290     return NULL;
291 #endif
292 }
293
294 /***********************************************************************
295  *      ldap_connect     (WLDAP32.@)
296  *
297  * Connect to an LDAP server. 
298  *
299  * PARAMS
300  *  ld      [I] Pointer to an LDAP context.
301  *  timeout [I] Pointer to an l_timeval structure specifying the
302  *              timeout in seconds.
303  *
304  * RETURNS
305  *  Success: LDAP_SUCCESS
306  *  Failure: An LDAP error code.
307  *
308  * NOTES
309  *  The timeout parameter may be NULL in which case a default timeout
310  *  value will be used.
311  */
312 ULONG CDECL ldap_connect( WLDAP32_LDAP *ld, struct l_timeval *timeout )
313 {
314     TRACE( "(%p, %p)\n", ld, timeout );
315
316     if (!ld) return WLDAP32_LDAP_PARAM_ERROR;
317     return WLDAP32_LDAP_SUCCESS; /* FIXME: do something, e.g. ping the host */
318 }
319
320 /***********************************************************************
321  *      ldap_initA     (WLDAP32.@)
322  *
323  * See ldap_initW.
324  */
325 WLDAP32_LDAP *  CDECL ldap_initA( PCHAR hostname, ULONG portnumber )
326 {
327 #ifdef HAVE_LDAP
328     WLDAP32_LDAP *ld = NULL;
329     WCHAR *hostnameW = NULL;
330
331     TRACE( "(%s, %d)\n", debugstr_a(hostname), portnumber );
332
333     if (hostname) {
334         hostnameW = strAtoW( hostname );
335         if (!hostnameW) goto exit;
336     }
337
338     ld = ldap_initW( hostnameW, portnumber );
339
340 exit:
341     strfreeW( hostnameW );
342     return ld;
343
344 #else
345     return NULL;
346 #endif
347 }
348
349 /***********************************************************************
350  *      ldap_initW     (WLDAP32.@)
351  *
352  * Initialize an LDAP context and create a TCP connection.
353  *
354  * PARAMS
355  *  hostname   [I] Name of the host to connect to.
356  *  portnumber [I] Portnumber to use.
357  *
358  * RETURNS
359  *  Success: Pointer to an LDAP context.
360  *  Failure: NULL
361  *
362  * NOTES
363  *  The hostname string can be a space separated string of hostnames,
364  *  in which case the LDAP runtime will try to connect to the hosts
365  *  in order, until a connection can be made. A hostname may have a
366  *  trailing portnumber (separated from the hostname by a ':'), which 
367  *  will take precedence over the portnumber supplied as a parameter
368  *  to this function. The connection will not be made until the first
369  *  LDAP function that needs it is called.
370  */
371 WLDAP32_LDAP * CDECL ldap_initW( PWCHAR hostname, ULONG portnumber )
372 {
373 #ifdef HAVE_LDAP
374     LDAP *ld = NULL;
375     char *hostnameU = NULL, *url = NULL;
376
377     TRACE( "(%s, %d)\n", debugstr_w(hostname), portnumber );
378
379     if (hostname) {
380         hostnameU = strWtoU( hostname );
381         if (!hostnameU) goto exit;
382     }
383     else {
384         hostnameU = strWtoU( defaulthost );
385         if (!hostnameU) goto exit;
386     }
387
388     url = urlify_hostnames( "ldap://", hostnameU, portnumber );
389     if (!url) goto exit;
390
391     ldap_initialize( &ld, url );
392
393 exit:
394     strfreeU( hostnameU );
395     strfreeU( url );
396     return ld;
397
398 #else
399     return NULL;
400 #endif
401 }
402
403 /***********************************************************************
404  *      ldap_openA     (WLDAP32.@)
405  *
406  * See ldap_openW.
407  */
408 WLDAP32_LDAP * CDECL ldap_openA( PCHAR hostname, ULONG portnumber )
409 {
410 #ifdef HAVE_LDAP
411     WLDAP32_LDAP *ld = NULL;
412     WCHAR *hostnameW = NULL;
413
414     TRACE( "(%s, %d)\n", debugstr_a(hostname), portnumber );
415
416     if (hostname) {
417         hostnameW = strAtoW( hostname );
418         if (!hostnameW) goto exit;
419     }
420
421     ld = ldap_openW( hostnameW, portnumber );
422
423 exit:
424     strfreeW( hostnameW );
425     return ld;
426
427 #else
428     return NULL;
429 #endif
430 }
431
432 /***********************************************************************
433  *      ldap_openW     (WLDAP32.@)
434  *
435  * Initialize an LDAP context and create a TCP connection.
436  *
437  * PARAMS
438  *  hostname   [I] Name of the host to connect to.
439  *  portnumber [I] Portnumber to use.
440  *
441  * RETURNS
442  *  Success: Pointer to an LDAP context.
443  *  Failure: NULL
444  *
445  * NOTES
446  *  The hostname string can be a space separated string of hostnames,
447  *  in which case the LDAP runtime will try to connect to the hosts
448  *  in order, until a connection can be made. A hostname may have a
449  *  trailing portnumber (separated from the hostname by a ':'), which 
450  *  will take precedence over the portnumber supplied as a parameter
451  *  to this function.
452  */
453 WLDAP32_LDAP * CDECL ldap_openW( PWCHAR hostname, ULONG portnumber )
454 {
455 #ifdef HAVE_LDAP
456     LDAP *ld = NULL;
457     char *hostnameU = NULL, *url = NULL;
458
459     TRACE( "(%s, %d)\n", debugstr_w(hostname), portnumber );
460
461     if (hostname) {
462         hostnameU = strWtoU( hostname );
463         if (!hostnameU) goto exit;
464     }
465     else {
466         hostnameU = strWtoU( defaulthost );
467         if (!hostnameU) goto exit;
468     }
469
470     url = urlify_hostnames( "ldap://", hostnameU, portnumber );
471     if (!url) goto exit;
472
473     ldap_initialize( &ld, url );
474
475 exit:
476     strfreeU( hostnameU );
477     strfreeU( url );
478     return ld;
479
480 #else
481     return NULL;
482 #endif
483 }
484
485 /***********************************************************************
486  *      ldap_sslinitA     (WLDAP32.@)
487  *
488  * See ldap_sslinitW.
489  */
490 WLDAP32_LDAP * CDECL ldap_sslinitA( PCHAR hostname, ULONG portnumber, int secure )
491 {
492 #ifdef HAVE_LDAP
493     WLDAP32_LDAP *ld;
494     WCHAR *hostnameW = NULL;
495
496     TRACE( "(%s, %d, 0x%08x)\n", debugstr_a(hostname), portnumber, secure );
497
498     if (hostname) {
499         hostnameW = strAtoW( hostname );
500         if (!hostnameW) return NULL;
501     }
502
503     ld  = ldap_sslinitW( hostnameW, portnumber, secure );
504
505     strfreeW( hostnameW );
506     return ld;
507
508 #else
509     return NULL;
510 #endif
511 }
512
513 /***********************************************************************
514  *      ldap_sslinitW     (WLDAP32.@)
515  *
516  * Initialize an LDAP context and create a secure TCP connection.
517  *
518  * PARAMS
519  *  hostname   [I] Name of the host to connect to.
520  *  portnumber [I] Portnumber to use.
521  *  secure     [I] Ask the server to create an SSL connection.
522  *
523  * RETURNS
524  *  Success: Pointer to an LDAP context.
525  *  Failure: NULL
526  *
527  * NOTES
528  *  The hostname string can be a space separated string of hostnames,
529  *  in which case the LDAP runtime will try to connect to the hosts
530  *  in order, until a connection can be made. A hostname may have a
531  *  trailing portnumber (separated from the hostname by a ':'), which 
532  *  will take precedence over the portnumber supplied as a parameter
533  *  to this function. The connection will not be made until the first
534  *  LDAP function that needs it is called.
535  */
536 WLDAP32_LDAP * CDECL ldap_sslinitW( PWCHAR hostname, ULONG portnumber, int secure )
537 {
538 #ifdef HAVE_LDAP
539     WLDAP32_LDAP *ld = NULL;
540     char *hostnameU = NULL, *url = NULL;
541
542     TRACE( "(%s, %d, 0x%08x)\n", debugstr_w(hostname), portnumber, secure );
543
544     if (hostname) {
545         hostnameU = strWtoU( hostname );
546         if (!hostnameU) goto exit;
547     }
548     else {
549         hostnameU = strWtoU( defaulthost );
550         if (!hostnameU) goto exit;
551     }
552
553     if (secure)
554         url = urlify_hostnames( "ldaps://", hostnameU, portnumber );
555     else
556         url = urlify_hostnames( "ldap://", hostnameU, portnumber );
557
558     if (!url) goto exit;
559     ldap_initialize( &ld, url );
560
561 exit:
562     strfreeU( hostnameU );
563     strfreeU( url );
564     return ld;
565
566 #else
567     return NULL;
568 #endif
569 }
570
571 /***********************************************************************
572  *      ldap_start_tls_sA     (WLDAP32.@)
573  *
574  * See ldap_start_tls_sW.
575  */
576 ULONG CDECL ldap_start_tls_sA( WLDAP32_LDAP *ld, PULONG retval, WLDAP32_LDAPMessage **result,
577     PLDAPControlA *serverctrls, PLDAPControlA *clientctrls )
578 {
579     ULONG ret = WLDAP32_LDAP_NOT_SUPPORTED;
580 #ifdef HAVE_LDAP
581     LDAPControlW **serverctrlsW = NULL, **clientctrlsW = NULL;
582
583     ret = WLDAP32_LDAP_NO_MEMORY;
584
585     TRACE( "(%p, %p, %p, %p, %p)\n", ld, retval, result, serverctrls, clientctrls );
586
587     if (!ld) return ~0UL;
588
589     if (serverctrls) {
590         serverctrlsW = controlarrayAtoW( serverctrls );
591         if (!serverctrlsW) goto exit;
592     }
593     if (clientctrls) {
594         clientctrlsW = controlarrayAtoW( clientctrls );
595         if (!clientctrlsW) goto exit;
596     }
597
598     ret = ldap_start_tls_sW( ld, retval, result, serverctrlsW, clientctrlsW );
599
600 exit:
601     controlarrayfreeW( serverctrlsW );
602     controlarrayfreeW( clientctrlsW );
603
604 #endif
605     return ret;
606 }
607
608 /***********************************************************************
609  *      ldap_start_tls_s     (WLDAP32.@)
610  *
611  * Start TLS encryption on an LDAP connection.
612  *
613  * PARAMS
614  *  ld          [I] Pointer to an LDAP context.
615  *  retval      [I] Return value from the server.
616  *  result      [I] Response message from the server.
617  *  serverctrls [I] Array of LDAP server controls.
618  *  clientctrls [I] Array of LDAP client controls.
619  *
620  * RETURNS
621  *  Success: LDAP_SUCCESS
622  *  Failure: An LDAP error code.
623  *
624  * NOTES
625  *  LDAP function that needs it is called.
626  */
627 ULONG CDECL ldap_start_tls_sW( WLDAP32_LDAP *ld, PULONG retval, WLDAP32_LDAPMessage **result,
628     PLDAPControlW *serverctrls, PLDAPControlW *clientctrls )
629 {
630     ULONG ret = WLDAP32_LDAP_NOT_SUPPORTED;
631 #ifdef HAVE_LDAP
632     LDAPControl **serverctrlsU = NULL, **clientctrlsU = NULL;
633
634     ret = WLDAP32_LDAP_NO_MEMORY;
635
636     TRACE( "(%p, %p, %p, %p, %p)\n", ld, retval, result, serverctrls, clientctrls );
637
638     if (!ld) return ~0UL;
639
640     if (serverctrls) {
641         serverctrlsU = controlarrayWtoU( serverctrls );
642         if (!serverctrlsU) goto exit;
643     }
644     if (clientctrls) {
645         clientctrlsU = controlarrayWtoU( clientctrls );
646         if (!clientctrlsU) goto exit;
647     }
648
649     ret = ldap_start_tls_s( ld, serverctrlsU, clientctrlsU );
650
651 exit:
652     controlarrayfreeU( serverctrlsU );
653     controlarrayfreeU( clientctrlsU );
654
655 #endif
656     return ret;
657 }
658
659 /***********************************************************************
660  *      ldap_startup     (WLDAP32.@)
661  */
662 ULONG CDECL ldap_startup( PLDAP_VERSION_INFO version, HANDLE *instance )
663 {
664     TRACE( "(%p, %p)\n", version, instance );
665     return WLDAP32_LDAP_SUCCESS;
666 }
667
668 /***********************************************************************
669  *      ldap_stop_tls_s     (WLDAP32.@)
670  *
671  * Stop TLS encryption on an LDAP connection.
672  *
673  * PARAMS
674  *  ld [I] Pointer to an LDAP context.
675  *
676  * RETURNS
677  *  Success: TRUE
678  *  Failure: FALSE
679  */
680 BOOLEAN CDECL ldap_stop_tls_s( WLDAP32_LDAP *ld )
681 {
682     TRACE( "(%p)\n", ld );
683     return TRUE; /* FIXME: find a way to stop tls on a connection */
684 }