Merge branch 'collectd-5.7'
[collectd.git] / src / curl_xml.c
1 /**
2  * collectd - src/curl_xml.c
3  * Copyright (C) 2009,2010       Amit Gupta
4  *
5  * This program is free software; you can redistribute it and/or modify it
6  * under the terms of the GNU General Public License as published by the
7  * Free Software Foundation; only version 2 of the License is applicable.
8  *
9  * This program is distributed in the hope that it will be useful, but
10  * WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12  * General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License along
15  * with this program; if not, write to the Free Software Foundation, Inc.,
16  * 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
17  *
18  * Authors:
19  *   Amit Gupta <amit.gupta221 at gmail.com>
20  **/
21
22 #include "collectd.h"
23
24 #include "common.h"
25 #include "plugin.h"
26 #include "utils_curl_stats.h"
27 #include "utils_llist.h"
28
29 #include <libxml/parser.h>
30 #include <libxml/tree.h>
31 #include <libxml/xpath.h>
32 #include <libxml/xpathInternals.h>
33
34 #include <curl/curl.h>
35
36 #define CX_DEFAULT_HOST "localhost"
37
38 /*
39  * Private data structures
40  */
41 struct cx_values_s /* {{{ */
42 {
43   char path[DATA_MAX_NAME_LEN];
44   size_t path_len;
45 };
46 typedef struct cx_values_s cx_values_t;
47 /* }}} */
48
49 struct cx_xpath_s /* {{{ */
50 {
51   char *path;
52   char *type;
53   cx_values_t *values;
54   size_t values_len;
55   char *instance_prefix;
56   char *instance;
57   int is_table;
58   unsigned long magic;
59 };
60 typedef struct cx_xpath_s cx_xpath_t;
61 /* }}} */
62
63 struct cx_namespace_s /* {{{ */
64 {
65   char *prefix;
66   char *url;
67 };
68 typedef struct cx_namespace_s cx_namespace_t;
69 /* }}} */
70
71 struct cx_s /* {{{ */
72 {
73   char *instance;
74   char *host;
75
76   char *url;
77   char *user;
78   char *pass;
79   char *credentials;
80   _Bool digest;
81   _Bool verify_peer;
82   _Bool verify_host;
83   char *cacert;
84   char *post_body;
85   int timeout;
86   struct curl_slist *headers;
87   curl_stats_t *stats;
88
89   cx_namespace_t *namespaces;
90   size_t namespaces_num;
91
92   CURL *curl;
93   char curl_errbuf[CURL_ERROR_SIZE];
94   char *buffer;
95   size_t buffer_size;
96   size_t buffer_fill;
97
98   llist_t *list; /* list of xpath blocks */
99 };
100 typedef struct cx_s cx_t; /* }}} */
101
102 /*
103  * Private functions
104  */
105 static size_t cx_curl_callback(void *buf, /* {{{ */
106                                size_t size, size_t nmemb, void *user_data) {
107   size_t len = size * nmemb;
108   cx_t *db;
109
110   db = user_data;
111   if (db == NULL) {
112     ERROR("curl_xml plugin: cx_curl_callback: "
113           "user_data pointer is NULL.");
114     return 0;
115   }
116
117   if (len == 0)
118     return len;
119
120   if ((db->buffer_fill + len) >= db->buffer_size) {
121     char *temp;
122
123     temp = realloc(db->buffer, db->buffer_fill + len + 1);
124     if (temp == NULL) {
125       ERROR("curl_xml plugin: realloc failed.");
126       return 0;
127     }
128     db->buffer = temp;
129     db->buffer_size = db->buffer_fill + len + 1;
130   }
131
132   memcpy(db->buffer + db->buffer_fill, (char *)buf, len);
133   db->buffer_fill += len;
134   db->buffer[db->buffer_fill] = 0;
135
136   return len;
137 } /* }}} size_t cx_curl_callback */
138
139 static void cx_xpath_free(cx_xpath_t *xpath) /* {{{ */
140 {
141   if (xpath == NULL)
142     return;
143
144   sfree(xpath->path);
145   sfree(xpath->type);
146   sfree(xpath->instance_prefix);
147   sfree(xpath->instance);
148   sfree(xpath->values);
149   sfree(xpath);
150 } /* }}} void cx_xpath_free */
151
152 static void cx_list_free(llist_t *list) /* {{{ */
153 {
154   llentry_t *le;
155
156   le = llist_head(list);
157   while (le != NULL) {
158     llentry_t *le_next;
159
160     le_next = le->next;
161
162     sfree(le->key);
163     cx_xpath_free(le->value);
164
165     le = le_next;
166   }
167
168   llist_destroy(list);
169 } /* }}} void cx_list_free */
170
171 static void cx_free(void *arg) /* {{{ */
172 {
173   cx_t *db;
174
175   DEBUG("curl_xml plugin: cx_free (arg = %p);", arg);
176
177   db = (cx_t *)arg;
178
179   if (db == NULL)
180     return;
181
182   if (db->curl != NULL)
183     curl_easy_cleanup(db->curl);
184   db->curl = NULL;
185
186   if (db->list != NULL)
187     cx_list_free(db->list);
188
189   sfree(db->buffer);
190   sfree(db->instance);
191   sfree(db->host);
192
193   sfree(db->url);
194   sfree(db->user);
195   sfree(db->pass);
196   sfree(db->credentials);
197   sfree(db->cacert);
198   sfree(db->post_body);
199   curl_slist_free_all(db->headers);
200   curl_stats_destroy(db->stats);
201
202   for (size_t i = 0; i < db->namespaces_num; i++) {
203     sfree(db->namespaces[i].prefix);
204     sfree(db->namespaces[i].url);
205   }
206   sfree(db->namespaces);
207
208   sfree(db);
209 } /* }}} void cx_free */
210
211 static const char *cx_host(cx_t *db) /* {{{ */
212 {
213   if (db->host == NULL)
214     return hostname_g;
215   return db->host;
216 } /* }}} cx_host */
217
218 static int cx_config_append_string(const char *name,
219                                    struct curl_slist **dest, /* {{{ */
220                                    oconfig_item_t *ci) {
221   struct curl_slist *temp = NULL;
222   if ((ci->values_num != 1) || (ci->values[0].type != OCONFIG_TYPE_STRING)) {
223     WARNING("curl_xml plugin: `%s' needs exactly one string argument.", name);
224     return -1;
225   }
226
227   temp = curl_slist_append(*dest, ci->values[0].value.string);
228   if (temp == NULL)
229     return -1;
230
231   *dest = temp;
232
233   return 0;
234 } /* }}} int cx_config_append_string */
235
236 static int cx_check_type(const data_set_t *ds, cx_xpath_t *xpath) /* {{{ */
237 {
238   if (!ds) {
239     WARNING("curl_xml plugin: DataSet `%s' not defined.", xpath->type);
240     return -1;
241   }
242
243   if (ds->ds_num != xpath->values_len) {
244     WARNING("curl_xml plugin: DataSet `%s' requires %zu values, but config "
245             "talks about %zu",
246             xpath->type, ds->ds_num, xpath->values_len);
247     return -1;
248   }
249
250   return 0;
251 } /* }}} cx_check_type */
252
253 static xmlXPathObjectPtr
254 cx_evaluate_xpath(xmlXPathContextPtr xpath_ctx, /* {{{ */
255                   xmlChar *expr) {
256   xmlXPathObjectPtr xpath_obj;
257
258   /* XXX: When to free this? */
259   xpath_obj = xmlXPathEvalExpression(BAD_CAST expr, xpath_ctx);
260   if (xpath_obj == NULL) {
261     WARNING("curl_xml plugin: "
262             "Error unable to evaluate xpath expression \"%s\". Skipping...",
263             expr);
264     return NULL;
265   }
266
267   return xpath_obj;
268 } /* }}} cx_evaluate_xpath */
269
270 static int cx_if_not_text_node(xmlNodePtr node) /* {{{ */
271 {
272   if (node->type == XML_TEXT_NODE || node->type == XML_ATTRIBUTE_NODE ||
273       node->type == XML_ELEMENT_NODE)
274     return 0;
275
276   WARNING("curl_xml plugin: "
277           "Node \"%s\" doesn't seem to be a text node. Skipping...",
278           node->name);
279   return -1;
280 } /* }}} cx_if_not_text_node */
281
282 static int cx_handle_single_value_xpath(xmlXPathContextPtr xpath_ctx, /* {{{ */
283                                         cx_xpath_t *xpath, const data_set_t *ds,
284                                         value_list_t *vl, int index) {
285   xmlXPathObjectPtr values_node_obj;
286   xmlNodeSetPtr values_node;
287   int tmp_size;
288   char *node_value;
289
290   values_node_obj =
291       cx_evaluate_xpath(xpath_ctx, BAD_CAST xpath->values[index].path);
292   if (values_node_obj == NULL)
293     return -1; /* Error already logged. */
294
295   values_node = values_node_obj->nodesetval;
296   tmp_size = (values_node) ? values_node->nodeNr : 0;
297
298   if (tmp_size == 0) {
299     WARNING("curl_xml plugin: "
300             "relative xpath expression \"%s\" doesn't match any of the nodes. "
301             "Skipping...",
302             xpath->values[index].path);
303     xmlXPathFreeObject(values_node_obj);
304     return -1;
305   }
306
307   if (tmp_size > 1) {
308     WARNING("curl_xml plugin: "
309             "relative xpath expression \"%s\" is expected to return "
310             "only one node. Skipping...",
311             xpath->values[index].path);
312     xmlXPathFreeObject(values_node_obj);
313     return -1;
314   }
315
316   /* ignoring the element if other than textnode/attribute*/
317   if (cx_if_not_text_node(values_node->nodeTab[0])) {
318     WARNING("curl_xml plugin: "
319             "relative xpath expression \"%s\" is expected to return "
320             "only text/attribute node which is not the case. Skipping...",
321             xpath->values[index].path);
322     xmlXPathFreeObject(values_node_obj);
323     return -1;
324   }
325
326   node_value = (char *)xmlNodeGetContent(values_node->nodeTab[0]);
327   switch (ds->ds[index].type) {
328   case DS_TYPE_COUNTER:
329     vl->values[index].counter =
330         (counter_t)strtoull(node_value,
331                             /* endptr = */ NULL, /* base = */ 0);
332     break;
333   case DS_TYPE_DERIVE:
334     vl->values[index].derive =
335         (derive_t)strtoll(node_value,
336                           /* endptr = */ NULL, /* base = */ 0);
337     break;
338   case DS_TYPE_ABSOLUTE:
339     vl->values[index].absolute =
340         (absolute_t)strtoull(node_value,
341                              /* endptr = */ NULL, /* base = */ 0);
342     break;
343   case DS_TYPE_GAUGE:
344     vl->values[index].gauge = (gauge_t)strtod(node_value,
345                                               /* endptr = */ NULL);
346   }
347
348   /* free up object */
349   xmlXPathFreeObject(values_node_obj);
350   sfree(node_value);
351
352   /* We have reached here which means that
353    * we have got something to work */
354   return 0;
355 } /* }}} int cx_handle_single_value_xpath */
356
357 static int cx_handle_all_value_xpaths(xmlXPathContextPtr xpath_ctx, /* {{{ */
358                                       cx_xpath_t *xpath, const data_set_t *ds,
359                                       value_list_t *vl) {
360   value_t values[xpath->values_len];
361   int status;
362
363   assert(xpath->values_len > 0);
364   assert(xpath->values_len == vl->values_len);
365   assert(xpath->values_len == ds->ds_num);
366   vl->values = values;
367
368   for (size_t i = 0; i < xpath->values_len; i++) {
369     status = cx_handle_single_value_xpath(xpath_ctx, xpath, ds, vl, i);
370     if (status != 0)
371       return -1; /* An error has been printed. */
372   }              /* for (i = 0; i < xpath->values_len; i++) */
373
374   plugin_dispatch_values(vl);
375   vl->values = NULL;
376
377   return 0;
378 } /* }}} int cx_handle_all_value_xpaths */
379
380 static int cx_handle_instance_xpath(xmlXPathContextPtr xpath_ctx, /* {{{ */
381                                     cx_xpath_t *xpath, value_list_t *vl,
382                                     _Bool is_table) {
383   xmlXPathObjectPtr instance_node_obj = NULL;
384   xmlNodeSetPtr instance_node = NULL;
385
386   memset(vl->type_instance, 0, sizeof(vl->type_instance));
387
388   /* If the base xpath returns more than one block, the result is assumed to be
389    * a table. The `Instance' option is not optional in this case. Check for the
390    * condition and inform the user. */
391   if (is_table && (xpath->instance == NULL)) {
392     WARNING("curl_xml plugin: "
393             "Base-XPath %s is a table (more than one result was returned), "
394             "but no instance-XPath has been defined.",
395             xpath->path);
396     return -1;
397   }
398
399   /* instance has to be an xpath expression */
400   if (xpath->instance != NULL) {
401     int tmp_size;
402
403     instance_node_obj = cx_evaluate_xpath(xpath_ctx, BAD_CAST xpath->instance);
404     if (instance_node_obj == NULL)
405       return -1; /* error is logged already */
406
407     instance_node = instance_node_obj->nodesetval;
408     tmp_size = (instance_node) ? instance_node->nodeNr : 0;
409
410     if (tmp_size <= 0) {
411       WARNING(
412           "curl_xml plugin: "
413           "relative xpath expression for 'InstanceFrom' \"%s\" doesn't match "
414           "any of the nodes. Skipping the node.",
415           xpath->instance);
416       xmlXPathFreeObject(instance_node_obj);
417       return -1;
418     }
419
420     if (tmp_size > 1) {
421       WARNING("curl_xml plugin: "
422               "relative xpath expression for 'InstanceFrom' \"%s\" is expected "
423               "to return only one text node. Skipping the node.",
424               xpath->instance);
425       xmlXPathFreeObject(instance_node_obj);
426       return -1;
427     }
428
429     /* ignoring the element if other than textnode/attribute */
430     if (cx_if_not_text_node(instance_node->nodeTab[0])) {
431       WARNING("curl_xml plugin: "
432               "relative xpath expression \"%s\" is expected to return only "
433               "text node "
434               "which is not the case. Skipping the node.",
435               xpath->instance);
436       xmlXPathFreeObject(instance_node_obj);
437       return -1;
438     }
439   } /* if (xpath->instance != NULL) */
440
441   if (xpath->instance_prefix != NULL) {
442     if (instance_node != NULL) {
443       char *node_value = (char *)xmlNodeGetContent(instance_node->nodeTab[0]);
444       snprintf(vl->type_instance, sizeof(vl->type_instance), "%s%s",
445                xpath->instance_prefix, node_value);
446       sfree(node_value);
447     } else
448       sstrncpy(vl->type_instance, xpath->instance_prefix,
449                sizeof(vl->type_instance));
450   } else {
451     /* If instance_prefix and instance_node are NULL, then
452      * don't set the type_instance */
453     if (instance_node != NULL) {
454       char *node_value = (char *)xmlNodeGetContent(instance_node->nodeTab[0]);
455       sstrncpy(vl->type_instance, node_value, sizeof(vl->type_instance));
456       sfree(node_value);
457     }
458   }
459
460   /* Free `instance_node_obj' this late, because `instance_node' points to
461    * somewhere inside this structure. */
462   xmlXPathFreeObject(instance_node_obj);
463
464   return 0;
465 } /* }}} int cx_handle_instance_xpath */
466
467 static int cx_handle_base_xpath(char const *plugin_instance, /* {{{ */
468                                 char const *host, xmlXPathContextPtr xpath_ctx,
469                                 const data_set_t *ds, char *base_xpath,
470                                 cx_xpath_t *xpath) {
471   int total_nodes;
472
473   xmlXPathObjectPtr base_node_obj = NULL;
474   xmlNodeSetPtr base_nodes = NULL;
475
476   value_list_t vl = VALUE_LIST_INIT;
477
478   base_node_obj = cx_evaluate_xpath(xpath_ctx, BAD_CAST base_xpath);
479   if (base_node_obj == NULL)
480     return -1; /* error is logged already */
481
482   base_nodes = base_node_obj->nodesetval;
483   total_nodes = (base_nodes) ? base_nodes->nodeNr : 0;
484
485   if (total_nodes == 0) {
486     ERROR("curl_xml plugin: "
487           "xpath expression \"%s\" doesn't match any of the nodes. "
488           "Skipping the xpath block...",
489           base_xpath);
490     xmlXPathFreeObject(base_node_obj);
491     return -1;
492   }
493
494   /* If base_xpath returned multiple results, then */
495   /* Instance in the xpath block is required */
496   if (total_nodes > 1 && xpath->instance == NULL) {
497     ERROR("curl_xml plugin: "
498           "InstanceFrom is must in xpath block since the base xpath expression "
499           "\"%s\" "
500           "returned multiple results. Skipping the xpath block...",
501           base_xpath);
502     return -1;
503   }
504
505   /* set the values for the value_list */
506   vl.values_len = ds->ds_num;
507   sstrncpy(vl.type, xpath->type, sizeof(vl.type));
508   sstrncpy(vl.plugin, "curl_xml", sizeof(vl.plugin));
509   sstrncpy(vl.host, host, sizeof(vl.host));
510   if (plugin_instance != NULL)
511     sstrncpy(vl.plugin_instance, plugin_instance, sizeof(vl.plugin_instance));
512
513   for (int i = 0; i < total_nodes; i++) {
514     int status;
515
516     xpath_ctx->node = base_nodes->nodeTab[i];
517
518     status = cx_handle_instance_xpath(xpath_ctx, xpath, &vl,
519                                       /* is_table = */ (total_nodes > 1));
520     if (status != 0)
521       continue; /* An error has already been reported. */
522
523     status = cx_handle_all_value_xpaths(xpath_ctx, xpath, ds, &vl);
524     if (status != 0)
525       continue; /* An error has been logged. */
526   }             /* for (i = 0; i < total_nodes; i++) */
527
528   /* free up the allocated memory */
529   xmlXPathFreeObject(base_node_obj);
530
531   return 0;
532 } /* }}} cx_handle_base_xpath */
533
534 static int cx_handle_parsed_xml(xmlDocPtr doc, /* {{{ */
535                                 xmlXPathContextPtr xpath_ctx, cx_t *db) {
536   llentry_t *le;
537   const data_set_t *ds;
538   cx_xpath_t *xpath;
539   int status = -1;
540
541   le = llist_head(db->list);
542   while (le != NULL) {
543     /* get the ds */
544     xpath = (cx_xpath_t *)le->value;
545     ds = plugin_get_ds(xpath->type);
546
547     if ((cx_check_type(ds, xpath) == 0) &&
548         (cx_handle_base_xpath(db->instance, cx_host(db), xpath_ctx, ds, le->key,
549                               xpath) == 0))
550       status = 0; /* we got atleast one success */
551
552     le = le->next;
553   } /* while (le != NULL) */
554
555   return status;
556 } /* }}} cx_handle_parsed_xml */
557
558 static int cx_parse_stats_xml(xmlChar *xml, cx_t *db) /* {{{ */
559 {
560   int status;
561   xmlDocPtr doc;
562   xmlXPathContextPtr xpath_ctx;
563
564   /* Load the XML */
565   doc = xmlParseDoc(xml);
566   if (doc == NULL) {
567     ERROR("curl_xml plugin: Failed to parse the xml document  - %s", xml);
568     return -1;
569   }
570
571   xpath_ctx = xmlXPathNewContext(doc);
572   if (xpath_ctx == NULL) {
573     ERROR("curl_xml plugin: Failed to create the xml context");
574     xmlFreeDoc(doc);
575     return -1;
576   }
577
578   for (size_t i = 0; i < db->namespaces_num; i++) {
579     cx_namespace_t const *ns = db->namespaces + i;
580     status =
581         xmlXPathRegisterNs(xpath_ctx, BAD_CAST ns->prefix, BAD_CAST ns->url);
582     if (status != 0) {
583       ERROR("curl_xml plugin: "
584             "unable to register NS with prefix=\"%s\" and href=\"%s\"\n",
585             ns->prefix, ns->url);
586       xmlXPathFreeContext(xpath_ctx);
587       xmlFreeDoc(doc);
588       return status;
589     }
590   }
591
592   status = cx_handle_parsed_xml(doc, xpath_ctx, db);
593   /* Cleanup */
594   xmlXPathFreeContext(xpath_ctx);
595   xmlFreeDoc(doc);
596   return status;
597 } /* }}} cx_parse_stats_xml */
598
599 static int cx_curl_perform(cx_t *db, CURL *curl) /* {{{ */
600 {
601   int status;
602   long rc;
603   char *ptr;
604   char *url;
605
606   db->buffer_fill = 0;
607
608   curl_easy_setopt(db->curl, CURLOPT_URL, db->url);
609
610   status = curl_easy_perform(curl);
611   if (status != CURLE_OK) {
612     ERROR("curl_xml plugin: curl_easy_perform failed with status %i: %s (%s)",
613           status, db->curl_errbuf, db->url);
614     return -1;
615   }
616   if (db->stats != NULL)
617     curl_stats_dispatch(db->stats, db->curl, cx_host(db), "curl_xml",
618                         db->instance);
619
620   curl_easy_getinfo(curl, CURLINFO_EFFECTIVE_URL, &url);
621   curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &rc);
622
623   /* The response code is zero if a non-HTTP transport was used. */
624   if ((rc != 0) && (rc != 200)) {
625     ERROR(
626         "curl_xml plugin: curl_easy_perform failed with response code %ld (%s)",
627         rc, url);
628     return -1;
629   }
630
631   ptr = db->buffer;
632
633   status = cx_parse_stats_xml(BAD_CAST ptr, db);
634   db->buffer_fill = 0;
635
636   return status;
637 } /* }}} int cx_curl_perform */
638
639 static int cx_read(user_data_t *ud) /* {{{ */
640 {
641   cx_t *db;
642
643   if ((ud == NULL) || (ud->data == NULL)) {
644     ERROR("curl_xml plugin: cx_read: Invalid user data.");
645     return -1;
646   }
647
648   db = (cx_t *)ud->data;
649
650   return cx_curl_perform(db, db->curl);
651 } /* }}} int cx_read */
652
653 /* Configuration handling functions {{{ */
654
655 static int cx_config_add_values(const char *name, cx_xpath_t *xpath, /* {{{ */
656                                 oconfig_item_t *ci) {
657   if (ci->values_num < 1) {
658     WARNING("curl_xml plugin: `ValuesFrom' needs at least one argument.");
659     return -1;
660   }
661
662   for (int i = 0; i < ci->values_num; i++)
663     if (ci->values[i].type != OCONFIG_TYPE_STRING) {
664       WARNING("curl_xml plugin: `ValuesFrom' needs only string argument.");
665       return -1;
666     }
667
668   sfree(xpath->values);
669
670   xpath->values_len = 0;
671   xpath->values = malloc(sizeof(cx_values_t) * ci->values_num);
672   if (xpath->values == NULL)
673     return -1;
674   xpath->values_len = (size_t)ci->values_num;
675
676   /* populate cx_values_t structure */
677   for (int i = 0; i < ci->values_num; i++) {
678     xpath->values[i].path_len = sizeof(ci->values[i].value.string);
679     sstrncpy(xpath->values[i].path, ci->values[i].value.string,
680              sizeof(xpath->values[i].path));
681   }
682
683   return 0;
684 } /* }}} cx_config_add_values */
685
686 static int cx_config_add_xpath(cx_t *db, oconfig_item_t *ci) /* {{{ */
687 {
688   cx_xpath_t *xpath;
689   char *name;
690   llentry_t *le;
691   int status;
692
693   xpath = calloc(1, sizeof(*xpath));
694   if (xpath == NULL) {
695     ERROR("curl_xml plugin: calloc failed.");
696     return -1;
697   }
698
699   status = cf_util_get_string(ci, &xpath->path);
700   if (status != 0) {
701     cx_xpath_free(xpath);
702     return status;
703   }
704
705   /* error out if xpath->path is an empty string */
706   if (strlen(xpath->path) == 0) {
707     ERROR("curl_xml plugin: invalid xpath. "
708           "xpath value can't be an empty string");
709     cx_xpath_free(xpath);
710     return -1;
711   }
712
713   status = 0;
714   for (int i = 0; i < ci->children_num; i++) {
715     oconfig_item_t *child = ci->children + i;
716
717     if (strcasecmp("Type", child->key) == 0)
718       status = cf_util_get_string(child, &xpath->type);
719     else if (strcasecmp("InstancePrefix", child->key) == 0)
720       status = cf_util_get_string(child, &xpath->instance_prefix);
721     else if (strcasecmp("InstanceFrom", child->key) == 0)
722       status = cf_util_get_string(child, &xpath->instance);
723     else if (strcasecmp("ValuesFrom", child->key) == 0)
724       status = cx_config_add_values("ValuesFrom", xpath, child);
725     else {
726       WARNING("curl_xml plugin: Option `%s' not allowed here.", child->key);
727       status = -1;
728     }
729
730     if (status != 0)
731       break;
732   } /* for (i = 0; i < ci->children_num; i++) */
733
734   if (status != 0) {
735     cx_xpath_free(xpath);
736     return status;
737   }
738
739   if (xpath->type == NULL) {
740     WARNING("curl_xml plugin: `Type' missing in `xpath' block.");
741     cx_xpath_free(xpath);
742     return -1;
743   }
744
745   if (db->list == NULL) {
746     db->list = llist_create();
747     if (db->list == NULL) {
748       ERROR("curl_xml plugin: list creation failed.");
749       cx_xpath_free(xpath);
750       return -1;
751     }
752   }
753
754   name = strdup(xpath->path);
755   if (name == NULL) {
756     ERROR("curl_xml plugin: strdup failed.");
757     cx_xpath_free(xpath);
758     return -1;
759   }
760
761   le = llentry_create(name, xpath);
762   if (le == NULL) {
763     ERROR("curl_xml plugin: llentry_create failed.");
764     cx_xpath_free(xpath);
765     sfree(name);
766     return -1;
767   }
768
769   llist_append(db->list, le);
770   return 0;
771 } /* }}} int cx_config_add_xpath */
772
773 static int cx_config_add_namespace(cx_t *db, /* {{{ */
774                                    oconfig_item_t *ci) {
775   cx_namespace_t *ns;
776
777   if ((ci->values_num != 2) || (ci->values[0].type != OCONFIG_TYPE_STRING) ||
778       (ci->values[1].type != OCONFIG_TYPE_STRING)) {
779     WARNING("curl_xml plugin: The `Namespace' option "
780             "needs exactly two string arguments.");
781     return EINVAL;
782   }
783
784   ns = realloc(db->namespaces,
785                sizeof(*db->namespaces) * (db->namespaces_num + 1));
786   if (ns == NULL) {
787     ERROR("curl_xml plugin: realloc failed.");
788     return ENOMEM;
789   }
790   db->namespaces = ns;
791   ns = db->namespaces + db->namespaces_num;
792   memset(ns, 0, sizeof(*ns));
793
794   ns->prefix = strdup(ci->values[0].value.string);
795   ns->url = strdup(ci->values[1].value.string);
796
797   if ((ns->prefix == NULL) || (ns->url == NULL)) {
798     sfree(ns->prefix);
799     sfree(ns->url);
800     ERROR("curl_xml plugin: strdup failed.");
801     return ENOMEM;
802   }
803
804   db->namespaces_num++;
805   return 0;
806 } /* }}} int cx_config_add_namespace */
807
808 /* Initialize db->curl */
809 static int cx_init_curl(cx_t *db) /* {{{ */
810 {
811   db->curl = curl_easy_init();
812   if (db->curl == NULL) {
813     ERROR("curl_xml plugin: curl_easy_init failed.");
814     return -1;
815   }
816
817   curl_easy_setopt(db->curl, CURLOPT_NOSIGNAL, 1L);
818   curl_easy_setopt(db->curl, CURLOPT_WRITEFUNCTION, cx_curl_callback);
819   curl_easy_setopt(db->curl, CURLOPT_WRITEDATA, db);
820   curl_easy_setopt(db->curl, CURLOPT_USERAGENT, COLLECTD_USERAGENT);
821   curl_easy_setopt(db->curl, CURLOPT_ERRORBUFFER, db->curl_errbuf);
822   curl_easy_setopt(db->curl, CURLOPT_FOLLOWLOCATION, 1L);
823   curl_easy_setopt(db->curl, CURLOPT_MAXREDIRS, 50L);
824
825   if (db->user != NULL) {
826 #ifdef HAVE_CURLOPT_USERNAME
827     curl_easy_setopt(db->curl, CURLOPT_USERNAME, db->user);
828     curl_easy_setopt(db->curl, CURLOPT_PASSWORD,
829                      (db->pass == NULL) ? "" : db->pass);
830 #else
831     size_t credentials_size;
832
833     credentials_size = strlen(db->user) + 2;
834     if (db->pass != NULL)
835       credentials_size += strlen(db->pass);
836
837     db->credentials = malloc(credentials_size);
838     if (db->credentials == NULL) {
839       ERROR("curl_xml plugin: malloc failed.");
840       return -1;
841     }
842
843     snprintf(db->credentials, credentials_size, "%s:%s", db->user,
844              (db->pass == NULL) ? "" : db->pass);
845     curl_easy_setopt(db->curl, CURLOPT_USERPWD, db->credentials);
846 #endif
847
848     if (db->digest)
849       curl_easy_setopt(db->curl, CURLOPT_HTTPAUTH, CURLAUTH_DIGEST);
850   }
851
852   curl_easy_setopt(db->curl, CURLOPT_SSL_VERIFYPEER, db->verify_peer ? 1L : 0L);
853   curl_easy_setopt(db->curl, CURLOPT_SSL_VERIFYHOST, db->verify_host ? 2L : 0L);
854   if (db->cacert != NULL)
855     curl_easy_setopt(db->curl, CURLOPT_CAINFO, db->cacert);
856   if (db->headers != NULL)
857     curl_easy_setopt(db->curl, CURLOPT_HTTPHEADER, db->headers);
858   if (db->post_body != NULL)
859     curl_easy_setopt(db->curl, CURLOPT_POSTFIELDS, db->post_body);
860
861 #ifdef HAVE_CURLOPT_TIMEOUT_MS
862   if (db->timeout >= 0)
863     curl_easy_setopt(db->curl, CURLOPT_TIMEOUT_MS, (long)db->timeout);
864   else
865     curl_easy_setopt(db->curl, CURLOPT_TIMEOUT_MS,
866                      (long)CDTIME_T_TO_MS(plugin_get_interval()));
867 #endif
868
869   return 0;
870 } /* }}} int cx_init_curl */
871
872 static int cx_config_add_url(oconfig_item_t *ci) /* {{{ */
873 {
874   cx_t *db;
875   int status = 0;
876
877   if ((ci->values_num != 1) || (ci->values[0].type != OCONFIG_TYPE_STRING)) {
878     WARNING("curl_xml plugin: The `URL' block "
879             "needs exactly one string argument.");
880     return -1;
881   }
882
883   db = calloc(1, sizeof(*db));
884   if (db == NULL) {
885     ERROR("curl_xml plugin: calloc failed.");
886     return -1;
887   }
888
889   db->timeout = -1;
890
891   if (strcasecmp("URL", ci->key) == 0) {
892     status = cf_util_get_string(ci, &db->url);
893     if (status != 0) {
894       sfree(db);
895       return status;
896     }
897   } else {
898     ERROR("curl_xml plugin: cx_config: "
899           "Invalid key: %s",
900           ci->key);
901     cx_free(db);
902     return -1;
903   }
904
905   /* Fill the `cx_t' structure.. */
906   for (int i = 0; i < ci->children_num; i++) {
907     oconfig_item_t *child = ci->children + i;
908
909     if (strcasecmp("Instance", child->key) == 0)
910       status = cf_util_get_string(child, &db->instance);
911     else if (strcasecmp("Host", child->key) == 0)
912       status = cf_util_get_string(child, &db->host);
913     else if (strcasecmp("User", child->key) == 0)
914       status = cf_util_get_string(child, &db->user);
915     else if (strcasecmp("Password", child->key) == 0)
916       status = cf_util_get_string(child, &db->pass);
917     else if (strcasecmp("Digest", child->key) == 0)
918       status = cf_util_get_boolean(child, &db->digest);
919     else if (strcasecmp("VerifyPeer", child->key) == 0)
920       status = cf_util_get_boolean(child, &db->verify_peer);
921     else if (strcasecmp("VerifyHost", child->key) == 0)
922       status = cf_util_get_boolean(child, &db->verify_host);
923     else if (strcasecmp("CACert", child->key) == 0)
924       status = cf_util_get_string(child, &db->cacert);
925     else if (strcasecmp("xpath", child->key) == 0)
926       status = cx_config_add_xpath(db, child);
927     else if (strcasecmp("Header", child->key) == 0)
928       status = cx_config_append_string("Header", &db->headers, child);
929     else if (strcasecmp("Post", child->key) == 0)
930       status = cf_util_get_string(child, &db->post_body);
931     else if (strcasecmp("Namespace", child->key) == 0)
932       status = cx_config_add_namespace(db, child);
933     else if (strcasecmp("Timeout", child->key) == 0)
934       status = cf_util_get_int(child, &db->timeout);
935     else if (strcasecmp("Statistics", child->key) == 0) {
936       db->stats = curl_stats_from_config(child);
937       if (db->stats == NULL)
938         status = -1;
939     } else {
940       WARNING("curl_xml plugin: Option `%s' not allowed here.", child->key);
941       status = -1;
942     }
943
944     if (status != 0)
945       break;
946   }
947
948   if (status == 0) {
949     if (db->list == NULL) {
950       WARNING("curl_xml plugin: No (valid) `Key' block "
951               "within `URL' block `%s'.",
952               db->url);
953       status = -1;
954     }
955     if (status == 0)
956       status = cx_init_curl(db);
957   }
958
959   /* If all went well, register this database for reading */
960   if (status == 0) {
961     char *cb_name;
962
963     if (db->instance == NULL)
964       db->instance = strdup("default");
965
966     DEBUG("curl_xml plugin: Registering new read callback: %s", db->instance);
967
968     cb_name = ssnprintf_alloc("curl_xml-%s-%s", db->instance, db->url);
969
970     plugin_register_complex_read(/* group = */ "curl_xml", cb_name, cx_read,
971                                  /* interval = */ 0,
972                                  &(user_data_t){
973                                      .data = db, .free_func = cx_free,
974                                  });
975     sfree(cb_name);
976   } else {
977     cx_free(db);
978     return -1;
979   }
980
981   return 0;
982 } /* }}} int cx_config_add_url */
983
984 /* }}} End of configuration handling functions */
985
986 static int cx_config(oconfig_item_t *ci) /* {{{ */
987 {
988   int success;
989   int errors;
990   int status;
991
992   success = 0;
993   errors = 0;
994
995   for (int i = 0; i < ci->children_num; i++) {
996     oconfig_item_t *child = ci->children + i;
997
998     if (strcasecmp("URL", child->key) == 0) {
999       status = cx_config_add_url(child);
1000       if (status == 0)
1001         success++;
1002       else
1003         errors++;
1004     } else {
1005       WARNING("curl_xml plugin: Option `%s' not allowed here.", child->key);
1006       errors++;
1007     }
1008   }
1009
1010   if ((success == 0) && (errors > 0)) {
1011     ERROR("curl_xml plugin: All statements failed.");
1012     return -1;
1013   }
1014
1015   return 0;
1016 } /* }}} int cx_config */
1017
1018 static int cx_init(void) /* {{{ */
1019 {
1020   /* Call this while collectd is still single-threaded to avoid
1021    * initialization issues in libgcrypt. */
1022   curl_global_init(CURL_GLOBAL_SSL);
1023   return 0;
1024 } /* }}} int cx_init */
1025
1026 void module_register(void) {
1027   plugin_register_complex_config("curl_xml", cx_config);
1028   plugin_register_init("curl_xml", cx_init);
1029 } /* void module_register */