2 * collectd - src/utils_db_query.c
3 * Copyright (C) 2008,2009 Florian octo Forster
5 * Permission is hereby granted, free of charge, to any person obtaining a
6 * copy of this software and associated documentation files (the "Software"),
7 * to deal in the Software without restriction, including without limitation
8 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
9 * and/or sell copies of the Software, and to permit persons to whom the
10 * Software is furnished to do so, subject to the following conditions:
12 * The above copyright notice and this permission notice shall be included in
13 * all copies or substantial portions of the Software.
15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
20 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
21 * DEALINGS IN THE SOFTWARE.
24 * Florian octo Forster <octo at collectd.org>
31 #include "utils_db_query.h"
36 struct udb_result_s; /* {{{ */
37 typedef struct udb_result_s udb_result_t;
40 char *instance_prefix;
51 struct udb_query_s /* {{{ */
56 char *plugin_instance_from;
58 unsigned int min_version;
59 unsigned int max_version;
61 udb_result_t *results;
64 struct udb_result_preparation_area_s /* {{{ */
67 size_t *instances_pos;
70 char **instances_buffer;
72 char **metadata_buffer;
73 char *plugin_instance;
75 struct udb_result_preparation_area_s *next;
77 typedef struct udb_result_preparation_area_s udb_result_preparation_area_t;
79 struct udb_query_preparation_area_s /* {{{ */
82 size_t plugin_instance_pos;
87 udb_result_preparation_area_t *result_prep_areas;
91 * Config Private functions
93 static int udb_config_add_string(char ***ret_array, /* {{{ */
94 size_t *ret_array_len, oconfig_item_t *ci) {
98 if (ci->values_num < 1) {
99 P_WARNING("The `%s' config option "
100 "needs at least one argument.",
105 for (int i = 0; i < ci->values_num; i++) {
106 if (ci->values[i].type != OCONFIG_TYPE_STRING) {
107 P_WARNING("Argument %i to the `%s' option "
114 array_len = *ret_array_len;
115 array = realloc(*ret_array, sizeof(char *) * (array_len + ci->values_num));
117 P_ERROR("udb_config_add_string: realloc failed.");
122 for (int i = 0; i < ci->values_num; i++) {
123 array[array_len] = strdup(ci->values[i].value.string);
124 if (array[array_len] == NULL) {
125 P_ERROR("udb_config_add_string: strdup failed.");
126 *ret_array_len = array_len;
132 *ret_array_len = array_len;
134 } /* }}} int udb_config_add_string */
136 static int udb_config_set_uint(unsigned int *ret_value, /* {{{ */
137 oconfig_item_t *ci) {
139 if ((ci->values_num != 1) || (ci->values[0].type != OCONFIG_TYPE_NUMBER)) {
140 P_WARNING("The `%s' config option "
141 "needs exactly one numeric argument.",
146 double tmp = ci->values[0].value.number;
147 if ((tmp < 0.0) || (tmp > ((double)UINT_MAX))) {
148 P_WARNING("The value given for the `%s` option is out of range.", ci->key);
152 *ret_value = (unsigned int)(tmp + .5);
154 } /* }}} int udb_config_set_uint */
157 * Result private functions
159 static int udb_result_submit(udb_result_t *r, /* {{{ */
160 udb_result_preparation_area_t *r_area,
161 udb_query_t const *q,
162 udb_query_preparation_area_t *q_area) {
163 value_list_t vl = VALUE_LIST_INIT;
166 assert(r_area->ds != NULL);
167 assert(((size_t)r_area->ds->ds_num) == r->values_num);
168 assert(r->values_num > 0);
170 vl.values = calloc(r->values_num, sizeof(*vl.values));
171 if (vl.values == NULL) {
172 P_ERROR("udb_result_submit: calloc failed.");
175 vl.values_len = r_area->ds->ds_num;
177 for (size_t i = 0; i < r->values_num; i++) {
178 char *value_str = r_area->values_buffer[i];
180 if (0 != parse_value(value_str, &vl.values[i], r_area->ds->ds[i].type)) {
181 P_ERROR("udb_result_submit: Parsing `%s' as %s failed.", value_str,
182 DS_TYPE_TO_STRING(r_area->ds->ds[i].type));
189 sstrncpy(vl.host, q_area->host, sizeof(vl.host));
190 sstrncpy(vl.plugin, q_area->plugin, sizeof(vl.plugin));
191 sstrncpy(vl.type, r->type, sizeof(vl.type));
193 /* Set vl.plugin_instance */
194 if (q->plugin_instance_from != NULL) {
195 sstrncpy(vl.plugin_instance, r_area->plugin_instance,
196 sizeof(vl.plugin_instance));
198 sstrncpy(vl.plugin_instance, q_area->db_name, sizeof(vl.plugin_instance));
201 /* Set vl.type_instance {{{ */
202 if (r->instances_num == 0) {
203 if (r->instance_prefix == NULL)
204 vl.type_instance[0] = 0;
206 sstrncpy(vl.type_instance, r->instance_prefix, sizeof(vl.type_instance));
207 } else /* if ((r->instances_num > 0) */
209 if (r->instance_prefix == NULL) {
210 int status = strjoin(vl.type_instance, sizeof(vl.type_instance),
211 r_area->instances_buffer, r->instances_num, "-");
214 "udb_result_submit: creating type_instance failed with status %d.",
219 char tmp[DATA_MAX_NAME_LEN];
221 int status = strjoin(tmp, sizeof(tmp), r_area->instances_buffer,
222 r->instances_num, "-");
225 "udb_result_submit: creating type_instance failed with status %d.",
229 tmp[sizeof(tmp) - 1] = 0;
231 snprintf(vl.type_instance, sizeof(vl.type_instance), "%s-%s",
232 r->instance_prefix, tmp);
235 vl.type_instance[sizeof(vl.type_instance) - 1] = 0;
238 /* Annotate meta data. {{{ */
239 if (r->metadata_num > 0) {
240 vl.meta = meta_data_create();
241 if (vl.meta == NULL) {
242 P_ERROR("udb_result_submit: meta_data_create failed.");
247 for (size_t i = 0; i < r->metadata_num; i++) {
248 int status = meta_data_add_string(vl.meta, r->metadata[i],
249 r_area->metadata_buffer[i]);
251 P_ERROR("udb_result_submit: meta_data_add_string failed.");
252 meta_data_destroy(vl.meta);
261 plugin_dispatch_values(&vl);
263 if (r->metadata_num > 0) {
264 meta_data_destroy(vl.meta);
269 } /* }}} void udb_result_submit */
271 static void udb_result_finish_result(udb_result_t const *r, /* {{{ */
272 udb_result_preparation_area_t *prep_area) {
273 if ((r == NULL) || (prep_area == NULL))
276 prep_area->ds = NULL;
277 sfree(prep_area->instances_pos);
278 sfree(prep_area->values_pos);
279 sfree(prep_area->metadata_pos);
280 sfree(prep_area->instances_buffer);
281 sfree(prep_area->values_buffer);
282 sfree(prep_area->metadata_buffer);
283 } /* }}} void udb_result_finish_result */
285 static int udb_result_handle_result(udb_result_t *r, /* {{{ */
286 udb_query_preparation_area_t *q_area,
287 udb_result_preparation_area_t *r_area,
288 udb_query_t const *q,
289 char **column_values) {
290 assert(r && q_area && r_area);
292 for (size_t i = 0; i < r->instances_num; i++)
293 r_area->instances_buffer[i] = column_values[r_area->instances_pos[i]];
295 for (size_t i = 0; i < r->values_num; i++)
296 r_area->values_buffer[i] = column_values[r_area->values_pos[i]];
298 for (size_t i = 0; i < r->metadata_num; i++)
299 r_area->metadata_buffer[i] = column_values[r_area->metadata_pos[i]];
301 if (q->plugin_instance_from)
302 r_area->plugin_instance = column_values[q_area->plugin_instance_pos];
304 return udb_result_submit(r, r_area, q, q_area);
305 } /* }}} int udb_result_handle_result */
307 static int udb_result_prepare_result(udb_result_t const *r, /* {{{ */
308 udb_result_preparation_area_t *prep_area,
309 char **column_names, size_t column_num) {
310 if ((r == NULL) || (prep_area == NULL))
314 assert(prep_area->ds == NULL);
315 assert(prep_area->instances_pos == NULL);
316 assert(prep_area->values_pos == NULL);
317 assert(prep_area->metadata_pos == NULL);
318 assert(prep_area->instances_buffer == NULL);
319 assert(prep_area->values_buffer == NULL);
320 assert(prep_area->metadata_buffer == NULL);
323 #define BAIL_OUT(status) \
324 udb_result_finish_result(r, prep_area); \
327 /* Read `ds' and check number of values {{{ */
328 prep_area->ds = plugin_get_ds(r->type);
329 if (prep_area->ds == NULL) {
330 P_ERROR("udb_result_prepare_result: Type `%s' is not "
331 "known by the daemon. See types.db(5) for details.",
336 if (prep_area->ds->ds_num != r->values_num) {
337 P_ERROR("udb_result_prepare_result: The type `%s' "
338 "requires exactly %" PRIsz
339 " value%s, but the configuration specifies %" PRIsz ".",
340 r->type, prep_area->ds->ds_num,
341 (prep_area->ds->ds_num == 1) ? "" : "s", r->values_num);
346 /* Allocate r->instances_pos, r->values_pos, r->metadata_post,
347 * r->instances_buffer, r->values_buffer, and r->metadata_buffer {{{ */
348 if (r->instances_num > 0) {
349 prep_area->instances_pos =
350 calloc(r->instances_num, sizeof(*prep_area->instances_pos));
351 if (prep_area->instances_pos == NULL) {
352 P_ERROR("udb_result_prepare_result: calloc failed.");
356 prep_area->instances_buffer =
357 calloc(r->instances_num, sizeof(*prep_area->instances_buffer));
358 if (prep_area->instances_buffer == NULL) {
359 P_ERROR("udb_result_prepare_result: calloc failed.");
362 } /* if (r->instances_num > 0) */
364 prep_area->values_pos = calloc(r->values_num, sizeof(*prep_area->values_pos));
365 if (prep_area->values_pos == NULL) {
366 P_ERROR("udb_result_prepare_result: calloc failed.");
370 prep_area->values_buffer =
371 calloc(r->values_num, sizeof(*prep_area->values_buffer));
372 if (prep_area->values_buffer == NULL) {
373 P_ERROR("udb_result_prepare_result: calloc failed.");
377 prep_area->metadata_pos =
378 calloc(r->metadata_num, sizeof(*prep_area->metadata_pos));
379 if (prep_area->metadata_pos == NULL) {
380 P_ERROR("udb_result_prepare_result: calloc failed.");
384 prep_area->metadata_buffer =
385 calloc(r->metadata_num, sizeof(*prep_area->metadata_buffer));
386 if (prep_area->metadata_buffer == NULL) {
387 P_ERROR("udb_result_prepare_result: calloc failed.");
393 /* Determine the position of the plugin instance column {{{ */
394 for (size_t i = 0; i < r->instances_num; i++) {
397 for (j = 0; j < column_num; j++) {
398 if (strcasecmp(r->instances[i], column_names[j]) == 0) {
399 prep_area->instances_pos[i] = j;
404 if (j >= column_num) {
405 P_ERROR("udb_result_prepare_result: "
406 "Column `%s' could not be found.",
410 } /* }}} for (i = 0; i < r->instances_num; i++) */
412 /* Determine the position of the value columns {{{ */
413 for (size_t i = 0; i < r->values_num; i++) {
416 for (j = 0; j < column_num; j++) {
417 if (strcasecmp(r->values[i], column_names[j]) == 0) {
418 prep_area->values_pos[i] = j;
423 if (j >= column_num) {
424 P_ERROR("udb_result_prepare_result: "
425 "Column `%s' could not be found.",
429 } /* }}} for (i = 0; i < r->values_num; i++) */
431 /* Determine the position of the metadata columns {{{ */
432 for (size_t i = 0; i < r->metadata_num; i++) {
435 for (j = 0; j < column_num; j++) {
436 if (strcasecmp(r->metadata[i], column_names[j]) == 0) {
437 prep_area->metadata_pos[i] = j;
442 if (j >= column_num) {
443 P_ERROR("udb_result_prepare_result: "
444 "Metadata column `%s' could not be found.",
448 } /* }}} for (i = 0; i < r->metadata_num; i++) */
452 } /* }}} int udb_result_prepare_result */
454 static void udb_result_free(udb_result_t *r) /* {{{ */
460 sfree(r->instance_prefix);
462 for (size_t i = 0; i < r->instances_num; i++)
463 sfree(r->instances[i]);
466 for (size_t i = 0; i < r->values_num; i++)
470 for (size_t i = 0; i < r->metadata_num; i++)
471 sfree(r->metadata[i]);
474 udb_result_free(r->next);
477 } /* }}} void udb_result_free */
479 static int udb_result_create(const char *query_name, /* {{{ */
480 udb_result_t **r_head, oconfig_item_t *ci) {
484 if (ci->values_num != 0) {
485 P_WARNING("The `Result' block doesn't accept "
486 "any arguments. Ignoring %i argument%s.",
487 ci->values_num, (ci->values_num == 1) ? "" : "s");
490 r = calloc(1, sizeof(*r));
492 P_ERROR("udb_result_create: calloc failed.");
496 r->instance_prefix = NULL;
502 /* Fill the `udb_result_t' structure.. */
504 for (int i = 0; i < ci->children_num; i++) {
505 oconfig_item_t *child = ci->children + i;
507 if (strcasecmp("Type", child->key) == 0)
508 status = cf_util_get_string(child, &r->type);
509 else if (strcasecmp("InstancePrefix", child->key) == 0)
510 status = cf_util_get_string(child, &r->instance_prefix);
511 else if (strcasecmp("InstancesFrom", child->key) == 0)
512 status = udb_config_add_string(&r->instances, &r->instances_num, child);
513 else if (strcasecmp("ValuesFrom", child->key) == 0)
514 status = udb_config_add_string(&r->values, &r->values_num, child);
515 else if (strcasecmp("MetadataFrom", child->key) == 0)
516 status = udb_config_add_string(&r->metadata, &r->metadata_num, child);
518 P_WARNING("Query `%s': Option `%s' not allowed here.", query_name,
527 /* Check that all necessary options have been given. */
528 while (status == 0) {
529 if (r->type == NULL) {
530 P_WARNING("udb_result_create: `Type' not given for "
531 "result in query `%s'",
535 if (r->values == NULL) {
536 P_WARNING("udb_result_create: `ValuesFrom' not given for "
537 "result in query `%s'",
543 } /* while (status == 0) */
550 /* If all went well, add this result to the list of results. */
551 if (*r_head == NULL) {
557 while (last->next != NULL)
564 } /* }}} int udb_result_create */
567 * Query private functions
569 static void udb_query_free_one(udb_query_t *q) /* {{{ */
576 sfree(q->plugin_instance_from);
578 udb_result_free(q->results);
581 } /* }}} void udb_query_free_one */
584 * Query public functions
586 int udb_query_create(udb_query_t ***ret_query_list, /* {{{ */
587 size_t *ret_query_list_len, oconfig_item_t *ci,
588 udb_query_create_callback_t cb) {
589 udb_query_t **query_list;
590 size_t query_list_len;
595 if ((ret_query_list == NULL) || (ret_query_list_len == NULL))
597 query_list = *ret_query_list;
598 query_list_len = *ret_query_list_len;
600 if ((ci->values_num != 1) || (ci->values[0].type != OCONFIG_TYPE_STRING)) {
601 P_WARNING("udb_result_create: The `Query' block "
602 "needs exactly one string argument.");
606 q = calloc(1, sizeof(*q));
608 P_ERROR("udb_query_create: calloc failed.");
612 q->max_version = UINT_MAX;
615 q->plugin_instance_from = NULL;
617 status = cf_util_get_string(ci, &q->name);
623 /* Fill the `udb_query_t' structure.. */
624 for (int i = 0; i < ci->children_num; i++) {
625 oconfig_item_t *child = ci->children + i;
627 if (strcasecmp("Statement", child->key) == 0)
628 status = cf_util_get_string(child, &q->statement);
629 else if (strcasecmp("Result", child->key) == 0)
630 status = udb_result_create(q->name, &q->results, child);
631 else if (strcasecmp("MinVersion", child->key) == 0)
632 status = udb_config_set_uint(&q->min_version, child);
633 else if (strcasecmp("MaxVersion", child->key) == 0)
634 status = udb_config_set_uint(&q->max_version, child);
635 else if (strcasecmp("PluginInstanceFrom", child->key) == 0)
636 status = cf_util_get_string(child, &q->plugin_instance_from);
638 /* Call custom callbacks */
639 else if (cb != NULL) {
640 status = (*cb)(q, child);
642 P_WARNING("The configuration callback failed "
647 P_WARNING("Query `%s': Option `%s' not allowed here.", q->name,
656 /* Check that all necessary options have been given. */
658 if (q->statement == NULL) {
659 P_WARNING("Query `%s': No `Statement' given.", q->name);
662 if (q->results == NULL) {
663 P_WARNING("Query `%s': No (valid) `Result' block given.", q->name);
666 } /* if (status == 0) */
668 /* If all went well, add this query to the list of queries within the
669 * database structure. */
673 temp = realloc(query_list, sizeof(*query_list) * (query_list_len + 1));
675 P_ERROR("udb_query_create: realloc failed");
679 query_list[query_list_len] = q;
685 udb_query_free_one(q);
689 *ret_query_list = query_list;
690 *ret_query_list_len = query_list_len;
693 } /* }}} int udb_query_create */
695 void udb_query_free(udb_query_t **query_list, size_t query_list_len) /* {{{ */
697 if (query_list == NULL)
700 for (size_t i = 0; i < query_list_len; i++)
701 udb_query_free_one(query_list[i]);
704 } /* }}} void udb_query_free */
706 int udb_query_pick_from_list_by_name(const char *name, /* {{{ */
707 udb_query_t **src_list,
709 udb_query_t ***dst_list,
710 size_t *dst_list_len) {
713 if ((name == NULL) || (src_list == NULL) || (dst_list == NULL) ||
714 (dst_list_len == NULL)) {
715 P_ERROR("udb_query_pick_from_list_by_name: "
716 "Invalid argument.");
721 for (size_t i = 0; i < src_list_len; i++) {
722 udb_query_t **tmp_list;
725 if (strcasecmp(name, src_list[i]->name) != 0)
728 tmp_list_len = *dst_list_len;
729 tmp_list = realloc(*dst_list, (tmp_list_len + 1) * sizeof(udb_query_t *));
730 if (tmp_list == NULL) {
731 P_ERROR("udb_query_pick_from_list_by_name: realloc failed.");
735 tmp_list[tmp_list_len] = src_list[i];
738 *dst_list = tmp_list;
739 *dst_list_len = tmp_list_len;
742 } /* for (i = 0; i < src_list_len; i++) */
744 if (num_added <= 0) {
745 P_ERROR("Cannot find query `%s'. Make sure the <Query> "
746 "block is above the database definition!",
750 DEBUG("Added %i versions of query `%s'.", num_added, name);
754 } /* }}} int udb_query_pick_from_list_by_name */
756 int udb_query_pick_from_list(oconfig_item_t *ci, /* {{{ */
757 udb_query_t **src_list, size_t src_list_len,
758 udb_query_t ***dst_list, size_t *dst_list_len) {
761 if ((ci == NULL) || (src_list == NULL) || (dst_list == NULL) ||
762 (dst_list_len == NULL)) {
763 P_ERROR("udb_query_pick_from_list: "
764 "Invalid argument.");
768 if ((ci->values_num != 1) || (ci->values[0].type != OCONFIG_TYPE_STRING)) {
769 P_ERROR("The `%s' config option "
770 "needs exactly one string argument.",
774 name = ci->values[0].value.string;
776 return udb_query_pick_from_list_by_name(name, src_list, src_list_len,
777 dst_list, dst_list_len);
778 } /* }}} int udb_query_pick_from_list */
780 const char *udb_query_get_name(udb_query_t *q) /* {{{ */
786 } /* }}} const char *udb_query_get_name */
788 const char *udb_query_get_statement(udb_query_t *q) /* {{{ */
794 } /* }}} const char *udb_query_get_statement */
796 void udb_query_set_user_data(udb_query_t *q, void *user_data) /* {{{ */
801 q->user_data = user_data;
802 } /* }}} void udb_query_set_user_data */
804 void *udb_query_get_user_data(udb_query_t *q) /* {{{ */
810 } /* }}} void *udb_query_get_user_data */
812 int udb_query_check_version(udb_query_t *q, unsigned int version) /* {{{ */
817 if ((version < q->min_version) || (version > q->max_version))
821 } /* }}} int udb_query_check_version */
823 void udb_query_finish_result(udb_query_t const *q, /* {{{ */
824 udb_query_preparation_area_t *prep_area) {
825 udb_result_preparation_area_t *r_area;
828 if ((q == NULL) || (prep_area == NULL))
831 prep_area->column_num = 0;
832 sfree(prep_area->host);
833 sfree(prep_area->plugin);
834 sfree(prep_area->db_name);
836 for (r = q->results, r_area = prep_area->result_prep_areas; r != NULL;
837 r = r->next, r_area = r_area->next) {
838 /* this may happen during error conditions of the caller */
841 udb_result_finish_result(r, r_area);
843 } /* }}} void udb_query_finish_result */
845 int udb_query_handle_result(udb_query_t const *q, /* {{{ */
846 udb_query_preparation_area_t *prep_area,
847 char **column_values) {
848 udb_result_preparation_area_t *r_area;
853 if ((q == NULL) || (prep_area == NULL))
856 if ((prep_area->column_num < 1) || (prep_area->host == NULL) ||
857 (prep_area->plugin == NULL) || (prep_area->db_name == NULL)) {
858 P_ERROR("Query `%s': Query is not prepared; "
859 "can't handle result.",
864 #if defined(COLLECT_DEBUG) && COLLECT_DEBUG /* {{{ */
866 for (size_t i = 0; i < prep_area->column_num; i++) {
867 DEBUG("udb_query_handle_result (%s, %s): "
868 "column[%" PRIsz "] = %s;",
869 prep_area->db_name, q->name, i, column_values[i]);
875 for (r = q->results, r_area = prep_area->result_prep_areas; r != NULL;
876 r = r->next, r_area = r_area->next) {
877 status = udb_result_handle_result(r, prep_area, r_area, q, column_values);
883 P_ERROR("udb_query_handle_result (%s, %s): "
884 "All results failed.",
885 prep_area->db_name, q->name);
890 } /* }}} int udb_query_handle_result */
892 int udb_query_prepare_result(udb_query_t const *q, /* {{{ */
893 udb_query_preparation_area_t *prep_area,
894 const char *host, const char *plugin,
895 const char *db_name, char **column_names,
897 udb_result_preparation_area_t *r_area;
901 if ((q == NULL) || (prep_area == NULL))
905 assert(prep_area->column_num == 0);
906 assert(prep_area->host == NULL);
907 assert(prep_area->plugin == NULL);
908 assert(prep_area->db_name == NULL);
911 prep_area->column_num = column_num;
912 prep_area->host = strdup(host);
913 prep_area->plugin = strdup(plugin);
914 prep_area->db_name = strdup(db_name);
916 if ((prep_area->host == NULL) || (prep_area->plugin == NULL) ||
917 (prep_area->db_name == NULL)) {
918 P_ERROR("Query `%s': Prepare failed: Out of memory.", q->name);
919 udb_query_finish_result(q, prep_area);
923 #if defined(COLLECT_DEBUG) && COLLECT_DEBUG
925 for (size_t i = 0; i < column_num; i++) {
926 DEBUG("udb_query_prepare_result: "
927 "query = %s; column[%" PRIsz "] = %s;",
928 q->name, i, column_names[i]);
933 /* Determine the position of the PluginInstance column {{{ */
934 if (q->plugin_instance_from != NULL) {
937 for (i = 0; i < column_num; i++) {
938 if (strcasecmp(q->plugin_instance_from, column_names[i]) == 0) {
939 prep_area->plugin_instance_pos = i;
944 if (i >= column_num) {
945 P_ERROR("udb_query_prepare_result: "
946 "Column `%s' from `PluginInstanceFrom' could not be found.",
947 q->plugin_instance_from);
948 udb_query_finish_result(q, prep_area);
954 for (r = q->results, r_area = prep_area->result_prep_areas; r != NULL;
955 r = r->next, r_area = r_area->next) {
957 P_ERROR("Query `%s': Invalid number of result "
958 "preparation areas.",
960 udb_query_finish_result(q, prep_area);
964 status = udb_result_prepare_result(r, r_area, column_names, column_num);
966 udb_query_finish_result(q, prep_area);
972 } /* }}} int udb_query_prepare_result */
974 udb_query_preparation_area_t *
975 udb_query_allocate_preparation_area(udb_query_t *q) /* {{{ */
977 udb_query_preparation_area_t *q_area;
978 udb_result_preparation_area_t **next_r_area;
981 q_area = calloc(1, sizeof(*q_area));
985 next_r_area = &q_area->result_prep_areas;
986 for (r = q->results; r != NULL; r = r->next) {
987 udb_result_preparation_area_t *r_area;
989 r_area = calloc(1, sizeof(*r_area));
990 if (r_area == NULL) {
991 udb_result_preparation_area_t *a = q_area->result_prep_areas;
994 udb_result_preparation_area_t *next = a->next;
1003 *next_r_area = r_area;
1004 next_r_area = &r_area->next;
1008 } /* }}} udb_query_preparation_area_t *udb_query_allocate_preparation_area */
1010 void udb_query_delete_preparation_area(
1011 udb_query_preparation_area_t *q_area) /* {{{ */
1013 udb_result_preparation_area_t *r_area;
1018 r_area = q_area->result_prep_areas;
1019 while (r_area != NULL) {
1020 udb_result_preparation_area_t *area = r_area;
1022 r_area = r_area->next;
1024 sfree(area->instances_pos);
1025 sfree(area->values_pos);
1026 sfree(area->instances_buffer);
1027 sfree(area->values_buffer);
1031 sfree(q_area->host);
1032 sfree(q_area->plugin);
1033 sfree(q_area->db_name);
1036 } /* }}} void udb_query_delete_preparation_area */