dirmmgr: Use a portability wrapper for struct timeval.
[gnupg.git] / dirmngr / dirmngr_ldap.c
1 /* dirmngr-ldap.c  -  The LDAP helper for dirmngr.
2  * Copyright (C) 2004 g10 Code GmbH
3  * Copyright (C) 2010 Free Software Foundation, Inc.
4  *
5  * This file is part of GnuPG.
6  *
7  * GnuPG is free software; you can redistribute it and/or modify
8  * it under the terms of the GNU General Public License as published by
9  * the Free Software Foundation; either version 3 of the License, or
10  * (at your option) any later version.
11  *
12  * GnuPG is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15  * GNU General Public License for more details.
16  *
17  * You should have received a copy of the GNU General Public License
18  * along with this program; if not, see <http://www.gnu.org/licenses/>.
19  */
20
21 #include <config.h>
22
23 #include <stdio.h>
24 #include <stdlib.h>
25 #include <stddef.h>
26 #include <stdarg.h>
27 #include <string.h>
28 #ifdef HAVE_SIGNAL_H
29 # include <signal.h>
30 #endif
31 #include <errno.h>
32 #include <assert.h>
33 #include <sys/time.h>
34 #include <unistd.h>
35 #ifndef USE_LDAPWRAPPER
36 # include <npth.h>
37 #endif
38
39 #ifdef HAVE_W32_SYSTEM
40 # include <winsock2.h>
41 # include <winldap.h>
42 # include <winber.h>
43 # include <fcntl.h>
44 # include "ldap-url.h"
45 #else
46   /* For OpenLDAP, to enable the API that we're using. */
47 # define LDAP_DEPRECATED 1
48 # include <ldap.h>
49 #endif
50
51
52 #define JNLIB_NEED_LOG_LOGV
53 #include "../common/logging.h"
54 #include "../common/argparse.h"
55 #include "../common/stringhelp.h"
56 #include "../common/mischelp.h"
57 #include "../common/strlist.h"
58
59 #include "i18n.h"
60 #include "util.h"
61 #include "../common/init.h"
62
63 /* With the ldap wrapper, there is no need for the npth_unprotect and leave
64    functions; thus we redefine them to nops.  If we are not using the
65    ldap wrapper process we need to include the prototype for our
66    module's main function.  */
67 #ifdef USE_LDAPWRAPPER
68 static void npth_unprotect (void) { }
69 static void npth_protect (void) { }
70 #else
71 # include "./ldap-wrapper.h"
72 #endif
73
74 #ifdef HAVE_W32CE_SYSTEM
75 # include "w32-ldap-help.h"
76 # define my_ldap_init(a,b)                      \
77   _dirmngr_ldap_init ((a), (b))
78 # define my_ldap_simple_bind_s(a,b,c)           \
79   _dirmngr_ldap_simple_bind_s ((a),(b),(c))
80 # define my_ldap_search_st(a,b,c,d,e,f,g,h)     \
81   _dirmngr_ldap_search_st ((a), (b), (c), (d), (e), (f), (g), (h))
82 # define my_ldap_first_attribute(a,b,c)         \
83   _dirmngr_ldap_first_attribute ((a),(b),(c))
84 # define my_ldap_next_attribute(a,b,c)          \
85   _dirmngr_ldap_next_attribute ((a),(b),(c))
86 # define my_ldap_get_values_len(a,b,c)          \
87   _dirmngr_ldap_get_values_len ((a),(b),(c))
88 # define my_ldap_free_attr(a)                   \
89   xfree ((a))
90 #else
91 # define my_ldap_init(a,b)              ldap_init ((a), (b))
92 # define my_ldap_simple_bind_s(a,b,c)   ldap_simple_bind_s ((a), (b), (c))
93 # define my_ldap_search_st(a,b,c,d,e,f,g,h)     \
94   ldap_search_st ((a), (b), (c), (d), (e), (f), (g), (h))
95 # define my_ldap_first_attribute(a,b,c) ldap_first_attribute ((a),(b),(c))
96 # define my_ldap_next_attribute(a,b,c)  ldap_next_attribute ((a),(b),(c))
97 # define my_ldap_get_values_len(a,b,c)  ldap_get_values_len ((a),(b),(c))
98 # define my_ldap_free_attr(a)           ldap_memfree ((a))
99 #endif
100
101 #ifdef HAVE_W32_SYSTEM
102  typedef LDAP_TIMEVAL  my_ldap_timeval_t;
103 #else
104  typedef struct timeval my_ldap_timeval_t;
105 #endif
106
107 #define DEFAULT_LDAP_TIMEOUT 100 /* Arbitrary long timeout. */
108
109
110 /* Constants for the options.  */
111 enum
112   {
113     oQuiet        = 'q',
114     oVerbose      = 'v',
115
116     oTimeout      = 500,
117     oMulti,
118     oProxy,
119     oHost,
120     oPort,
121     oUser,
122     oPass,
123     oEnvPass,
124     oDN,
125     oFilter,
126     oAttr,
127
128     oOnlySearchTimeout,
129     oLogWithPID
130   };
131
132
133 /* The list of options as used by the argparse.c code.  */
134 static ARGPARSE_OPTS opts[] = {
135   { oVerbose,  "verbose",   0, N_("verbose") },
136   { oQuiet,    "quiet",     0, N_("be somewhat more quiet") },
137   { oTimeout,  "timeout",   1, N_("|N|set LDAP timeout to N seconds")},
138   { oMulti,    "multi",     0, N_("return all values in"
139                                   " a record oriented format")},
140   { oProxy,    "proxy",     2,
141     N_("|NAME|ignore host part and connect through NAME")},
142   { oHost,     "host",      2, N_("|NAME|connect to host NAME")},
143   { oPort,     "port",      1, N_("|N|connect to port N")},
144   { oUser,     "user",      2, N_("|NAME|use user NAME for authentication")},
145   { oPass,     "pass",      2, N_("|PASS|use password PASS"
146                                   " for authentication")},
147   { oEnvPass,  "env-pass",  0, N_("take password from $DIRMNGR_LDAP_PASS")},
148   { oDN,       "dn",        2, N_("|STRING|query DN STRING")},
149   { oFilter,   "filter",    2, N_("|STRING|use STRING as filter expression")},
150   { oAttr,     "attr",      2, N_("|STRING|return the attribute STRING")},
151   { oOnlySearchTimeout, "only-search-timeout", 0, "@"},
152   { oLogWithPID,"log-with-pid", 0, "@"},
153   { 0, NULL, 0, NULL }
154 };
155
156
157 /* A structure with module options.  This is not a static variable
158    because if we are not build as a standalone binary, each thread
159    using this module needs to handle its own values.  */
160 struct my_opt_s
161 {
162   int quiet;
163   int verbose;
164   my_ldap_timeval_t timeout;/* Timeout for the LDAP search functions.  */
165   unsigned int alarm_timeout; /* And for the alarm based timeout.  */
166   int multi;
167
168   estream_t outstream;    /* Send output to thsi stream.  */
169
170   /* Note that we can't use const for the strings because ldap_* are
171      not defined that way.  */
172   char *proxy; /* Host and Port override.  */
173   char *user;  /* Authentication user.  */
174   char *pass;  /* Authentication password.  */
175   char *host;  /* Override host.  */
176   int port;    /* Override port.  */
177   char *dn;    /* Override DN.  */
178   char *filter;/* Override filter.  */
179   char *attr;  /* Override attribute.  */
180 };
181 typedef struct my_opt_s *my_opt_t;
182
183
184 /* Prototypes.  */
185 #ifndef HAVE_W32_SYSTEM
186 static void catch_alarm (int dummy);
187 #endif
188 static int process_url (my_opt_t myopt, const char *url);
189
190
191
192 /* Function called by argparse.c to display information.  */
193 #ifdef USE_LDAPWRAPPER
194 static const char *
195 my_strusage (int level)
196 {
197   const char *p;
198
199   switch(level)
200     {
201     case 11: p = "dirmngr_ldap (@GNUPG@)";
202       break;
203     case 13: p = VERSION; break;
204     case 17: p = PRINTABLE_OS_NAME; break;
205     case 19: p = _("Please report bugs to <@EMAIL@>.\n"); break;
206     case 49: p = PACKAGE_BUGREPORT; break;
207     case 1:
208     case 40: p =
209                _("Usage: dirmngr_ldap [options] [URL] (-h for help)\n");
210       break;
211     case 41: p =
212           _("Syntax: dirmngr_ldap [options] [URL]\n"
213             "Internal LDAP helper for Dirmngr\n"
214             "Interface and options may change without notice\n");
215       break;
216
217     default: p = NULL;
218     }
219   return p;
220 }
221 #endif /*!USE_LDAPWRAPPER*/
222
223
224 int
225 #ifdef USE_LDAPWRAPPER
226 main (int argc, char **argv)
227 #else
228 ldap_wrapper_main (char **argv, estream_t outstream)
229 #endif
230 {
231 #ifndef USE_LDAPWRAPPER
232   int argc;
233 #endif
234   ARGPARSE_ARGS pargs;
235   int any_err = 0;
236   char *p;
237   int only_search_timeout = 0;
238   struct my_opt_s my_opt_buffer;
239   my_opt_t myopt = &my_opt_buffer;
240   char *malloced_buffer1 = NULL;
241
242   memset (&my_opt_buffer, 0, sizeof my_opt_buffer);
243
244 #ifdef USE_LDAPWRAPPER
245   set_strusage (my_strusage);
246   log_set_prefix ("dirmngr_ldap", JNLIB_LOG_WITH_PREFIX);
247
248   /* Setup I18N and common subsystems. */
249   i18n_init();
250
251   init_common_subsystems (&argc, &argv);
252
253   es_set_binary (es_stdout);
254   myopt->outstream = es_stdout;
255 #else /*!USE_LDAPWRAPPER*/
256   myopt->outstream = outstream;
257   for (argc=0; argv[argc]; argc++)
258     ;
259 #endif /*!USE_LDAPWRAPPER*/
260
261   /* LDAP defaults */
262   myopt->timeout.tv_sec = DEFAULT_LDAP_TIMEOUT;
263   myopt->timeout.tv_usec = 0;
264   myopt->alarm_timeout = 0;
265
266   /* Parse the command line.  */
267   pargs.argc = &argc;
268   pargs.argv = &argv;
269   pargs.flags= 1;  /* Do not remove the args. */
270   while (arg_parse (&pargs, opts) )
271     {
272       switch (pargs.r_opt)
273         {
274         case oVerbose: myopt->verbose++; break;
275         case oQuiet: myopt->quiet++; break;
276         case oTimeout:
277           myopt->timeout.tv_sec = pargs.r.ret_int;
278           myopt->timeout.tv_usec = 0;
279           myopt->alarm_timeout = pargs.r.ret_int;
280           break;
281         case oOnlySearchTimeout: only_search_timeout = 1; break;
282         case oMulti: myopt->multi = 1; break;
283         case oUser: myopt->user = pargs.r.ret_str; break;
284         case oPass: myopt->pass = pargs.r.ret_str; break;
285         case oEnvPass:
286           myopt->pass = getenv ("DIRMNGR_LDAP_PASS");
287           break;
288         case oProxy: myopt->proxy = pargs.r.ret_str; break;
289         case oHost: myopt->host = pargs.r.ret_str; break;
290         case oPort: myopt->port = pargs.r.ret_int; break;
291         case oDN:   myopt->dn = pargs.r.ret_str; break;
292         case oFilter: myopt->filter = pargs.r.ret_str; break;
293         case oAttr: myopt->attr = pargs.r.ret_str; break;
294         case oLogWithPID:
295           {
296             unsigned int oldflags;
297             log_get_prefix (&oldflags);
298             log_set_prefix (NULL, oldflags | JNLIB_LOG_WITH_PID);
299           }
300           break;
301
302         default :
303 #ifdef USE_LDAPWRAPPER
304           pargs.err = ARGPARSE_PRINT_ERROR;
305 #else
306           pargs.err = ARGPARSE_PRINT_WARNING;  /* No exit() please.  */
307 #endif
308           break;
309         }
310     }
311
312   if (only_search_timeout)
313     myopt->alarm_timeout = 0;
314
315   if (myopt->proxy)
316     {
317       malloced_buffer1 = xtrystrdup (myopt->proxy);
318       if (!malloced_buffer1)
319         {
320           log_error ("error copying string: %s\n", strerror (errno));
321           return 1;
322         }
323       myopt->host = malloced_buffer1;
324       p = strchr (myopt->host, ':');
325       if (p)
326         {
327           *p++ = 0;
328           myopt->port = atoi (p);
329         }
330       if (!myopt->port)
331         myopt->port = 389;  /* make sure ports gets overridden.  */
332     }
333
334   if (myopt->port < 0 || myopt->port > 65535)
335     log_error (_("invalid port number %d\n"), myopt->port);
336
337 #ifdef USE_LDAPWRAPPER
338   if (log_get_errorcount (0))
339     exit (2);
340   if (argc < 1)
341     usage (1);
342 #else
343   /* All passed arguments should be fine in this case.  */
344   assert (argc);
345 #endif
346
347 #ifdef USE_LDAPWRAPPER
348   if (myopt->alarm_timeout)
349     {
350 #ifndef HAVE_W32_SYSTEM
351 # if defined(HAVE_SIGACTION) && defined(HAVE_STRUCT_SIGACTION)
352       struct sigaction act;
353
354       act.sa_handler = catch_alarm;
355       sigemptyset (&act.sa_mask);
356       act.sa_flags = 0;
357       if (sigaction (SIGALRM,&act,NULL))
358 # else
359       if (signal (SIGALRM, catch_alarm) == SIG_ERR)
360 # endif
361           log_fatal ("unable to register timeout handler\n");
362 #endif
363     }
364 #endif /*USE_LDAPWRAPPER*/
365
366   for (; argc; argc--, argv++)
367     if (process_url (myopt, *argv))
368       any_err = 1;
369
370   xfree (malloced_buffer1);
371   return any_err;
372 }
373
374 #ifndef HAVE_W32_SYSTEM
375 static void
376 catch_alarm (int dummy)
377 {
378   (void)dummy;
379   _exit (10);
380 }
381 #endif
382
383 static void
384 set_timeout (my_opt_t myopt)
385 {
386 #ifdef HAVE_W32_SYSTEM
387   /* FIXME for W32.  */
388   (void)myopt;
389 #else
390   if (myopt->alarm_timeout)
391     alarm (myopt->alarm_timeout);
392 #endif
393 }
394
395
396 /* Helper for fetch_ldap().  */
397 static int
398 print_ldap_entries (my_opt_t myopt, LDAP *ld, LDAPMessage *msg, char *want_attr)
399 {
400   LDAPMessage *item;
401   int any = 0;
402
403   for (npth_unprotect (), item = ldap_first_entry (ld, msg), npth_protect ();
404        item;
405        npth_unprotect (), item = ldap_next_entry (ld, item), npth_protect ())
406     {
407       BerElement *berctx;
408       char *attr;
409
410       if (myopt->verbose > 1)
411         log_info (_("scanning result for attribute '%s'\n"),
412                   want_attr? want_attr : "[all]");
413
414       if (myopt->multi)
415         { /*  Write item marker. */
416           if (es_fwrite ("I\0\0\0\0", 5, 1, myopt->outstream) != 1)
417             {
418               log_error (_("error writing to stdout: %s\n"),
419                          strerror (errno));
420               return -1;
421             }
422         }
423
424
425       for (npth_unprotect (), attr = my_ldap_first_attribute (ld, item, &berctx),
426              npth_protect ();
427            attr;
428            npth_unprotect (), attr = my_ldap_next_attribute (ld, item, berctx),
429              npth_protect ())
430         {
431           struct berval **values;
432           int idx;
433
434           if (myopt->verbose > 1)
435             log_info (_("          available attribute '%s'\n"), attr);
436
437           set_timeout (myopt);
438
439           /* I case we want only one attribute we do a case
440              insensitive compare without the optional extension
441              (i.e. ";binary").  Case insensitive is not really correct
442              but the best we can do.  */
443           if (want_attr)
444             {
445               char *cp1, *cp2;
446               int cmpres;
447
448               cp1 = strchr (want_attr, ';');
449               if (cp1)
450                 *cp1 = 0;
451               cp2 = strchr (attr, ';');
452               if (cp2)
453                 *cp2 = 0;
454               cmpres = ascii_strcasecmp (want_attr, attr);
455               if (cp1)
456                 *cp1 = ';';
457               if (cp2)
458                 *cp2 = ';';
459               if (cmpres)
460                 {
461                   my_ldap_free_attr (attr);
462                   continue; /* Not found:  Try next attribute.  */
463                 }
464             }
465
466           npth_unprotect ();
467           values = my_ldap_get_values_len (ld, item, attr);
468           npth_protect ();
469
470           if (!values)
471             {
472               if (myopt->verbose)
473                 log_info (_("attribute '%s' not found\n"), attr);
474               my_ldap_free_attr (attr);
475               continue;
476             }
477
478           if (myopt->verbose)
479             {
480               log_info (_("found attribute '%s'\n"), attr);
481               if (myopt->verbose > 1)
482                 for (idx=0; values[idx]; idx++)
483                   log_info ("         length[%d]=%d\n",
484                             idx, (int)values[0]->bv_len);
485
486             }
487
488           if (myopt->multi)
489             { /*  Write attribute marker. */
490               unsigned char tmp[5];
491               size_t n = strlen (attr);
492
493               tmp[0] = 'A';
494               tmp[1] = (n >> 24);
495               tmp[2] = (n >> 16);
496               tmp[3] = (n >> 8);
497               tmp[4] = (n);
498               if (es_fwrite (tmp, 5, 1, myopt->outstream) != 1
499                   || es_fwrite (attr, n, 1, myopt->outstream) != 1)
500                 {
501                   log_error (_("error writing to stdout: %s\n"),
502                              strerror (errno));
503                   ldap_value_free_len (values);
504                   my_ldap_free_attr (attr);
505                   ber_free (berctx, 0);
506                   return -1;
507                 }
508             }
509
510           for (idx=0; values[idx]; idx++)
511             {
512               if (myopt->multi)
513                 { /* Write value marker.  */
514                   unsigned char tmp[5];
515                   size_t n = values[0]->bv_len;
516
517                   tmp[0] = 'V';
518                   tmp[1] = (n >> 24);
519                   tmp[2] = (n >> 16);
520                   tmp[3] = (n >> 8);
521                   tmp[4] = (n);
522
523                   if (es_fwrite (tmp, 5, 1, myopt->outstream) != 1)
524                     {
525                       log_error (_("error writing to stdout: %s\n"),
526                                  strerror (errno));
527                       ldap_value_free_len (values);
528                       my_ldap_free_attr (attr);
529                       ber_free (berctx, 0);
530                       return -1;
531                     }
532                 }
533
534               if (es_fwrite (values[0]->bv_val, values[0]->bv_len,
535                              1, myopt->outstream) != 1)
536                 {
537                   log_error (_("error writing to stdout: %s\n"),
538                              strerror (errno));
539                   ldap_value_free_len (values);
540                   my_ldap_free_attr (attr);
541                   ber_free (berctx, 0);
542                   return -1;
543                 }
544
545               any = 1;
546               if (!myopt->multi)
547                 break; /* Print only the first value.  */
548             }
549           ldap_value_free_len (values);
550           my_ldap_free_attr (attr);
551           if (want_attr || !myopt->multi)
552             break; /* We only want to return the first attribute.  */
553         }
554       ber_free (berctx, 0);
555     }
556
557   if (myopt->verbose > 1 && any)
558     log_info ("result has been printed\n");
559
560   return any?0:-1;
561 }
562
563
564
565 /* Helper for the URL based LDAP query. */
566 static int
567 fetch_ldap (my_opt_t myopt, const char *url, const LDAPURLDesc *ludp)
568 {
569   LDAP *ld;
570   LDAPMessage *msg;
571   int rc = 0;
572   char *host, *dn, *filter, *attrs[2], *attr;
573   int port;
574   int ret;
575
576   host     = myopt->host?   myopt->host   : ludp->lud_host;
577   port     = myopt->port?   myopt->port   : ludp->lud_port;
578   dn       = myopt->dn?     myopt->dn     : ludp->lud_dn;
579   filter   = myopt->filter? myopt->filter : ludp->lud_filter;
580   attrs[0] = myopt->attr?   myopt->attr   : ludp->lud_attrs? ludp->lud_attrs[0]:NULL;
581   attrs[1] = NULL;
582   attr = attrs[0];
583
584   if (!port)
585     port = (ludp->lud_scheme && !strcmp (ludp->lud_scheme, "ldaps"))? 636:389;
586
587   if (myopt->verbose)
588     {
589       log_info (_("processing url '%s'\n"), url);
590       if (myopt->user)
591         log_info (_("          user '%s'\n"), myopt->user);
592       if (myopt->pass)
593         log_info (_("          pass '%s'\n"), *myopt->pass?"*****":"");
594       if (host)
595         log_info (_("          host '%s'\n"), host);
596       log_info (_("          port %d\n"), port);
597       if (dn)
598         log_info (_("            DN '%s'\n"), dn);
599       if (filter)
600         log_info (_("        filter '%s'\n"), filter);
601       if (myopt->multi && !myopt->attr && ludp->lud_attrs)
602         {
603           int i;
604           for (i=0; ludp->lud_attrs[i]; i++)
605             log_info (_("          attr '%s'\n"), ludp->lud_attrs[i]);
606         }
607       else if (attr)
608         log_info (_("          attr '%s'\n"), attr);
609     }
610
611
612   if (!host || !*host)
613     {
614       log_error (_("no host name in '%s'\n"), url);
615       return -1;
616     }
617   if (!myopt->multi && !attr)
618     {
619       log_error (_("no attribute given for query '%s'\n"), url);
620       return -1;
621     }
622
623   if (!myopt->multi && !myopt->attr
624       && ludp->lud_attrs && ludp->lud_attrs[0] && ludp->lud_attrs[1])
625     log_info (_("WARNING: using first attribute only\n"));
626
627
628   set_timeout (myopt);
629   npth_unprotect ();
630   ld = my_ldap_init (host, port);
631   npth_protect ();
632   if (!ld)
633     {
634       log_error (_("LDAP init to '%s:%d' failed: %s\n"),
635                  host, port, strerror (errno));
636       return -1;
637     }
638   npth_unprotect ();
639   /* Fixme:  Can we use MYOPT->user or is it shared with other theeads?.  */
640   ret = my_ldap_simple_bind_s (ld, myopt->user, myopt->pass);
641   npth_protect ();
642   if (ret)
643     {
644       log_error (_("binding to '%s:%d' failed: %s\n"),
645                  host, port, strerror (errno));
646       ldap_unbind (ld);
647       return -1;
648     }
649
650   set_timeout (myopt);
651   npth_unprotect ();
652   rc = my_ldap_search_st (ld, dn, ludp->lud_scope, filter,
653                           myopt->multi && !myopt->attr && ludp->lud_attrs?
654                           ludp->lud_attrs:attrs,
655                           0,
656                           &myopt->timeout, &msg);
657   npth_protect ();
658   if (rc == LDAP_SIZELIMIT_EXCEEDED && myopt->multi)
659     {
660       if (es_fwrite ("E\0\0\0\x09truncated", 14, 1, myopt->outstream) != 1)
661         {
662           log_error (_("error writing to stdout: %s\n"), strerror (errno));
663           return -1;
664         }
665     }
666   else if (rc)
667     {
668 #ifdef HAVE_W32CE_SYSTEM
669       log_error ("searching '%s' failed: %d\n", url, rc);
670 #else
671       log_error (_("searching '%s' failed: %s\n"),
672                  url, ldap_err2string (rc));
673 #endif
674       if (rc != LDAP_NO_SUCH_OBJECT)
675         {
676           /* FIXME: Need deinit (ld)?  */
677           /* Hmmm: Do we need to released MSG in case of an error? */
678           return -1;
679         }
680     }
681
682   rc = print_ldap_entries (myopt, ld, msg, myopt->multi? NULL:attr);
683
684   ldap_msgfree (msg);
685   ldap_unbind (ld);
686   return rc;
687 }
688
689
690
691
692 /* Main processing.  Take the URL and run the LDAP query. The result
693    is printed to stdout, errors are logged to the log stream. */
694 static int
695 process_url (my_opt_t myopt, const char *url)
696 {
697   int rc;
698   LDAPURLDesc *ludp = NULL;
699
700
701   if (!ldap_is_ldap_url (url))
702     {
703       log_error (_("'%s' is not an LDAP URL\n"), url);
704       return -1;
705     }
706
707   if (ldap_url_parse (url, &ludp))
708     {
709       log_error (_("'%s' is an invalid LDAP URL\n"), url);
710       return -1;
711     }
712
713   rc = fetch_ldap (myopt, url, ludp);
714
715   ldap_free_urldesc (ludp);
716   return rc;
717 }