0b71e15e1fdf897ba2a8e477533092c7ff3eebea
1 /**
2 * collection4 - graph_instance.c
3 * Copyright (C) 2010 Florian octo Forster
4 *
5 * This program is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU Lesser General Public
7 * License as published by the Free Software Foundation; either
8 * version 2.1 of the License, or (at your option) any later version.
9 *
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * Lesser General Public License for more details.
14 *
15 * You should have received a copy of the GNU Lesser General Public
16 * License along with this program; if not, write to the Free Software
17 * Foundation, Inc., 51 Franklin Street, Fifth Floor,
18 * Boston, MA 02110-1301 USA
19 *
20 * Authors:
21 * Florian octo Forster <ff at octo.it>
22 **/
24 #include <stdlib.h>
25 #include <string.h>
26 #include <errno.h>
27 #include <time.h>
28 #include <assert.h>
30 #include "graph_instance.h"
31 #include "graph.h"
32 #include "graph_def.h"
33 #include "graph_ident.h"
34 #include "graph_list.h"
35 #include "common.h"
36 #include "utils_cgi.h"
38 #include <fcgiapp.h>
39 #include <fcgi_stdio.h>
41 struct graph_instance_s /* {{{ */
42 {
43 graph_ident_t *select;
45 graph_ident_t **files;
46 size_t files_num;
47 }; /* }}} struct graph_instance_s */
49 struct def_callback_data_s
50 {
51 graph_instance_t *inst;
52 rrd_args_t *args;
53 };
54 typedef struct def_callback_data_s def_callback_data_t;
56 /*
57 * Private functions
58 */
59 /* Create one DEF for each data source in the file. Called by
60 * "inst_get_default_defs" for each file. */
61 static graph_def_t *ident_get_default_defs (graph_config_t *cfg, /* {{{ */
62 graph_ident_t *ident, graph_def_t *def_head)
63 {
64 graph_def_t *defs = NULL;
65 char *file;
66 char **dses = NULL;
67 size_t dses_num = 0;
68 int status;
69 size_t i;
71 if ((cfg == NULL) || (ident == NULL))
72 return (def_head);
74 file = ident_to_file (ident);
75 if (file == NULL)
76 {
77 fprintf (stderr, "ident_get_default_defs: ident_to_file failed\n");
78 return (def_head);
79 }
81 status = ds_list_from_rrd_file (file, &dses_num, &dses);
82 if (status != 0)
83 {
84 free (file);
85 return (def_head);
86 }
88 for (i = 0; i < dses_num; i++)
89 {
90 graph_def_t *def;
92 def = def_search (def_head, ident, dses[i]);
93 if (def != NULL)
94 continue;
96 def = def_create (cfg, ident, dses[i]);
97 if (def == NULL)
98 continue;
100 if (defs == NULL)
101 defs = def;
102 else
103 def_append (defs, def);
105 free (dses[i]);
106 }
108 free (dses);
109 free (file);
111 return (defs);
112 } /* }}} int ident_get_default_defs */
114 /* Create one or more DEFs for each file in the graph instance. The number
115 * depends on the number of data sources in each of the files. Called from
116 * "inst_get_rrdargs" if no DEFs are available from the configuration.
117 * */
118 static graph_def_t *inst_get_default_defs (graph_config_t *cfg, /* {{{ */
119 graph_instance_t *inst)
120 {
121 graph_def_t *defs = NULL;
122 size_t i;
124 if ((cfg == NULL) || (inst == NULL))
125 return (NULL);
127 for (i = 0; i < inst->files_num; i++)
128 {
129 graph_def_t *def;
131 def = ident_get_default_defs (cfg, inst->files[i], defs);
132 if (def == NULL)
133 continue;
135 if (defs == NULL)
136 defs = def;
137 else
138 def_append (defs, def);
139 }
141 return (defs);
142 } /* }}} graph_def_t *inst_get_default_defs */
144 /* Called with each DEF in turn. Calls "def_get_rrdargs" with every appropriate
145 * file / DEF pair. */
146 static int gl_instance_get_rrdargs_cb (graph_def_t *def, void *user_data) /* {{{ */
147 {
148 def_callback_data_t *data = user_data;
149 graph_instance_t *inst = data->inst;
150 rrd_args_t *args = data->args;
152 size_t i;
154 for (i = 0; i < inst->files_num; i++)
155 {
156 if (!def_matches (def, inst->files[i]))
157 continue;
159 def_get_rrdargs (def, inst->files[i], args);
160 }
162 return (0);
163 } /* }}} int gl_instance_get_rrdargs_cb */
165 static const char *get_part_from_param (const char *prim_key, /* {{{ */
166 const char *sec_key)
167 {
168 const char *val;
170 val = param (prim_key);
171 if (val != NULL)
172 return (val);
174 return (param (sec_key));
175 } /* }}} const char *get_part_from_param */
177 static graph_ident_t *inst_get_selector_from_params (void) /* {{{ */
178 {
179 const char *host = get_part_from_param ("inst_host", "host");
180 const char *plugin = get_part_from_param ("inst_plugin", "plugin");
181 const char *plugin_instance = get_part_from_param ("inst_plugin_instance",
182 "plugin_instance");
183 const char *type = get_part_from_param ("inst_type", "type");
184 const char *type_instance = get_part_from_param ("inst_type_instance",
185 "type_instance");
187 graph_ident_t *ident;
189 if ((host == NULL)
190 || (plugin == NULL) || (plugin_instance == NULL)
191 || (type == NULL) || (type_instance == NULL))
192 {
193 fprintf (stderr, "inst_get_selected: A parameter is NULL\n");
194 return (NULL);
195 }
197 ident = ident_create (host, plugin, plugin_instance, type, type_instance);
198 if (ident == NULL)
199 {
200 fprintf (stderr, "inst_get_selected: ident_create failed\n");
201 return (NULL);
202 }
204 return (ident);
205 } /* }}} graph_ident_t *inst_get_selector_from_params */
207 /*
208 * Public functions
209 */
210 graph_instance_t *inst_create (graph_config_t *cfg, /* {{{ */
211 const graph_ident_t *ident)
212 {
213 graph_instance_t *i;
214 graph_ident_t *selector;
216 if ((cfg == NULL) || (ident == NULL))
217 return (NULL);
219 i = malloc (sizeof (*i));
220 if (i == NULL)
221 return (NULL);
222 memset (i, 0, sizeof (*i));
224 selector = graph_get_selector (cfg);
225 if (selector == NULL)
226 {
227 fprintf (stderr, "inst_create: graph_get_selector failed\n");
228 free (i);
229 return (NULL);
230 }
232 i->select = ident_copy_with_selector (selector, ident,
233 IDENT_FLAG_REPLACE_ANY);
234 if (i->select == NULL)
235 {
236 fprintf (stderr, "inst_create: ident_copy_with_selector failed\n");
237 ident_destroy (selector);
238 free (i);
239 return (NULL);
240 }
242 ident_destroy (selector);
244 i->files = NULL;
245 i->files_num = 0;
247 return (i);
248 } /* }}} graph_instance_t *inst_create */
250 void inst_destroy (graph_instance_t *inst) /* {{{ */
251 {
252 size_t i;
254 if (inst == NULL)
255 return;
257 ident_destroy (inst->select);
259 for (i = 0; i < inst->files_num; i++)
260 ident_destroy (inst->files[i]);
261 free (inst->files);
263 free (inst);
264 } /* }}} void inst_destroy */
266 int inst_add_file (graph_instance_t *inst, /* {{{ */
267 const graph_ident_t *file)
268 {
269 graph_ident_t **tmp;
271 tmp = realloc (inst->files, sizeof (*inst->files) * (inst->files_num + 1));
272 if (tmp == NULL)
273 return (ENOMEM);
274 inst->files = tmp;
276 inst->files[inst->files_num] = ident_clone (file);
277 if (inst->files[inst->files_num] == NULL)
278 return (ENOMEM);
280 inst->files_num++;
282 return (0);
283 } /* }}} int inst_add_file */
285 graph_instance_t *inst_get_selected (graph_config_t *cfg) /* {{{ */
286 {
287 graph_ident_t *ident;
288 graph_instance_t *inst;
290 if (cfg == NULL)
291 cfg = gl_graph_get_selected ();
293 if (cfg == NULL)
294 {
295 DEBUG ("inst_get_selected: cfg == NULL;\n");
296 return (NULL);
297 }
299 ident = inst_get_selector_from_params ();
300 if (ident == NULL)
301 {
302 fprintf (stderr, "inst_get_selected: ident_create failed\n");
303 return (NULL);
304 }
306 inst = graph_inst_find_exact (cfg, ident);
308 ident_destroy (ident);
309 return (inst);
310 } /* }}} graph_instance_t *inst_get_selected */
312 int inst_get_all_selected (graph_config_t *cfg, /* {{{ */
313 graph_inst_callback_t callback, void *user_data)
314 {
315 graph_ident_t *ident;
316 int status;
318 if ((cfg == NULL) || (callback == NULL))
319 return (EINVAL);
321 ident = inst_get_selector_from_params ();
322 if (ident == NULL)
323 {
324 fprintf (stderr, "inst_get_all_selected: "
325 "inst_get_selector_from_params failed\n");
326 return (EINVAL);
327 }
329 status = graph_inst_find_all_matching (cfg, ident, callback, user_data);
331 ident_destroy (ident);
332 return (status);
333 } /* }}} int inst_get_all_selected */
335 int inst_get_rrdargs (graph_config_t *cfg, /* {{{ */
336 graph_instance_t *inst,
337 rrd_args_t *args)
338 {
339 def_callback_data_t data = { inst, args };
340 graph_def_t *defs;
341 int status;
343 if ((cfg == NULL) || (inst == NULL) || (args == NULL))
344 return (EINVAL);
346 status = graph_get_rrdargs (cfg, inst, args);
347 if (status != 0)
348 return (status);
350 defs = graph_get_defs (cfg);
351 if (defs == NULL)
352 {
353 defs = inst_get_default_defs (cfg, inst);
355 if (defs == NULL)
356 return (-1);
358 status = def_foreach (defs, gl_instance_get_rrdargs_cb, &data);
360 def_destroy (defs);
361 }
362 else
363 {
364 status = def_foreach (defs, gl_instance_get_rrdargs_cb, &data);
365 }
367 return (status);
368 } /* }}} int inst_get_rrdargs */
370 graph_ident_t *inst_get_selector (graph_instance_t *inst) /* {{{ */
371 {
372 if (inst == NULL)
373 return (NULL);
375 return (ident_clone (inst->select));
376 } /* }}} graph_ident_t *inst_get_selector */
378 int inst_get_params (graph_config_t *cfg, graph_instance_t *inst, /* {{{ */
379 char *buffer, size_t buffer_size)
380 {
381 graph_ident_t *cfg_select;
383 if ((cfg == NULL) || (inst == NULL)
384 || (buffer == NULL) || (buffer_size < 1))
385 return (EINVAL);
387 cfg_select = graph_get_selector (cfg);
388 if (cfg_select == NULL)
389 {
390 fprintf (stderr, "inst_get_params: graph_get_selector failed");
391 return (-1);
392 }
394 buffer[0] = 0;
396 #define COPY_FIELD(field) do { \
397 const char *cfg_f = ident_get_##field (cfg_select); \
398 const char *inst_f = ident_get_##field (inst->select); \
399 if (strcmp (cfg_f, inst_f) == 0) \
400 { \
401 strlcat (buffer, #field, buffer_size); \
402 strlcat (buffer, "=", buffer_size); \
403 strlcat (buffer, cfg_f, buffer_size); \
404 } \
405 else \
406 { \
407 strlcat (buffer, "graph_", buffer_size); \
408 strlcat (buffer, #field, buffer_size); \
409 strlcat (buffer, "=", buffer_size); \
410 strlcat (buffer, cfg_f, buffer_size); \
411 strlcat (buffer, ";", buffer_size); \
412 strlcat (buffer, "inst_", buffer_size); \
413 strlcat (buffer, #field, buffer_size); \
414 strlcat (buffer, "=", buffer_size); \
415 strlcat (buffer, inst_f, buffer_size); \
416 } \
417 } while (0)
419 COPY_FIELD(host);
420 strlcat (buffer, ";", buffer_size);
421 COPY_FIELD(plugin);
422 strlcat (buffer, ";", buffer_size);
423 COPY_FIELD(plugin_instance);
424 strlcat (buffer, ";", buffer_size);
425 COPY_FIELD(type);
426 strlcat (buffer, ";", buffer_size);
427 COPY_FIELD(type_instance);
429 #undef COPY_FIELD
431 ident_destroy (cfg_select);
433 return (0);
434 } /* }}} int inst_get_params */
436 int inst_compare_ident (graph_instance_t *inst, /* {{{ */
437 const graph_ident_t *ident)
438 {
439 if ((inst == NULL) || (ident == NULL))
440 return (0);
442 return (ident_compare (inst->select, ident));
443 } /* }}} int inst_compare_ident */
445 _Bool inst_ident_matches (graph_instance_t *inst, /* {{{ */
446 const graph_ident_t *ident)
447 {
448 #if C4_DEBUG
449 if ((inst == NULL) || (ident == NULL))
450 return (0);
451 #endif
453 return (ident_matches (inst->select, ident));
454 } /* }}} _Bool inst_ident_matches */
456 _Bool inst_matches_ident (graph_instance_t *inst, /* {{{ */
457 const graph_ident_t *ident)
458 {
459 if ((inst == NULL) || (ident == NULL))
460 return (0);
462 return (ident_matches (ident, inst->select));
463 } /* }}} _Bool inst_matches_ident */
465 _Bool inst_matches_string (graph_config_t *cfg, /* {{{ */
466 graph_instance_t *inst,
467 const char *term)
468 {
469 char buffer[1024];
470 int status;
472 if ((cfg == NULL) || (inst == NULL) || (term == NULL))
473 return (0);
475 status = inst_describe (cfg, inst, buffer, sizeof (buffer));
476 if (status != 0)
477 {
478 fprintf (stderr, "inst_matches_string: inst_describe failed\n");
479 return (status);
480 }
482 strtolower (buffer);
484 /* no match */
485 if (strstr (buffer, term) == NULL)
486 return (0);
488 return (1);
489 } /* }}} _Bool inst_matches_string */
491 _Bool inst_matches_field (graph_instance_t *inst, /* {{{ */
492 graph_ident_field_t field, const char *field_value)
493 {
494 const char *selector_field;
495 size_t i;
497 if ((inst == NULL) || (field_value == NULL))
498 return (0);
500 selector_field = ident_get_field (inst->select, field);
501 if (selector_field == NULL)
502 return (0);
504 assert (!IS_ANY (selector_field));
505 if (!IS_ALL (selector_field))
506 {
507 if (strcasecmp (selector_field, field_value) == 0)
508 return (1);
509 else
510 return (0);
511 }
513 /* The selector field is an ALL selector
514 * => we need to check the files to see if the instance matches. */
515 for (i = 0; i < inst->files_num; i++)
516 {
517 selector_field = ident_get_field (inst->files[i], field);
518 if (selector_field == NULL)
519 continue;
521 assert (!IS_ANY (selector_field));
522 assert (!IS_ALL (selector_field));
524 if (strcasecmp (selector_field, field_value) == 0)
525 return (1);
526 } /* for files */
528 return (0);
529 } /* }}} _Bool inst_matches_field */
531 int inst_describe (graph_config_t *cfg, graph_instance_t *inst, /* {{{ */
532 char *buffer, size_t buffer_size)
533 {
534 graph_ident_t *cfg_select;
536 if ((cfg == NULL) || (inst == NULL)
537 || (buffer == NULL) || (buffer_size < 2))
538 return (EINVAL);
540 cfg_select = graph_get_selector (cfg);
541 if (cfg_select == NULL)
542 {
543 fprintf (stderr, "inst_describe: graph_get_selector failed\n");
544 return (-1);
545 }
547 buffer[0] = 0;
549 #define CHECK_FIELD(field) do { \
550 if (IS_ANY (ident_get_##field (cfg_select))) \
551 { \
552 if (buffer[0] != 0) \
553 strlcat (buffer, "/", buffer_size); \
554 strlcat (buffer, ident_get_##field (inst->select), buffer_size); \
555 } \
556 } while (0)
558 CHECK_FIELD (host);
559 CHECK_FIELD (plugin);
560 CHECK_FIELD (plugin_instance);
561 CHECK_FIELD (type);
562 CHECK_FIELD (type_instance);
564 #undef CHECK_FIELD
566 if (buffer[0] == 0)
567 strlcat (buffer, "default", buffer_size);
569 ident_destroy (cfg_select);
571 return (0);
572 } /* }}} int inst_describe */
574 time_t inst_get_mtime (graph_instance_t *inst) /* {{{ */
575 {
576 size_t i;
577 time_t mtime;
579 if (inst == NULL)
580 return (0);
582 mtime = 0;
583 for (i = 0; i < inst->files_num; i++)
584 {
585 time_t tmp;
587 tmp = ident_get_mtime (inst->files[i]);
588 if (mtime < tmp)
589 mtime = tmp;
590 }
592 return (mtime);
593 } /* }}} time_t inst_get_mtime */
595 /* vim: set sw=2 sts=2 et fdm=marker : */