4eae8b60edad176fa541ddbf4cda5318696b1d32
[php-utility-classes.git] / include / classes / rrdstat.php-class
1 <?php
2 /* ***** BEGIN LICENSE BLOCK *****
3  *
4  * The contents of this file are subject to Austrian copyright reegulations
5  * ("Urheberrecht"); you may not use this file except in compliance with
6  * those laws.
7  * This contents and any derived work, if it gets distributed in any way,
8  * is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND,
9  * either express or implied.
10  *
11  * The Original Code is KaiRo's RRD statistics class.
12  *
13  * The Initial Developer of the Original Code is
14  * KaiRo - Robert Kaiser.
15  * Portions created by the Initial Developer are Copyright (C) 2005
16  * the Initial Developer. All Rights Reserved.
17  *
18  * Contributor(s): Robert Kaiser <kairo@kairo.at>
19  *
20  * ***** END LICENSE BLOCK ***** */
21
22 class rrdstat {
23   // rrdstat PHP class
24   // rrdtool statistics functions
25   //
26   // function rrdstat($rrdconfig, [$conf_id])
27   //   CONSTRUCTOR
28   //     if $conf_id is set, $rrdconfig is a total configuration set
29   //     else it's the configuration for this one RRD
30   //     currently only a config array is supported, XML config is planned
31   //
32   // var $rrd_file
33   // RRD file name
34   //
35   // var $basename
36   // base name for this RRD (usually file name without .rrd)
37   //
38   // var $basedir
39   // base directory for this RRD (with a trailing slash)
40   //   note that $rrd_file usually includes that path as well, but graph directory gets based on this value
41   //
42   // var $config_all
43   // complete, raw configuration array set
44   //
45   // var $config_raw
46   // configuration array set for current RRD
47   //
48   // var $config_graph
49   // configuration array set for default graph in this RRD
50   //
51   // var $config_page
52   // configuration array set for default page in this RRD
53   //
54   // var $rrd_fields
55   // definition of this RRD's fields
56   //
57   // var $rra_base
58   // definition of this RRD's base RRAs
59   //
60   // var $rrd_step
61   // basic stepping of this RRD in seconds (default: 300)
62   //
63   // var $rra_add_max
64   // should RRAs for MAX be added for every base RRA? (bool, default: true)
65   //
66   // var $status
67   // status of the RRD (unused/ok/readonly/graphonly)
68   //   note that most functions require certain status values
69   //   (e.g. update only works if status is ok, graph for ok/readonly/graphonly)
70   //
71   // var $mod_textdomain
72   //   GNU gettext domain for this module
73   //
74   // function set_def($rrdconfig, [$conf_id])
75   //   set definitions based on given configuration
76   //   [intended for internal use, called by the constructor]
77   //
78   // function create()
79   //   create RRD file according to set config
80   //
81   // function update([$upArray])
82   //   feed new data into RRD (either use given array of values or use auto-update info from config)
83   //
84   // function fetch([$cf] = 'AVERAGE', $resolution = null, $start = null, $end = null)
85   //   fetch data from the defined RRD
86   //     using given consolidation function [default is AVERAGE],
87   //     resolution (seconds, default is the RRD's stepping),
88   //     start and end times (unix epoch, defaults are the RRD's last update time)
89   //
90   // function last_update()
91   //   fetch time of last update in this RRD file
92   //
93   // function graph([$timeframe], [$sub], [$extra])
94   //   create a RRD graph (and return all meta info in a flat string)
95   //     for given timeframe (day [default]/week/month/year),
96   //     sub-graph ID (if given) and extra config options (if given)
97   //
98   // function graph_plus([$timeframe], [$sub], [$extra])
99   //   create a RRD graph (see above) and return meta info as a ready-to-use array
100   //
101   // function page([$sub], [$page_extras], [$graph_extras])
102   //   create a (HTML) page and return it in a string
103   //     for given sub-page ID (if given, default is a simple HTML page)
104   //     and extra page and graph config options (if given)
105   //
106   // function simple_html([$sub], [$page_extras], [$graph_extras])
107   //   create a simple (MRTG-like) HTML page and return it in a string
108   //   XXX: this is here temporarily for compat only, it's preferred to use page()!
109   //
110   // function page_index($pconf)
111   //   create a bare, very simple index list HTML page and return it in a string
112   //   using given page config options
113   //   [intended for internal use, called by page()]
114   //
115   // function page_overview($pconf, [$graph_extras])
116   //   create an overview HTML page (including graphs) and return it in a string
117   //   using given page config options and extra graph options (if given)
118   //   [intended for internal use, called by page()]
119   //
120   // function page_simple($pconf, [$graph_extras])
121   //   create a simple (MRTG-like) HTML page and return it in a string
122   //   using given page config options and extra graph options (if given)
123   //   [intended for internal use, called by page()]
124   //
125   // function h_page_statsArray($pconf)
126   //   return array of stats to list on a page, using given page config options
127   //   [intended for internal use, called by page_*()]
128   //
129   // function h_page_footer()
130   //   return generic page footer
131   //   [intended for internal use, called by page_*()]
132   //
133   // function text_quote($text)
134   //   return a quoted/escaped text for use in rrdtool commandline text fields
135
136   var $rrd_file = null;
137   var $basename = null;
138   var $basedir = null;
139
140   var $config_all = null;
141   var $config_raw = null;
142   var $config_graph = null;
143   var $config_page = null;
144
145   var $rrd_fields = array();
146   var $rra_base = array();
147   var $rrd_step = 300;
148   var $rra_add_max = true;
149
150   var $status = 'unused';
151
152   var $mod_textdomain;
153
154   function rrdstat($rrdconfig, $conf_id = null) {
155     // ***** init RRD stat module *****
156     $this->mod_textdomain = 'class_rrdstat';
157     $mod_charset = 'iso-8859-15';
158
159     bindtextdomain($this->mod_textdomain, class_exists('baseutils')?baseutils::getDir('locale'):'locale/');
160     bind_textdomain_codeset($this->mod_textdomain, $mod_charset);
161
162     $this->set_def($rrdconfig, $conf_id);
163
164     if (($this->status == 'unused') && !is_null($this->rrd_file)) {
165       if (!is_writeable($this->rrd_file)) {
166         if (!file_exists($this->rrd_file)) {
167           if (@touch($this->rrd_file)) { $this->create(); }
168           else { trigger_error('RRD file can not be created', E_USER_WARNING); }
169         }
170         else {
171           if (is_readable($this->rrd_file)) { $this->status = 'readonly'; }
172           else { trigger_error('RRD file is not readable', E_USER_WARNING); }
173         }
174       }
175       else {
176         $this->status = 'ok';
177       }
178     }
179   }
180
181   function set_def($rrdconfig, $conf_id = null) {
182     if (is_array($rrdconfig)) {
183       // we have an array in the format we like to have
184       $complete_conf =& $rrdconfig;
185     }
186     else {
187       // we have something else (XML data?), try to generate the iinfo aray from it
188       $complete_conf =& $rrdconfig;
189     }
190
191     if (!is_null($conf_id)) {
192       $iinfo = isset($complete_conf[$conf_id])?$complete_conf[$conf_id]:array();
193       if (isset($complete_conf['*'])) {
194         $iinfo = (array)$iinfo + (array)$complete_conf['*'];
195         if (isset($complete_conf['*']['graph'])) { $iinfo['graph'] = (array)$iinfo['graph'] + (array)$complete_conf['*']['graph']; }
196         if (isset($complete_conf['*']['page'])) { $iinfo['page'] = (array)$iinfo['page'] + (array)$complete_conf['*']['page']; }
197       }
198     }
199     else {
200       $iinfo = $complete_conf;
201     }
202
203     if (isset($iinfo['path']) && strlen($iinfo['path'])) {
204       $this->basedir = $iinfo['path'];
205       if (substr($this->basedir, -1) != '/') { $this->basedir .= '/'; }
206     }
207
208     if (isset($iinfo['graph-only']) && $iinfo['graph-only'] && !is_null($conf_id)) {
209       $this->basename = $conf_id;
210       $this->status = 'graphonly';
211     }
212     elseif (isset($iinfo['file'])) {
213       $this->rrd_file = (($iinfo['file']{0} != '/')?$this->basedir:'').$iinfo['file'];
214       $this->basename = basename((substr($this->rrd_file, -4) == '.rrd')?substr($this->rrd_file, 0, -4):$this->rrd_file);
215     }
216     elseif (!is_null($conf_id) && file_exists($conf_id.'.rrd')) {
217       $this->rrd_file = (($iinfo['file']{0} != '/')?$this->basedir:'').$conf_id.'.rrd';
218       $this->basename = $conf_id;
219     }
220     else {
221       $this->basename = !is_null($conf_id)?$conf_id:'xxx.unknown';
222     }
223
224     if (!is_null($this->rrd_file)) {
225       // fields (data sources, DS)
226       //  name - DS name
227       //  type - one of COUNTER, GAUGE, DERIVE, ABSOLUTE
228       //  heartbeat - if no sample recieved for that time, store UNKNOWN
229       //  min - U (unconstrained) or minimum value
230       //  max - U (unconstrained) or maximum value
231       //  update - this string will be fed into eval() for updating this field
232       if (isset($iinfo['fields']) && is_array($iinfo['fields'])) {
233         $this->rrd_fields = $iinfo['fields'];
234       }
235       else {
236         $this->rrd_fields[] = array('name' => 'ds0', 'type' => 'COUNTER', 'heartbeat' => 600, 'min' => 'U', 'max' => 'U');
237         $this->rrd_fields[] = array('name' => 'ds1', 'type' => 'COUNTER', 'heartbeat' => 600, 'min' => 'U', 'max' => 'U');
238       }
239
240
241       // MRTG-style RRD "database", see http://people.ee.ethz.ch/~oetiker/webtools/rrdtool/tut/rrdtutorial.en.html
242       //
243       // archives (RRAs):
244       // 600 samples of 5 minutes  (2 days and 2 hours)
245       // 700 samples of 30 minutes (2 days and 2 hours, plus 12.5 days)
246       // 775 samples of 2 hours    (above + 50 days)
247       // 797 samples of 1 day      (above + 732 days, rounded up to 797)
248
249       $this->rrd_step = isset($iinfo['rrd_step'])?$iinfo['rrd_step']:300;
250
251       if (isset($iinfo['rra_base']) && is_array($iinfo['rra_base'])) {
252         $this->rra_base = $iinfo['rra_base'];
253       }
254       else {
255         $this->rra_base[] = array('step' => 1, 'rows' => 600);
256         $this->rra_base[] = array('step' => 6, 'rows' => 700);
257         $this->rra_base[] = array('step' => 24, 'rows' => 775);
258         $this->rra_base[] = array('step' => 288, 'rows' => 797);
259       }
260
261       $this->rra_add_max = isset($iinfo['rra_add_max'])?$iinfo['rra_add_max']:true;
262     }
263
264     if (isset($iinfo['graph'])) { $this->config_graph = $iinfo['graph']; }
265     if (isset($iinfo['page'])) { $this->config_page = $iinfo['page']; }
266     $this->config_raw = $iinfo;
267     $this->config_all = $complete_conf;
268   }
269
270   function create() {
271     // create RRD file
272
273     // compose create command
274     $create_cmd = 'rrdtool create '.$this->rrd_file.' --step '.$this->rrd_step;
275     foreach ($this->rrd_fields as $ds) {
276       if (!isset($ds['type'])) { $ds['type'] = 'COUNTER'; }
277       if (!isset($ds['heartbeat'])) { $ds['heartbeat'] = 2*$this->rrd_step; }
278       if (!isset($ds['min'])) { $ds['min'] = 'U'; }
279       if (!isset($ds['max'])) { $ds['max'] = 'U'; }
280       $create_cmd .= ' DS:'.$ds['name'].':'.$ds['type'].':'.$ds['heartbeat'].':'.$ds['min'].':'.$ds['max'];
281     }
282     foreach ($this->rra_base as $rra) {
283       if (!isset($rra['cf'])) { $rra['cf'] = 'AVERAGE'; }
284       if (!isset($rra['xff'])) { $rra['xff'] = 0.5; }
285       if (!isset($rra['step'])) { $rra['step'] = 1; }
286       if (!isset($rra['rows'])) { $rra['rows'] = 600; }
287       $create_cmd .= ' RRA:'.$rra['cf'].':'.$rra['xff'].':'.$rra['step'].':'.$rra['rows'];
288     }
289     if ($this->rra_add_max) {
290       foreach ($this->rra_base as $rra) {
291         if (!isset($rra['cf'])) {
292           // only rows that have no CF set will be looked at here
293           $rra['cf'] = 'MAX';
294           if (!isset($rra['xff'])) { $rra['xff'] = 0.5; }
295           if (!isset($rra['step'])) { $rra['step'] = 1; }
296           if (!isset($rra['rows'])) { $rra['rows'] = 600; }
297           $create_cmd .= ' RRA:'.$rra['cf'].':'.$rra['xff'].':'.$rra['step'].':'.$rra['rows'];
298         }
299       }
300     }
301     $return = `$create_cmd 2>&1`;
302     if (strpos($return, 'ERROR') !== false) {
303       trigger_error($this->rrd_file.' - rrd create error: '.$return, E_USER_WARNING);
304     }
305     else { $this->status = 'ok'; }
306   }
307
308   function update($upArray = null) {
309     // feed new data into RRD
310     if ($this->status != 'ok') { trigger_error('Cannot update non-writeable file', E_USER_WARNING); return false; }
311     $upvals = array();
312     if (isset($this->config_raw['update'])) {
313       if (preg_match('/^\s*function\s+{(.*)}\s*$/is', $this->config_raw['update'], $regs)) {
314         $upfunc = create_function('', $regs[1]);
315         $upvals = $upfunc();
316       }
317       else {
318         $evalcode = $this->config_raw['update'];
319         if (!is_null($evalcode)) {
320           ob_start();
321           eval($evalcode);
322           $ret = ob_get_contents();
323           if (strlen($ret)) { $upvals = explode("\n", $ret); }
324           ob_end_clean();
325         }
326       }
327     }
328     else {
329       foreach ($this->rrd_fields as $ds) {
330         if (is_array($upArray) && isset($upArray[$ds['name']])) { $val = $upArray[$ds['name']]; }
331         elseif (isset($ds['update'])) {
332           $val = null; $evalcode = null;
333           if (substr($ds['update'], 0, 4) == 'val:') {
334             $evalcode = 'function { return trim('.substr($ds['update'], 4).')); }';
335           }
336           elseif (substr($ds['update'], 0, 8) == 'snmp-if:') {
337             $snmphost = 'localhost'; $snmpcomm = 'public';
338             list($nix, $ifname, $valtype) = explode(':', $ds['update'], 3);
339             $iflist = explode("\n", `snmpwalk -v2c -c $snmpcomm $snmphost interfaces.ifTable.ifEntry.ifDescr`);
340             $ifnr = null;
341             foreach ($iflist as $ifdesc) {
342               if (preg_match('/ifDescr\.(\d+) = STRING: '.$ifname.'/', $ifdesc, $regs)) { $ifnr = $regs[1]; }
343             }
344             $oid = null;
345             if ($valtype == 'in') { $oid = '1.3.6.1.2.1.2.2.1.10.'.$ifnr; }
346             elseif ($valtype == 'out') { $oid = '1.3.6.1.2.1.2.2.1.16.'.$ifnr; }
347             if (!is_null($ifnr) && !is_null($oid)) {
348               $evalcode = 'function { return trim(substr(strrchr(`snmpget -v2c -c '.$snmpcomm.' '.$snmphost.' '.$oid.'`,":"),1)); }';
349             }
350           }
351           else { $evalcode = $ds['update']; }
352           if (preg_match('/^\s*function\s+{(.*)}\s*$/is', $evalcode, $regs)) {
353             $upfunc = create_function('', $regs[1]);
354             $val = $upfunc();
355           }
356           elseif (!is_null($evalcode)) {
357             ob_start();
358             eval($evalcode);
359             $val = ob_get_contents();
360             ob_end_clean();
361           }
362         }
363         else { $val = null; }
364         $upvals[$ds['name']] = $val;
365       }
366     }
367     $key_names = (!is_numeric(array_shift(array_keys($upvals))));
368     if (in_array('L', $upvals, true)) {
369       // for at least one value, we need to set the same as the last recorded value
370       $fvals = $this->fetch();
371       $rowids = array_shift($fvals);
372       $lastvals = array_shift($fvals);
373       foreach (array_keys($upvals, 'L') as $akey) {
374         $upvals[$akey] = $key_names?$lastvals[$akey]:$lastvals[$rowids[$akey]];
375       }
376     }
377     $walkfunc = create_function('&$val,$key', '$val = is_numeric(trim($val))?trim($val):"U";');
378     array_walk($upvals, $walkfunc);
379     $return = null;
380     if (count($upvals)) {
381       $update_cmd = 'rrdtool update '.$this->rrd_file.($key_names?' --template '.implode(':', array_keys($upvals)):'').' N:'.implode(':', $upvals);
382       $return = `$update_cmd 2>&1`;
383     }
384
385     if (strpos($return, 'ERROR') !== false) {
386       trigger_error($this->rrd_file.' - rrd update error: '.$return, E_USER_WARNING);
387       $success = false;
388     }
389     else { $success = true; }
390   return $success;
391   }
392
393   function fetch($cf = 'AVERAGE', $resolution = null, $start = null, $end = null) {
394     // fetch data from a RRD
395     if (!in_array($this->status, array('ok','readonly'))) { trigger_error('Error: rrd status is '.$this->status, E_USER_WARNING); return false; }
396
397     if (!in_array($cf, array('AVERAGE','MIN','MAX','LAST'))) { $cf = 'AVERAGE'; }
398     if (!is_numeric($resolution)) { $resolution = $this->rrd_step; }
399     if (!is_numeric($end)) { $end = $this->last_update(); }
400     elseif ($end < 0) { $end += $this->last_update(); }
401     $end = intval($end/$resolution)*$resolution;
402     if (!is_numeric($start)) { $start = $end; }
403     elseif ($start < 0) { $start += $end; }
404     $start = intval($start/$resolution)*$resolution;
405
406     $fetch_cmd = 'rrdtool fetch '.$this->rrd_file.' '.$cf.' --resolution '.$resolution.' --start '.$start.' --end '.$end;
407     $return = `$fetch_cmd 2>&1`;
408
409     if (strpos($return, 'ERROR') !== false) {
410       trigger_error($this->rrd_file.' - rrd fetch error: '.$return, E_USER_WARNING);
411       $fresult = false;
412     }
413     else {
414       $fresult = array();
415       $rows = explode("\n", $return);
416       $fields = preg_split('/\s+/', array_shift($rows));
417       if (array_shift($fields) == 'timestamp') {
418         $fresult[0] = $fields;
419         foreach ($rows as $row) {
420           if (strlen(trim($row))) {
421             $rvals = preg_split('/\s+/', $row);
422             $rtime = str_replace(':', '', array_shift($rvals));
423             $rv_array = array();
424             foreach ($rvals as $key=>$rval) {
425               $rv_array[$fields[$key]] = ($rval=='nan')?null:floatval($rval);
426             }
427             $fresult[$rtime] = $rv_array;
428           }
429         }
430       }
431     }
432   return $fresult;
433   }
434
435   function last_update() {
436     // fetch time of last update in this RRD file
437     static $last_update;
438     if (!isset($last_update) && in_array($this->status, array('ok','readonly'))) {
439       $last_cmd = 'rrdtool last '.$this->rrd_file;
440       $return = trim(`$last_cmd 2>&1`);
441       $last_update = is_numeric($return)?$return:null;
442     }
443   return isset($last_update)?$last_update:null;
444   }
445
446   function graph($timeframe = 'day', $sub = null, $extra = null) {
447     // create a RRD graph
448     static $gColors;
449     if (!isset($gColors)) {
450       $gColors = array('#00CC00','#0000FF','#000000','#FF0000','#00FF00','#FFFF00','#FF00FF','#00FFFF','#808080','#800000','#008000','#000080','#808000','#800080','#008080','#C0C0C0');
451     }
452
453     if (!in_array($this->status, array('ok','readonly','graphonly'))) { trigger_error('Error: rrd status is '.$this->status, E_USER_WARNING); return false; }
454
455     // assemble configuration
456     $gconf = (array)$extra;
457     if (!is_null($sub) && is_array($this->config_raw['graph.'.$sub])) {
458       $gconf = $gconf + $this->config_raw['graph.'.$sub];
459     }
460     $gconf = $gconf + (array)$this->config_graph;
461
462     if (isset($gconf['format']) && ($gconf['format'] == 'SVG')) {
463       $format = $gconf['format']; $fmt_ext = '.svg';
464     }
465     elseif (isset($gconf['format']) && ($gconf['format'] == 'EPS')) {
466       $format = $gconf['format']; $fmt_ext = '.eps';
467     }
468     elseif (isset($gconf['format']) && ($gconf['format'] == 'PDF')) {
469       $format = $gconf['format']; $fmt_ext = '.pdf';
470     }
471     else {
472       $format = 'PNG'; $fmt_ext = '.png';
473     }
474
475     if (isset($gconf['filename'])) { $fname = $gconf['filename']; }
476     else { $fname = $this->basename.(is_null($sub)?'':'-%s').'-%t%f'; }
477     $fname = str_replace('%s', strval($sub), $fname);
478     $fname = str_replace('%t', $timeframe, $fname);
479     $fname = str_replace('%f', $fmt_ext, $fname);
480     if (substr($fname, -strlen($fmt_ext)) != $fmt_ext) { $fname .= $fmt_ext; }
481     if (isset($gconf['path']) && ($fname{0} != '/')) { $fname = $gconf['path'].'/'.$fname; }
482     if ($fname{0} != '/') { $fname = $this->basedir.$fname; }
483     $fname = str_replace('//', '/', $fname);
484
485     $graphrows = array(); $specialrows = array(); $gC = 0;
486     $gDefs = ''; $gGraphs = ''; $addSpecial = '';
487
488     if ($timeframe == 'day') {
489       $duration = isset($gconf['duration'])?$gconf['duration']:30*3600; // 30 hours
490       $slice = isset($gconf['slice'])?$gconf['slice']:300; // 5 minutes
491       // vertical lines at day borders
492       $addSpecial .= ' VRULE:'.strtotime(date('Y-m-d')).'#FF0000';
493       $addSpecial .= ' VRULE:'.strtotime(date('Y-m-d').' -1 day').'#FF0000';
494       if (!isset($gconf['grid_x'])) { $gconf['grid_x'] = 'HOUR:1:HOUR:6:HOUR:2:0:%-H'; }
495     }
496     elseif ($timeframe == 'week') {
497       $duration = isset($gconf['duration'])?$gconf['duration']:8*86400; // 8 days
498       $slice = isset($gconf['slice'])?$gconf['slice']:1800; // 30 minutes
499       // vertical lines at week borders
500       $addSpecial .= ' VRULE:'.strtotime(date('Y-m-d').' '.(-date('w')+1).' day').'#FF0000';
501       $addSpecial .= ' VRULE:'.strtotime(date('Y-m-d').' '.(-date('w')-6).' day').'#FF0000';
502     }
503     elseif ($timeframe == 'month') {
504       $duration = isset($gconf['duration'])?$gconf['duration']:36*86400; // 36 days
505       $slice = isset($gconf['slice'])?$gconf['slice']:7200; // 2 hours
506       // vertical lines at month borders
507       $addSpecial .= ' VRULE:'.strtotime(date('Y-m-01')).'#FF0000';
508       $addSpecial .= ' VRULE:'.strtotime(date('Y-m-01').' -1 month').'#FF0000';
509     }
510     elseif ($timeframe == 'year') {
511       $duration = isset($gconf['duration'])?$gconf['duration']:396*86400; // 365+31 days
512       $slice = isset($gconf['slice'])?$gconf['slice']:86400; // 1 day
513       // vertical lines at month borders
514       $addSpecial .= ' VRULE:'.strtotime(date('Y-01-01 12:00:00')).'#FF0000';
515       $addSpecial .= ' VRULE:'.strtotime(date('Y-01-01 12:00:00').' -1 year').'#FF0000';
516     }
517     else {
518       $duration = isset($gconf['duration'])?$gconf['duration']:$this->rrd_step*500; // 500 steps
519       $slice = isset($gconf['slice'])?$gconf['slice']:$this->rrd_step; // whatever our step is
520     }
521
522     if (isset($gconf['rows']) && count($gconf['rows'])) {
523       foreach ($gconf['rows'] as $erow) {
524         if (isset($erow['name']) && strlen($erow['name'])) {
525           if (!isset($erow['scale']) && isset($gconf['scale'])) { $erow['scale'] = $gconf['scale']; }
526           $grow = array();
527           $grow['dType'] = isset($erow['dType'])?$erow['dType']:'DEF';
528           $grow['name'] = $erow['name'].(isset($erow['scale'])?'_tmp':'');
529           if ($grow['dType'] == 'DEF') {
530             $grow['dsname'] = isset($erow['dsname'])?$erow['dsname']:$erow['name'];
531             if (isset($erow['dsfile'])) { $grow['dsfile'] = $erow['dsfile']; }
532             $grow['cf'] = isset($erow['cf'])?$erow['cf']:'AVERAGE';
533           }
534           else {
535             $grow['rpn_expr'] = isset($erow['rpn_expr'])?$erow['rpn_expr']:'0';
536           }
537           if (isset($erow['scale'])) {
538             $graphrows[] = $grow;
539             $grow = array();
540             $grow['dType'] = 'CDEF';
541             $grow['name'] = $erow['name'];
542             $grow['rpn_expr'] = $erow['name'].'_tmp,'.$erow['scale'].',*';
543           }
544           $grow['gType'] = isset($erow['gType'])?$erow['gType']:'LINE1';
545           $grow['color'] = isset($erow['color'])?$erow['color']:$gColors[$gC++];
546           if ($gC >= count($gColors)) { $gC = 0; }
547           if (isset($erow['legend'])) {
548             $grow['legend'] = $erow['legend'];
549             if (!isset($gconf['show_legend'])) { $gconf['show_legend'] = true; }
550           }
551           if (isset($erow['stack'])) { $grow['stack'] = ($erow['stack'] == true); }
552           if (isset($erow['desc'])) { $grow['desc'] = $erow['desc']; }
553           $graphrows[] = $grow;
554         }
555       }
556     }
557     else {
558       foreach ($this->rrd_fields as $key=>$ds) {
559         $grow = array();
560         $grow['dType'] = 'DEF';
561         $grow['name'] = $ds['name'].(isset($gconf['scale'])?'_tmp':'');
562         $grow['dsname'] = $ds['name'];
563         $grow['cf'] = 'AVERAGE';
564         if (isset($gconf['scale'])) {
565           $graphrows[] = $grow;
566           $grow = array();
567           $grow['dType'] = 'CDEF';
568           $grow['name'] = $ds['name'];
569           $grow['rpn_expr'] = $ds['name'].'_tmp,'.$gconf['scale'].',*';
570         }
571         $grow['gType'] = ((count($this->rrd_fields)==2) && ($key==0))?'AREA':'LINE1';
572         $grow['color'] = $gColors[$gC++]; if ($gC >= count($gColors)) { $gC = 0; }
573         if (isset($ds['legend'])) {
574           $grow['legend'] = $ds['legend'];
575           if (!isset($gconf['show_legend'])) { $gconf['show_legend'] = true; }
576         }
577         if (isset($ds['desc'])) { $grow['desc'] = $ds['desc']; }
578         $graphrows[] = $grow;
579       }
580     }
581
582     if (isset($gconf['special']) && count($gconf['special'])) {
583       foreach ($gconf['special'] as $crow) {
584         $srow = array();
585         $srow['sType'] = isset($crow['sType'])?$crow['sType']:'COMMENT';
586         if ($grow['sType'] != 'COMMENT') {
587           // XXX: use line below and remove cf var once we have rrdtol 1.2
588           // $srow['name'] = $crow['name'].(isset($crow['cf'])?'_'.$crow['cf']:'');
589           $srow['name'] = $crow['name'];
590           $srow['cf'] = isset($crow['cf'])?$crow['cf']:'AVERAGE';
591           if (isset($crow['cf'])) {
592             // XXX: use line below once we have rrdtol 1.2
593             // $graphrows[] = array('dType'=>'VDEF', 'name'=>$srow['name'].'_'.$crow['cf'], 'rpn_expr'=>$srow['name'].','.$crow['cf']);
594           }
595           elseif (isset($crow['rpn_expr'])) {
596             // XXX: does only work with rrdtool 1.2
597             $graphrows[] = array('dType'=>'VDEF', 'name'=>$srow['name'], 'rpn_expr'=>$crow['rpn_expr']);
598           }
599         }
600         $srow['text'] = isset($crow['text'])?$crow['text']:'';
601         $specialrows[] = $srow;
602       }
603     }
604     else {
605       $td = $this->mod_textdomain;
606       foreach ($graphrows as $grow) {
607         if (isset($grow['gType']) && strlen($grow['gType'])) {
608           $textprefix = isset($grow['desc'])?$grow['desc']:(isset($grow['legend'])?$grow['legend']:$grow['name']);
609           // XXX: use lines below once we have rrdtol 1.2
610           // $graphrows[] = array('dType'=>'VDEF', 'name'=>$grow['name'].'_last', 'rpn_expr'=>$grow['name'].',LAST');
611           // $specialrows[] = array('sType'=>'PRINT', 'name'=>$grow['name'].'_last', 'text'=>'%3.2lf%s');
612           $specialrows[] = array('sType'=>'PRINT', 'name'=>$grow['name'], 'cf'=>'MAX', 'text'=>$textprefix.'|'.dgettext($td, 'Maximum').'|%.2lf%s');
613           $specialrows[] = array('sType'=>'PRINT', 'name'=>$grow['name'], 'cf'=>'AVERAGE', 'text'=>$textprefix.'|'.dgettext($td, 'Average').'|%.2lf%s');
614           $specialrows[] = array('sType'=>'PRINT', 'name'=>$grow['name'], 'cf'=>'LAST', 'text'=>$textprefix.'|'.dgettext($td, 'Current').'|%.2lf%s');
615         }
616       }
617     }
618
619     $endtime = isset($gconf['time_end'])?$gconf['time_end']:(is_numeric($this->last_update())?$this->last_update():time());
620     $gOpts = ' --start '.($endtime-$duration).' --end '.$endtime.' --step '.$slice;
621     if (isset($gconf['label_top'])) { $gOpts .= ' --title '.$this->text_quote($gconf['label_top']); }
622     if (isset($gconf['label_y'])) { $gOpts .= ' --vertical-label '.$this->text_quote($gconf['label_y']); }
623     if (isset($gconf['width'])) { $gOpts .= ' --width '.$gconf['width']; }
624     if (isset($gconf['height'])) { $gOpts .= ' --height '.$gconf['height'];
625       if (($gconf['height'] <= 32) && isset($gconf['thumb']) && ($gconf['thumb'])) { $gOpts .= ' --only-graph'; }
626     }
627     if (!isset($gconf['show_legend']) || (!$gconf['show_legend'])) { $gOpts .= ' --no-legend'; }
628     if (isset($gconf['min_y'])) { $gOpts .= ' --lower-limit '.$gconf['min_y']; }
629     if (isset($gconf['max_y'])) { $gOpts .= ' --upper-limit '.$gconf['max_y']; }
630     if (isset($gconf['fix_scale_y']) && $gconf['fix_scale_y']) { $gOpts .= ' --rigid'; }
631     if (isset($gconf['grid_x'])) { $gOpts .= ' --x-grid '.$gconf['grid_x']; }
632     if (isset($gconf['grid_y'])) { $gOpts .= ' --y-grid '.$gconf['grid_y']; }
633     if (isset($gconf['units_exponent'])) { $gOpts .= ' --units-exponent '.$gconf['units_exponent']; }
634     if (isset($gconf['units_length'])) { $gOpts .= ' --units-length '.$gconf['units_length']; }
635     if (!isset($gconf['force_recreate']) || (!$gconf['force_recreate'])) { $gOpts .= ' --lazy'; }
636     if (isset($gconf['force_color']) && is_array($gconf['force_color'])) {
637       foreach ($gconf['force_color'] as $ctag=>$cval) { $gOpts .= ' --color '.$ctag.$cval; }
638     }
639     if (isset($gconf['force_font']) && is_array($gconf['force_font'])) {
640       foreach ($gconf['force_font'] as $ctag=>$cval) { $gOpts .= ' --font '.$ctag.$cval; }
641     }
642     if (isset($gconf['units_binary']) && $gconf['units_binary']) { $gOpts .= ' --base 1024'; }
643
644     foreach ($graphrows as $grow) {
645       if (isset($grow['dType']) && strlen($grow['dType'])) {
646         $gDefs .= ' '.$grow['dType'].':'.$grow['name'].'=';
647         if ($grow['dType'] == 'DEF') {
648           $gDefs .= isset($grow['dsfile'])?$grow['dsfile']:$this->rrd_file;
649           $gDefs .= ':'.$grow['dsname'].':'.$grow['cf'];
650         }
651         else { $gDefs .= $grow['rpn_expr']; }
652       }
653       if (isset($grow['gType']) && strlen($grow['gType'])) {
654         // XXX: change from STACK type to STACK flag once we have rrdtool 1.2
655         if (isset($grow['stack']) && $grow['stack']) { $grow['gType'] = 'STACK'; }
656         $gGraphs .= ' '.$grow['gType'].':'.$grow['name'].$grow['color'];
657         if (isset($grow['legend'])) { $gGraphs .= ':'.$this->text_quote($grow['legend']); }
658         // XXX: remove above STACK if-command and uncomment the one below once we have rrdtool 1.2
659         //if (isset($grow['stack']) && $grow['stack']) { $gGraphs .= ':STACK'; }
660       }
661     }
662
663     foreach ($specialrows as $srow) {
664       $addSpecial .= ' '.$srow['sType'];
665       // XXX: eliminate cf once we have rrdtool 1.2
666       // $addSpecial .= ($grow['sType']!='COMMENT')?':'.$grow['name']:'');
667       $addSpecial .= (($srow['sType']!='COMMENT')?':'.$srow['name'].':'.$srow['cf']:'');
668       $addSpecial .= ':'.$this->text_quote($srow['text']);
669     }
670
671     $graph_cmd = 'rrdtool graph '.str_replace('*', '\*', $fname.$gOpts.$gDefs.$gGraphs.$addSpecial);
672     $return = `$graph_cmd 2>&1`;
673
674     if (strpos($return, 'ERROR') !== false) {
675       trigger_error($this->rrd_file.' - rrd graph error: '.$return, E_USER_WARNING);
676       $return = $graph_cmd."\n\n".$return;
677     }
678     $return = 'file:'.$fname."\n".$return;
679   return $return;
680   }
681
682   function graph_plus($timeframe = 'day', $sub = null, $extra = null) {
683     // create a RRD graph and return meta info as a ready-to-use array
684     $gmeta = array('filename'=>null);
685     $ret = $this->graph($timeframe, $sub, $extra);
686     if (strpos($ret, "\n\n") !== false) { $gmeta['graph_cmd'] = substr($ret, 0, strpos($ret, "\n\n")); $ret = substr($ret, strpos($ret, "\n\n")+2); }
687     else { $gmeta['graph_cmd'] = null; }
688     $grout = explode("\n", $ret);
689     foreach ($grout as $gline) {
690       if (preg_match('/^file:(.+)$/', $gline, $regs)) {
691         $gmeta['filename'] = $regs[1];
692       }
693       elseif (preg_match('/^(\d+)x(\d+)$/', $gline, $regs)) {
694         $gmeta['width'] = $regs[1]; $gmeta['height'] = $regs[2];
695       }
696       elseif (preg_match('/^([^\|]+)\|([^|]+)\|([^\|]*)$/', $gline, $regs)) {
697         $gmeta['data'][$regs[1]][$regs[2]] = $regs[3];
698       }
699       elseif (preg_match('/^([^\|]+)\|([^\|]*)$/', $gline, $regs)) {
700         $gmeta['var'][$regs[1]] = $regs[2];
701       }
702       elseif (strlen(trim($gline))) {
703         $gmeta['info'][] = $gline;
704       }
705     }
706     if (is_null($gmeta['filename'])) {
707       $gmeta['filename'] = $this->basename.(!is_null($sub)?'-'.$sub:'').'-'.$timeframe.'.png';
708     }
709   return $gmeta;
710   }
711
712   function page($sub = null, $page_extras = null, $graph_extras = null) {
713     // create a (HTML) page and return it in a string
714
715     // assemble configuration
716     $pconf = (array)$page_extras;
717     if (!is_null($sub) && is_array($this->config_raw['page.'.$sub])) {
718       $pconf = $pconf + $this->config_raw['page.'.$sub];
719     }
720     $pconf = $pconf + (array)$this->config_page;
721
722     $return = null;
723     switch (@$pconf['type']) {
724       case 'index':
725         $return = $this->page_index($pconf);
726         break;
727       case 'overview':
728         $return = $this->page_overview($pconf, $graph_extras);
729         break;
730       case 'simple':
731       default:
732         $return = $this->page_simple($pconf, $graph_extras);
733         break;
734     }
735   return $return;
736   }
737
738   function simple_html($sub = null, $page_extras = null, $graph_extras = null) {
739     // create a simple (MRTG-like) HTML page and return it in a string
740     // XXX: this is here temporarily for compat only, it's preferred to use page()!
741
742     // assemble configuration
743     $pconf = (array)$page_extras;
744     if (!is_null($sub) && is_array($this->config_raw['page.'.$sub])) {
745       $pconf = $pconf + $this->config_raw['page.'.$sub];
746     }
747     $pconf = $pconf + (array)$this->config_page;
748
749   return $this->page_simple($pconf, $graph_extras);
750   }
751
752   function page_index($pconf) {
753     // create a bare, very simple index list HTML page and return it in a string
754     $td = $this->mod_textdomain;
755     $ptitle = isset($pconf['title_page'])?$pconf['title_page']:dgettext($td, 'RRD statistics index');
756
757     $out = '<html><head>';
758     $out .= '<title>'.$ptitle.'</title>';
759     $out .= '<style>';
760     if (isset($pconf['style_base'])) { $out .= $pconf['style_base']; }
761     else {
762       $out .= 'h1 { font-weight: bold; font-size: 1.5em; }';
763       $out .= '.footer { font-size: 0.75em; margin: 0.5em 0; }';
764       $out .= 'li.scanfile { font-style: italic; }';
765     }
766     if (isset($pconf['style'])) { $out .= $pconf['style']; }
767     $out .= '</style>';
768     $out .= '</head>';
769     $out .= '<body>';
770
771     $out .= '<h1>'.$ptitle.'</h1>';
772     if (isset($pconf['text_intro']) && strlen($pconf['text_intro'])) {
773       $out .= '<p class="intro">'.$pconf['text_intro'].'</p>';
774     }
775     elseif (!isset($pconf['text_intro'])) {
776       $out .= '<p class="intro">'.dgettext($td, 'The following RRD stats are available:').'</p>';
777     }
778
779     $stats = $this->h_page_statsArray($pconf);
780
781     if (isset($pconf['stats_url'])) { $sURL_base = $pconf['stats_url']; }
782     else { $sURL_base = '?stat=%i%a'; }
783
784     if (isset($pconf['stats_url_add'])) { $sURL_add = $pconf['stats_url_add']; }
785     else { $sURL_add = '&sub=%s'; }
786
787     $out .= '<ul class="indexlist">';
788     foreach ($stats as $stat) {
789       $out .= '<li'.(isset($stat['class'])?' class="'.$stat['class'].'"':'').'>';
790       $sURL = str_replace('%i', $stat['name'], $sURL_base);
791       $sURL = str_replace('%a', '', $sURL);
792       $sURL = str_replace('%s', '', $sURL);
793       $out .= '<a href="'.$sURL.'">'.$stat['name'].'</a>';
794       if (isset($stat['sub']) && count($stat['sub'])) {
795         $sprt = array();
796         foreach ($stat['sub'] as $ssub) {
797           $sURL = str_replace('%i', $stat['name'], $sURL_base);
798           $sURL = str_replace('%a', $sURL_add, $sURL);
799           $sURL = str_replace('%s', $ssub, $sURL);
800           $sprt[] = '<a href="'.$sURL.'">'.$ssub.'</a>';
801         }
802         $out .= ' <span="subs">('.implode(', ', $sprt).')</span>';
803       }
804       $out .= '</li>';
805     }
806     $out .= '</ul>';
807
808     $out .= $this->h_page_footer();
809     $out .= '</body></html>';
810   return $out;
811   }
812
813   function page_overview($pconf, $graph_extras = null) {
814     // create an overview HTML page (including graphs) and return it in a string
815     $td = $this->mod_textdomain;
816     $ptitle = isset($pconf['title_page'])?$pconf['title_page']:dgettext($td, 'RRD statistics overview');
817
818     $out = '<html><head>';
819     $out .= '<title>'.$ptitle.'</title>';
820     $out .= '<style>';
821     if (isset($pconf['style_base'])) { $out .= $pconf['style_base']; }
822     else {
823       $out .= 'h1 { font-weight: bold; font-size: 1.5em; }';
824       $out .= 'h2 { font-weight: bold; font-size: 1em; margin: 0.5em 0; }';
825       $out .= '.footer { font-size: 0.75em; margin: 0.5em 0; }';
826       $out .= 'img.rrdgraph { border: none; }';
827     }
828     if (isset($pconf['style'])) { $out .= $pconf['style']; }
829     $out .= '</style>';
830     $out .= '</head>';
831     $out .= '<body>';
832
833     $out .= '<h1>'.$ptitle.'</h1>';
834     if (isset($pconf['text_intro'])) { $out .= '<p class="intro">'.$pconf['text_intro'].'</p>'; }
835
836     $stats = $this->h_page_statsArray($pconf);
837
838     if (isset($pconf['stats_url'])) { $sURL_base = $pconf['stats_url']; }
839     else { $sURL_base = '?stat=%i%a'; }
840
841     if (isset($pconf['stats_url_add'])) { $sURL_add = $pconf['stats_url_add']; }
842     else { $sURL_add = '&sub=%s'; }
843
844     $num_rows = is_numeric($pconf['num_rows'])?$pconf['num_rows']:2;
845     $num_cols = ceil(count($stats)/$num_rows);
846
847     $out .= '<table class="overview">';
848     for ($col = 0; $col < $num_cols; $col++) {
849       $out .= '<tr>';
850       for ($row = 0; $row < $num_rows; $row++) {
851         $idx = $col * $num_rows + $row;
852         $out .= '<td>';
853         if ($idx < count($stats)) {
854           list($sname, $s_psub) = explode('|', $stats[$idx]['name'], 2);
855           $s_psname = 'page'.(isset($s_psub)?'.'.$s_psub:'');
856           $g_sub = $this->config_all[$sname][$s_psname]['graph_sub'];
857
858           if (isset($this->config_all[$sname][$s_psname]['title_page'])) {
859             $s_ptitle = $this->config_all[$sname][$s_psname]['title_page'];
860           }
861           elseif (isset($this->config_all[$sname]['page']['title_page'])) {
862             $s_ptitle = $this->config_all[$sname]['page']['title_page'];
863           }
864           else {
865             $s_ptitle = isset($s_psub)?sprintf(dgettext($td, '%s (%s) statistics'), $sname, $s_psub):sprintf(dgettext($td, '%s statistics'), $sname);
866           }
867           if (!isset($pconf['hide_titles']) || !$pconf['hide_titles']) {
868             $out .= '<h2>'.$s_ptitle.'</h2>';
869           }
870
871           $s_rrd = new rrdstat($this->config_all, $sname);
872           if (in_array($s_rrd->status, array('ok','readonly','graphonly'))) {
873             $tframe = isset($pconf['graph_timeframe'])?$pconf['graph_timeframe']:'day';
874             $gmeta = $s_rrd->graph_plus($tframe, $g_sub);
875             if (isset($pconf['graph_url'])) {
876               $gURL = $pconf['graph_url'];
877               $gURL = str_replace('%f', basename($gmeta['filename']), $gURL);
878               $gURL = str_replace('%p', $gmeta['filename'], $gURL);
879               if (substr($gURL, -1) == '/') { $gURL .= $gmeta['filename']; }
880             }
881             else {
882               $gURL = $gmeta['filename'];
883             }
884             $sURL = str_replace('%i', $sname, $sURL_base);
885             $sURL = str_replace('%a', isset($s_psub)?$sURL_add:'', $sURL);
886             $sURL = str_replace('%s', isset($s_psub)?$s_pub:'', $sURL);
887             $out .= '<a href="'.$sURL.'">';
888             $out .= '<img src="'.$gURL.'"';
889             $out .= ' alt="'.$s_rrd->basename.(!is_null($g_sub)?' - '.$g_sub:'').' - '.$tframe.'" class="rrdgraph"';
890             if (isset($gmeta['width']) && isset($gmeta['height'])) { $out .= ' style="width:'.$gmeta['width'].'px;height:'.$gmeta['height'].'px;"'; }
891             $out .= '></a>';
892           }
893           else {
894             $out .= sprintf(dgettext($td, 'RRD error: status is "%s"'), $s_rrd->status);
895           }
896         }
897         else {
898           $out .= '&nbsp;';
899         }
900         $out .= '</td>';
901       }
902       $out .= '</tr>';
903     }
904     $out .= '</table>';
905
906     $out .= $this->h_page_footer();
907     $out .= '</body></html>';
908   return $out;
909   }
910
911   function page_simple($pconf, $graph_extras = null) {
912     // create a simple (MRTG-like) HTML page and return it in a string
913     $td = $this->mod_textdomain;
914
915     $ptitle = isset($pconf['title_page'])?$pconf['title_page']:sprintf(dgettext($td, '%s - RRD statistics'),$this->basename);
916     $gtitle = array();
917     $gtitle['day'] = isset($pconf['title_day'])?$pconf['title_day']:dgettext($td, 'Day overview (scaling 5 minutes)');
918     $gtitle['week'] = isset($pconf['title_week'])?$pconf['title_week']:dgettext($td, 'Week overview (scaling 30 minutes)');
919     $gtitle['month'] = isset($pconf['title_month'])?$pconf['title_month']:dgettext($td, 'Month overview (scaling 2 hours)');
920     $gtitle['year'] = isset($pconf['title_year'])?$pconf['title_year']:dgettext($td, 'Year overview (scaling 1 day)');
921
922     $out = '<html><head>';
923     $out .= '<title>'.$ptitle.'</title>';
924     $out .= '<style>';
925     if (isset($pconf['style_base'])) { $out .= $pconf['style_base']; }
926     else {
927       $out .= 'h1 { font-weight: bold; font-size: 1.5em; }';
928       $out .= 'h2 { font-weight: bold; font-size: 1em; }';
929       $out .= '.gdata, .gvar, .ginfo { font-size: 0.75em; margin: 0.5em 0; }';
930       $out .= 'table.gdata { border: 1px solid gray; border-collapse: collapse; }';
931       $out .= 'table.gdata td, table.gdata th { border: 1px solid gray; padding: 0.1em 0.2em; }';
932       $out .= '.footer { font-size: 0.75em; margin: 0.5em 0; }';
933     }
934     if (isset($pconf['style'])) { $out .= $pconf['style']; }
935     $out .= '</style>';
936     $out .= '</head>';
937     $out .= '<body>';
938
939     $out .= '<h1>'.$ptitle.'</h1>';
940     if (!isset($pconf['show_update']) || $pconf['show_update']) {
941       $out .= '<p class="last_up">';
942       if (is_null($this->last_update())) { $up_time = dgettext($td, 'unknown'); }
943       elseif (class_exists('baseutils')) { $up_time = baseutils::dateFormat($this->last_update(), 'short'); }
944       else { $up_time = date('Y-m-d H:i:s', $this->last_update()); }
945       $out .= sprintf(dgettext($td, 'Last Update: %s'), $up_time);
946       $out .= '</p>';
947     }
948
949     $g_sub = isset($pconf['graph_sub'])?$pconf['graph_sub']:null;
950     if (in_array($this->status, array('ok','readonly','graphonly'))) {
951       foreach (array('day','week','month','year') as $tframe) {
952         $gmeta = $this->graph_plus($tframe, $g_sub, $graph_extras);
953         if (isset($pconf['graph_url'])) {
954           $gURL = $pconf['graph_url'];
955           $gURL = str_replace('%f', basename($gmeta['filename']), $gURL);
956           $gURL = str_replace('%p', $gmeta['filename'], $gURL);
957           if (substr($gURL, -1) == '/') { $gURL .= $gmeta['filename']; }
958         }
959         else {
960           $gURL = $gmeta['filename'];
961         }
962         $out .= '<div class="'.$tframe.'">';
963 //         $out .= '<p>'.nl2br($ret).'</p>';
964         $out .= '<h2>'.$gtitle[$tframe].'</h2>';
965         $out .= '<img src="'.$gURL.'"';
966         $out .= ' alt="'.$this->basename.(!is_null($g_sub)?' - '.$g_sub:'').' - '.$tframe.'" class="rrdgraph"';
967         if (isset($gmeta['width']) && isset($gmeta['height'])) { $out .= ' style="width:'.$gmeta['width'].'px;height:'.$gmeta['height'].'px;"'; }
968         $out .= '>';
969         if (isset($gmeta['data']) && count($gmeta['data'])) {
970           $out .= '<table class="gdata">';
971           foreach ($gmeta['data'] as $field=>$gdata) {
972             $out .= '<tr><th>'.$field.'</th>';
973             foreach ($gdata as $gkey=>$gval) {
974               $out .= '<td><span class="gkey">'.$gkey.': </span>'.$gval.'</td>';
975             }
976             $out .= '</tr>';
977           }
978           $out .= '</table>';
979         }
980         if (isset($gmeta['var']) && count($gmeta['var'])) {
981           foreach ($gmeta['var'] as $gkey=>$gval) {
982             $out .= '<p class="gvar"><span class="gkey">'.$gkey.': </span>'.$gval.'</p>';
983           }
984         }
985         if (isset($gmeta['info']) && count($gmeta['info'])) {
986           foreach ($gmeta['info'] as $gval) {
987             $out .= '<p class="ginfo">'.$gval.'</p>';
988           }
989         }
990         $out .= '</div>';
991       }
992     }
993     else {
994       $out .= sprintf(dgettext($td, 'RRD error: status is "%s"'), $this->status);
995     }
996
997     $out .= $this->h_page_footer();
998     $out .= '</body></html>';
999   return $out;
1000   }
1001
1002   function h_page_statsArray($pconf) {
1003     // return array of stats to list on a page
1004     $stats = array();
1005     $snames = array(); $s_exclude = array(); $sfiles = array();
1006     if (isset($pconf['index_ids'])) {
1007       foreach (explode(',', $pconf['index_ids']) as $iid) {
1008         if ($iid{0} == '-') { $s_exclude[] = substr($iid, 1); }
1009         else { $snames[] = $iid; }
1010       }
1011     }
1012     if (!isset($pconf['scan_config']) || $pconf['scan_config']) {
1013       foreach ($this->config_all as $iname=>$rinfo) {
1014         if (($iname != '*') && !(isset($rinfo['hidden']) && $rinfo['hidden']) &&
1015             !(in_array($iname, $snames)) && !(in_array($iname, $s_exclude))) {
1016           $snames[] = $iname;
1017         }
1018       }
1019     }
1020     foreach ($snames as $iname) {
1021       $newstat = array('name'=>$iname);
1022       $sfiles[] = isset($this->config_all[$iname]['file'])?$this->config_all[$iname]['file']:$iname.'.rrd';
1023       if (is_array($this->config_all[$iname])) {
1024         foreach ($this->config_all[$iname] as $key=>$val) {
1025           if (substr($key, 0, 5) == 'page.') { $newstat['sub'][] = substr($key, 5); }
1026         }
1027       }
1028       $stats[] = $newstat;
1029     }
1030     if (isset($pconf['scan_files']) && $pconf['scan_files']) {
1031       $rrdfiles = glob('*.rrd');
1032       foreach ($rrdfiles as $rrdfile) {
1033         $iname = (substr($rrdfile, -4) == '.rrd')?substr($rrdfile, 0, -4):$rrdfile;
1034         if (!in_array($rrdfile, $sfiles) && !(in_array($iname, $s_exclude))) {
1035           $stats[] = array('name'=>$iname, 'class'=>'scanfile');
1036         }
1037       }
1038     }
1039   return $stats;
1040   }
1041
1042   function h_page_footer() {
1043     // return generic page footer
1044     $out = '<p class="footer">';
1045     $out .= sprintf(dgettext($this->mod_textdomain, 'Statistics created with %s using a library created by %s.'),
1046                     '<a href="http://people.ee.ethz.ch/~oetiker/webtools/rrdtool/">RRDtool</a>',
1047                     '<a href="http://www.kairo.at/">KaiRo.at</a>');
1048     $out .= '</p>';
1049   return $out;
1050   }
1051
1052   function text_quote($text) { return '"'.str_replace('"', '\"', str_replace(':', '\:', $text)).'"'; }
1053 }
1054 ?>