2 * collectd - src/curl_json.c
3 * Copyright (C) 2009 Doug MacEachern
4 * Copyright (C) 2006-2013 Florian octo Forster
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.
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.
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
20 * Doug MacEachern <dougm at hyperic.com>
21 * Florian octo Forster <octo at collectd.org>
28 #include "utils_avltree.h"
29 #include "utils_complain.h"
30 #include "utils_curl_stats.h"
32 #include <sys/types.h>
35 #include <curl/curl.h>
37 #include <yajl/yajl_parse.h>
38 #if HAVE_YAJL_YAJL_VERSION_H
39 #include <yajl/yajl_version.h>
42 #if defined(YAJL_MAJOR) && (YAJL_MAJOR > 1)
43 #define HAVE_YAJL_V2 1
46 #define CJ_DEFAULT_HOST "localhost"
47 #define CJ_KEY_MAGIC 0x43484b59UL /* CHKY */
48 #define CJ_IS_KEY(key) ((key)->magic == CJ_KEY_MAGIC)
50 #define COUCH_MIN(x, y) ((x) < (y) ? (x) : (y))
53 typedef struct cj_key_s cj_key_t;
54 struct cj_key_s /* {{{ */
78 struct curl_slist *headers;
85 char curl_errbuf[CURL_ERROR_SIZE];
98 char name[DATA_MAX_NAME_LEN];
99 } state[YAJL_MAX_DEPTH];
101 typedef struct cj_s cj_t; /* }}} */
104 typedef size_t yajl_len_t;
106 typedef unsigned int yajl_len_t;
109 static int cj_read(user_data_t *ud);
110 static void cj_submit(cj_t *db, cj_key_t *key, value_t *value);
112 static size_t cj_curl_callback(void *buf, /* {{{ */
113 size_t size, size_t nmemb, void *user_data) {
127 status = yajl_parse(db->yajl, (unsigned char *)buf, len);
128 if (status == yajl_status_ok)
131 else if (status == yajl_status_insufficient_data)
136 yajl_get_error(db->yajl, /* verbose = */ 1,
137 /* jsonText = */ (unsigned char *)buf, (unsigned int)len);
138 ERROR("curl_json plugin: yajl_parse failed: %s", msg);
139 yajl_free_error(db->yajl, msg);
140 return (0); /* abort write callback */
141 } /* }}} size_t cj_curl_callback */
143 static int cj_get_type(cj_key_t *key) {
144 const data_set_t *ds;
146 if ((key == NULL) || !CJ_IS_KEY(key))
149 ds = plugin_get_ds(key->type);
151 static char type[DATA_MAX_NAME_LEN] = "!!!invalid!!!";
153 assert(key->type != NULL);
154 if (strcmp(type, key->type) != 0) {
155 ERROR("curl_json plugin: Unable to look up DS type \"%s\".", key->type);
156 sstrncpy(type, key->type, sizeof(type));
160 } else if (ds->ds_num > 1) {
161 static c_complain_t complaint = C_COMPLAIN_INIT_STATIC;
164 LOG_WARNING, &complaint,
165 "curl_json plugin: The type \"%s\" has more than one data source. "
166 "This is currently not supported. I will return the type of the "
167 "first data source, but this will likely lead to problems later on.",
171 return ds->ds[0].type;
174 /* cj_load_key loads the configuration for "key" from the parent context and
175 * sets either .key or .tree in the current context. */
176 static int cj_load_key(cj_t *db, char const *key) {
177 if (db == NULL || key == NULL || db->depth <= 0)
180 sstrncpy(db->state[db->depth].name, key, sizeof(db->state[db->depth].name));
182 c_avl_tree_t *tree = db->state[db->depth - 1].tree;
187 /* the parent has a key, so the tree pointer is invalid. */
188 if (CJ_IS_KEY(db->state[db->depth - 1].key)) {
193 if (c_avl_get(tree, key, (void *)&value) == 0) {
194 if (CJ_IS_KEY((cj_key_t *)value)) {
195 db->state[db->depth].key = value;
197 db->state[db->depth].tree = value;
199 } else if (c_avl_get(tree, CJ_ANY, (void *)&value) == 0) {
200 if (CJ_IS_KEY((cj_key_t *)value)) {
201 db->state[db->depth].key = value;
203 db->state[db->depth].tree = value;
206 db->state[db->depth].key = NULL;
212 static void cj_advance_array(cj_t *db) {
213 if (!db->state[db->depth].in_array)
216 db->state[db->depth].index++;
218 char name[DATA_MAX_NAME_LEN];
219 ssnprintf(name, sizeof(name), "%d", db->state[db->depth].index);
220 cj_load_key(db, name);
224 #define CJ_CB_ABORT 0
225 #define CJ_CB_CONTINUE 1
227 static int cj_cb_boolean(void *ctx, int boolVal) {
228 cj_advance_array(ctx);
229 return (CJ_CB_CONTINUE);
232 static int cj_cb_null(void *ctx) {
233 cj_advance_array(ctx);
234 return (CJ_CB_CONTINUE);
237 static int cj_cb_number(void *ctx, const char *number, yajl_len_t number_len) {
238 char buffer[number_len + 1];
240 cj_t *db = (cj_t *)ctx;
241 cj_key_t *key = db->state[db->depth].key;
243 /* Create a null-terminated version of the string. */
244 memcpy(buffer, number, number_len);
245 buffer[sizeof(buffer) - 1] = 0;
250 /* no config for this element. */
251 cj_advance_array(ctx);
252 return CJ_CB_CONTINUE;
253 } else if (!CJ_IS_KEY(key)) {
254 /* the config expects a map or an array. */
256 "curl_json plugin: Found \"%s\", but the configuration expects a map.",
258 cj_advance_array(ctx);
259 return CJ_CB_CONTINUE;
262 int type = cj_get_type(key);
264 int status = parse_value(buffer, &vt, type);
266 NOTICE("curl_json plugin: Unable to parse number: \"%s\"", buffer);
267 cj_advance_array(ctx);
268 return (CJ_CB_CONTINUE);
271 cj_submit(db, key, &vt);
272 cj_advance_array(ctx);
273 return (CJ_CB_CONTINUE);
274 } /* int cj_cb_number */
276 /* Queries the key-tree of the parent context for "in_name" and, if found,
277 * updates the "key" field of the current context. Otherwise, "key" is set to
279 static int cj_cb_map_key(void *ctx, unsigned char const *in_name,
280 yajl_len_t in_name_len) {
281 char name[in_name_len + 1];
283 memmove(name, in_name, in_name_len);
284 name[sizeof(name) - 1] = 0;
286 if (cj_load_key(ctx, name) != 0)
289 return CJ_CB_CONTINUE;
292 static int cj_cb_string(void *ctx, const unsigned char *val, yajl_len_t len) {
293 /* Handle the string as if it was a number. */
294 return (cj_cb_number(ctx, (const char *)val, len));
295 } /* int cj_cb_string */
297 static int cj_cb_end(void *ctx) {
298 cj_t *db = (cj_t *)ctx;
299 db->state[db->depth].tree = NULL;
301 cj_advance_array(ctx);
302 return (CJ_CB_CONTINUE);
305 static int cj_cb_start_map(void *ctx) {
306 cj_t *db = (cj_t *)ctx;
308 if ((db->depth + 1) >= YAJL_MAX_DEPTH) {
309 ERROR("curl_json plugin: %s depth exceeds max, aborting.",
310 db->url ? db->url : db->sock);
311 return (CJ_CB_ABORT);
314 return (CJ_CB_CONTINUE);
317 static int cj_cb_end_map(void *ctx) { return cj_cb_end(ctx); }
319 static int cj_cb_start_array(void *ctx) {
320 cj_t *db = (cj_t *)ctx;
322 if ((db->depth + 1) >= YAJL_MAX_DEPTH) {
323 ERROR("curl_json plugin: %s depth exceeds max, aborting.",
324 db->url ? db->url : db->sock);
328 db->state[db->depth].in_array = 1;
329 db->state[db->depth].index = 0;
331 cj_load_key(db, "0");
333 return CJ_CB_CONTINUE;
336 static int cj_cb_end_array(void *ctx) {
337 cj_t *db = (cj_t *)ctx;
338 db->state[db->depth].in_array = 0;
339 return cj_cb_end(ctx);
342 static yajl_callbacks ycallbacks = {
343 cj_cb_null, /* null */
344 cj_cb_boolean, /* boolean */
347 cj_cb_number, cj_cb_string, cj_cb_start_map, cj_cb_map_key,
348 cj_cb_end_map, cj_cb_start_array, cj_cb_end_array};
350 /* end yajl callbacks */
352 static void cj_key_free(cj_key_t *key) /* {{{ */
359 sfree(key->instance);
362 } /* }}} void cj_key_free */
364 static void cj_tree_free(c_avl_tree_t *tree) /* {{{ */
369 while (c_avl_pick(tree, (void *)&name, (void *)&value) == 0) {
370 cj_key_t *key = (cj_key_t *)value;
375 cj_tree_free((c_avl_tree_t *)value);
381 } /* }}} void cj_tree_free */
383 static void cj_free(void *arg) /* {{{ */
387 DEBUG("curl_json plugin: cj_free (arg = %p);", arg);
394 if (db->curl != NULL)
395 curl_easy_cleanup(db->curl);
398 if (db->tree != NULL)
399 cj_tree_free(db->tree);
410 sfree(db->credentials);
412 sfree(db->post_body);
413 curl_slist_free_all(db->headers);
414 curl_stats_destroy(db->stats);
417 } /* }}} void cj_free */
419 /* Configuration handling functions {{{ */
421 static c_avl_tree_t *cj_avl_create(void) {
422 return c_avl_create((int (*)(const void *, const void *))strcmp);
425 static int cj_config_append_string(const char *name,
426 struct curl_slist **dest, /* {{{ */
427 oconfig_item_t *ci) {
428 struct curl_slist *temp = NULL;
429 if ((ci->values_num != 1) || (ci->values[0].type != OCONFIG_TYPE_STRING)) {
430 WARNING("curl_json plugin: `%s' needs exactly one string argument.", name);
434 temp = curl_slist_append(*dest, ci->values[0].value.string);
441 } /* }}} int cj_config_append_string */
443 static int cj_config_add_key(cj_t *db, /* {{{ */
444 oconfig_item_t *ci) {
448 if ((ci->values_num != 1) || (ci->values[0].type != OCONFIG_TYPE_STRING)) {
449 WARNING("curl_json plugin: The `Key' block "
450 "needs exactly one string argument.");
454 key = calloc(1, sizeof(*key));
456 ERROR("curl_json plugin: calloc failed.");
459 key->magic = CJ_KEY_MAGIC;
461 if (strcasecmp("Key", ci->key) == 0) {
462 status = cf_util_get_string(ci, &key->path);
468 ERROR("curl_json plugin: cj_config: "
476 for (int i = 0; i < ci->children_num; i++) {
477 oconfig_item_t *child = ci->children + i;
479 if (strcasecmp("Type", child->key) == 0)
480 status = cf_util_get_string(child, &key->type);
481 else if (strcasecmp("Instance", child->key) == 0)
482 status = cf_util_get_string(child, &key->instance);
484 WARNING("curl_json plugin: Option `%s' not allowed here.", child->key);
490 } /* for (i = 0; i < ci->children_num; i++) */
497 if (key->type == NULL) {
498 WARNING("curl_json plugin: `Type' missing in `Key' block.");
503 /* store path in a tree that will match the json map structure, example:
504 * "httpd/requests/count",
505 * "httpd/requests/current" ->
506 * { "httpd": { "requests": { "count": $key, "current": $key } } }
512 if (db->tree == NULL)
513 db->tree = cj_avl_create();
521 while ((ptr = strchr(name, '/')) != NULL) {
530 len = COUCH_MIN(len, sizeof(ent) - 1);
531 sstrncpy(ent, name, len + 1);
533 if (c_avl_get(tree, ent, (void *)&value) != 0) {
534 value = cj_avl_create();
535 c_avl_insert(tree, strdup(ent), value);
542 if (strlen(name) == 0) {
543 ERROR("curl_json plugin: invalid key: %s", key->path);
548 c_avl_insert(tree, strdup(name), key);
550 } /* }}} int cj_config_add_key */
552 static int cj_init_curl(cj_t *db) /* {{{ */
554 db->curl = curl_easy_init();
555 if (db->curl == NULL) {
556 ERROR("curl_json plugin: curl_easy_init failed.");
560 curl_easy_setopt(db->curl, CURLOPT_NOSIGNAL, 1L);
561 curl_easy_setopt(db->curl, CURLOPT_WRITEFUNCTION, cj_curl_callback);
562 curl_easy_setopt(db->curl, CURLOPT_WRITEDATA, db);
563 curl_easy_setopt(db->curl, CURLOPT_USERAGENT, COLLECTD_USERAGENT);
564 curl_easy_setopt(db->curl, CURLOPT_ERRORBUFFER, db->curl_errbuf);
565 curl_easy_setopt(db->curl, CURLOPT_FOLLOWLOCATION, 1L);
566 curl_easy_setopt(db->curl, CURLOPT_MAXREDIRS, 50L);
568 if (db->user != NULL) {
569 #ifdef HAVE_CURLOPT_USERNAME
570 curl_easy_setopt(db->curl, CURLOPT_USERNAME, db->user);
571 curl_easy_setopt(db->curl, CURLOPT_PASSWORD,
572 (db->pass == NULL) ? "" : db->pass);
574 size_t credentials_size;
576 credentials_size = strlen(db->user) + 2;
577 if (db->pass != NULL)
578 credentials_size += strlen(db->pass);
580 db->credentials = malloc(credentials_size);
581 if (db->credentials == NULL) {
582 ERROR("curl_json plugin: malloc failed.");
586 ssnprintf(db->credentials, credentials_size, "%s:%s", db->user,
587 (db->pass == NULL) ? "" : db->pass);
588 curl_easy_setopt(db->curl, CURLOPT_USERPWD, db->credentials);
592 curl_easy_setopt(db->curl, CURLOPT_HTTPAUTH, CURLAUTH_DIGEST);
595 curl_easy_setopt(db->curl, CURLOPT_SSL_VERIFYPEER, (long)db->verify_peer);
596 curl_easy_setopt(db->curl, CURLOPT_SSL_VERIFYHOST, db->verify_host ? 2L : 0L);
597 if (db->cacert != NULL)
598 curl_easy_setopt(db->curl, CURLOPT_CAINFO, db->cacert);
599 if (db->headers != NULL)
600 curl_easy_setopt(db->curl, CURLOPT_HTTPHEADER, db->headers);
601 if (db->post_body != NULL)
602 curl_easy_setopt(db->curl, CURLOPT_POSTFIELDS, db->post_body);
604 #ifdef HAVE_CURLOPT_TIMEOUT_MS
605 if (db->timeout >= 0)
606 curl_easy_setopt(db->curl, CURLOPT_TIMEOUT_MS, (long)db->timeout);
607 else if (db->interval > 0)
608 curl_easy_setopt(db->curl, CURLOPT_TIMEOUT_MS,
609 (long)CDTIME_T_TO_MS(db->interval));
611 curl_easy_setopt(db->curl, CURLOPT_TIMEOUT_MS,
612 (long)CDTIME_T_TO_MS(plugin_get_interval()));
616 } /* }}} int cj_init_curl */
618 static int cj_config_add_url(oconfig_item_t *ci) /* {{{ */
623 if ((ci->values_num != 1) || (ci->values[0].type != OCONFIG_TYPE_STRING)) {
624 WARNING("curl_json plugin: The `URL' block "
625 "needs exactly one string argument.");
629 db = calloc(1, sizeof(*db));
631 ERROR("curl_json plugin: calloc failed.");
637 if (strcasecmp("URL", ci->key) == 0)
638 status = cf_util_get_string(ci, &db->url);
639 else if (strcasecmp("Sock", ci->key) == 0)
640 status = cf_util_get_string(ci, &db->sock);
642 ERROR("curl_json plugin: cj_config: "
653 /* Fill the `cj_t' structure.. */
654 for (int i = 0; i < ci->children_num; i++) {
655 oconfig_item_t *child = ci->children + i;
657 if (strcasecmp("Instance", child->key) == 0)
658 status = cf_util_get_string(child, &db->instance);
659 else if (strcasecmp("Host", child->key) == 0)
660 status = cf_util_get_string(child, &db->host);
661 else if (db->url && strcasecmp("User", child->key) == 0)
662 status = cf_util_get_string(child, &db->user);
663 else if (db->url && strcasecmp("Password", child->key) == 0)
664 status = cf_util_get_string(child, &db->pass);
665 else if (strcasecmp("Digest", child->key) == 0)
666 status = cf_util_get_boolean(child, &db->digest);
667 else if (db->url && strcasecmp("VerifyPeer", child->key) == 0)
668 status = cf_util_get_boolean(child, &db->verify_peer);
669 else if (db->url && strcasecmp("VerifyHost", child->key) == 0)
670 status = cf_util_get_boolean(child, &db->verify_host);
671 else if (db->url && strcasecmp("CACert", child->key) == 0)
672 status = cf_util_get_string(child, &db->cacert);
673 else if (db->url && strcasecmp("Header", child->key) == 0)
674 status = cj_config_append_string("Header", &db->headers, child);
675 else if (db->url && strcasecmp("Post", child->key) == 0)
676 status = cf_util_get_string(child, &db->post_body);
677 else if (strcasecmp("Key", child->key) == 0)
678 status = cj_config_add_key(db, child);
679 else if (strcasecmp("Interval", child->key) == 0)
680 status = cf_util_get_cdtime(child, &db->interval);
681 else if (strcasecmp("Timeout", child->key) == 0)
682 status = cf_util_get_int(child, &db->timeout);
683 else if (strcasecmp("Statistics", child->key) == 0) {
684 db->stats = curl_stats_from_config(child);
685 if (db->stats == NULL)
688 WARNING("curl_json plugin: Option `%s' not allowed here.", child->key);
697 if (db->tree == NULL) {
698 WARNING("curl_json plugin: No (valid) `Key' block within `%s' \"`%s'\".",
699 db->url ? "URL" : "Sock", db->url ? db->url : db->sock);
702 if (status == 0 && db->url)
703 status = cj_init_curl(db);
706 /* If all went well, register this database for reading */
710 if (db->instance == NULL)
711 db->instance = strdup("default");
713 DEBUG("curl_json plugin: Registering new read callback: %s", db->instance);
715 cb_name = ssnprintf_alloc("curl_json-%s-%s", db->instance,
716 db->url ? db->url : db->sock);
718 plugin_register_complex_read(/* group = */ NULL, cb_name, cj_read,
719 /* interval = */ db->interval,
721 .data = db, .free_func = cj_free,
731 /* }}} int cj_config_add_database */
733 static int cj_config(oconfig_item_t *ci) /* {{{ */
742 for (int i = 0; i < ci->children_num; i++) {
743 oconfig_item_t *child = ci->children + i;
745 if (strcasecmp("Sock", child->key) == 0 ||
746 strcasecmp("URL", child->key) == 0) {
747 status = cj_config_add_url(child);
753 WARNING("curl_json plugin: Option `%s' not allowed here.", child->key);
758 if ((success == 0) && (errors > 0)) {
759 ERROR("curl_json plugin: All statements failed.");
764 } /* }}} int cj_config */
766 /* }}} End of configuration handling functions */
768 static const char *cj_host(cj_t *db) /* {{{ */
770 if ((db->host == NULL) || (strcmp("", db->host) == 0) ||
771 (strcmp(CJ_DEFAULT_HOST, db->host) == 0))
776 static void cj_submit(cj_t *db, cj_key_t *key, value_t *value) /* {{{ */
778 value_list_t vl = VALUE_LIST_INIT;
783 if (key->instance == NULL) {
785 for (int i = 0; i < db->depth; i++)
786 len += ssnprintf(vl.type_instance + len, sizeof(vl.type_instance) - len,
787 i ? "-%s" : "%s", db->state[i + 1].name);
789 sstrncpy(vl.type_instance, key->instance, sizeof(vl.type_instance));
791 sstrncpy(vl.host, cj_host(db), sizeof(vl.host));
792 sstrncpy(vl.plugin, "curl_json", sizeof(vl.plugin));
793 sstrncpy(vl.plugin_instance, db->instance, sizeof(vl.plugin_instance));
794 sstrncpy(vl.type, key->type, sizeof(vl.type));
796 if (db->interval > 0)
797 vl.interval = db->interval;
799 plugin_dispatch_values(&vl);
800 } /* }}} int cj_submit */
802 static int cj_sock_perform(cj_t *db) /* {{{ */
805 struct sockaddr_un sa_unix = {0};
806 sa_unix.sun_family = AF_UNIX;
807 sstrncpy(sa_unix.sun_path, db->sock, sizeof(sa_unix.sun_path));
809 int fd = socket(AF_UNIX, SOCK_STREAM, 0);
812 if (connect(fd, (struct sockaddr *)&sa_unix, sizeof(sa_unix)) < 0) {
813 ERROR("curl_json plugin: connect(%s) failed: %s",
814 (db->sock != NULL) ? db->sock : "<null>",
815 sstrerror(errno, errbuf, sizeof(errbuf)));
822 unsigned char buffer[4096];
823 red = read(fd, buffer, sizeof(buffer));
825 ERROR("curl_json plugin: read(%s) failed: %s",
826 (db->sock != NULL) ? db->sock : "<null>",
827 sstrerror(errno, errbuf, sizeof(errbuf)));
831 if (!cj_curl_callback(buffer, red, 1, db))
836 } /* }}} int cj_sock_perform */
838 static int cj_curl_perform(cj_t *db) /* {{{ */
844 curl_easy_setopt(db->curl, CURLOPT_URL, db->url);
846 status = curl_easy_perform(db->curl);
847 if (status != CURLE_OK) {
848 ERROR("curl_json plugin: curl_easy_perform failed with status %i: %s (%s)",
849 status, db->curl_errbuf, db->url);
852 if (db->stats != NULL)
853 curl_stats_dispatch(db->stats, db->curl, cj_host(db), "curl_json",
856 curl_easy_getinfo(db->curl, CURLINFO_EFFECTIVE_URL, &url);
857 curl_easy_getinfo(db->curl, CURLINFO_RESPONSE_CODE, &rc);
859 /* The response code is zero if a non-HTTP transport was used. */
860 if ((rc != 0) && (rc != 200)) {
861 ERROR("curl_json plugin: curl_easy_perform failed with "
862 "response code %ld (%s)",
867 } /* }}} int cj_curl_perform */
869 static int cj_perform(cj_t *db) /* {{{ */
872 yajl_handle yprev = db->yajl;
874 db->yajl = yajl_alloc(&ycallbacks,
876 /* alloc funcs = */ NULL,
878 /* alloc funcs = */ NULL, NULL,
880 /* context = */ (void *)db);
881 if (db->yajl == NULL) {
882 ERROR("curl_json plugin: yajl_alloc failed.");
888 status = cj_curl_perform(db);
890 status = cj_sock_perform(db);
898 status = yajl_complete_parse(db->yajl);
900 status = yajl_parse_complete(db->yajl);
902 if (status != yajl_status_ok) {
903 unsigned char *errmsg;
905 errmsg = yajl_get_error(db->yajl, /* verbose = */ 0,
906 /* jsonText = */ NULL, /* jsonTextLen = */ 0);
907 ERROR("curl_json plugin: yajl_parse_complete failed: %s", (char *)errmsg);
908 yajl_free_error(db->yajl, errmsg);
917 } /* }}} int cj_perform */
919 static int cj_read(user_data_t *ud) /* {{{ */
923 if ((ud == NULL) || (ud->data == NULL)) {
924 ERROR("curl_json plugin: cj_read: Invalid user data.");
928 db = (cj_t *)ud->data;
931 memset(&db->state, 0, sizeof(db->state));
932 db->state[db->depth].tree = db->tree;
935 return cj_perform(db);
936 } /* }}} int cj_read */
938 static int cj_init(void) /* {{{ */
940 /* Call this while collectd is still single-threaded to avoid
941 * initialization issues in libgcrypt. */
942 curl_global_init(CURL_GLOBAL_SSL);
944 } /* }}} int cj_init */
946 void module_register(void) {
947 plugin_register_complex_config("curl_json", cj_config);
948 plugin_register_init("curl_json", cj_init);
949 } /* void module_register */
951 /* vim: set sw=2 sts=2 et fdm=marker : */