1 /****************************************************************************
2 * RRDtool 1.2.11 Copyright by Tobi Oetiker, 1997-2005
3 ****************************************************************************
4 * rrd_graph_helper.c commandline parser functions
5 * this code initially written by Alex van den Bogaerdt
6 ****************************************************************************/
10 #define dprintf if (gdp->debug) printf
12 /* Define prototypes for the parsing methods.
14 char *line - pointer to base of input source
15 unsigned int eaten - index to next input character (INPUT/OUTPUT)
16 graph_desc_t *gdp - pointer to a graph description
17 image_desc_t *im - pointer to an image description
20 int rrd_parse_find_gf (char *, unsigned int *, graph_desc_t *);
21 int rrd_parse_legend (char *, unsigned int *, graph_desc_t *);
22 int rrd_parse_color (char *, graph_desc_t *);
23 int rrd_parse_CF (char *, unsigned int *, graph_desc_t *, enum cf_en *);
24 int rrd_parse_print (char *, unsigned int *, graph_desc_t *, image_desc_t *);
25 int rrd_parse_shift (char *, unsigned int *, graph_desc_t *, image_desc_t *);
26 int rrd_parse_xport (char *, unsigned int *, graph_desc_t *, image_desc_t *);
27 int rrd_parse_PVHLAST (char *, unsigned int *, graph_desc_t *, image_desc_t *);
28 int rrd_parse_vname (char *, unsigned int *, graph_desc_t *, image_desc_t *);
29 int rrd_parse_def (char *, unsigned int *, graph_desc_t *, image_desc_t *);
30 int rrd_parse_vdef (char *, unsigned int *, graph_desc_t *, image_desc_t *);
31 int rrd_parse_cdef (char *, unsigned int *, graph_desc_t *, image_desc_t *);
36 rrd_parse_find_gf(char *line, unsigned int *eaten, graph_desc_t *gdp) {
37 char funcname[11],c1=0;
40 /* start an argument with DEBUG to be able to see how it is parsed */
41 sscanf(&line[*eaten], "DEBUG%n", &i);
46 dprintf("Scanning line '%s'\n",&line[*eaten]);
48 sscanf(&line[*eaten], "%10[A-Z]%n%c", funcname, &i, &c1);
50 rrd_set_error("Could not make sense out of '%s'",line);
53 if ((int)(gdp->gf=gf_conv(funcname)) == -1) {
54 rrd_set_error("'%s' is not a valid function name", funcname);
57 dprintf("- found function name '%s'\n",funcname);
60 if (gdp->gf == GF_LINE) {
63 dprintf("- - using default width of 1\n");
67 if (sscanf(&line[*eaten],"%lf%n:",&width,&i)) {
68 if (width < 0 || isnan(width) || isinf(width) ) {
69 rrd_set_error("LINE width is %lf. It must be finite and >= 0 though",width);
73 dprintf("- - using width %f\n",width);
75 rrd_set_error("LINE width: %s",line);
81 rrd_set_error("Malformed %s command: %s",funcname,line);
90 rrd_parse_legend(char *line, unsigned int *eaten, graph_desc_t *gdp) {
93 if (line[*eaten]=='\0' || line[*eaten]==':') {
94 dprintf("- no (or: empty) legend found\n");
98 i=scan_for_col(&line[*eaten],FMT_LEG_LEN,gdp->legend);
102 if (line[*eaten]!='\0' && line[*eaten]!=':') {
103 rrd_set_error("Legend too long");
111 rrd_parse_color(char *string, graph_desc_t *gdp) {
112 unsigned int r=0,g=0,b=0,a=0,i;
114 /* matches the following formats:
122 while (string[i] && isxdigit((unsigned int)string[i])) i++;
123 if (string[i] != '\0') return 1; /* garbage follows hexdigits */
127 sscanf(string, "%1x%1x%1x%1x",&r,&g,&b,&a);
136 sscanf(string, "%02x%02x%02x%02x",&r,&g,&b,&a);
140 return 1; /* wrong number of digits */
142 gdp->col = r<<24|g<<16|b<<8|a;
147 rrd_parse_CF(char *line, unsigned int *eaten, graph_desc_t *gdp, enum cf_en *cf) {
148 char symname[CF_NAM_SIZE];
151 sscanf(&line[*eaten], CF_NAM_FMT "%n", symname,&i);
152 if ((!i)||((line[(*eaten)+i]!='\0')&&(line[(*eaten)+i]!=':'))) {
153 rrd_set_error("Cannot parse CF in '%s'",line);
157 dprintf("- using CF '%s'\n",symname);
159 if ((int)(*cf = cf_conv(symname))==-1) {
160 rrd_set_error("Unknown CF '%s' in '%s'",symname,line);
164 if (line[*eaten]!='\0') (*eaten)++;
168 /* Parsing old-style xPRINT and new-style xPRINT */
170 rrd_parse_print(char *line, unsigned int *eaten, graph_desc_t *gdp, image_desc_t *im) {
171 /* vname:CF:format in case of DEF-based vname
172 ** vname:CF:format in case of CDEF-based vname
173 ** vname:format in case of VDEF-based vname
175 char tmpstr[MAX_VNAME_LEN+1];
178 sscanf(&line[*eaten], DEF_NAM_FMT ":%n", tmpstr,&i);
180 rrd_set_error("Could not parse line '%s'",line);
184 dprintf("- Found candidate vname '%s'\n",tmpstr);
186 if ((gdp->vidx=find_var(im,tmpstr))<0) {
187 rrd_set_error("Not a valid vname: %s in line %s",tmpstr,line);
190 switch (im->gdes[gdp->vidx].gf) {
193 dprintf("- vname is of type DEF or CDEF, looking for CF\n");
194 if (rrd_parse_CF(line,eaten,gdp,&gdp->cf)) return 1;
197 dprintf("- vname is of type VDEF\n");
200 rrd_set_error("Encountered unknown type variable '%s'",tmpstr);
204 if (rrd_parse_legend(line,eaten,gdp)) return 1;
205 /* for *PRINT the legend itself gets rendered later. We only
206 get the format at this juncture */
207 strcpy(gdp->format,gdp->legend);
213 rrd_parse_shift(char *line, unsigned int *eaten, graph_desc_t *gdp, image_desc_t *im) {
214 char *l = strdup(line + *eaten), *p;
219 rrd_set_error("Invalid SHIFT syntax");
224 if ((gdp->vidx=find_var(im,l))<0) {
225 rrd_set_error("Not a valid vname: %s in line %s",l,line);
229 /* constant will parse; otherwise, must be VDEF reference */
230 if (sscanf(p, "%ld", &gdp->shval) != 1) {
233 if ((gdp->shidx=find_var(im, p))<0) {
234 rrd_set_error("invalid offset vname: %s", p);
238 vdp = &im->gdes[gdp->shidx];
239 if (vdp->gf != GF_VDEF) {
240 rrd_set_error("offset must specify value or VDEF");
247 *eaten = strlen(line);
256 rrd_parse_xport(char *line, unsigned int *eaten, graph_desc_t *gdp, image_desc_t *im) {
257 char *l = strdup(line + *eaten), *p;
266 if ((gdp->vidx=find_var(im, l))==-1){
267 rrd_set_error("unknown variable '%s'",l);
271 if (strlen(p) >= FMT_LEG_LEN)
272 *(p + FMT_LEG_LEN) = '\0';
274 strcpy(gdp->legend, p);
275 *eaten = strlen(line);
283 /* Parsing of PART, VRULE, HRULE, LINE, AREA, STACK and TICK
284 ** is done in one function.
286 ** Stacking PART, VRULE, HRULE or TICK is not allowed.
288 ** If a number (which is valid to enter) is more than a
289 ** certain amount of characters, it is caught as an error.
290 ** While this is arguable, so is entering fixed numbers
291 ** with more than MAX_VNAME_LEN significant digits.
294 rrd_parse_PVHLAST(char *line, unsigned int *eaten, graph_desc_t *gdp, image_desc_t *im) {
297 char tmpstr[MAX_VNAME_LEN + 10]; /* vname#RRGGBBAA\0 */
298 static int spacecnt = 0;
301 float one_space = gfx_get_text_width(im->canvas, 0,
302 im->text_prop[TEXT_PROP_LEGEND].font,
303 im->text_prop[TEXT_PROP_LEGEND].size,
304 im->tabwidth," ", 0) / 4.0;
305 float target_space = gfx_get_text_width(im->canvas, 0,
306 im->text_prop[TEXT_PROP_LEGEND].font,
307 im->text_prop[TEXT_PROP_LEGEND].size,
308 im->tabwidth,"oo", 0);
309 spacecnt = target_space / one_space;
310 dprintf("- spacecnt: %i onespace: %f targspace: %f\n",spacecnt,one_space,target_space);
314 dprintf("- parsing '%s'\n",&line[*eaten]);
316 /* have simpler code in the drawing section */
317 if ( gdp->gf == GF_STACK ){
321 i=scan_for_col(&line[*eaten],MAX_VNAME_LEN+9,tmpstr);
322 if (line[*eaten+i]!='\0' && line[*eaten+i]!=':') {
323 rrd_set_error("Cannot parse line '%s'",line);
327 j=i; while (j>0 && tmpstr[j]!='#') j--;
334 * It is a number only if "k" equals either "j" or "i",
335 * depending on which is appropriate
337 dprintf("- examining value '%s'\n",tmpstr);
339 if (gdp->gf == GF_VRULE) {
340 sscanf(tmpstr,"%li%n",&gdp->xrule,&k);
341 if (((j!=0)&&(k==j))||((j==0)&&(k==i))) {
342 dprintf("- found time: %li\n",gdp->xrule);
344 gdp->xrule=0; /* reset the value to "none" */
347 sscanf(tmpstr,"%lf%n",&gdp->yrule,&k);
348 if (((j!=0)&&(k==j))||((j==0)&&(k==i))) {
349 dprintf("- found number: %f\n",gdp->yrule);
351 gdp->yrule=DNAN; /* reset the value to "none" */
354 if (((j!=0)&&(k!=j))||((j==0)&&(k!=i))) {
355 if ((gdp->vidx=find_var(im,tmpstr))<0) {
356 rrd_set_error("Not a valid vname: %s in line %s",tmpstr,line);
359 dprintf("- found vname: '%s' vidx %li\n",tmpstr,gdp->vidx);
364 dprintf("- examining color '%s'\n",&tmpstr[j]);
365 if (rrd_parse_color(&tmpstr[j],gdp)) {
366 rrd_set_error("Could not parse color in '%s'",&tmpstr[j]);
369 dprintf("- parsed color 0x%08x\n",(unsigned int)gdp->col);
372 dprintf("- no color present in '%s'\n",tmpstr);
375 (*eaten) += i; /* after vname#color */
376 if (line[*eaten]!='\0') {
377 (*eaten)++; /* after colon */
380 if (gdp->gf == GF_TICK) {
381 dprintf("- parsing '%s'\n",&line[*eaten]);
382 dprintf("- looking for optional TICK number\n");
384 sscanf(&line[*eaten],"%lf%n",&gdp->yrule,&j);
386 if (line[*eaten+j]!='\0' && line[*eaten+j]!=':') {
387 rrd_set_error("Cannot parse TICK fraction '%s'",line);
390 dprintf("- found number %f\n",gdp->yrule);
391 if (gdp->yrule > 1.0 || gdp->yrule < -1.0) {
392 rrd_set_error("Tick factor should be <= 1.0");
397 dprintf("- not found, defaulting to 0.1\n");
400 if (line[*eaten] == '\0') {
401 dprintf("- done parsing line\n");
403 } else { if (line[*eaten] == ':') {
406 rrd_set_error("Can't make sense of that TICK line");
412 dprintf("- parsing '%s'\n",&line[*eaten]);
414 /* Legend is next. A legend without a color is an error.
415 ** Stacking an item without having a legend is OK however
416 ** then an empty legend should be specified.
417 ** LINE:val#color:STACK means legend is string "STACK"
418 ** LINE:val#color::STACK means no legend, and do STACK
419 ** LINE:val:STACK is an error (legend but no color)
420 ** LINE:val::STACK means no legend, and do STACK
424 char *linecp = strdup(line);
425 dprintf("- looking for optional legend\n");
427 dprintf("- examining '%s'\n",&line[*eaten]);
428 if (linecp[*eaten] != '\0' && linecp[*eaten] != ':') {
430 /* If the legend is not empty, it has to be prefixed with spacecnt ' ' characters. This then gets
431 * replaced by the color box later on. */
432 for (spi=0;spi<spacecnt && (*eaten) > 1;spi++){
433 linecp[--(*eaten)]=' ';
437 if (rrd_parse_legend(linecp, eaten, gdp)) err=1;
441 dprintf("- found legend '%s'\n", &gdp->legend[2]);
443 dprintf("- skipping empty legend\n");
444 if (line[*eaten] != '\0' && line[*eaten] != ':') {
445 rrd_set_error("Legend set but no color: %s",&line[*eaten]);
449 if (line[*eaten]=='\0') {
450 dprintf("- done parsing line\n");
453 (*eaten)++; /* after colon */
455 /* PART, HRULE, VRULE and TICK cannot be stacked. */
456 if ( (gdp->gf == GF_HRULE)
457 || (gdp->gf == GF_VRULE)
459 || (gdp->gf == GF_PART)
461 || (gdp->gf == GF_TICK)
464 dprintf("- parsing '%s'\n",&line[*eaten]);
465 if (line[*eaten]!='\0') {
466 dprintf("- still more, should be STACK\n");
467 j=scan_for_col(&line[*eaten],5,tmpstr);
468 if (line[*eaten+j]!='\0' && line[*eaten+j]!=':') {
470 rrd_set_error("Garbage found where STACK expected");
473 if (!strcmp("STACK",tmpstr)) {
474 dprintf("- found STACK\n");
478 rrd_set_error("Garbage found where STACK expected");
482 if (line[*eaten]=='\0') {
483 dprintf("- done parsing line\n");
487 dprintf("- parsing '%s'\n",&line[*eaten]);
493 rrd_parse_vname(char *line, unsigned int *eaten, graph_desc_t *gdp, image_desc_t *im) {
494 char tmpstr[MAX_VNAME_LEN + 10];
497 sscanf(&line[*eaten], DEF_NAM_FMT "=%n", tmpstr,&i);
499 rrd_set_error("Cannot parse vname from '%s'",line);
502 dprintf("- found candidate '%s'\n",tmpstr);
504 if ((gdp->vidx=find_var(im,tmpstr))>=0) {
505 rrd_set_error("Attempting to reuse '%s'",im->gdes[gdp->vidx].vname);
508 strcpy(gdp->vname,tmpstr);
509 dprintf("- created vname '%s' vidx %lu\n", gdp->vname,im->gdes_c-1);
515 rrd_parse_def(char *line, unsigned int *eaten, graph_desc_t *gdp, image_desc_t *im) {
517 char command[7]; /* step, start, end, reduce */
519 struct rrd_time_value start_tv,end_tv;
520 time_t start_tmp=0,end_tmp=0;
521 char *parsetime_error=NULL;
523 start_tv.type = end_tv.type=ABSOLUTE_TIME;
524 start_tv.offset = end_tv.offset=0;
525 localtime_r(&gdp->start, &start_tv.tm);
526 localtime_r(&gdp->end, &end_tv.tm);
528 dprintf("- parsing '%s'\n",&line[*eaten]);
529 dprintf("- from line '%s'\n",line);
531 if (rrd_parse_vname(line,eaten,gdp,im)) return 1;
532 i=scan_for_col(&line[*eaten],254,gdp->rrd);
533 if (line[*eaten+i]!=':') {
534 rrd_set_error("Problems reading database name");
538 dprintf("- using file '%s'\n",gdp->rrd);
541 sscanf(&line[*eaten], DS_NAM_FMT ":%n", gdp->ds_nam,&i);
543 rrd_set_error("Cannot parse DS in '%s'",line);
547 dprintf("- using DS '%s'\n",gdp->ds_nam);
549 if (rrd_parse_CF(line,eaten,gdp,&gdp->cf)) return 1;
550 gdp->cf_reduce = gdp->cf;
552 if (line[*eaten]=='\0') return 0;
555 dprintf("- optional parameter follows: %s\n", &line[*eaten]);
557 sscanf(&line[*eaten], "%6[a-z]=%n", command, &i);
559 rrd_set_error("Parse error in '%s'",line);
563 dprintf("- processing '%s'\n",command);
564 if (!strcmp("reduce",command)) {
565 if (rrd_parse_CF(line,eaten,gdp,&gdp->cf_reduce)) return 1;
566 if (line[*eaten] != '\0')
568 } else if (!strcmp("step",command)) {
570 sscanf(&line[*eaten],"%lu%n",&gdp->step,&i);
571 gdp->step_orig = gdp->step;
573 dprintf("- using step %lu\n",gdp->step);
574 } else if (!strcmp("start",command)) {
575 i=scan_for_col(&line[*eaten],255,tmpstr);
577 if ((parsetime_error = parsetime(tmpstr, &start_tv))) {
578 rrd_set_error( "start time: %s", parsetime_error );
581 dprintf("- done parsing: '%s'\n",&line[*eaten]);
582 } else if (!strcmp("end",command)) {
583 i=scan_for_col(&line[*eaten],255,tmpstr);
585 if ((parsetime_error = parsetime(tmpstr, &end_tv))) {
586 rrd_set_error( "end time: %s", parsetime_error );
589 dprintf("- done parsing: '%s'\n",&line[*eaten]);
591 rrd_set_error("Parse error in '%s'",line);
594 if (line[*eaten]=='\0') break;
595 if (line[*eaten]!=':') {
596 dprintf("- Expected to see end of string but got '%s'\n",\
598 rrd_set_error("Parse error in '%s'",line);
603 if (proc_start_end(&start_tv,&end_tv,&start_tmp,&end_tmp) == -1){
604 /* error string is set in parsetime.c */
607 if (start_tmp < 3600*24*365*10) {
608 rrd_set_error("the first entry to fetch should be "
609 "after 1980 (%ld)",start_tmp);
613 if (end_tmp < start_tmp) {
614 rrd_set_error("start (%ld) should be less than end (%ld)",
619 gdp->start = start_tmp;
621 gdp->start_orig = start_tmp;
622 gdp->end_orig = end_tmp;
624 dprintf("- start time %lu\n",gdp->start);
625 dprintf("- end time %lu\n",gdp->end);
631 rrd_parse_vdef(char *line, unsigned int *eaten, graph_desc_t *gdp, image_desc_t *im) {
632 char tmpstr[MAX_VNAME_LEN+1]; /* vname\0 */
635 dprintf("- parsing '%s'\n",&line[*eaten]);
636 if (rrd_parse_vname(line,eaten,gdp,im)) return 1;
638 sscanf(&line[*eaten], DEF_NAM_FMT ",%n", tmpstr,&i);
640 rrd_set_error("Cannot parse line '%s'",line);
643 if ((gdp->vidx=find_var(im,tmpstr))<0) {
644 rrd_set_error("Not a valid vname: %s in line %s",tmpstr,line);
647 if ( im->gdes[gdp->vidx].gf != GF_DEF
648 && im->gdes[gdp->vidx].gf != GF_CDEF) {
649 rrd_set_error("variable '%s' not DEF nor "
650 "CDEF in VDEF '%s'", tmpstr,gdp->vname);
653 dprintf("- found vname: '%s' vidx %li\n",tmpstr,gdp->vidx);
656 dprintf("- calling vdef_parse with param '%s'\n",&line[*eaten]);
657 vdef_parse(gdp,&line[*eaten]);
658 while (line[*eaten]!='\0'&&line[*eaten]!=':')
665 rrd_parse_cdef(char *line, unsigned int *eaten, graph_desc_t *gdp, image_desc_t *im) {
666 dprintf("- parsing '%s'\n",&line[*eaten]);
667 if (rrd_parse_vname(line,eaten,gdp,im)) return 1;
668 if ((gdp->rpnp = rpn_parse(
673 rrd_set_error("invalid rpn expression in: %s",&line[*eaten]);
676 while (line[*eaten]!='\0'&&line[*eaten]!=':')
682 rrd_graph_script(int argc, char *argv[], image_desc_t *im, int optno) {
685 for (i=optind+optno;i<argc;i++) {
687 unsigned int eaten=0;
689 if (gdes_alloc(im)) return; /* the error string is already set */
690 gdp = &im->gdes[im->gdes_c-1];
695 if (rrd_parse_find_gf(argv[i],&eaten,gdp)) return;
698 case GF_SHIFT: /* vname:value */
699 if (rrd_parse_shift(argv[i],&eaten,gdp,im)) return;
702 if (rrd_parse_xport(argv[i],&eaten,gdp,im)) return;
704 case GF_PRINT: /* vname:CF:format -or- vname:format */
705 case GF_GPRINT: /* vname:CF:format -or- vname:format */
706 if (rrd_parse_print(argv[i],&eaten,gdp,im)) return;
708 case GF_COMMENT: /* text */
709 if (rrd_parse_legend(argv[i],&eaten,gdp)) return;
711 case GF_STACK: /* vname-or-value[#color[:legend]] */
713 case GF_PART: /* value[#color[:legend]] */
715 case GF_VRULE: /* value#color[:legend] */
716 case GF_HRULE: /* value#color[:legend] */
717 case GF_LINE: /* vname-or-value[#color[:legend]][:STACK] */
718 case GF_AREA: /* vname-or-value[#color[:legend]][:STACK] */
719 case GF_TICK: /* vname#color[:num[:legend]] */
720 if (rrd_parse_PVHLAST(argv[i],&eaten,gdp,im)) return;
722 /* data acquisition */
723 case GF_DEF: /* vname=x:DS:CF:[:step=#][:start=#][:end=#] */
724 if (rrd_parse_def(argv[i],&eaten,gdp,im)) return;
726 case GF_CDEF: /* vname=rpn-expression */
727 if (rrd_parse_cdef(argv[i],&eaten,gdp,im)) return;
729 case GF_VDEF: /* vname=rpn-expression */
730 if (rrd_parse_vdef(argv[i],&eaten,gdp,im)) return;
734 dprintf("used %i out of %i chars\n",eaten,strlen(argv[i]));
735 dprintf("parsed line: '%s'\n",argv[i]);
736 dprintf("remaining: '%s'\n",&argv[i][eaten]);
737 if (eaten >= strlen(argv[i]))
738 dprintf("Command finished successfully\n");
740 if (eaten < strlen(argv[i])) {
741 rrd_set_error("Garbage '%s' after command:\n%s",
742 &argv[i][eaten],argv[i]);