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  **/
  23
  24 #include "config.h"
  25
  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 */
  37
  38 #if TIMEGM_NEEDS_BSD
  39 #ifndef _BSD_SOURCE
  40 #define _BSD_SOURCE 1
  41 #endif
  42 #endif /* TIMEGM_NEEDS_BSD */
  43
  44 #include "collectd.h"
  45
  46 #include "common.h"
  47 #include "plugin.h"
  48
  49 #include <time.h>
  50
  51 /* Some versions of libcurl don't include this themselves and then don't have
  52  * fd_set available. */
  53 #if HAVE_SYS_SELECT_H
  54 #include <sys/select.h>
  55 #endif
  56
  57 #include <curl/curl.h>
  58 #include <libxml/parser.h>
  59 #include <libxml/xpath.h>
  60
  61 #ifndef BIND_DEFAULT_URL
  62 #define BIND_DEFAULT_URL "http://localhost:8053/"
  63 #endif
  64
  65 /*
  66  * Some types used for the callback functions. `translation_table_ptr_t' and
  67  * `list_info_ptr_t' are passed to the callbacks in the `void *user_data'
  68  * pointer.
  69  */
  70 typedef int (*list_callback_t)(const char *name, value_t value,
  71                                time_t current_time, void *user_data);
  72
  73 struct cb_view_s {
  74   char *name;
  75
  76   int qtypes;
  77   int resolver_stats;
  78   int cacherrsets;
  79
  80   char **zones;
  81   size_t zones_num;
  82 };
  83 typedef struct cb_view_s cb_view_t;
  84
  85 struct translation_info_s {
  86   const char *xml_name;
  87   const char *type;
  88   const char *type_instance;
  89 };
  90 typedef struct translation_info_s translation_info_t;
  91
  92 struct translation_table_ptr_s {
  93   const translation_info_t *table;
  94   size_t table_length;
  95   const char *plugin_instance;
  96 };
  97 typedef struct translation_table_ptr_s translation_table_ptr_t;
  98
  99 struct list_info_ptr_s {
 100   const char *plugin_instance;
 101   const char *type;
 102 };
 103 typedef struct list_info_ptr_s list_info_ptr_t;
 104
 105 /* FIXME: Enabled by default for backwards compatibility. */
 106 /* TODO: Remove time parsing code. */
 107 static _Bool config_parse_time = 1;
 108
 109 static char *url = NULL;
 110 static int global_opcodes = 1;
 111 static int global_qtypes = 1;
 112 static int global_server_stats = 1;
 113 static int global_zone_maint_stats = 1;
 114 static int global_resolver_stats = 0;
 115 static int global_memory_stats = 1;
 116 static int timeout = -1;
 117
 118 static cb_view_t *views = NULL;
 119 static size_t views_num = 0;
 120
 121 static CURL *curl = NULL;
 122
 123 static char *bind_buffer = NULL;
 124 static size_t bind_buffer_size = 0;
 125 static size_t bind_buffer_fill = 0;
 126 static char bind_curl_error[CURL_ERROR_SIZE];
 127
 128 /* Translation table for the `nsstats' values. */
 129 static const translation_info_t nsstats_translation_table[] = /* {{{ */
 130     {
 131         /* Requests */
 132         {"Requestv4", "dns_request", "IPv4"},
 133         {"Requestv6", "dns_request", "IPv6"},
 134         {"ReqEdns0", "dns_request", "EDNS0"},
 135         {"ReqBadEDNSVer", "dns_request", "BadEDNSVer"},
 136         {"ReqTSIG", "dns_request", "TSIG"},
 137         {"ReqSIG0", "dns_request", "SIG0"},
 138         {"ReqBadSIG", "dns_request", "BadSIG"},
 139         {"ReqTCP", "dns_request", "TCP"},
 140         /* Rejects */
 141         {"AuthQryRej", "dns_reject", "authoritative"},
 142         {"RecQryRej", "dns_reject", "recursive"},
 143         {"XfrRej", "dns_reject", "transfer"},
 144         {"UpdateRej", "dns_reject", "update"},
 145         /* Responses */
 146         {"Response", "dns_response", "normal"},
 147         {"TruncatedResp", "dns_response", "truncated"},
 148         {"RespEDNS0", "dns_response", "EDNS0"},
 149         {"RespTSIG", "dns_response", "TSIG"},
 150         {"RespSIG0", "dns_response", "SIG0"},
 151         /* Queries */
 152         {"QryAuthAns", "dns_query", "authoritative"},
 153         {"QryNoauthAns", "dns_query", "nonauth"},
 154         {"QryReferral", "dns_query", "referral"},
 155         {"QryRecursion", "dns_query", "recursion"},
 156         {"QryDuplicate", "dns_query", "duplicate"},
 157         {"QryDropped", "dns_query", "dropped"},
 158         {"QryFailure", "dns_query", "failure"},
 159         /* Response codes */
 160         {"QrySuccess", "dns_rcode", "tx-NOERROR"},
 161         {"QryNxrrset", "dns_rcode", "tx-NXRRSET"},
 162         {"QrySERVFAIL", "dns_rcode", "tx-SERVFAIL"},
 163         {"QryFORMERR", "dns_rcode", "tx-FORMERR"},
 164         {"QryNXDOMAIN", "dns_rcode", "tx-NXDOMAIN"}
 165 #if 0
 166   { "XfrReqDone",      "type",         "type_instance" },
 167   { "UpdateReqFwd",    "type",         "type_instance" },
 168   { "UpdateRespFwd",   "type",         "type_instance" },
 169   { "UpdateFwdFail",   "type",         "type_instance" },
 170   { "UpdateDone",      "type",         "type_instance" },
 171   { "UpdateFail",      "type",         "type_instance" },
 172   { "UpdateBadPrereq", "type",         "type_instance" },
 173 #endif
 174 };
 175 static int nsstats_translation_table_length =
 176     STATIC_ARRAY_SIZE(nsstats_translation_table);
 177 /* }}} */
 178
 179 /* Translation table for the `zonestats' values. */
 180 static const translation_info_t zonestats_translation_table[] = /* {{{ */
 181     {
 182         /* Notify's */
 183         {"NotifyOutv4", "dns_notify", "tx-IPv4"},
 184         {"NotifyOutv6", "dns_notify", "tx-IPv6"},
 185         {"NotifyInv4", "dns_notify", "rx-IPv4"},
 186         {"NotifyInv6", "dns_notify", "rx-IPv6"},
 187         {"NotifyRej", "dns_notify", "rejected"},
 188         /* SOA/AXFS/IXFS requests */
 189         {"SOAOutv4", "dns_opcode", "SOA-IPv4"},
 190         {"SOAOutv6", "dns_opcode", "SOA-IPv6"},
 191         {"AXFRReqv4", "dns_opcode", "AXFR-IPv4"},
 192         {"AXFRReqv6", "dns_opcode", "AXFR-IPv6"},
 193         {"IXFRReqv4", "dns_opcode", "IXFR-IPv4"},
 194         {"IXFRReqv6", "dns_opcode", "IXFR-IPv6"},
 195         /* Domain transfers */
 196         {"XfrSuccess", "dns_transfer", "success"},
 197         {"XfrFail", "dns_transfer", "failure"}};
 198 static int zonestats_translation_table_length =
 199     STATIC_ARRAY_SIZE(zonestats_translation_table);
 200 /* }}} */
 201
 202 /* Translation table for the `resstats' values. */
 203 static const translation_info_t resstats_translation_table[] = /* {{{ */
 204     {
 205         /* Generic resolver information */
 206         {"Queryv4", "dns_query", "IPv4"},
 207         {"Queryv6", "dns_query", "IPv6"},
 208         {"Responsev4", "dns_response", "IPv4"},
 209         {"Responsev6", "dns_response", "IPv6"},
 210         /* Received response codes */
 211         {"NXDOMAIN", "dns_rcode", "rx-NXDOMAIN"},
 212         {"SERVFAIL", "dns_rcode", "rx-SERVFAIL"},
 213         {"FORMERR", "dns_rcode", "rx-FORMERR"},
 214         {"OtherError", "dns_rcode", "rx-OTHER"},
 215         {"EDNS0Fail", "dns_rcode", "rx-EDNS0Fail"},
 216         /* Received responses */
 217         {"Mismatch", "dns_response", "mismatch"},
 218         {"Truncated", "dns_response", "truncated"},
 219         {"Lame", "dns_response", "lame"},
 220         {"Retry", "dns_query", "retry"},
 221 #if 0
 222   { "GlueFetchv4",     "type", "type_instance" },
 223   { "GlueFetchv6",     "type", "type_instance" },
 224   { "GlueFetchv4Fail", "type", "type_instance" },
 225   { "GlueFetchv6Fail", "type", "type_instance" },
 226 #endif
 227         /* DNSSEC information */
 228         {"ValAttempt", "dns_resolver", "DNSSEC-attempt"},
 229         {"ValOk", "dns_resolver", "DNSSEC-okay"},
 230         {"ValNegOk", "dns_resolver", "DNSSEC-negokay"},
 231         {"ValFail", "dns_resolver", "DNSSEC-fail"}};
 232 static int resstats_translation_table_length =
 233     STATIC_ARRAY_SIZE(resstats_translation_table);
 234 /* }}} */
 235
 236 /* Translation table for the `memory/summary' values. */
 237 static const translation_info_t memsummary_translation_table[] = /* {{{ */
 238     {{"TotalUse", "memory", "TotalUse"},
 239      {"InUse", "memory", "InUse"},
 240      {"BlockSize", "memory", "BlockSize"},
 241      {"ContextSize", "memory", "ContextSize"},
 242      {"Lost", "memory", "Lost"}};
 243 static int memsummary_translation_table_length =
 244     STATIC_ARRAY_SIZE(memsummary_translation_table);
 245 /* }}} */
 246
 247 static void submit(time_t ts, const char *plugin_instance, /* {{{ */
 248                    const char *type, const char *type_instance, value_t value) {
 249   value_list_t vl = VALUE_LIST_INIT;
 250
 251   vl.values = &value;
 252   vl.values_len = 1;
 253   if (config_parse_time)
 254     vl.time = TIME_T_TO_CDTIME_T(ts);
 255   sstrncpy(vl.plugin, "bind", sizeof(vl.plugin));
 256   if (plugin_instance) {
 257     sstrncpy(vl.plugin_instance, plugin_instance, sizeof(vl.plugin_instance));
 258     replace_special(vl.plugin_instance, sizeof(vl.plugin_instance));
 259   }
 260   sstrncpy(vl.type, type, sizeof(vl.type));
 261   if (type_instance) {
 262     sstrncpy(vl.type_instance, type_instance, sizeof(vl.type_instance));
 263     replace_special(vl.type_instance, sizeof(vl.type_instance));
 264   }
 265   plugin_dispatch_values(&vl);
 266 } /* }}} void submit */
 267
 268 static size_t bind_curl_callback(void *buf, size_t size, /* {{{ */
 269                                  size_t nmemb,
 270                                  void __attribute__((unused)) * stream) {
 271   size_t len = size * nmemb;
 272
 273   if (len == 0)
 274     return len;
 275
 276   if ((bind_buffer_fill + len) >= bind_buffer_size) {
 277     char *temp;
 278
 279     temp = realloc(bind_buffer, bind_buffer_fill + len + 1);
 280     if (temp == NULL) {
 281       ERROR("bind plugin: realloc failed.");
 282       return 0;
 283     }
 284     bind_buffer = temp;
 285     bind_buffer_size = bind_buffer_fill + len + 1;
 286   }
 287
 288   memcpy(bind_buffer + bind_buffer_fill, (char *)buf, len);
 289   bind_buffer_fill += len;
 290   bind_buffer[bind_buffer_fill] = 0;
 291
 292   return len;
 293 } /* }}} size_t bind_curl_callback */
 294
 295 /*
 296  * Callback, that's called with a translation table.
 297  * (Plugin instance is fixed, type and type instance come from lookup table.)
 298  */
 299 static int bind_xml_table_callback(const char *name, value_t value, /* {{{ */
 300                                    time_t current_time, void *user_data) {
 301   translation_table_ptr_t *table = (translation_table_ptr_t *)user_data;
 302
 303   if (table == NULL)
 304     return -1;
 305
 306   for (size_t i = 0; i < table->table_length; i++) {
 307     if (strcmp(table->table[i].xml_name, name) != 0)
 308       continue;
 309
 310     submit(current_time, table->plugin_instance, table->table[i].type,
 311            table->table[i].type_instance, value);
 312     break;
 313   }
 314
 315   return 0;
 316 } /* }}} int bind_xml_table_callback */
 317
 318 /*
 319  * Callback, that's used for lists.
 320  * (Plugin instance and type are fixed, xml name is used as type instance.)
 321  */
 322 static int bind_xml_list_callback(const char *name, /* {{{ */
 323                                   value_t value, time_t current_time,
 324                                   void *user_data) {
 325   list_info_ptr_t *list_info = (list_info_ptr_t *)user_data;
 326
 327   if (list_info == NULL)
 328     return -1;
 329
 330   submit(current_time, list_info->plugin_instance, list_info->type,
 331          /* type instance = */ name, value);
 332
 333   return 0;
 334 } /* }}} int bind_xml_list_callback */
 335
 336 static int bind_xml_read_derive(xmlDoc *doc, xmlNode *node, /* {{{ */
 337                                 derive_t *ret_value) {
 338   char *str_ptr;
 339   value_t value;
 340   int status;
 341
 342   str_ptr = (char *)xmlNodeListGetString(doc, node->xmlChildrenNode, 1);
 343   if (str_ptr == NULL) {
 344     ERROR("bind plugin: bind_xml_read_derive: xmlNodeListGetString failed.");
 345     return -1;
 346   }
 347
 348   status = parse_value(str_ptr, &value, DS_TYPE_DERIVE);
 349   if (status != 0) {
 350     ERROR("bind plugin: Parsing string \"%s\" to derive value failed.",
 351           str_ptr);
 352     xmlFree(str_ptr);
 353     return -1;
 354   }
 355
 356   xmlFree(str_ptr);
 357   *ret_value = value.derive;
 358   return 0;
 359 } /* }}} int bind_xml_read_derive */
 360
 361 static int bind_xml_read_gauge(xmlDoc *doc, xmlNode *node, /* {{{ */
 362                                gauge_t *ret_value) {
 363   char *str_ptr, *end_ptr;
 364   double value;
 365
 366   str_ptr = (char *)xmlNodeListGetString(doc, node->xmlChildrenNode, 1);
 367   if (str_ptr == NULL) {
 368     ERROR("bind plugin: bind_xml_read_gauge: xmlNodeListGetString failed.");
 369     return -1;
 370   }
 371
 372   errno = 0;
 373   value = strtod(str_ptr, &end_ptr);
 374   xmlFree(str_ptr);
 375   if (str_ptr == end_ptr || errno) {
 376     if (errno && (value < 0))
 377       ERROR("bind plugin: bind_xml_read_gauge: strtod failed with underflow.");
 378     else if (errno && (value > 0))
 379       ERROR("bind plugin: bind_xml_read_gauge: strtod failed with overflow.");
 380     else
 381       ERROR("bind plugin: bind_xml_read_gauge: strtod failed.");
 382     return -1;
 383   }
 384
 385   *ret_value = (gauge_t)value;
 386   return 0;
 387 } /* }}} int bind_xml_read_gauge */
 388
 389 static int bind_xml_read_timestamp(const char *xpath_expression, /* {{{ */
 390                                    xmlDoc *doc, xmlXPathContext *xpathCtx,
 391                                    time_t *ret_value) {
 392   xmlXPathObject *xpathObj = NULL;
 393   xmlNode *node;
 394   char *str_ptr;
 395   char *tmp;
 396   struct tm tm = {0};
 397
 398   xpathObj = xmlXPathEvalExpression(BAD_CAST xpath_expression, xpathCtx);
 399   if (xpathObj == NULL) {
 400     ERROR("bind plugin: Unable to evaluate XPath expression `%s'.",
 401           xpath_expression);
 402     return -1;
 403   }
 404
 405   if ((xpathObj->nodesetval == NULL) || (xpathObj->nodesetval->nodeNr < 1)) {
 406     xmlXPathFreeObject(xpathObj);
 407     return -1;
 408   }
 409
 410   if (xpathObj->nodesetval->nodeNr != 1) {
 411     NOTICE("bind plugin: Evaluating the XPath expression `%s' returned "
 412            "%i nodes. Only handling the first one.",
 413            xpath_expression, xpathObj->nodesetval->nodeNr);
 414   }
 415
 416   node = xpathObj->nodesetval->nodeTab[0];
 417
 418   if (node->xmlChildrenNode == NULL) {
 419     ERROR("bind plugin: bind_xml_read_timestamp: "
 420           "node->xmlChildrenNode == NULL");
 421     xmlXPathFreeObject(xpathObj);
 422     return -1;
 423   }
 424
 425   str_ptr = (char *)xmlNodeListGetString(doc, node->xmlChildrenNode, 1);
 426   if (str_ptr == NULL) {
 427     ERROR("bind plugin: bind_xml_read_timestamp: xmlNodeListGetString failed.");
 428     xmlXPathFreeObject(xpathObj);
 429     return -1;
 430   }
 431
 432   tmp = strptime(str_ptr, "%Y-%m-%dT%T", &tm);
 433   xmlFree(str_ptr);
 434   if (tmp == NULL) {
 435     ERROR("bind plugin: bind_xml_read_timestamp: strptime failed.");
 436     xmlXPathFreeObject(xpathObj);
 437     return -1;
 438   }
 439
 440 #if HAVE_TIMEGM
 441   time_t t = timegm(&tm);
 442   if (t == ((time_t)-1)) {
 443     char errbuf[1024];
 444     ERROR("bind plugin: timegm() failed: %s",
 445           sstrerror(errno, errbuf, sizeof(errbuf)));
 446     return -1;
 447   }
 448   *ret_value = t;
 449 #else
 450   time_t t = mktime(&tm);
 451   if (t == ((time_t)-1)) {
 452     char errbuf[1024];
 453     ERROR("bind plugin: mktime() failed: %s",
 454           sstrerror(errno, errbuf, sizeof(errbuf)));
 455     return -1;
 456   }
 457   /* mktime assumes that tm is local time. Luckily, it also sets timezone to
 458    * the offset used for the conversion, and we undo the conversion to convert
 459    * back to UTC. */
 460   *ret_value = t - timezone;
 461 #endif
 462
 463   xmlXPathFreeObject(xpathObj);
 464   return 0;
 465 } /* }}} int bind_xml_read_timestamp */
 466
 467 /*
 468  * bind_parse_generic_name_value
 469  *
 470  * Reads statistics in the form:
 471  * <foo>
 472  *   <name>QUERY</name>
 473  *   <counter>123</counter>
 474  * </foo>
 475  */
 476 static int bind_parse_generic_name_value(const char *xpath_expression, /* {{{ */
 477                                          list_callback_t list_callback,
 478                                          void *user_data, xmlDoc *doc,
 479                                          xmlXPathContext *xpathCtx,
 480                                          time_t current_time, int ds_type) {
 481   xmlXPathObject *xpathObj = NULL;
 482   int num_entries;
 483
 484   xpathObj = xmlXPathEvalExpression(BAD_CAST xpath_expression, xpathCtx);
 485   if (xpathObj == NULL) {
 486     ERROR("bind plugin: Unable to evaluate XPath expression `%s'.",
 487           xpath_expression);
 488     return -1;
 489   }
 490
 491   num_entries = 0;
 492   /* Iterate over all matching nodes. */
 493   for (int i = 0; xpathObj->nodesetval && (i < xpathObj->nodesetval->nodeNr);
 494        i++) {
 495     xmlNode *name_node = NULL;
 496     xmlNode *counter = NULL;
 497     xmlNode *parent;
 498
 499     parent = xpathObj->nodesetval->nodeTab[i];
 500     DEBUG("bind plugin: bind_parse_generic_name_value: parent->name = %s;",
 501           (char *)parent->name);
 502
 503     /* Iterate over all child nodes. */
 504     for (xmlNode *child = parent->xmlChildrenNode; child != NULL;
 505          child = child->next) {
 506       if (child->type != XML_ELEMENT_NODE)
 507         continue;
 508
 509       if (xmlStrcmp(BAD_CAST "name", child->name) == 0)
 510         name_node = child;
 511       else if (xmlStrcmp(BAD_CAST "counter", child->name) == 0)
 512         counter = child;
 513     }
 514
 515     if ((name_node != NULL) && (counter != NULL)) {
 516       char *name =
 517           (char *)xmlNodeListGetString(doc, name_node->xmlChildrenNode, 1);
 518       value_t value;
 519       int status;
 520
 521       if (ds_type == DS_TYPE_GAUGE)
 522         status = bind_xml_read_gauge(doc, counter, &value.gauge);
 523       else
 524         status = bind_xml_read_derive(doc, counter, &value.derive);
 525       if (status != 0) {
 526         xmlFree(name);
 527         continue;
 528       }
 529
 530       status = (*list_callback)(name, value, current_time, user_data);
 531       if (status == 0)
 532         num_entries++;
 533
 534       xmlFree(name);
 535     }
 536   }
 537
 538   DEBUG("bind plugin: Found %d %s for XPath expression `%s'", num_entries,
 539         (num_entries == 1) ? "entry" : "entries", xpath_expression);
 540
 541   xmlXPathFreeObject(xpathObj);
 542
 543   return 0;
 544 } /* }}} int bind_parse_generic_name_value */
 545
 546 /*
 547  * bind_parse_generic_value_list
 548  *
 549  * Reads statistics in the form:
 550  * <foo>
 551  *   <name0>123</name0>
 552  *   <name1>234</name1>
 553  *   <name2>345</name2>
 554  *   :
 555  * </foo>
 556  */
 557 static int bind_parse_generic_value_list(const char *xpath_expression, /* {{{ */
 558                                          list_callback_t list_callback,
 559                                          void *user_data, xmlDoc *doc,
 560                                          xmlXPathContext *xpathCtx,
 561                                          time_t current_time, int ds_type) {
 562   xmlXPathObject *xpathObj = NULL;
 563   int num_entries;
 564
 565   xpathObj = xmlXPathEvalExpression(BAD_CAST xpath_expression, xpathCtx);
 566   if (xpathObj == NULL) {
 567     ERROR("bind plugin: Unable to evaluate XPath expression `%s'.",
 568           xpath_expression);
 569     return -1;
 570   }
 571
 572   num_entries = 0;
 573   /* Iterate over all matching nodes. */
 574   for (int i = 0; xpathObj->nodesetval && (i < xpathObj->nodesetval->nodeNr);
 575        i++) {
 576     /* Iterate over all child nodes. */
 577     for (xmlNode *child = xpathObj->nodesetval->nodeTab[i]->xmlChildrenNode;
 578          child != NULL; child = child->next) {
 579       char *node_name;
 580       value_t value;
 581       int status;
 582
 583       if (child->type != XML_ELEMENT_NODE)
 584         continue;
 585
 586       node_name = (char *)child->name;
 587
 588       if (ds_type == DS_TYPE_GAUGE)
 589         status = bind_xml_read_gauge(doc, child, &value.gauge);
 590       else
 591         status = bind_xml_read_derive(doc, child, &value.derive);
 592       if (status != 0)
 593         continue;
 594
 595       status = (*list_callback)(node_name, value, current_time, user_data);
 596       if (status == 0)
 597         num_entries++;
 598     }
 599   }
 600
 601   DEBUG("bind plugin: Found %d %s for XPath expression `%s'", num_entries,
 602         (num_entries == 1) ? "entry" : "entries", xpath_expression);
 603
 604   xmlXPathFreeObject(xpathObj);
 605
 606   return 0;
 607 } /* }}} int bind_parse_generic_value_list */
 608
 609 /*
 610  * bind_parse_generic_name_attr_value_list
 611  *
 612  * Reads statistics in the form:
 613  * <foo>
 614  *   <counter name="name0">123</counter>
 615  *   <counter name="name1">234</counter>
 616  *   <counter name="name2">345</counter>
 617  *   :
 618  * </foo>
 619  */
 620 static int bind_parse_generic_name_attr_value_list(
 621     const char *xpath_expression, /* {{{ */
 622     list_callback_t list_callback, void *user_data, xmlDoc *doc,
 623     xmlXPathContext *xpathCtx, time_t current_time, int ds_type) {
 624   xmlXPathObject *xpathObj = NULL;
 625   int num_entries;
 626
 627   xpathObj = xmlXPathEvalExpression(BAD_CAST xpath_expression, xpathCtx);
 628   if (xpathObj == NULL) {
 629     ERROR("bind plugin: Unable to evaluate XPath expression `%s'.",
 630           xpath_expression);
 631     return -1;
 632   }
 633
 634   num_entries = 0;
 635   /* Iterate over all matching nodes. */
 636   for (int i = 0; xpathObj->nodesetval && (i < xpathObj->nodesetval->nodeNr);
 637        i++) {
 638     /* Iterate over all child nodes. */
 639     for (xmlNode *child = xpathObj->nodesetval->nodeTab[i]->xmlChildrenNode;
 640          child != NULL; child = child->next) {
 641       if (child->type != XML_ELEMENT_NODE)
 642         continue;
 643
 644       if (strncmp("counter", (char *)child->name, strlen("counter")) != 0)
 645         continue;
 646
 647       char *attr_name;
 648       value_t value;
 649       int status;
 650
 651       attr_name = (char *)xmlGetProp(child, BAD_CAST "name");
 652       if (attr_name == NULL) {
 653         DEBUG("bind plugin: found <counter> without name.");
 654         continue;
 655       }
 656       if (ds_type == DS_TYPE_GAUGE)
 657         status = bind_xml_read_gauge(doc, child, &value.gauge);
 658       else
 659         status = bind_xml_read_derive(doc, child, &value.derive);
 660       if (status != 0) {
 661         xmlFree(attr_name);
 662         continue;
 663       }
 664
 665       status = (*list_callback)(attr_name, value, current_time, user_data);
 666       if (status == 0)
 667         num_entries++;
 668
 669       xmlFree(attr_name);
 670     }
 671   }
 672
 673   DEBUG("bind plugin: Found %d %s for XPath expression `%s'", num_entries,
 674         (num_entries == 1) ? "entry" : "entries", xpath_expression);
 675
 676   xmlXPathFreeObject(xpathObj);
 677
 678   return 0;
 679 } /* }}} int bind_parse_generic_name_attr_value_list */
 680
 681 static int bind_xml_stats_handle_zone(int version, xmlDoc *doc, /* {{{ */
 682                                       xmlXPathContext *path_ctx, xmlNode *node,
 683                                       cb_view_t *view, time_t current_time) {
 684   xmlXPathObject *path_obj;
 685   char *zone_name = NULL;
 686   size_t j;
 687
 688   if (version >= 3) {
 689     char *n = (char *)xmlGetProp(node, BAD_CAST "name");
 690     char *c = (char *)xmlGetProp(node, BAD_CAST "rdataclass");
 691     if (n && c) {
 692       zone_name = (char *)xmlMalloc(strlen(n) + strlen(c) + 2);
 693       snprintf(zone_name, strlen(n) + strlen(c) + 2, "%s/%s", n, c);
 694     }
 695     xmlFree(n);
 696     xmlFree(c);
 697   } else {
 698     path_obj = xmlXPathEvalExpression(BAD_CAST "name", path_ctx);
 699     if (path_obj == NULL) {
 700       ERROR("bind plugin: xmlXPathEvalExpression failed.");
 701       return -1;
 702     }
 703
 704     for (int i = 0; path_obj->nodesetval && (i < path_obj->nodesetval->nodeNr);
 705          i++) {
 706       zone_name = (char *)xmlNodeListGetString(
 707           doc, path_obj->nodesetval->nodeTab[i]->xmlChildrenNode, 1);
 708       if (zone_name != NULL)
 709         break;
 710     }
 711     xmlXPathFreeObject(path_obj);
 712   }
 713
 714   if (zone_name == NULL) {
 715     ERROR("bind plugin: Could not determine zone name.");
 716     return -1;
 717   }
 718
 719   for (j = 0; j < view->zones_num; j++) {
 720     if (strcasecmp(zone_name, view->zones[j]) == 0)
 721       break;
 722   }
 723
 724   xmlFree(zone_name);
 725   zone_name = NULL;
 726
 727   if (j >= view->zones_num)
 728     return 0;
 729
 730   zone_name = view->zones[j];
 731
 732   DEBUG("bind plugin: bind_xml_stats_handle_zone: Found zone `%s'.", zone_name);
 733
 734   { /* Parse the <counters> tag {{{ */
 735     char plugin_instance[DATA_MAX_NAME_LEN];
 736     translation_table_ptr_t table_ptr = {nsstats_translation_table,
 737                                          nsstats_translation_table_length,
 738                                          plugin_instance};
 739
 740     snprintf(plugin_instance, sizeof(plugin_instance), "%s-zone-%s", view->name,
 741              zone_name);
 742
 743     if (version == 3) {
 744       list_info_ptr_t list_info = {plugin_instance,
 745                                    /* type = */ "dns_qtype"};
 746       bind_parse_generic_name_attr_value_list(
 747           /* xpath = */ "counters[@type='rcode']",
 748           /* callback = */ bind_xml_table_callback,
 749           /* user_data = */ &table_ptr, doc, path_ctx, current_time,
 750           DS_TYPE_COUNTER);
 751       bind_parse_generic_name_attr_value_list(
 752           /* xpath = */ "counters[@type='qtype']",
 753           /* callback = */ bind_xml_list_callback,
 754           /* user_data = */ &list_info, doc, path_ctx, current_time,
 755           DS_TYPE_COUNTER);
 756     } else {
 757       bind_parse_generic_value_list(/* xpath = */ "counters",
 758                                     /* callback = */ bind_xml_table_callback,
 759                                     /* user_data = */ &table_ptr, doc, path_ctx,
 760                                     current_time, DS_TYPE_COUNTER);
 761     }
 762   } /* }}} */
 763
 764   return 0;
 765 } /* }}} int bind_xml_stats_handle_zone */
 766
 767 static int bind_xml_stats_search_zones(int version, xmlDoc *doc, /* {{{ */
 768                                        xmlXPathContext *path_ctx, xmlNode *node,
 769                                        cb_view_t *view, time_t current_time) {
 770   xmlXPathObject *zone_nodes = NULL;
 771   xmlXPathContext *zone_path_context;
 772
 773   zone_path_context = xmlXPathNewContext(doc);
 774   if (zone_path_context == NULL) {
 775     ERROR("bind plugin: xmlXPathNewContext failed.");
 776     return -1;
 777   }
 778
 779   zone_nodes = xmlXPathEvalExpression(BAD_CAST "zones/zone", path_ctx);
 780   if (zone_nodes == NULL) {
 781     ERROR("bind plugin: Cannot find any <view> tags.");
 782     xmlXPathFreeContext(zone_path_context);
 783     return -1;
 784   }
 785
 786   for (int i = 0; i < zone_nodes->nodesetval->nodeNr; i++) {
 787     node = zone_nodes->nodesetval->nodeTab[i];
 788     assert(node != NULL);
 789
 790     zone_path_context->node = node;
 791
 792     bind_xml_stats_handle_zone(version, doc, zone_path_context, node, view,
 793                                current_time);
 794   }
 795
 796   xmlXPathFreeObject(zone_nodes);
 797   xmlXPathFreeContext(zone_path_context);
 798   return 0;
 799 } /* }}} int bind_xml_stats_search_zones */
 800
 801 static int bind_xml_stats_handle_view(int version, xmlDoc *doc, /* {{{ */
 802                                       xmlXPathContext *path_ctx, xmlNode *node,
 803                                       time_t current_time) {
 804   char *view_name = NULL;
 805   cb_view_t *view;
 806   size_t j;
 807
 808   if (version == 3) {
 809     view_name = (char *)xmlGetProp(node, BAD_CAST "name");
 810
 811     if (view_name == NULL) {
 812       ERROR("bind plugin: Could not determine view name.");
 813       return -1;
 814     }
 815
 816     for (j = 0; j < views_num; j++) {
 817       if (strcasecmp(view_name, views[j].name) == 0)
 818         break;
 819     }
 820
 821     xmlFree(view_name);
 822     view_name = NULL;
 823   } else {
 824     xmlXPathObject *path_obj;
 825     path_obj = xmlXPathEvalExpression(BAD_CAST "name", path_ctx);
 826     if (path_obj == NULL) {
 827       ERROR("bind plugin: xmlXPathEvalExpression failed.");
 828       return -1;
 829     }
 830
 831     for (int i = 0; path_obj->nodesetval && (i < path_obj->nodesetval->nodeNr);
 832          i++) {
 833       view_name = (char *)xmlNodeListGetString(
 834           doc, path_obj->nodesetval->nodeTab[i]->xmlChildrenNode, 1);
 835       if (view_name != NULL)
 836         break;
 837     }
 838
 839     if (view_name == NULL) {
 840       ERROR("bind plugin: Could not determine view name.");
 841       xmlXPathFreeObject(path_obj);
 842       return -1;
 843     }
 844
 845     for (j = 0; j < views_num; j++) {
 846       if (strcasecmp(view_name, views[j].name) == 0)
 847         break;
 848     }
 849
 850     xmlFree(view_name);
 851     xmlXPathFreeObject(path_obj);
 852
 853     view_name = NULL;
 854     path_obj = NULL;
 855   }
 856
 857   if (j >= views_num)
 858     return 0;
 859
 860   view = views + j;
 861
 862   DEBUG("bind plugin: bind_xml_stats_handle_view: Found view `%s'.",
 863         view->name);
 864
 865   if (view->qtypes != 0) /* {{{ */
 866   {
 867     char plugin_instance[DATA_MAX_NAME_LEN];
 868     list_info_ptr_t list_info = {plugin_instance,
 869                                  /* type = */ "dns_qtype"};
 870
 871     snprintf(plugin_instance, sizeof(plugin_instance), "%s-qtypes", view->name);
 872     if (version == 3) {
 873       bind_parse_generic_name_attr_value_list(
 874           /* xpath = */ "counters[@type='resqtype']",
 875           /* callback = */ bind_xml_list_callback,
 876           /* user_data = */ &list_info, doc, path_ctx, current_time,
 877           DS_TYPE_COUNTER);
 878     } else {
 879       bind_parse_generic_name_value(/* xpath = */ "rdtype",
 880                                     /* callback = */ bind_xml_list_callback,
 881                                     /* user_data = */ &list_info, doc, path_ctx,
 882                                     current_time, DS_TYPE_COUNTER);
 883     }
 884   } /* }}} */
 885
 886   if (view->resolver_stats != 0) /* {{{ */
 887   {
 888     char plugin_instance[DATA_MAX_NAME_LEN];
 889     translation_table_ptr_t table_ptr = {resstats_translation_table,
 890                                          resstats_translation_table_length,
 891                                          plugin_instance};
 892
 893     snprintf(plugin_instance, sizeof(plugin_instance), "%s-resolver_stats",
 894              view->name);
 895     if (version == 3) {
 896       bind_parse_generic_name_attr_value_list(
 897           "counters[@type='resstats']",
 898           /* callback = */ bind_xml_table_callback,
 899           /* user_data = */ &table_ptr, doc, path_ctx, current_time,
 900           DS_TYPE_COUNTER);
 901     } else {
 902       bind_parse_generic_name_value("resstat",
 903                                     /* callback = */ bind_xml_table_callback,
 904                                     /* user_data = */ &table_ptr, doc, path_ctx,
 905                                     current_time, DS_TYPE_COUNTER);
 906     }
 907   } /* }}} */
 908
 909   /* Record types in the cache */
 910   if (view->cacherrsets != 0) /* {{{ */
 911   {
 912     char plugin_instance[DATA_MAX_NAME_LEN];
 913     list_info_ptr_t list_info = {plugin_instance,
 914                                  /* type = */ "dns_qtype_cached"};
 915
 916     snprintf(plugin_instance, sizeof(plugin_instance), "%s-cache_rr_sets",
 917              view->name);
 918
 919     bind_parse_generic_name_value(/* xpath = */ "cache/rrset",
 920                                   /* callback = */ bind_xml_list_callback,
 921                                   /* user_data = */ &list_info, doc, path_ctx,
 922                                   current_time, DS_TYPE_GAUGE);
 923   } /* }}} */
 924
 925   if (view->zones_num > 0)
 926     bind_xml_stats_search_zones(version, doc, path_ctx, node, view,
 927                                 current_time);
 928
 929   return 0;
 930 } /* }}} int bind_xml_stats_handle_view */
 931
 932 static int bind_xml_stats_search_views(int version, xmlDoc *doc, /* {{{ */
 933                                        xmlXPathContext *xpathCtx,
 934                                        xmlNode *statsnode,
 935                                        time_t current_time) {
 936   xmlXPathObject *view_nodes = NULL;
 937   xmlXPathContext *view_path_context;
 938
 939   view_path_context = xmlXPathNewContext(doc);
 940   if (view_path_context == NULL) {
 941     ERROR("bind plugin: xmlXPathNewContext failed.");
 942     return -1;
 943   }
 944
 945   view_nodes = xmlXPathEvalExpression(BAD_CAST "views/view", xpathCtx);
 946   if (view_nodes == NULL) {
 947     ERROR("bind plugin: Cannot find any <view> tags.");
 948     xmlXPathFreeContext(view_path_context);
 949     return -1;
 950   }
 951
 952   for (int i = 0; i < view_nodes->nodesetval->nodeNr; i++) {
 953     xmlNode *node;
 954
 955     node = view_nodes->nodesetval->nodeTab[i];
 956     assert(node != NULL);
 957
 958     view_path_context->node = node;
 959
 960     bind_xml_stats_handle_view(version, doc, view_path_context, node,
 961                                current_time);
 962   }
 963
 964   xmlXPathFreeObject(view_nodes);
 965   xmlXPathFreeContext(view_path_context);
 966   return 0;
 967 } /* }}} int bind_xml_stats_search_views */
 968
 969 static void bind_xml_stats_v3(xmlDoc *doc, /* {{{ */
 970                               xmlXPathContext *xpathCtx, xmlNode *statsnode,
 971                               time_t current_time) {
 972   /* XPath:     server/counters[@type='opcode']
 973    * Variables: QUERY, IQUERY, NOTIFY, UPDATE, ...
 974    * Layout v3:
 975    *   <counters type="opcode">
 976    *     <counter name="A">1</counter>
 977    *     :
 978    *   </counters>
 979    */
 980   if (global_opcodes != 0) {
 981     list_info_ptr_t list_info = {/* plugin instance = */ "global-opcodes",
 982                                  /* type = */ "dns_opcode"};
 983     bind_parse_generic_name_attr_value_list(
 984         /* xpath = */ "server/counters[@type='opcode']",
 985         /* callback = */ bind_xml_list_callback,
 986         /* user_data = */ &list_info, doc, xpathCtx, current_time,
 987         DS_TYPE_COUNTER);
 988   }
 989
 990   /* XPath:     server/counters[@type='qtype']
 991    * Variables: RESERVED0, A, NS, CNAME, SOA, MR, PTR, HINFO, MX, TXT, RP,
 992    *            X25, PX, AAAA, LOC, SRV, NAPTR, A6, DS, RRSIG, NSEC, DNSKEY,
 993    *            SPF, TKEY, IXFR, AXFR, ANY, ..., Others
 994    * Layout v3:
 995    *   <counters type="opcode">
 996    *     <counter name="A">1</counter>
 997    *     :
 998    *   </counters>
 999    */
1000   if (global_qtypes != 0) {
1001     list_info_ptr_t list_info = {/* plugin instance = */ "global-qtypes",
1002                                  /* type = */ "dns_qtype"};
1003
1004     bind_parse_generic_name_attr_value_list(
1005         /* xpath = */ "server/counters[@type='qtype']",
1006         /* callback = */ bind_xml_list_callback,
1007         /* user_data = */ &list_info, doc, xpathCtx, current_time,
1008         DS_TYPE_COUNTER);
1009   }
1010
1011   /* XPath:     server/counters[@type='nsstat']
1012    * Variables: Requestv4, Requestv6, ReqEdns0, ReqBadEDNSVer, ReqTSIG,
1013    *            ReqSIG0, ReqBadSIG, ReqTCP, AuthQryRej, RecQryRej, XfrRej,
1014    *            UpdateRej, Response, TruncatedResp, RespEDNS0, RespTSIG,
1015    *            RespSIG0, QrySuccess, QryAuthAns, QryNoauthAns, QryReferral,
1016    *            QryNxrrset, QrySERVFAIL, QryFORMERR, QryNXDOMAIN, QryRecursion,
1017    *            QryDuplicate, QryDropped, QryFailure, XfrReqDone, UpdateReqFwd,
1018    *            UpdateRespFwd, UpdateFwdFail, UpdateDone, UpdateFail,
1019    *            UpdateBadPrereq
1020    * Layout v3:
1021    *   <counters type="nsstat"
1022    *     <counter name="Requestv4">1</counter>
1023    *     <counter name="Requestv6">0</counter>
1024    *     :
1025    *   </counter>
1026    */
1027   if (global_server_stats) {
1028     translation_table_ptr_t table_ptr = {
1029         nsstats_translation_table, nsstats_translation_table_length,
1030         /* plugin_instance = */ "global-server_stats"};
1031
1032     bind_parse_generic_name_attr_value_list(
1033         "server/counters[@type='nsstat']",
1034         /* callback = */ bind_xml_table_callback,
1035         /* user_data = */ &table_ptr, doc, xpathCtx, current_time,
1036         DS_TYPE_COUNTER);
1037   }
1038
1039   /* XPath:     server/zonestats, server/zonestat,
1040    * server/counters[@type='zonestat']
1041    * Variables: NotifyOutv4, NotifyOutv6, NotifyInv4, NotifyInv6, NotifyRej,
1042    *            SOAOutv4, SOAOutv6, AXFRReqv4, AXFRReqv6, IXFRReqv4, IXFRReqv6,
1043    *            XfrSuccess, XfrFail
1044    * Layout v3:
1045    *   <counters type="zonestat"
1046    *     <counter name="NotifyOutv4">0</counter>
1047    *     <counter name="NotifyOutv6">0</counter>
1048    *     :
1049    *   </counter>
1050    */
1051   if (global_zone_maint_stats) {
1052     translation_table_ptr_t table_ptr = {
1053         zonestats_translation_table, zonestats_translation_table_length,
1054         /* plugin_instance = */ "global-zone_maint_stats"};
1055
1056     bind_parse_generic_name_attr_value_list(
1057         "server/counters[@type='zonestat']",
1058         /* callback = */ bind_xml_table_callback,
1059         /* user_data = */ &table_ptr, doc, xpathCtx, current_time,
1060         DS_TYPE_COUNTER);
1061   }
1062
1063   /* XPath:     server/resstats, server/counters[@type='resstat']
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 v3:
1069    *   <counters type="resstat"
1070    *     <counter name="Queryv4">0</counter>
1071    *     <counter name="Queryv6">0</counter>
1072    *     :
1073    *   </counter>
1074    */
1075   if (global_resolver_stats != 0) {
1076     translation_table_ptr_t table_ptr = {
1077         resstats_translation_table, resstats_translation_table_length,
1078         /* plugin_instance = */ "global-resolver_stats"};
1079
1080     bind_parse_generic_name_attr_value_list(
1081         "server/counters[@type='resstat']",
1082         /* callback = */ bind_xml_table_callback,
1083         /* user_data = */ &table_ptr, doc, xpathCtx, current_time,
1084         DS_TYPE_COUNTER);
1085   }
1086 } /* }}} bind_xml_stats_v3 */
1087
1088 static void bind_xml_stats_v1_v2(int version, xmlDoc *doc, /* {{{ */
1089                                  xmlXPathContext *xpathCtx, xmlNode *statsnode,
1090                                  time_t current_time) {
1091   /* XPath:     server/requests/opcode, server/counters[@type='opcode']
1092    * Variables: QUERY, IQUERY, NOTIFY, UPDATE, ...
1093    * Layout V1 and V2:
1094    *   <opcode>
1095    *     <name>A</name>
1096    *     <counter>1</counter>
1097    *   </opcode>
1098    *   :
1099    */
1100   if (global_opcodes != 0) {
1101     list_info_ptr_t list_info = {/* plugin instance = */ "global-opcodes",
1102                                  /* type = */ "dns_opcode"};
1103
1104     bind_parse_generic_name_value(/* xpath = */ "server/requests/opcode",
1105                                   /* callback = */ bind_xml_list_callback,
1106                                   /* user_data = */ &list_info, doc, xpathCtx,
1107                                   current_time, DS_TYPE_COUNTER);
1108   }
1109
1110   /* XPath:     server/queries-in/rdtype, server/counters[@type='qtype']
1111    * Variables: RESERVED0, A, NS, CNAME, SOA, MR, PTR, HINFO, MX, TXT, RP,
1112    *            X25, PX, AAAA, LOC, SRV, NAPTR, A6, DS, RRSIG, NSEC, DNSKEY,
1113    *            SPF, TKEY, IXFR, AXFR, ANY, ..., Others
1114    * Layout v1 or v2:
1115    *   <rdtype>
1116    *     <name>A</name>
1117    *     <counter>1</counter>
1118    *   </rdtype>
1119    *   :
1120    */
1121   if (global_qtypes != 0) {
1122     list_info_ptr_t list_info = {/* plugin instance = */ "global-qtypes",
1123                                  /* type = */ "dns_qtype"};
1124
1125     bind_parse_generic_name_value(/* xpath = */ "server/queries-in/rdtype",
1126                                   /* callback = */ bind_xml_list_callback,
1127                                   /* user_data = */ &list_info, doc, xpathCtx,
1128                                   current_time, DS_TYPE_COUNTER);
1129   }
1130
1131   /* XPath:     server/nsstats, server/nsstat, server/counters[@type='nsstat']
1132    * Variables: Requestv4, Requestv6, ReqEdns0, ReqBadEDNSVer, ReqTSIG,
1133    *            ReqSIG0, ReqBadSIG, ReqTCP, AuthQryRej, RecQryRej, XfrRej,
1134    *            UpdateRej, Response, TruncatedResp, RespEDNS0, RespTSIG,
1135    *            RespSIG0, QrySuccess, QryAuthAns, QryNoauthAns, QryReferral,
1136    *            QryNxrrset, QrySERVFAIL, QryFORMERR, QryNXDOMAIN, QryRecursion,
1137    *            QryDuplicate, QryDropped, QryFailure, XfrReqDone, UpdateReqFwd,
1138    *            UpdateRespFwd, UpdateFwdFail, UpdateDone, UpdateFail,
1139    *            UpdateBadPrereq
1140    * Layout v1:
1141    *   <nsstats>
1142    *     <Requestv4>1</Requestv4>
1143    *     <Requestv6>0</Requestv6>
1144    *     :
1145    *   </nsstats>
1146    * Layout v2:
1147    *   <nsstat>
1148    *     <name>Requestv4</name>
1149    *     <counter>1</counter>
1150    *   </nsstat>
1151    *   <nsstat>
1152    *     <name>Requestv6</name>
1153    *     <counter>0</counter>
1154    *   </nsstat>
1155    *   :
1156    */
1157   if (global_server_stats) {
1158     translation_table_ptr_t table_ptr = {
1159         nsstats_translation_table, nsstats_translation_table_length,
1160         /* plugin_instance = */ "global-server_stats"};
1161
1162     if (version == 1) {
1163       bind_parse_generic_value_list("server/nsstats",
1164                                     /* callback = */ bind_xml_table_callback,
1165                                     /* user_data = */ &table_ptr, doc, xpathCtx,
1166                                     current_time, DS_TYPE_COUNTER);
1167     } else {
1168       bind_parse_generic_name_value("server/nsstat",
1169                                     /* callback = */ bind_xml_table_callback,
1170                                     /* user_data = */ &table_ptr, doc, xpathCtx,
1171                                     current_time, DS_TYPE_COUNTER);
1172     }
1173   }
1174
1175   /* XPath:     server/zonestats, server/zonestat,
1176    * server/counters[@type='zonestat']
1177    * Variables: NotifyOutv4, NotifyOutv6, NotifyInv4, NotifyInv6, NotifyRej,
1178    *            SOAOutv4, SOAOutv6, AXFRReqv4, AXFRReqv6, IXFRReqv4, IXFRReqv6,
1179    *            XfrSuccess, XfrFail
1180    * Layout v1:
1181    *   <zonestats>
1182    *     <NotifyOutv4>0</NotifyOutv4>
1183    *     <NotifyOutv6>0</NotifyOutv6>
1184    *     :
1185    *   </zonestats>
1186    * Layout v2:
1187    *   <zonestat>
1188    *     <name>NotifyOutv4</name>
1189    *     <counter>0</counter>
1190    *   </zonestat>
1191    *   <zonestat>
1192    *     <name>NotifyOutv6</name>
1193    *     <counter>0</counter>
1194    *   </zonestat>
1195    *   :
1196    */
1197   if (global_zone_maint_stats) {
1198     translation_table_ptr_t table_ptr = {
1199         zonestats_translation_table, zonestats_translation_table_length,
1200         /* plugin_instance = */ "global-zone_maint_stats"};
1201
1202     if (version == 1) {
1203       bind_parse_generic_value_list("server/zonestats",
1204                                     /* callback = */ bind_xml_table_callback,
1205                                     /* user_data = */ &table_ptr, doc, xpathCtx,
1206                                     current_time, DS_TYPE_COUNTER);
1207     } else {
1208       bind_parse_generic_name_value("server/zonestat",
1209                                     /* callback = */ bind_xml_table_callback,
1210                                     /* user_data = */ &table_ptr, doc, xpathCtx,
1211                                     current_time, DS_TYPE_COUNTER);
1212     }
1213   }
1214
1215   /* XPath:     server/resstats, server/counters[@type='resstat']
1216    * Variables: Queryv4, Queryv6, Responsev4, Responsev6, NXDOMAIN, SERVFAIL,
1217    *            FORMERR, OtherError, EDNS0Fail, Mismatch, Truncated, Lame,
1218    *            Retry, GlueFetchv4, GlueFetchv6, GlueFetchv4Fail,
1219    *            GlueFetchv6Fail, ValAttempt, ValOk, ValNegOk, ValFail
1220    * Layout v1:
1221    *   <resstats>
1222    *     <Queryv4>0</Queryv4>
1223    *     <Queryv6>0</Queryv6>
1224    *     :
1225    *   </resstats>
1226    * Layout v2:
1227    *   <resstat>
1228    *     <name>Queryv4</name>
1229    *     <counter>0</counter>
1230    *   </resstat>
1231    *   <resstat>
1232    *     <name>Queryv6</name>
1233    *     <counter>0</counter>
1234    *   </resstat>
1235    *   :
1236    */
1237   if (global_resolver_stats != 0) {
1238     translation_table_ptr_t table_ptr = {
1239         resstats_translation_table, resstats_translation_table_length,
1240         /* plugin_instance = */ "global-resolver_stats"};
1241
1242     if (version == 1) {
1243       bind_parse_generic_value_list("server/resstats",
1244                                     /* callback = */ bind_xml_table_callback,
1245                                     /* user_data = */ &table_ptr, doc, xpathCtx,
1246                                     current_time, DS_TYPE_COUNTER);
1247     } else {
1248       bind_parse_generic_name_value("server/resstat",
1249                                     /* callback = */ bind_xml_table_callback,
1250                                     /* user_data = */ &table_ptr, doc, xpathCtx,
1251                                     current_time, DS_TYPE_COUNTER);
1252     }
1253   }
1254 } /* }}} bind_xml_stats_v1_v2 */
1255
1256 static int bind_xml_stats(int version, xmlDoc *doc, /* {{{ */
1257                           xmlXPathContext *xpathCtx, xmlNode *statsnode) {
1258   time_t current_time = 0;
1259   int status;
1260
1261   xpathCtx->node = statsnode;
1262
1263   /* TODO: Check `server/boot-time' to recognize server restarts. */
1264
1265   status = bind_xml_read_timestamp("server/current-time", doc, xpathCtx,
1266                                    &current_time);
1267   if (status != 0) {
1268     ERROR("bind plugin: Reading `server/current-time' failed.");
1269     return -1;
1270   }
1271   DEBUG("bind plugin: Current server time is %i.", (int)current_time);
1272
1273   if (version == 3) {
1274     bind_xml_stats_v3(doc, xpathCtx, statsnode, current_time);
1275   } else {
1276     bind_xml_stats_v1_v2(version, doc, xpathCtx, statsnode, current_time);
1277   }
1278
1279   /* XPath:  memory/summary
1280    * Variables: TotalUse, InUse, BlockSize, ContextSize, Lost
1281    * Layout: v2 and v3:
1282    *   <summary>
1283    *     <TotalUse>6587096</TotalUse>
1284    *     <InUse>1345424</InUse>
1285    *     <BlockSize>5505024</BlockSize>
1286    *     <ContextSize>3732456</ContextSize>
1287    *     <Lost>0</Lost>
1288    *   </summary>
1289    */
1290   if (global_memory_stats != 0) {
1291     translation_table_ptr_t table_ptr = {
1292         memsummary_translation_table, memsummary_translation_table_length,
1293         /* plugin_instance = */ "global-memory_stats"};
1294
1295     bind_parse_generic_value_list("memory/summary",
1296                                   /* callback = */ bind_xml_table_callback,
1297                                   /* user_data = */ &table_ptr, doc, xpathCtx,
1298                                   current_time, DS_TYPE_GAUGE);
1299   }
1300
1301   if (views_num > 0)
1302     bind_xml_stats_search_views(version, doc, xpathCtx, statsnode,
1303                                 current_time);
1304
1305   return 0;
1306 } /* }}} int bind_xml_stats */
1307
1308 static int bind_xml(const char *data) /* {{{ */
1309 {
1310   xmlDoc *doc = NULL;
1311   xmlXPathContext *xpathCtx = NULL;
1312   xmlXPathObject *xpathObj = NULL;
1313   int ret = -1;
1314
1315   doc = xmlParseMemory(data, strlen(data));
1316   if (doc == NULL) {
1317     ERROR("bind plugin: xmlParseMemory failed.");
1318     return -1;
1319   }
1320
1321   xpathCtx = xmlXPathNewContext(doc);
1322   if (xpathCtx == NULL) {
1323     ERROR("bind plugin: xmlXPathNewContext failed.");
1324     xmlFreeDoc(doc);
1325     return -1;
1326   }
1327
1328   //
1329   // version 3.* of statistics XML (since BIND9.9)
1330   //
1331
1332   xpathObj = xmlXPathEvalExpression(BAD_CAST "/statistics", xpathCtx);
1333   if (xpathObj == NULL || xpathObj->nodesetval == NULL ||
1334       xpathObj->nodesetval->nodeNr == 0) {
1335     DEBUG("bind plugin: Statistics appears not to be v3");
1336     // we will fallback to v1 or v2 detection
1337     if (xpathObj != NULL) {
1338       xmlXPathFreeObject(xpathObj);
1339     }
1340   } else {
1341     for (int i = 0; i < xpathObj->nodesetval->nodeNr; i++) {
1342       xmlNode *node;
1343       char *attr_version;
1344
1345       node = xpathObj->nodesetval->nodeTab[i];
1346       assert(node != NULL);
1347
1348       attr_version = (char *)xmlGetProp(node, BAD_CAST "version");
1349       if (attr_version == NULL) {
1350         NOTICE("bind plugin: Found <statistics> tag doesn't have a "
1351                "`version' attribute.");
1352         continue;
1353       }
1354       DEBUG("bind plugin: Found: <statistics version=\"%s\">", attr_version);
1355
1356       if (strncmp("3.", attr_version, strlen("3.")) != 0) {
1357         /* TODO: Use the complaint mechanism here. */
1358         NOTICE("bind plugin: Found <statistics> tag with version `%s'. "
1359                "Unfortunately I have no clue how to parse that. "
1360                "Please open a bug report for this.",
1361                attr_version);
1362         xmlFree(attr_version);
1363         continue;
1364       }
1365       ret = bind_xml_stats(3, doc, xpathCtx, node);
1366
1367       xmlFree(attr_version);
1368       /* One <statistics> node ought to be enough. */
1369       break;
1370     }
1371
1372     // we are finished, early-return
1373     xmlXPathFreeObject(xpathObj);
1374     xmlXPathFreeContext(xpathCtx);
1375     xmlFreeDoc(doc);
1376
1377     return ret;
1378   }
1379
1380   //
1381   // versions 1.* or 2.* of statistics XML
1382   //
1383
1384   xpathObj = xmlXPathEvalExpression(BAD_CAST "/isc/bind/statistics", xpathCtx);
1385   if (xpathObj == NULL) {
1386     ERROR("bind plugin: Cannot find the <statistics> tag.");
1387     xmlXPathFreeContext(xpathCtx);
1388     xmlFreeDoc(doc);
1389     return -1;
1390   } else if (xpathObj->nodesetval == NULL) {
1391     ERROR("bind plugin: xmlXPathEvalExpression failed.");
1392     xmlXPathFreeObject(xpathObj);
1393     xmlXPathFreeContext(xpathCtx);
1394     xmlFreeDoc(doc);
1395     return -1;
1396   }
1397
1398   for (int i = 0; i < xpathObj->nodesetval->nodeNr; i++) {
1399     xmlNode *node;
1400     char *attr_version;
1401     int parsed_version = 0;
1402
1403     node = xpathObj->nodesetval->nodeTab[i];
1404     assert(node != NULL);
1405
1406     attr_version = (char *)xmlGetProp(node, BAD_CAST "version");
1407     if (attr_version == NULL) {
1408       NOTICE("bind plugin: Found <statistics> tag doesn't have a "
1409              "`version' attribute.");
1410       continue;
1411     }
1412     DEBUG("bind plugin: Found: <statistics version=\"%s\">", attr_version);
1413
1414     /* At the time this plugin was written, version "1.0" was used by
1415      * BIND 9.5.0, version "2.0" was used by BIND 9.5.1 and 9.6.0. We assume
1416      * that "1.*" and "2.*" don't introduce structural changes, so we just
1417      * check for the first two characters here. */
1418     if (strncmp("1.", attr_version, strlen("1.")) == 0)
1419       parsed_version = 1;
1420     else if (strncmp("2.", attr_version, strlen("2.")) == 0)
1421       parsed_version = 2;
1422     else {
1423       /* TODO: Use the complaint mechanism here. */
1424       NOTICE("bind plugin: Found <statistics> tag with version `%s'. "
1425              "Unfortunately I have no clue how to parse that. "
1426              "Please open a bug report for this.",
1427              attr_version);
1428       xmlFree(attr_version);
1429       continue;
1430     }
1431
1432     ret = bind_xml_stats(parsed_version, doc, xpathCtx, node);
1433
1434     xmlFree(attr_version);
1435     /* One <statistics> node ought to be enough. */
1436     break;
1437   }
1438
1439   xmlXPathFreeObject(xpathObj);
1440   xmlXPathFreeContext(xpathCtx);
1441   xmlFreeDoc(doc);
1442
1443   return ret;
1444 } /* }}} int bind_xml */
1445
1446 static int bind_config_set_bool(const char *name, int *var, /* {{{ */
1447                                 oconfig_item_t *ci) {
1448   if ((ci->values_num != 1) || (ci->values[0].type != OCONFIG_TYPE_BOOLEAN)) {
1449     WARNING("bind plugin: The `%s' option needs "
1450             "exactly one boolean argument.",
1451             name);
1452     return -1;
1453   }
1454
1455   if (ci->values[0].value.boolean)
1456     *var = 1;
1457   else
1458     *var = 0;
1459   return 0;
1460 } /* }}} int bind_config_set_bool */
1461
1462 static int bind_config_add_view_zone(cb_view_t *view, /* {{{ */
1463                                      oconfig_item_t *ci) {
1464   char **tmp;
1465
1466   if ((ci->values_num != 1) || (ci->values[0].type != OCONFIG_TYPE_STRING)) {
1467     WARNING("bind plugin: The `Zone' option needs "
1468             "exactly one string argument.");
1469     return -1;
1470   }
1471
1472   tmp = realloc(view->zones, sizeof(char *) * (view->zones_num + 1));
1473   if (tmp == NULL) {
1474     ERROR("bind plugin: realloc failed.");
1475     return -1;
1476   }
1477   view->zones = tmp;
1478
1479   view->zones[view->zones_num] = strdup(ci->values[0].value.string);
1480   if (view->zones[view->zones_num] == NULL) {
1481     ERROR("bind plugin: strdup failed.");
1482     return -1;
1483   }
1484   view->zones_num++;
1485
1486   return 0;
1487 } /* }}} int bind_config_add_view_zone */
1488
1489 static int bind_config_add_view(oconfig_item_t *ci) /* {{{ */
1490 {
1491   cb_view_t *tmp;
1492
1493   if ((ci->values_num != 1) || (ci->values[0].type != OCONFIG_TYPE_STRING)) {
1494     WARNING("bind plugin: `View' blocks need exactly one string argument.");
1495     return -1;
1496   }
1497
1498   tmp = realloc(views, sizeof(*views) * (views_num + 1));
1499   if (tmp == NULL) {
1500     ERROR("bind plugin: realloc failed.");
1501     return -1;
1502   }
1503   views = tmp;
1504   tmp = views + views_num;
1505
1506   memset(tmp, 0, sizeof(*tmp));
1507   tmp->qtypes = 1;
1508   tmp->resolver_stats = 1;
1509   tmp->cacherrsets = 1;
1510   tmp->zones = NULL;
1511   tmp->zones_num = 0;
1512
1513   tmp->name = strdup(ci->values[0].value.string);
1514   if (tmp->name == NULL) {
1515     ERROR("bind plugin: strdup failed.");
1516     sfree(views);
1517     return -1;
1518   }
1519
1520   for (int i = 0; i < ci->children_num; i++) {
1521     oconfig_item_t *child = ci->children + i;
1522
1523     if (strcasecmp("QTypes", child->key) == 0)
1524       bind_config_set_bool("QTypes", &tmp->qtypes, child);
1525     else if (strcasecmp("ResolverStats", child->key) == 0)
1526       bind_config_set_bool("ResolverStats", &tmp->resolver_stats, child);
1527     else if (strcasecmp("CacheRRSets", child->key) == 0)
1528       bind_config_set_bool("CacheRRSets", &tmp->cacherrsets, child);
1529     else if (strcasecmp("Zone", child->key) == 0)
1530       bind_config_add_view_zone(tmp, child);
1531     else {
1532       WARNING("bind plugin: Unknown configuration option "
1533               "`%s' in view `%s' will be ignored.",
1534               child->key, tmp->name);
1535     }
1536   } /* for (i = 0; i < ci->children_num; i++) */
1537
1538   views_num++;
1539   return 0;
1540 } /* }}} int bind_config_add_view */
1541
1542 static int bind_config(oconfig_item_t *ci) /* {{{ */
1543 {
1544   for (int i = 0; i < ci->children_num; i++) {
1545     oconfig_item_t *child = ci->children + i;
1546
1547     if (strcasecmp("Url", child->key) == 0) {
1548       if ((child->values_num != 1) ||
1549           (child->values[0].type != OCONFIG_TYPE_STRING)) {
1550         WARNING("bind plugin: The `Url' option needs "
1551                 "exactly one string argument.");
1552         return -1;
1553       }
1554
1555       sfree(url);
1556       url = strdup(child->values[0].value.string);
1557     } else if (strcasecmp("OpCodes", child->key) == 0)
1558       bind_config_set_bool("OpCodes", &global_opcodes, child);
1559     else if (strcasecmp("QTypes", child->key) == 0)
1560       bind_config_set_bool("QTypes", &global_qtypes, child);
1561     else if (strcasecmp("ServerStats", child->key) == 0)
1562       bind_config_set_bool("ServerStats", &global_server_stats, child);
1563     else if (strcasecmp("ZoneMaintStats", child->key) == 0)
1564       bind_config_set_bool("ZoneMaintStats", &global_zone_maint_stats, child);
1565     else if (strcasecmp("ResolverStats", child->key) == 0)
1566       bind_config_set_bool("ResolverStats", &global_resolver_stats, child);
1567     else if (strcasecmp("MemoryStats", child->key) == 0)
1568       bind_config_set_bool("MemoryStats", &global_memory_stats, child);
1569     else if (strcasecmp("View", child->key) == 0)
1570       bind_config_add_view(child);
1571     else if (strcasecmp("ParseTime", child->key) == 0)
1572       cf_util_get_boolean(child, &config_parse_time);
1573     else if (strcasecmp("Timeout", child->key) == 0)
1574       cf_util_get_int(child, &timeout);
1575     else {
1576       WARNING("bind plugin: Unknown configuration option "
1577               "`%s' will be ignored.",
1578               child->key);
1579     }
1580   }
1581
1582   return 0;
1583 } /* }}} int bind_config */
1584
1585 static int bind_init(void) /* {{{ */
1586 {
1587   if (curl != NULL)
1588     return 0;
1589
1590   curl = curl_easy_init();
1591   if (curl == NULL) {
1592     ERROR("bind plugin: bind_init: curl_easy_init failed.");
1593     return -1;
1594   }
1595
1596   curl_easy_setopt(curl, CURLOPT_NOSIGNAL, 1L);
1597   curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, bind_curl_callback);
1598   curl_easy_setopt(curl, CURLOPT_USERAGENT, COLLECTD_USERAGENT);
1599   curl_easy_setopt(curl, CURLOPT_ERRORBUFFER, bind_curl_error);
1600   curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
1601   curl_easy_setopt(curl, CURLOPT_MAXREDIRS, 50L);
1602 #ifdef HAVE_CURLOPT_TIMEOUT_MS
1603   curl_easy_setopt(curl, CURLOPT_TIMEOUT_MS,
1604                    (timeout >= 0) ? (long)timeout : (long)CDTIME_T_TO_MS(
1605                                                         plugin_get_interval()));
1606 #endif
1607
1608   return 0;
1609 } /* }}} int bind_init */
1610
1611 static int bind_read(void) /* {{{ */
1612 {
1613   int status;
1614
1615   if (curl == NULL) {
1616     ERROR("bind plugin: I don't have a CURL object.");
1617     return -1;
1618   }
1619
1620   bind_buffer_fill = 0;
1621
1622   curl_easy_setopt(curl, CURLOPT_URL, (url != NULL) ? url : BIND_DEFAULT_URL);
1623
1624   if (curl_easy_perform(curl) != CURLE_OK) {
1625     ERROR("bind plugin: curl_easy_perform failed: %s", bind_curl_error);
1626     return -1;
1627   }
1628
1629   status = bind_xml(bind_buffer);
1630   if (status != 0)
1631     return -1;
1632   else
1633     return 0;
1634 } /* }}} int bind_read */
1635
1636 static int bind_shutdown(void) /* {{{ */
1637 {
1638   if (curl != NULL) {
1639     curl_easy_cleanup(curl);
1640     curl = NULL;
1641   }
1642
1643   return 0;
1644 } /* }}} int bind_shutdown */
1645
1646 void module_register(void) {
1647   plugin_register_complex_config("bind", bind_config);
1648   plugin_register_init("bind", bind_init);
1649   plugin_register_read("bind", bind_read);
1650   plugin_register_shutdown("bind", bind_shutdown);
1651 } /* void module_register */