Code

rrdtool plugin: Use cdrand_range() for the random variation.
[collectd.git] / src / bind.c
1 /**
2  * collectd - src/bind.c
3  * Copyright (C) 2009       Bruno PrĂ©mont
4  * Copyright (C) 2009,2010  Florian Forster
5  *
6  * This program is free software; you can redistribute it and/or modify it
7  * under the terms of the GNU General Public License as published by the
8  * Free Software Foundation; only version 2 of the License is applicable.
9  *
10  * This program is distributed in the hope that it will be useful, but
11  * WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13  * General Public License for more details.
14  *
15  * You should have received a copy of the GNU General Public License along
16  * with this program; if not, write to the Free Software Foundation, Inc.,
17  * 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
18  *
19  * Authors:
20  *   Bruno PrĂ©mont <bonbons at linux-vserver.org>
21  *   Florian Forster <octo at collectd.org>
22  **/
24 #include "config.h"
26 #if STRPTIME_NEEDS_STANDARDS
27 # ifndef _ISOC99_SOURCE
28 #  define _ISOC99_SOURCE 1
29 # endif
30 # ifndef _POSIX_C_SOURCE
31 #  define _POSIX_C_SOURCE 200112L
32 # endif
33 # ifndef _XOPEN_SOURCE
34 #  define _XOPEN_SOURCE 500
35 # endif
36 #endif /* STRPTIME_NEEDS_STANDARDS */
38 #include "collectd.h"
39 #include "common.h"
40 #include "plugin.h"
41 #include "configfile.h"
43 /* Some versions of libcurl don't include this themselves and then don't have
44  * fd_set available. */
45 #if HAVE_SYS_SELECT_H
46 # include <sys/select.h>
47 #endif
49 #include <curl/curl.h>
50 #include <libxml/parser.h>
51 #include <libxml/xpath.h>
53 #ifndef BIND_DEFAULT_URL
54 # define BIND_DEFAULT_URL "http://localhost:8053/"
55 #endif
57 /* 
58  * Some types used for the callback functions. `translation_table_ptr_t' and
59  * `list_info_ptr_t' are passed to the callbacks in the `void *user_data'
60  * pointer.
61  */
62 typedef int (*list_callback_t) (const char *name, value_t value,
63     time_t current_time, void *user_data);
65 struct cb_view_s
66 {
67   char *name;
69   int qtypes;
70   int resolver_stats;
71   int cacherrsets;
73   char **zones;
74   size_t zones_num;
75 };
76 typedef struct cb_view_s cb_view_t;
78 struct translation_info_s
79 {
80   const char *xml_name;
81   const char *type;
82   const char *type_instance;
83 };
84 typedef struct translation_info_s translation_info_t;
86 struct translation_table_ptr_s
87 {
88   const translation_info_t *table;
89   size_t table_length;
90   const char *plugin_instance;
91 };
92 typedef struct translation_table_ptr_s translation_table_ptr_t;
94 struct list_info_ptr_s
95 {
96   const char *plugin_instance;
97   const char *type;
98 };
99 typedef struct list_info_ptr_s list_info_ptr_t;
101 /* FIXME: Enabled by default for backwards compatibility. */
102 /* TODO: Remove time parsing code. */
103 static _Bool config_parse_time = 1;
105 static char *url                   = NULL;
106 static int global_opcodes          = 1;
107 static int global_qtypes           = 1;
108 static int global_server_stats     = 1;
109 static int global_zone_maint_stats = 1;
110 static int global_resolver_stats   = 0;
111 static int global_memory_stats     = 1;
113 static cb_view_t *views = NULL;
114 static size_t     views_num = 0;
116 static CURL *curl = NULL;
118 static char  *bind_buffer = NULL;
119 static size_t bind_buffer_size = 0;
120 static size_t bind_buffer_fill = 0;
121 static char   bind_curl_error[CURL_ERROR_SIZE];
123 /* Translation table for the `nsstats' values. */
124 static const translation_info_t nsstats_translation_table[] = /* {{{ */
126   /* Requests */
127   { "Requestv4",       "dns_request",  "IPv4"        },
128   { "Requestv6",       "dns_request",  "IPv6"        },
129   { "ReqEdns0",        "dns_request",  "EDNS0"       },
130   { "ReqBadEDNSVer",   "dns_request",  "BadEDNSVer"  },
131   { "ReqTSIG",         "dns_request",  "TSIG"        },
132   { "ReqSIG0",         "dns_request",  "SIG0"        },
133   { "ReqBadSIG",       "dns_request",  "BadSIG"      },
134   { "ReqTCP",          "dns_request",  "TCP"         },
135   /* Rejects */
136   { "AuthQryRej",      "dns_reject",   "authorative" },
137   { "RecQryRej",       "dns_reject",   "recursive"   },
138   { "XfrRej",          "dns_reject",   "transfer"    },
139   { "UpdateRej",       "dns_reject",   "update"      },
140   /* Responses */
141   { "Response",        "dns_response", "normal"      },
142   { "TruncatedResp",   "dns_response", "truncated"   },
143   { "RespEDNS0",       "dns_response", "EDNS0"       },
144   { "RespTSIG",        "dns_response", "TSIG"        },
145   { "RespSIG0",        "dns_response", "SIG0"        },
146   /* Queries */
147   { "QryAuthAns",      "dns_query",    "authorative" },
148   { "QryNoauthAns",    "dns_query",    "nonauth"     },
149   { "QryReferral",     "dns_query",    "referral"    },
150   { "QryRecursion",    "dns_query",    "recursion"   },
151   { "QryDuplicate",    "dns_query",    "dupliate"    },
152   { "QryDropped",      "dns_query",    "dropped"     },
153   { "QryFailure",      "dns_query",    "failure"     },
154   /* Response codes */
155   { "QrySuccess",      "dns_rcode",    "tx-NOERROR"  },
156   { "QryNxrrset",      "dns_rcode",    "tx-NXRRSET"  },
157   { "QrySERVFAIL",     "dns_rcode",    "tx-SERVFAIL" },
158   { "QryFORMERR",      "dns_rcode",    "tx-FORMERR"  },
159   { "QryNXDOMAIN",     "dns_rcode",    "tx-NXDOMAIN" }
160 #if 0
161   { "XfrReqDone",      "type", "type_instance"       },
162   { "UpdateReqFwd",    "type", "type_instance"       },
163   { "UpdateRespFwd",   "type", "type_instance"       },
164   { "UpdateFwdFail",   "type", "type_instance"       },
165   { "UpdateDone",      "type", "type_instance"       },
166   { "UpdateFail",      "type", "type_instance"       },
167   { "UpdateBadPrereq", "type", "type_instance"       },
168 #endif
169 };
170 static int nsstats_translation_table_length =
171   STATIC_ARRAY_SIZE (nsstats_translation_table);
172 /* }}} */
174 /* Translation table for the `zonestats' values. */
175 static const translation_info_t zonestats_translation_table[] = /* {{{ */
177   /* Notify's */
178   { "NotifyOutv4",     "dns_notify",   "tx-IPv4"     },
179   { "NotifyOutv6",     "dns_notify",   "tx-IPv6"     },
180   { "NotifyInv4",      "dns_notify",   "rx-IPv4"     },
181   { "NotifyInv6",      "dns_notify",   "rx-IPv6"     },
182   { "NotifyRej",       "dns_notify",   "rejected"    },
183   /* SOA/AXFS/IXFS requests */
184   { "SOAOutv4",        "dns_opcode",   "SOA-IPv4"    },
185   { "SOAOutv6",        "dns_opcode",   "SOA-IPv6"    },
186   { "AXFRReqv4",       "dns_opcode",   "AXFR-IPv4"   },
187   { "AXFRReqv6",       "dns_opcode",   "AXFR-IPv6"   },
188   { "IXFRReqv4",       "dns_opcode",   "IXFR-IPv4"   },
189   { "IXFRReqv6",       "dns_opcode",   "IXFR-IPv6"   },
190   /* Domain transfers */
191   { "XfrSuccess",      "dns_transfer", "success"     },
192   { "XfrFail",         "dns_transfer", "failure"     }
193 };
194 static int zonestats_translation_table_length =
195   STATIC_ARRAY_SIZE (zonestats_translation_table);
196 /* }}} */
198 /* Translation table for the `resstats' values. */
199 static const translation_info_t resstats_translation_table[] = /* {{{ */
201   /* Generic resolver information */
202   { "Queryv4",         "dns_query",    "IPv4"        },
203   { "Queryv6",         "dns_query",    "IPv6"        },
204   { "Responsev4",      "dns_response", "IPv4"        },
205   { "Responsev6",      "dns_response", "IPv6"        },
206   /* Received response codes */
207   { "NXDOMAIN",        "dns_rcode",    "rx-NXDOMAIN" },
208   { "SERVFAIL",        "dns_rcode",    "rx-SERVFAIL" },
209   { "FORMERR",         "dns_rcode",    "rx-FORMERR"  },
210   { "OtherError",      "dns_rcode",    "rx-OTHER"    },
211   { "EDNS0Fail",       "dns_rcode",    "rx-EDNS0Fail"},
212   /* Received responses */
213   { "Mismatch",        "dns_response", "mismatch"    },
214   { "Truncated",       "dns_response", "truncated"   },
215   { "Lame",            "dns_response", "lame"        },
216   { "Retry",           "dns_query",    "retry"       },
217 #if 0
218   { "GlueFetchv4",     "type", "type_instance" },
219   { "GlueFetchv6",     "type", "type_instance" },
220   { "GlueFetchv4Fail", "type", "type_instance" },
221   { "GlueFetchv6Fail", "type", "type_instance" },
222 #endif
223   /* DNSSEC information */
224   { "ValAttempt",      "dns_resolver", "DNSSEC-attempt" },
225   { "ValOk",           "dns_resolver", "DNSSEC-okay"    },
226   { "ValNegOk",        "dns_resolver", "DNSSEC-negokay" },
227   { "ValFail",         "dns_resolver", "DNSSEC-fail"    }
228 };
229 static int resstats_translation_table_length =
230   STATIC_ARRAY_SIZE (resstats_translation_table);
231 /* }}} */
233 /* Translation table for the `memory/summary' values. */
234 static const translation_info_t memsummary_translation_table[] = /* {{{ */
236   { "TotalUse",        "memory",       "TotalUse"    },
237   { "InUse",           "memory",       "InUse"       },
238   { "BlockSize",       "memory",       "BlockSize"   },
239   { "ContextSize",     "memory",       "ContextSize" },
240   { "Lost",            "memory",       "Lost"        }
241 };
242 static int memsummary_translation_table_length =
243   STATIC_ARRAY_SIZE (memsummary_translation_table);
244 /* }}} */
246 static void submit (time_t ts, const char *plugin_instance, /* {{{ */
247     const char *type, const char *type_instance, value_t value)
249   value_t values[1];
250   value_list_t vl = VALUE_LIST_INIT;
252   values[0] = value;
254   vl.values = values;
255   vl.values_len = 1;
256   if (config_parse_time)
257     vl.time = TIME_T_TO_CDTIME_T (ts);
258   sstrncpy(vl.host, hostname_g, sizeof(vl.host));
259   sstrncpy(vl.plugin, "bind", sizeof(vl.plugin));
260   if (plugin_instance) {
261     sstrncpy(vl.plugin_instance, plugin_instance,
262         sizeof(vl.plugin_instance));
263     replace_special (vl.plugin_instance, sizeof (vl.plugin_instance));
264   }
265   sstrncpy(vl.type, type, sizeof(vl.type));
266   if (type_instance) {
267     sstrncpy(vl.type_instance, type_instance,
268         sizeof(vl.type_instance));
269     replace_special (vl.plugin_instance, sizeof (vl.plugin_instance));
270   }
271   plugin_dispatch_values(&vl);
272 } /* }}} void submit */
274 static size_t bind_curl_callback (void *buf, size_t size, /* {{{ */
275     size_t nmemb, void __attribute__((unused)) *stream)
277   size_t len = size * nmemb;
279   if (len <= 0)
280     return (len);
282   if ((bind_buffer_fill + len) >= bind_buffer_size)
283   {
284     char *temp;
286     temp = realloc(bind_buffer, bind_buffer_fill + len + 1);
287     if (temp == NULL)
288     {
289       ERROR ("bind plugin: realloc failed.");
290       return (0);
291     }
292     bind_buffer = temp;
293     bind_buffer_size = bind_buffer_fill + len + 1;
294   }
296   memcpy (bind_buffer + bind_buffer_fill, (char *) buf, len);
297   bind_buffer_fill += len;
298   bind_buffer[bind_buffer_fill] = 0;
300   return (len);
301 } /* }}} size_t bind_curl_callback */
303 /*
304  * Callback, that's called with a translation table.
305  * (Plugin instance is fixed, type and type instance come from lookup table.)
306  */
307 static int bind_xml_table_callback (const char *name, value_t value, /* {{{ */
308     time_t current_time, void *user_data)
310   translation_table_ptr_t *table = (translation_table_ptr_t *) user_data;
311   size_t i;
313   if (table == NULL)
314     return (-1);
316   for (i = 0; i < table->table_length; i++)
317   {
318     if (strcmp (table->table[i].xml_name, name) != 0)
319       continue;
321     submit (current_time,
322         table->plugin_instance,
323         table->table[i].type,
324         table->table[i].type_instance,
325         value);
326     break;
327   }
329   return (0);
330 } /* }}} int bind_xml_table_callback */
332 /*
333  * Callback, that's used for lists.
334  * (Plugin instance and type are fixed, xml name is used as type instance.)
335  */
336 static int bind_xml_list_callback (const char *name, /* {{{ */
337     value_t value, time_t current_time, void *user_data)
339   list_info_ptr_t *list_info = (list_info_ptr_t *) user_data;
341   if (list_info == NULL)
342     return (-1);
344   submit (current_time,
345       list_info->plugin_instance,
346       list_info->type,
347       /* type instance = */ name,
348       value);
350   return (0);
351 } /* }}} int bind_xml_list_callback */
353 static int bind_xml_read_derive (xmlDoc *doc, xmlNode *node, /* {{{ */
354     derive_t *ret_value)
356   char *str_ptr;
357   value_t value;
358   int status;
360   str_ptr = (char *) xmlNodeListGetString (doc, node->xmlChildrenNode, 1);
361   if (str_ptr == NULL)
362   {
363     ERROR ("bind plugin: bind_xml_read_derive: xmlNodeListGetString failed.");
364     return (-1);
365   }
367   status = parse_value (str_ptr, &value, DS_TYPE_DERIVE);
368   if (status != 0)
369   {
370     ERROR ("bind plugin: Parsing string \"%s\" to derive value failed.",
371         str_ptr);
372     return (-1);
373   }
375   *ret_value = value.derive;
376   return (0);
377 } /* }}} int bind_xml_read_derive */
379 static int bind_xml_read_gauge (xmlDoc *doc, xmlNode *node, /* {{{ */
380     gauge_t *ret_value)
382   char *str_ptr, *end_ptr;
383   double value;
385   str_ptr = (char *) xmlNodeListGetString (doc, node->xmlChildrenNode, 1);
386   if (str_ptr == NULL)
387   {
388     ERROR ("bind plugin: bind_xml_read_gauge: xmlNodeListGetString failed.");
389     return (-1);
390   }
392   errno = 0;
393   value = strtod (str_ptr, &end_ptr);
394   xmlFree(str_ptr);
395   if (str_ptr == end_ptr || errno)
396   {
397     if (errno && (value < 0))
398       ERROR ("bind plugin: bind_xml_read_gauge: strtod failed with underflow.");
399     else if (errno && (value > 0))
400       ERROR ("bind plugin: bind_xml_read_gauge: strtod failed with overflow.");
401     else
402       ERROR ("bind plugin: bind_xml_read_gauge: strtod failed.");
403     return (-1);
404   }
406   *ret_value = (gauge_t) value;
407   return (0);
408 } /* }}} int bind_xml_read_gauge */
410 static int bind_xml_read_timestamp (const char *xpath_expression, /* {{{ */
411     xmlDoc *doc, xmlXPathContext *xpathCtx, time_t *ret_value)
413   xmlXPathObject *xpathObj = NULL;
414   xmlNode *node;
415   char *str_ptr;
416   char *tmp;
417   struct tm tm;
419   xpathObj = xmlXPathEvalExpression (BAD_CAST xpath_expression, xpathCtx);
420   if (xpathObj == NULL)
421   {
422     ERROR ("bind plugin: Unable to evaluate XPath expression `%s'.",
423         xpath_expression);
424     return (-1);
425   }
427   if ((xpathObj->nodesetval == NULL) || (xpathObj->nodesetval->nodeNr < 1))
428   {
429     xmlXPathFreeObject (xpathObj);
430     return (-1);
431   }
433   if (xpathObj->nodesetval->nodeNr != 1)
434   {
435     NOTICE ("bind plugin: Evaluating the XPath expression `%s' returned "
436         "%i nodes. Only handling the first one.",
437         xpath_expression, xpathObj->nodesetval->nodeNr);
438   }
440   node = xpathObj->nodesetval->nodeTab[0];
442   if (node->xmlChildrenNode == NULL)
443   {
444     ERROR ("bind plugin: bind_xml_read_timestamp: "
445         "node->xmlChildrenNode == NULL");
446     xmlXPathFreeObject (xpathObj);
447     return (-1);
448   }
450   str_ptr = (char *) xmlNodeListGetString (doc, node->xmlChildrenNode, 1);
451   if (str_ptr == NULL)
452   {
453     ERROR ("bind plugin: bind_xml_read_timestamp: xmlNodeListGetString failed.");
454     xmlXPathFreeObject (xpathObj);
455     return (-1);
456   }
458   memset (&tm, 0, sizeof(tm));
459   tmp = strptime (str_ptr, "%Y-%m-%dT%T", &tm);
460   xmlFree(str_ptr);
461   if (tmp == NULL)
462   {
463     ERROR ("bind plugin: bind_xml_read_timestamp: strptime failed.");
464     xmlXPathFreeObject (xpathObj);
465     return (-1);
466   }
468   *ret_value = mktime(&tm);
470   xmlXPathFreeObject (xpathObj);
471   return (0);
472 } /* }}} int bind_xml_read_timestamp */
474 /* 
475  * bind_parse_generic_name_value
476  *
477  * Reads statistics in the form:
478  * <foo>
479  *   <name>QUERY</name>
480  *   <counter>123</counter>
481  * </foo>
482  */
483 static int bind_parse_generic_name_value (const char *xpath_expression, /* {{{ */
484     list_callback_t list_callback,
485     void *user_data,
486     xmlDoc *doc, xmlXPathContext *xpathCtx,
487     time_t current_time, int ds_type)
489   xmlXPathObject *xpathObj = NULL;
490   int num_entries;
491   int i;
493   xpathObj = xmlXPathEvalExpression(BAD_CAST xpath_expression, xpathCtx);
494   if (xpathObj == NULL)
495   {
496     ERROR("bind plugin: Unable to evaluate XPath expression `%s'.",
497         xpath_expression);
498     return (-1);
499   }
501   num_entries = 0;
502   /* Iterate over all matching nodes. */
503   for (i = 0; xpathObj->nodesetval && (i < xpathObj->nodesetval->nodeNr); i++)
504   {
505     xmlNode *name_node = NULL;
506     xmlNode *counter = NULL;
507     xmlNode *parent;
508     xmlNode *child;
510     parent = xpathObj->nodesetval->nodeTab[i];
511     DEBUG ("bind plugin: bind_parse_generic_name_value: parent->name = %s;",
512         (char *) parent->name);
514     /* Iterate over all child nodes. */
515     for (child = parent->xmlChildrenNode;
516         child != NULL;
517         child = child->next)
518     {
519       if (child->type != XML_ELEMENT_NODE)
520         continue;
522       if (xmlStrcmp (BAD_CAST "name", child->name) == 0)
523         name_node = child;
524       else if (xmlStrcmp (BAD_CAST "counter", child->name) == 0)
525         counter = child;
526     }
528     if ((name_node != NULL) && (counter != NULL))
529     {
530       char *name = (char *) xmlNodeListGetString (doc,
531           name_node->xmlChildrenNode, 1);
532       value_t value;
533       int status;
535       if (ds_type == DS_TYPE_GAUGE)
536         status = bind_xml_read_gauge (doc, counter, &value.gauge);
537       else
538         status = bind_xml_read_derive (doc, counter, &value.derive);
539       if (status != 0)
540         continue;
542       status = (*list_callback) (name, value, current_time, user_data);
543       if (status == 0)
544         num_entries++;
546       xmlFree (name);
547     }
548   }
550   DEBUG ("bind plugin: Found %d %s for XPath expression `%s'",
551       num_entries, (num_entries == 1) ? "entry" : "entries",
552       xpath_expression);
554   xmlXPathFreeObject(xpathObj);
556   return (0);
557 } /* }}} int bind_parse_generic_name_value */
559 /* 
560  * bind_parse_generic_value_list
561  *
562  * Reads statistics in the form:
563  * <foo>
564  *   <name0>123</name0>
565  *   <name1>234</name1>
566  *   <name2>345</name2>
567  *   :
568  * </foo>
569  */
570 static int bind_parse_generic_value_list (const char *xpath_expression, /* {{{ */
571     list_callback_t list_callback,
572     void *user_data,
573     xmlDoc *doc, xmlXPathContext *xpathCtx,
574     time_t current_time, int ds_type)
576   xmlXPathObject *xpathObj = NULL;
577   int num_entries;
578   int i;
580   xpathObj = xmlXPathEvalExpression(BAD_CAST xpath_expression, xpathCtx);
581   if (xpathObj == NULL)
582   {
583     ERROR("bind plugin: Unable to evaluate XPath expression `%s'.",
584         xpath_expression);
585     return (-1);
586   }
588   num_entries = 0;
589   /* Iterate over all matching nodes. */
590   for (i = 0; xpathObj->nodesetval && (i < xpathObj->nodesetval->nodeNr); i++)
591   {
592     xmlNode *child;
594     /* Iterate over all child nodes. */
595     for (child = xpathObj->nodesetval->nodeTab[i]->xmlChildrenNode;
596         child != NULL;
597         child = child->next)
598     {
599       char *node_name;
600       value_t value;
601       int status;
603       if (child->type != XML_ELEMENT_NODE)
604         continue;
606       node_name = (char *) child->name;
608       if (ds_type == DS_TYPE_GAUGE)
609         status = bind_xml_read_gauge (doc, child, &value.gauge);
610       else
611         status = bind_xml_read_derive (doc, child, &value.derive);
612       if (status != 0)
613         continue;
615       status = (*list_callback) (node_name, value, current_time, user_data);
616       if (status == 0)
617         num_entries++;
618     }
619   }
621   DEBUG ("bind plugin: Found %d %s for XPath expression `%s'",
622       num_entries, (num_entries == 1) ? "entry" : "entries",
623       xpath_expression);
625   xmlXPathFreeObject(xpathObj);
627   return (0);
628 } /* }}} int bind_parse_generic_value_list */
630 static int bind_xml_stats_handle_zone (int version, xmlDoc *doc, /* {{{ */
631     xmlXPathContext *path_ctx, xmlNode *node, cb_view_t *view,
632     time_t current_time)
634   xmlXPathObject *path_obj;
635   char *zone_name = NULL;
636   int i;
637   size_t j;
639   path_obj = xmlXPathEvalExpression (BAD_CAST "name", path_ctx);
640   if (path_obj == NULL)
641   {
642     ERROR ("bind plugin: xmlXPathEvalExpression failed.");
643     return (-1);
644   }
646   for (i = 0; path_obj->nodesetval && (i < path_obj->nodesetval->nodeNr); i++)
647   {
648     zone_name = (char *) xmlNodeListGetString (doc,
649         path_obj->nodesetval->nodeTab[i]->xmlChildrenNode, 1);
650     if (zone_name != NULL)
651       break;
652   }
654   if (zone_name == NULL)
655   {
656     ERROR ("bind plugin: Could not determine zone name.");
657     xmlXPathFreeObject (path_obj);
658     return (-1);
659   }
661   for (j = 0; j < view->zones_num; j++)
662   {
663     if (strcasecmp (zone_name, view->zones[j]) == 0)
664       break;
665   }
667   xmlFree (zone_name);
668   zone_name = NULL;
670   if (j >= views_num)
671   {
672     xmlXPathFreeObject (path_obj);
673     return (0);
674   }
676   zone_name = view->zones[j];
678   DEBUG ("bind plugin: bind_xml_stats_handle_zone: Found zone `%s'.",
679       zone_name);
681   { /* Parse the <counters> tag {{{ */
682     char plugin_instance[DATA_MAX_NAME_LEN];
683     translation_table_ptr_t table_ptr =
684     { 
685       nsstats_translation_table,
686       nsstats_translation_table_length,
687       plugin_instance
688     };
690     ssnprintf (plugin_instance, sizeof (plugin_instance), "%s-zone-%s",
691         view->name, zone_name);
693     bind_parse_generic_value_list (/* xpath = */ "counters",
694         /* callback = */ bind_xml_table_callback,
695         /* user_data = */ &table_ptr,
696         doc, path_ctx, current_time, DS_TYPE_COUNTER);
697   } /* }}} */
699   xmlXPathFreeObject (path_obj);
701   return (0);
702 } /* }}} int bind_xml_stats_handle_zone */
704 static int bind_xml_stats_search_zones (int version, xmlDoc *doc, /* {{{ */
705     xmlXPathContext *path_ctx, xmlNode *node, cb_view_t *view,
706     time_t current_time)
708   xmlXPathObject *zone_nodes = NULL;
709   xmlXPathContext *zone_path_context;
710   int i;
712   zone_path_context = xmlXPathNewContext (doc);
713   if (zone_path_context == NULL)
714   {
715     ERROR ("bind plugin: xmlXPathNewContext failed.");
716     return (-1);
717   }
719   zone_nodes = xmlXPathEvalExpression (BAD_CAST "zones/zone", path_ctx);
720   if (zone_nodes == NULL)
721   {
722     ERROR ("bind plugin: Cannot find any <view> tags.");
723     xmlXPathFreeContext (zone_path_context);
724     return (-1);
725   }
727   for (i = 0; i < zone_nodes->nodesetval->nodeNr; i++)
728   {
729     xmlNode *node;
731     node = zone_nodes->nodesetval->nodeTab[i];
732     assert (node != NULL);
734     zone_path_context->node = node;
736     bind_xml_stats_handle_zone (version, doc, zone_path_context, node, view,
737         current_time);
738   }
740   xmlXPathFreeObject (zone_nodes);
741   xmlXPathFreeContext (zone_path_context);
742   return (0);
743 } /* }}} int bind_xml_stats_search_zones */
745 static int bind_xml_stats_handle_view (int version, xmlDoc *doc, /* {{{ */
746     xmlXPathContext *path_ctx, xmlNode *node, time_t current_time)
748   xmlXPathObject *path_obj;
749   char *view_name = NULL;
750   cb_view_t *view;
751   int i;
752   size_t j;
754   path_obj = xmlXPathEvalExpression (BAD_CAST "name", path_ctx);
755   if (path_obj == NULL)
756   {
757     ERROR ("bind plugin: xmlXPathEvalExpression failed.");
758     return (-1);
759   }
761   for (i = 0; path_obj->nodesetval && (i < path_obj->nodesetval->nodeNr); i++)
762   {
763     view_name = (char *) xmlNodeListGetString (doc,
764         path_obj->nodesetval->nodeTab[i]->xmlChildrenNode, 1);
765     if (view_name != NULL)
766       break;
767   }
769   if (view_name == NULL)
770   {
771     ERROR ("bind plugin: Could not determine view name.");
772     xmlXPathFreeObject (path_obj);
773     return (-1);
774   }
776   for (j = 0; j < views_num; j++)
777   {
778     if (strcasecmp (view_name, views[j].name) == 0)
779       break;
780   }
782   xmlFree (view_name);
783   xmlXPathFreeObject (path_obj);
785   view_name = NULL;
786   path_obj = NULL;
788   if (j >= views_num)
789     return (0);
791   view = views + j;
793   DEBUG ("bind plugin: bind_xml_stats_handle_view: Found view `%s'.",
794       view->name);
796   if (view->qtypes != 0) /* {{{ */
797   {
798     char plugin_instance[DATA_MAX_NAME_LEN];
799     list_info_ptr_t list_info =
800     {
801       plugin_instance,
802       /* type = */ "dns_qtype"
803     };
805     ssnprintf (plugin_instance, sizeof (plugin_instance), "%s-qtypes",
806         view->name);
808     bind_parse_generic_name_value (/* xpath = */ "rdtype",
809         /* callback = */ bind_xml_list_callback,
810         /* user_data = */ &list_info,
811         doc, path_ctx, current_time, DS_TYPE_COUNTER);
812   } /* }}} */
814   if (view->resolver_stats != 0) /* {{{ */
815   {
816     char plugin_instance[DATA_MAX_NAME_LEN];
817     translation_table_ptr_t table_ptr =
818     { 
819       resstats_translation_table,
820       resstats_translation_table_length,
821       plugin_instance
822     };
824     ssnprintf (plugin_instance, sizeof (plugin_instance),
825         "%s-resolver_stats", view->name);
827     bind_parse_generic_name_value ("resstat",
828         /* callback = */ bind_xml_table_callback,
829         /* user_data = */ &table_ptr,
830         doc, path_ctx, current_time, DS_TYPE_COUNTER);
831   } /* }}} */
833   /* Record types in the cache */
834   if (view->cacherrsets != 0) /* {{{ */
835   {
836     char plugin_instance[DATA_MAX_NAME_LEN];
837     list_info_ptr_t list_info =
838     {
839       plugin_instance,
840       /* type = */ "dns_qtype_cached"
841     };
843     ssnprintf (plugin_instance, sizeof (plugin_instance), "%s-cache_rr_sets",
844         view->name);
846     bind_parse_generic_name_value (/* xpath = */ "cache/rrset",
847         /* callback = */ bind_xml_list_callback,
848         /* user_data = */ &list_info,
849         doc, path_ctx, current_time, DS_TYPE_GAUGE);
850   } /* }}} */
852   if (view->zones_num > 0)
853     bind_xml_stats_search_zones (version, doc, path_ctx, node, view,
854         current_time);
856   return (0);
857 } /* }}} int bind_xml_stats_handle_view */
859 static int bind_xml_stats_search_views (int version, xmlDoc *doc, /* {{{ */
860     xmlXPathContext *xpathCtx, xmlNode *statsnode, time_t current_time)
862   xmlXPathObject *view_nodes = NULL;
863   xmlXPathContext *view_path_context;
864   int i;
866   view_path_context = xmlXPathNewContext (doc);
867   if (view_path_context == NULL)
868   {
869     ERROR ("bind plugin: xmlXPathNewContext failed.");
870     return (-1);
871   }
873   view_nodes = xmlXPathEvalExpression (BAD_CAST "views/view", xpathCtx);
874   if (view_nodes == NULL)
875   {
876     ERROR ("bind plugin: Cannot find any <view> tags.");
877     xmlXPathFreeContext (view_path_context);
878     return (-1);
879   }
881   for (i = 0; i < view_nodes->nodesetval->nodeNr; i++)
882   {
883     xmlNode *node;
885     node = view_nodes->nodesetval->nodeTab[i];
886     assert (node != NULL);
888     view_path_context->node = node;
890     bind_xml_stats_handle_view (version, doc, view_path_context, node,
891         current_time);
892   }
894   xmlXPathFreeObject (view_nodes);
895   xmlXPathFreeContext (view_path_context);
896   return (0);
897 } /* }}} int bind_xml_stats_search_views */
899 static int bind_xml_stats (int version, xmlDoc *doc, /* {{{ */
900     xmlXPathContext *xpathCtx, xmlNode *statsnode)
902   time_t current_time = 0;
903   int status;
905   xpathCtx->node = statsnode;
907   /* TODO: Check `server/boot-time' to recognize server restarts. */
909   status = bind_xml_read_timestamp ("server/current-time",
910       doc, xpathCtx, &current_time);
911   if (status != 0)
912   {
913     ERROR ("bind plugin: Reading `server/current-time' failed.");
914     return (-1);
915   }
916   DEBUG ("bind plugin: Current server time is %i.", (int) current_time);
918   /* XPath:     server/requests/opcode
919    * Variables: QUERY, IQUERY, NOTIFY, UPDATE, ...
920    * Layout:
921    *   <opcode>
922    *     <name>A</name>
923    *     <counter>1</counter>
924    *   </opcode>
925    *   :
926    */
927   if (global_opcodes != 0)
928   {
929     list_info_ptr_t list_info =
930     {
931       /* plugin instance = */ "global-opcodes",
932       /* type = */ "dns_opcode"
933     };
935     bind_parse_generic_name_value (/* xpath = */ "server/requests/opcode",
936         /* callback = */ bind_xml_list_callback,
937         /* user_data = */ &list_info,
938         doc, xpathCtx, current_time, DS_TYPE_COUNTER);
939   }
941   /* XPath:     server/queries-in/rdtype
942    * Variables: RESERVED0, A, NS, CNAME, SOA, MR, PTR, HINFO, MX, TXT, RP,
943    *            X25, PX, AAAA, LOC, SRV, NAPTR, A6, DS, RRSIG, NSEC, DNSKEY,
944    *            SPF, TKEY, IXFR, AXFR, ANY, ..., Others
945    * Layout:
946    *   <rdtype>
947    *     <name>A</name>
948    *     <counter>1</counter>
949    *   </rdtype>
950    *   :
951    */
952   if (global_qtypes != 0)
953   {
954     list_info_ptr_t list_info =
955     {
956       /* plugin instance = */ "global-qtypes",
957       /* type = */ "dns_qtype"
958     };
960     bind_parse_generic_name_value (/* xpath = */ "server/queries-in/rdtype",
961         /* callback = */ bind_xml_list_callback,
962         /* user_data = */ &list_info,
963         doc, xpathCtx, current_time, DS_TYPE_COUNTER);
964   }
965   
966   /* XPath:     server/nsstats, server/nsstat
967    * Variables: Requestv4, Requestv6, ReqEdns0, ReqBadEDNSVer, ReqTSIG,
968    *            ReqSIG0, ReqBadSIG, ReqTCP, AuthQryRej, RecQryRej, XfrRej,
969    *            UpdateRej, Response, TruncatedResp, RespEDNS0, RespTSIG,
970    *            RespSIG0, QrySuccess, QryAuthAns, QryNoauthAns, QryReferral,
971    *            QryNxrrset, QrySERVFAIL, QryFORMERR, QryNXDOMAIN, QryRecursion,
972    *            QryDuplicate, QryDropped, QryFailure, XfrReqDone, UpdateReqFwd,
973    *            UpdateRespFwd, UpdateFwdFail, UpdateDone, UpdateFail,
974    *            UpdateBadPrereq
975    * Layout v1:
976    *   <nsstats>
977    *     <Requestv4>1</Requestv4>
978    *     <Requestv6>0</Requestv6>
979    *     :
980    *   </nsstats>
981    * Layout v2:
982    *   <nsstat>
983    *     <name>Requestv4</name>
984    *     <counter>1</counter>
985    *   </nsstat>
986    *   <nsstat>
987    *     <name>Requestv6</name>
988    *     <counter>0</counter>
989    *   </nsstat>
990    *   :
991    */
992   if (global_server_stats)
993   {
994     translation_table_ptr_t table_ptr =
995     { 
996       nsstats_translation_table,
997       nsstats_translation_table_length,
998       /* plugin_instance = */ "global-server_stats"
999     };
1001     if (version == 1)
1002     {
1003       bind_parse_generic_value_list ("server/nsstats",
1004           /* callback = */ bind_xml_table_callback,
1005           /* user_data = */ &table_ptr,
1006           doc, xpathCtx, current_time, DS_TYPE_COUNTER);
1007     }
1008     else
1009     {
1010       bind_parse_generic_name_value ("server/nsstat",
1011           /* callback = */ bind_xml_table_callback,
1012           /* user_data = */ &table_ptr,
1013           doc, xpathCtx, current_time, DS_TYPE_COUNTER);
1014     }
1015   }
1017   /* XPath:     server/zonestats, server/zonestat
1018    * Variables: NotifyOutv4, NotifyOutv6, NotifyInv4, NotifyInv6, NotifyRej,
1019    *            SOAOutv4, SOAOutv6, AXFRReqv4, AXFRReqv6, IXFRReqv4, IXFRReqv6,
1020    *            XfrSuccess, XfrFail
1021    * Layout v1:
1022    *   <zonestats>
1023    *     <NotifyOutv4>0</NotifyOutv4>
1024    *     <NotifyOutv6>0</NotifyOutv6>
1025    *     :
1026    *   </zonestats>
1027    * Layout v2:
1028    *   <zonestat>
1029    *     <name>NotifyOutv4</name>
1030    *     <counter>0</counter>
1031    *   </zonestat>
1032    *   <zonestat>
1033    *     <name>NotifyOutv6</name>
1034    *     <counter>0</counter>
1035    *   </zonestat>
1036    *   :
1037    */
1038   if (global_zone_maint_stats)
1039   {
1040     translation_table_ptr_t table_ptr =
1041     { 
1042       zonestats_translation_table,
1043       zonestats_translation_table_length,
1044       /* plugin_instance = */ "global-zone_maint_stats"
1045     };
1047     if (version == 1)
1048     {
1049       bind_parse_generic_value_list ("server/zonestats",
1050           /* callback = */ bind_xml_table_callback,
1051           /* user_data = */ &table_ptr,
1052           doc, xpathCtx, current_time, DS_TYPE_COUNTER);
1053     }
1054     else
1055     {
1056       bind_parse_generic_name_value ("server/zonestat",
1057           /* callback = */ bind_xml_table_callback,
1058           /* user_data = */ &table_ptr,
1059           doc, xpathCtx, current_time, DS_TYPE_COUNTER);
1060     }
1061   }
1063   /* XPath:     server/resstats
1064    * Variables: Queryv4, Queryv6, Responsev4, Responsev6, NXDOMAIN, SERVFAIL,
1065    *            FORMERR, OtherError, EDNS0Fail, Mismatch, Truncated, Lame,
1066    *            Retry, GlueFetchv4, GlueFetchv6, GlueFetchv4Fail,
1067    *            GlueFetchv6Fail, ValAttempt, ValOk, ValNegOk, ValFail
1068    * Layout v1:
1069    *   <resstats>
1070    *     <Queryv4>0</Queryv4>
1071    *     <Queryv6>0</Queryv6>
1072    *     :
1073    *   </resstats>
1074    * Layout v2:
1075    *   <resstat>
1076    *     <name>Queryv4</name>
1077    *     <counter>0</counter>
1078    *   </resstat>
1079    *   <resstat>
1080    *     <name>Queryv6</name>
1081    *     <counter>0</counter>
1082    *   </resstat>
1083    *   :
1084    */
1085   if (global_resolver_stats != 0)
1086   {
1087     translation_table_ptr_t table_ptr =
1088     { 
1089       resstats_translation_table,
1090       resstats_translation_table_length,
1091       /* plugin_instance = */ "global-resolver_stats"
1092     };
1094     if (version == 1)
1095     {
1096       bind_parse_generic_value_list ("server/resstats",
1097           /* callback = */ bind_xml_table_callback,
1098           /* user_data = */ &table_ptr,
1099           doc, xpathCtx, current_time, DS_TYPE_COUNTER);
1100     }
1101     else
1102     {
1103       bind_parse_generic_name_value ("server/resstat",
1104           /* callback = */ bind_xml_table_callback,
1105           /* user_data = */ &table_ptr,
1106           doc, xpathCtx, current_time, DS_TYPE_COUNTER);
1107     }
1108   }
1110   /* XPath:  memory/summary
1111    * Variables: TotalUse, InUse, BlockSize, ContextSize, Lost
1112    * Layout: v2:
1113    *   <summary>
1114    *     <TotalUse>6587096</TotalUse>
1115    *     <InUse>1345424</InUse>
1116    *     <BlockSize>5505024</BlockSize>
1117    *     <ContextSize>3732456</ContextSize>
1118    *     <Lost>0</Lost>
1119    *   </summary>
1120    */
1121   if (global_memory_stats != 0)
1122   {
1123     translation_table_ptr_t table_ptr =
1124     {
1125       memsummary_translation_table,
1126       memsummary_translation_table_length,
1127       /* plugin_instance = */ "global-memory_stats"
1128     };
1130     bind_parse_generic_value_list ("memory/summary",
1131           /* callback = */ bind_xml_table_callback,
1132           /* user_data = */ &table_ptr,
1133           doc, xpathCtx, current_time, DS_TYPE_GAUGE);
1134   }
1136   if (views_num > 0)
1137     bind_xml_stats_search_views (version, doc, xpathCtx, statsnode,
1138         current_time);
1140   return 0;
1141 } /* }}} int bind_xml_stats */
1143 static int bind_xml (const char *data) /* {{{ */
1145   xmlDoc *doc = NULL;
1146   xmlXPathContext *xpathCtx = NULL;
1147   xmlXPathObject *xpathObj = NULL;
1148   int ret = -1;
1149   int i;
1151   doc = xmlParseMemory (data, strlen (data));
1152   if (doc == NULL)
1153   {
1154     ERROR ("bind plugin: xmlParseMemory failed.");
1155     return (-1);
1156   }
1158   xpathCtx = xmlXPathNewContext (doc);
1159   if (xpathCtx == NULL)
1160   {
1161     ERROR ("bind plugin: xmlXPathNewContext failed.");
1162     xmlFreeDoc (doc);
1163     return (-1);
1164   }
1166   xpathObj = xmlXPathEvalExpression (BAD_CAST "/isc/bind/statistics", xpathCtx);
1167   if (xpathObj == NULL)
1168   {
1169     ERROR ("bind plugin: Cannot find the <statistics> tag.");
1170     xmlXPathFreeContext (xpathCtx);
1171     xmlFreeDoc (doc);
1172     return (-1);
1173   }
1174   else if (xpathObj->nodesetval == NULL)
1175   {
1176     ERROR ("bind plugin: xmlXPathEvalExpression failed.");
1177     xmlXPathFreeObject (xpathObj);
1178     xmlXPathFreeContext (xpathCtx);
1179     xmlFreeDoc (doc);
1180     return (-1);
1181   }
1183   for (i = 0; i < xpathObj->nodesetval->nodeNr; i++)
1184   {
1185     xmlNode *node;
1186     char *attr_version;
1187     int parsed_version = 0;
1189     node = xpathObj->nodesetval->nodeTab[i];
1190     assert (node != NULL);
1192     attr_version = (char *) xmlGetProp (node, BAD_CAST "version");
1193     if (attr_version == NULL)
1194     {
1195       NOTICE ("bind plugin: Found <statistics> tag doesn't have a "
1196           "`version' attribute.");
1197       continue;
1198     }
1199     DEBUG ("bind plugin: Found: <statistics version=\"%s\">", attr_version);
1201     /* At the time this plugin was written, version "1.0" was used by
1202      * BIND 9.5.0, version "2.0" was used by BIND 9.5.1 and 9.6.0. We assume
1203      * that "1.*" and "2.*" don't introduce structural changes, so we just
1204      * check for the first two characters here. */
1205     if (strncmp ("1.", attr_version, strlen ("1.")) == 0)
1206       parsed_version = 1;
1207     else if (strncmp ("2.", attr_version, strlen ("2.")) == 0)
1208       parsed_version = 2;
1209     else
1210     {
1211       /* TODO: Use the complaint mechanism here. */
1212       NOTICE ("bind plugin: Found <statistics> tag with version `%s'. "
1213           "Unfortunately I have no clue how to parse that. "
1214           "Please open a bug report for this.", attr_version);
1215       xmlFree (attr_version);
1216       continue;
1217     }
1219     ret = bind_xml_stats (parsed_version,
1220         doc, xpathCtx, node);
1222     xmlFree (attr_version);
1223     /* One <statistics> node ought to be enough. */
1224     break;
1225   }
1227   xmlXPathFreeObject (xpathObj);
1228   xmlXPathFreeContext (xpathCtx);
1229   xmlFreeDoc (doc);
1231   return (ret);
1232 } /* }}} int bind_xml */
1234 static int bind_config_set_bool (const char *name, int *var, /* {{{ */
1235     oconfig_item_t *ci)
1237   if ((ci->values_num != 1) || ( ci->values[0].type != OCONFIG_TYPE_BOOLEAN))
1238   {
1239     WARNING ("bind plugin: The `%s' option needs "
1240         "exactly one boolean argument.", name);
1241     return (-1);
1242   }
1244   if (ci->values[0].value.boolean)
1245     *var = 1;
1246   else
1247     *var = 0;
1248   return 0;
1249 } /* }}} int bind_config_set_bool */
1251 static int bind_config_add_view_zone (cb_view_t *view, /* {{{ */
1252     oconfig_item_t *ci)
1254   char **tmp;
1256   if ((ci->values_num != 1) || (ci->values[0].type != OCONFIG_TYPE_STRING))
1257   {
1258     WARNING ("bind plugin: The `Zone' option needs "
1259         "exactly one string argument.");
1260     return (-1);
1261   }
1263   tmp = (char **) realloc (view->zones,
1264       sizeof (char *) * (view->zones_num + 1));
1265   if (tmp == NULL)
1266   {
1267     ERROR ("bind plugin: realloc failed.");
1268     return (-1);
1269   }
1270   view->zones = tmp;
1272   view->zones[view->zones_num] = strdup (ci->values[0].value.string);
1273   if (view->zones[view->zones_num] == NULL)
1274   {
1275     ERROR ("bind plugin: strdup failed.");
1276     return (-1);
1277   }
1278   view->zones_num++;
1280   return (0);
1281 } /* }}} int bind_config_add_view_zone */
1283 static int bind_config_add_view (oconfig_item_t *ci) /* {{{ */
1285   cb_view_t *tmp;
1286   int i;
1288   if ((ci->values_num != 1) || (ci->values[0].type != OCONFIG_TYPE_STRING))
1289   {
1290     WARNING ("bind plugin: `View' blocks need exactly one string argument.");
1291     return (-1);
1292   }
1294   tmp = (cb_view_t *) realloc (views, sizeof (*views) * (views_num + 1));
1295   if (tmp == NULL)
1296   {
1297     ERROR ("bind plugin: realloc failed.");
1298     return (-1);
1299   }
1300   views = tmp;
1301   tmp = views + views_num;
1303   memset (tmp, 0, sizeof (*tmp));
1304   tmp->qtypes = 1;
1305   tmp->resolver_stats = 1;
1306   tmp->cacherrsets = 1;
1307   tmp->zones = NULL;
1308   tmp->zones_num = 0;
1310   tmp->name = strdup (ci->values[0].value.string);
1311   if (tmp->name == NULL)
1312   {
1313     ERROR ("bind plugin: strdup failed.");
1314     free (tmp);
1315     return (-1);
1316   }
1318   for (i = 0; i < ci->children_num; i++)
1319   {
1320     oconfig_item_t *child = ci->children + i;
1322     if (strcasecmp ("QTypes", child->key) == 0)
1323       bind_config_set_bool ("QTypes", &tmp->qtypes, child);
1324     else if (strcasecmp ("ResolverStats", child->key) == 0)
1325       bind_config_set_bool ("ResolverStats", &tmp->resolver_stats, child);
1326     else if (strcasecmp ("CacheRRSets", child->key) == 0)
1327       bind_config_set_bool ("CacheRRSets", &tmp->cacherrsets, child);
1328     else if (strcasecmp ("Zone", child->key) == 0)
1329       bind_config_add_view_zone (tmp, child);
1330     else
1331     {
1332       WARNING ("bind plugin: Unknown configuration option "
1333           "`%s' in view `%s' will be ignored.", child->key, tmp->name);
1334     }
1335   } /* for (i = 0; i < ci->children_num; i++) */
1337   views_num++;
1338   return (0);
1339 } /* }}} int bind_config_add_view */
1341 static int bind_config (oconfig_item_t *ci) /* {{{ */
1343   int i;
1345   for (i = 0; i < ci->children_num; i++)
1346   {
1347     oconfig_item_t *child = ci->children + i;
1349     if (strcasecmp ("Url", child->key) == 0) {
1350       if ((child->values_num != 1) || (child->values[0].type != OCONFIG_TYPE_STRING))
1351       {
1352         WARNING ("bind plugin: The `Url' option needs "
1353                  "exactly one string argument.");
1354         return (-1);
1355       }
1357       url = strdup (child->values[0].value.string);
1358     } else if (strcasecmp ("OpCodes", child->key) == 0)
1359       bind_config_set_bool ("OpCodes", &global_opcodes, child);
1360     else if (strcasecmp ("QTypes", child->key) == 0)
1361       bind_config_set_bool ("QTypes", &global_qtypes, child);
1362     else if (strcasecmp ("ServerStats", child->key) == 0)
1363       bind_config_set_bool ("ServerStats", &global_server_stats, child);
1364     else if (strcasecmp ("ZoneMaintStats", child->key) == 0)
1365       bind_config_set_bool ("ZoneMaintStats", &global_zone_maint_stats, child);
1366     else if (strcasecmp ("ResolverStats", child->key) == 0)
1367       bind_config_set_bool ("ResolverStats", &global_resolver_stats, child);
1368     else if (strcasecmp ("MemoryStats", child->key) == 0)
1369       bind_config_set_bool ("MemoryStats", &global_memory_stats, child);
1370     else if (strcasecmp ("View", child->key) == 0)
1371       bind_config_add_view (child);
1372     else if (strcasecmp ("ParseTime", child->key) == 0)
1373       cf_util_get_boolean (child, &config_parse_time);
1374     else
1375     {
1376       WARNING ("bind plugin: Unknown configuration option "
1377           "`%s' will be ignored.", child->key);
1378     }
1379   }
1381   return (0);
1382 } /* }}} int bind_config */
1384 static int bind_init (void) /* {{{ */
1386   if (curl != NULL)
1387     return (0);
1389   curl = curl_easy_init ();
1390   if (curl == NULL)
1391   {
1392     ERROR ("bind plugin: bind_init: curl_easy_init failed.");
1393     return (-1);
1394   }
1396   curl_easy_setopt (curl, CURLOPT_NOSIGNAL, 1L);
1397   curl_easy_setopt (curl, CURLOPT_WRITEFUNCTION, bind_curl_callback);
1398   curl_easy_setopt (curl, CURLOPT_USERAGENT, PACKAGE_NAME"/"PACKAGE_VERSION);
1399   curl_easy_setopt (curl, CURLOPT_ERRORBUFFER, bind_curl_error);
1400   curl_easy_setopt (curl, CURLOPT_URL, (url != NULL) ? url : BIND_DEFAULT_URL);
1401   curl_easy_setopt (curl, CURLOPT_FOLLOWLOCATION, 1L);
1402   curl_easy_setopt (curl, CURLOPT_MAXREDIRS, 50L);
1404   return (0);
1405 } /* }}} int bind_init */
1407 static int bind_read (void) /* {{{ */
1409   int status;
1411   if (curl == NULL)
1412   {
1413     ERROR ("bind plugin: I don't have a CURL object.");
1414     return (-1);
1415   }
1417   bind_buffer_fill = 0;
1418   if (curl_easy_perform (curl) != CURLE_OK)
1419   {
1420     ERROR ("bind plugin: curl_easy_perform failed: %s",
1421         bind_curl_error);
1422     return (-1);
1423   }
1425   status = bind_xml (bind_buffer);
1426   if (status != 0)
1427     return (-1);
1428   else
1429     return (0);
1430 } /* }}} int bind_read */
1432 static int bind_shutdown (void) /* {{{ */
1434   if (curl != NULL)
1435   {
1436     curl_easy_cleanup (curl);
1437     curl = NULL;
1438   }
1440   return (0);
1441 } /* }}} int bind_shutdown */
1443 void module_register (void)
1445   plugin_register_complex_config ("bind", bind_config);
1446   plugin_register_init ("bind", bind_init);
1447   plugin_register_read ("bind", bind_read);
1448   plugin_register_shutdown ("bind", bind_shutdown);
1449 } /* void module_register */
1451 /* vim: set sw=2 sts=2 ts=8 et fdm=marker : */