1 /****************************************************************************
2 * RRDtool 1.2.x Copyright Tobias Oetiker, 1997 - 2005
3 ****************************************************************************
4 * rrd_graph_helper.c commandline parser functions
5 * this code was probably writtenn 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,c2=0;
40 sscanf(&line[*eaten], "DEBUG%n", &i);
45 dprintf("Scanning line '%s'\n",&line[*eaten]);
47 sscanf(&line[*eaten], "%10[A-Z]%n%c%c", funcname, &i, &c1, &c2);
49 rrd_set_error("Could not make sense out of '%s'",line);
52 if ((int)(gdp->gf=gf_conv(funcname)) == -1) {
53 rrd_set_error("'%s' is not a valid function name", funcname);
56 if (gdp->gf == GF_LINE) {
57 if (c1 < '1' || c1 > '3' || c2 != ':') {
58 rrd_set_error("Malformed LINE command: %s",line);
61 gdp->linewidth=c1-'0';
65 rrd_set_error("Malformed %s command: %s",funcname,line);
74 rrd_parse_legend(char *line, unsigned int *eaten, graph_desc_t *gdp) {
77 dprintf("- examining '%s'\n",&line[*eaten]);
79 i=scan_for_col(&line[*eaten],FMT_LEG_LEN,gdp->legend);
82 if (line[*eaten]!='\0' && line[*eaten]!=':') {
83 rrd_set_error("Legend too long");
86 dprintf("- found legend '%s'\n", gdp->legend);
92 rrd_parse_color(char *string, graph_desc_t *gdp) {
93 unsigned int r=0,g=0,b=0,a=0;
96 if (string[0] != '#') return 1;
97 sscanf(string, "#%02x%02x%02x%n%02x%n%*s%n",
98 &r,&g,&b,&i1,&a,&i2,&i3);
100 if (i3) return 1; /* garbage after color */
102 if (!i1) return 1; /* no color after '#' */
103 gdp->col = r<<24|g<<16|b<<8|a;
108 rrd_parse_CF(char *line, unsigned int *eaten, graph_desc_t *gdp, enum cf_en *cf) {
109 char symname[CF_NAM_SIZE];
112 sscanf(&line[*eaten], CF_NAM_FMT "%n", symname,&i);
113 if ((!i)||((line[*eaten+i]!='\0')&&(line[*eaten+i]!=':'))) {
114 rrd_set_error("Cannot parse CF in '%s'",line);
118 dprintf("- using CF '%s'\n",symname);
120 if ((int)(*cf = cf_conv(symname))==-1) {
121 rrd_set_error("Unknown CF '%s' in '%s'",symname,line);
125 if (line[*eaten]!='\0') (*eaten)++;
129 /* Parsing old-style xPRINT and new-style xPRINT */
131 rrd_parse_print(char *line, unsigned int *eaten, graph_desc_t *gdp, image_desc_t *im) {
132 /* vname:CF:format in case of DEF-based vname
133 ** vname:CF:format in case of CDEF-based vname
134 ** vname:format in case of VDEF-based vname
136 char tmpstr[MAX_VNAME_LEN+1];
139 sscanf(&line[*eaten], DEF_NAM_FMT ":%n", tmpstr,&i);
141 rrd_set_error("Could not parse line '%s'",line);
145 dprintf("- Found candidate vname '%s'\n",tmpstr);
147 if ((gdp->vidx=find_var(im,tmpstr))<0) {
148 rrd_set_error("Not a valid vname: %s in line %s",tmpstr,line);
151 switch (im->gdes[gdp->vidx].gf) {
154 dprintf("- vname is of type DEF or CDEF, looking for CF\n");
155 if (rrd_parse_CF(line,eaten,gdp,&gdp->cf)) return 1;
158 dprintf("- vname is of type VDEF\n");
161 rrd_set_error("Encountered unknown type variable '%s'",tmpstr);
165 if (rrd_parse_legend(line,eaten,gdp)) return 1;
167 /* Why is there a separate structure member "format" ??? */
168 strcpy(gdp->format,gdp->legend);
174 rrd_parse_shift(char *line, unsigned int *eaten, graph_desc_t *gdp, image_desc_t *im) {
175 char *l = strdup(line + *eaten), *p;
180 rrd_set_error("Invalid SHIFT syntax");
185 if ((gdp->vidx=find_var(im,l))<0) {
186 rrd_set_error("Not a valid vname: %s in line %s",l,line);
190 /* constant will parse; otherwise, must be VDEF reference */
191 if (sscanf(p, "%ld", &gdp->shval) != 1) {
194 if ((gdp->shidx=find_var(im, p))<0) {
195 rrd_set_error("invalid offset vname: %s", p);
199 vdp = &im->gdes[gdp->shidx];
200 if (vdp->gf != GF_VDEF) {
201 rrd_set_error("offset must specify value or VDEF");
208 *eaten = strlen(line);
217 rrd_parse_xport(char *line, unsigned int *eaten, graph_desc_t *gdp, image_desc_t *im) {
218 char *l = strdup(line + *eaten), *p;
227 if ((gdp->vidx=find_var(im, l))==-1){
228 rrd_set_error("unknown variable '%s'",l);
232 if (strlen(p) >= FMT_LEG_LEN)
233 *(p + FMT_LEG_LEN) = '\0';
235 strcpy(gdp->legend, p);
236 *eaten = strlen(line);
244 /* Parsing of PART, VRULE, HRULE, LINE, AREA, STACK and TICK
245 ** is done in one function. Stacking STACK is silently ignored
246 ** as it is redundant. Stacking PART, VRULE, HRULE or TICK is
247 ** not allowed. The check for color doesn't need to be so strict
248 ** anymore, the user can specify the color '#00000000' and
249 ** effectively circumvent this check, so why bother.
251 ** If a number (which is valid to enter) is more than a
252 ** certain amount of characters, it is caught as an error.
253 ** While this is arguable, so is entering fixed numbers
254 ** with more than MAX_VNAME_LEN significant digits.
257 rrd_parse_PVHLAST(char *line, unsigned int *eaten, graph_desc_t *gdp, image_desc_t *im) {
260 char tmpstr[MAX_VNAME_LEN + 10]; /* vname#RRGGBBAA\0 */
262 dprintf("- parsing '%s'\n",&line[*eaten]);
263 dprintf("- from line '%s'\n",line);
265 i=scan_for_col(&line[*eaten],MAX_VNAME_LEN+9,tmpstr);
266 if (line[*eaten+i]!='\0' && line[*eaten+i]!=':') {
267 rrd_set_error("Cannot parse line '%s'",line);
271 j=i; while (j>0 && tmpstr[j]!='#') j--;
273 if (tmpstr[j]=='#') {
274 if (rrd_parse_color(&tmpstr[j],gdp)) {
275 rrd_set_error("Could not parse color in '%s'",tmpstr[j]);
279 dprintf("- parsed color 0x%08x\n",(unsigned int)gdp->col);
283 dprintf("- examining '%s'\n",tmpstr);
285 if (gdp->gf == GF_VRULE) {
286 sscanf(tmpstr,"%li%n",&gdp->xrule,&j);
287 if (j) dprintf("- found time: %li\n",gdp->xrule);
289 sscanf(tmpstr,"%lf%n",&gdp->yrule,&j);
290 if (j) dprintf("- found number: %f\n",gdp->yrule);
293 if ((gdp->vidx=find_var(im,tmpstr))<0) {
294 rrd_set_error("Not a valid vname: %s in line %s",tmpstr,line);
297 dprintf("- found vname: '%s' vidx %li\n",tmpstr,gdp->vidx);
299 /* "*eaten" is still pointing to the original location,
300 ** "*eaten +i" is pointing to the character after the color
301 ** or to the terminating '\0' in which case we're finished.
303 if (line[*eaten+i]=='\0') {
309 /* If a color is specified and the only remaining part is
310 ** ":STACK" then it is assumed to be the legend. An empty
311 ** legend can be specified as expected. This means the
312 ** following can be done: LINE1:x#FF0000FF::STACK
314 if (colorfound) { /* no legend if no color */
315 if (gdp->gf == GF_TICK) {
316 dprintf("- looking for optional number\n");
317 sscanf(&line[*eaten],"%lf%n",&gdp->yrule,&j);
319 dprintf("- found number %f\n",gdp->yrule);
321 if (gdp->yrule > 1.0 || gdp->yrule < -1.0) {
322 rrd_set_error("Tick factor should be <= 1.0");
325 if (line[*eaten] == ':')
328 dprintf("- not found, defaulting to 0.1\n");
333 dprintf("- looking for optional legend\n");
334 dprintf("- in '%s'\n",&line[*eaten]);
335 /* the legend for a graph item must start with "m " the first
336 m will then be over drawn with a color box. Since there
337 is ample space I overwrite the first few characters of the line
338 with the material that I want to see in the legend */
339 if (line[*eaten] != '\0' && line[*eaten] != ':'){
342 line[*eaten+1] = ' ';
344 if (rrd_parse_legend(line, eaten, gdp)) return 1;
347 /* PART, HRULE, VRULE and TICK cannot be stacked. We're finished */
348 if ( (gdp->gf == GF_HRULE)
349 || (gdp->gf == GF_VRULE)
350 || (gdp->gf == GF_PART)
351 || (gdp->gf == GF_TICK)
354 if (line[*eaten]!='\0') {
355 dprintf("- still more, should be STACK\n");
357 j=scan_for_col(&line[*eaten],5,tmpstr);
358 if (line[*eaten+j]!='\0') {
359 rrd_set_error("Garbage found where STACK expected");
362 if (!strcmp("STACK",tmpstr)) {
363 dprintf("- found STACK\n");
367 rrd_set_error("Garbage found where STACK expected");
375 rrd_parse_vname(char *line, unsigned int *eaten, graph_desc_t *gdp, image_desc_t *im) {
376 char tmpstr[MAX_VNAME_LEN + 10];
379 sscanf(&line[*eaten], DEF_NAM_FMT "=%n", tmpstr,&i);
381 rrd_set_error("Cannot parse vname from '%s'",line);
384 dprintf("- found candidate '%s'\n",tmpstr);
386 if ((gdp->vidx=find_var(im,tmpstr))>=0) {
387 rrd_set_error("Attempting to reuse '%s'",im->gdes[gdp->vidx].vname);
390 strcpy(gdp->vname,tmpstr);
391 dprintf("- created vname '%s' vidx %lu\n", gdp->vname,im->gdes_c-1);
397 rrd_parse_def(char *line, unsigned int *eaten, graph_desc_t *gdp, image_desc_t *im) {
399 char command[7]; /* step, start, end, reduce */
401 struct rrd_time_value start_tv,end_tv;
402 time_t start_tmp=0,end_tmp=0;
403 char *parsetime_error=NULL;
405 start_tv.type = end_tv.type=ABSOLUTE_TIME;
406 start_tv.offset = end_tv.offset=0;
407 localtime_r(&gdp->start, &start_tv.tm);
408 localtime_r(&gdp->end, &end_tv.tm);
410 dprintf("- parsing '%s'\n",&line[*eaten]);
411 dprintf("- from line '%s'\n",line);
413 if (rrd_parse_vname(line,eaten,gdp,im)) return 1;
414 i=scan_for_col(&line[*eaten],254,gdp->rrd);
415 if (line[*eaten+i]!=':') {
416 rrd_set_error("Problems reading database name");
420 dprintf("- using file '%s'\n",gdp->rrd);
423 sscanf(&line[*eaten], DS_NAM_FMT ":%n", gdp->ds_nam,&i);
425 rrd_set_error("Cannot parse DS in '%s'",line);
429 dprintf("- using DS '%s'\n",gdp->ds_nam);
431 if (rrd_parse_CF(line,eaten,gdp,&gdp->cf)) return 1;
432 gdp->cf_reduce = gdp->cf;
434 if (line[*eaten]=='\0') return 0;
437 dprintf("- optional parameter follows: %s\n", &line[*eaten]);
439 sscanf(&line[*eaten], "%6[a-z]=%n", command, &i);
441 rrd_set_error("Parse error in '%s'",line);
445 dprintf("- processing '%s'\n",command);
446 if (!strcmp("reduce",command)) {
447 if (rrd_parse_CF(line,eaten,gdp,&gdp->cf_reduce)) return 1;
448 if (line[*eaten] != '\0')
450 } else if (!strcmp("step",command)) {
452 sscanf(&line[*eaten],"%lu%n",&gdp->step,&i);
454 dprintf("- using step %lu\n",gdp->step);
455 } else if (!strcmp("start",command)) {
456 i=scan_for_col(&line[*eaten],255,tmpstr);
458 if ((parsetime_error = parsetime(tmpstr, &start_tv))) {
459 rrd_set_error( "start time: %s", parsetime_error );
462 dprintf("- done parsing: '%s'\n",&line[*eaten]);
463 } else if (!strcmp("end",command)) {
464 i=scan_for_col(&line[*eaten],255,tmpstr);
466 if ((parsetime_error = parsetime(tmpstr, &end_tv))) {
467 rrd_set_error( "end time: %s", parsetime_error );
470 dprintf("- done parsing: '%s'\n",&line[*eaten]);
472 rrd_set_error("Parse error in '%s'",line);
475 if (line[*eaten]=='\0') break;
476 if (line[*eaten]!=':') {
477 dprintf("- Expected to see end of string but got '%s'\n",\
479 rrd_set_error("Parse error in '%s'",line);
484 if (proc_start_end(&start_tv,&end_tv,&start_tmp,&end_tmp) == -1){
485 /* error string is set in parsetime.c */
488 if (start_tmp < 3600*24*365*10) {
489 rrd_set_error("the first entry to fetch should be "
490 "after 1980 (%ld)",start_tmp);
494 if (end_tmp < start_tmp) {
495 rrd_set_error("start (%ld) should be less than end (%ld)",
500 gdp->start = start_tmp;
503 dprintf("- start time %lu\n",gdp->start);
504 dprintf("- end time %lu\n",gdp->end);
510 rrd_parse_vdef(char *line, unsigned int *eaten, graph_desc_t *gdp, image_desc_t *im) {
511 char tmpstr[MAX_VNAME_LEN+1]; /* vname\0 */
514 dprintf("- parsing '%s'\n",&line[*eaten]);
515 if (rrd_parse_vname(line,eaten,gdp,im)) return 1;
517 sscanf(&line[*eaten], DEF_NAM_FMT ",%n", tmpstr,&i);
519 rrd_set_error("Cannot parse line '%s'",line);
522 if ((gdp->vidx=find_var(im,tmpstr))<0) {
523 rrd_set_error("Not a valid vname: %s in line %s",tmpstr,line);
526 if ( im->gdes[gdp->vidx].gf != GF_DEF
527 && im->gdes[gdp->vidx].gf != GF_CDEF) {
528 rrd_set_error("variable '%s' not DEF nor "
529 "CDEF in VDEF '%s'", tmpstr,gdp->vname);
532 dprintf("- found vname: '%s' vidx %li\n",tmpstr,gdp->vidx);
535 dprintf("- calling vdef_parse with param '%s'\n",&line[*eaten]);
536 vdef_parse(gdp,&line[*eaten]);
537 while (line[*eaten]!='\0'&&line[*eaten]!=':')
544 rrd_parse_cdef(char *line, unsigned int *eaten, graph_desc_t *gdp, image_desc_t *im) {
545 dprintf("- parsing '%s'\n",&line[*eaten]);
546 if (rrd_parse_vname(line,eaten,gdp,im)) return 1;
547 if ((gdp->rpnp = rpn_parse(
552 rrd_set_error("invalid rpn expression in: %s",&line[*eaten]);
555 while (line[*eaten]!='\0'&&line[*eaten]!=':')
561 rrd_graph_script(int argc, char *argv[], image_desc_t *im, int optno) {
564 for (i=optind+optno;i<argc;i++) {
566 unsigned int eaten=0;
568 if (gdes_alloc(im)) return; /* the error string is already set */
569 gdp = &im->gdes[im->gdes_c-1];
574 if (rrd_parse_find_gf(argv[i],&eaten,gdp)) return;
577 case GF_SHIFT: /* vname:value */
578 if (rrd_parse_shift(argv[i],&eaten,gdp,im)) return;
581 if (rrd_parse_xport(argv[i],&eaten,gdp,im)) return;
583 case GF_PRINT: /* vname:CF:format -or- vname:format */
584 case GF_GPRINT: /* vname:CF:format -or- vname:format */
585 if (rrd_parse_print(argv[i],&eaten,gdp,im)) return;
587 case GF_COMMENT: /* text */
588 if (rrd_parse_legend(argv[i],&eaten,gdp)) return;
590 case GF_PART: /* value[#color[:legend]] */
591 case GF_VRULE: /* value#color[:legend] */
592 case GF_HRULE: /* value#color[:legend] */
593 case GF_LINE: /* vname-or-value[#color[:legend]][:STACK] */
594 case GF_AREA: /* vname-or-value[#color[:legend]][:STACK] */
595 case GF_STACK: /* vname-or-value[#color[:legend]] */
596 case GF_TICK: /* vname#color[:num[:legend]] */
597 if (rrd_parse_PVHLAST(argv[i],&eaten,gdp,im)) return;
599 /* data acquisition */
600 case GF_DEF: /* vname=x:DS:CF:[:step=#][:start=#][:end=#] */
601 if (rrd_parse_def(argv[i],&eaten,gdp,im)) return;
603 case GF_CDEF: /* vname=rpn-expression */
604 if (rrd_parse_cdef(argv[i],&eaten,gdp,im)) return;
606 case GF_VDEF: /* vname=rpn-expression */
607 if (rrd_parse_vdef(argv[i],&eaten,gdp,im)) return;
611 dprintf("used %i out of %i chars\n",eaten,strlen(argv[i]));
612 dprintf("parsed line: '%s'\n",argv[i]);
613 dprintf("remaining: '%s'\n",&argv[i][eaten]);
614 if (eaten >= strlen(argv[i]))
615 dprintf("Command finished successfully\n");
617 if (eaten < strlen(argv[i])) {
618 rrd_set_error("Garbage '%s' after command:\n%s",
619 &argv[i][eaten],argv[i]);