RRDCGI(1)                           rrdtool                          RRDCGI(1)


<?><?><?> (NAME)
       rrdcgi - <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> RRD <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       "#!/path/to/"rrdcgi [--filter|-f]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?><?> rrdcgi <?><?> <?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?>.
       <?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> cgi <?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <RRD:: <?><?><?>. rrdcgi <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?> <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>. <?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> CGI <?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?>.

       <?><?><?><?><?><?> rrdcgi <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
       <?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>. <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?>. <?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
       <?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?>.

       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> C-shell
       <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       --filter|-f
               <?><?><?> <?><?><?><?><?><?> <?><?> rrdcgi <?><?>
               <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
               <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?> cgi.

   <?><?><?><?><?><?><?><?><?><?><?> (Keywords)
       RRD::CV name
               <?><?><?><?><?> CGI <?><?> <?><?><?> <?><?><?><?><?><?><?><?>
               <?><?> <?><?><?> <?><?><?><?><?><?>.

       RRD::CV::QUOTE name
               <?><?><?><?><?> CGI <?><?> <?><?><?> <?><?><?><?><?><?><?><?>
               <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?>
               <?><?><?><?><?><?><?><?><?><?><?><?><?> (quote)
               <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
               <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
               <?><?><?><?><?> <?><?><?><?> RRD:: <?><?><?><?><?>
               <?><?><?><?>. <?><?> <?><?><?> <?><?><?><?><?> <?><?><?>
               <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> CGI
               <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
               <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
               <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
               <?><?><?><?><?><?>.

       RRD::CV::PATH name
               <?><?><?><?><?> CGI <?><?> <?><?><?> <?><?><?><?><?><?><?><?>
               <?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?>
               <?><?><?><?><?><?> <?> <?><?><?><?><?><?><?> <?><?><?><?>
               <?><?><?><?><?><?> <?><?> <?><?> <?><?> '/' <?><?><?><?>
               <?><?><?> <?> <?><?> <?><?><?><?> '..' <?><?><?><?>. <?><?><?>
               <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?>
               <?><?><?> <?><?> <?><?><?> <?><?><?> <?><?><?><?>
               <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
               <?><?><?><?> <?><?><?><?> CGI <?><?><?><?> <?><?><?>.

       RRD::GETENV variable
               <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
               <?><?><?><?><?><?> <?><?><?><?><?><?>.

                <RRD::GETENV REMOTE_USER>

               <?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
               <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>
               <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
               <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?>
               <?><?><?><?><?> <?><?><?><?><?><?> (remote user) <?><?> <?><?>
               <?><?><?> <?><?><?><?><?><?><?><?><?>.

       RRD::GOODFOR seconds
               <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?>
               <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
               <?><?> <?><?><?><?> <?><?><?><?><?><?>. <?><?><?> <?><?><?>
               <?><?><?><?> <?><?><?><?><?><?> rrdcgi
               <?><?><?><?><?><?><?><?><?> Last-Modified <?> Expire <?> <?><?>
               <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
               <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?> Refresh
               <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?>.

       RRD::INCLUDE filename
               <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
               <?><?><?><?> <?><?><?><?>
               <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> cgi
               <?><?><?><?><?><?><?><?><?>.

       RRD::SETENV variable value
               <?><?><?> <?><?><?><?><?><?><?><?><?>
               <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?>
               <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
               <?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>
               <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>

                <RRD::SETENV TZ UTC>

               <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?>
               <?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
               <?><?><?><?> <?><?><?><?><?> (Universal Time) <?><?><?><?><?>
               <?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?>
               <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
               <?><?><?><?> TZ <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?>
               <?><?><?><?><?> <?><?><?><?>.

       RRD::SETVAR variable value
               <?><?><?><?><?> SETENV<?> <?><?><?> <?><?><?><?>
               <?><?><?><?><?><?><?><?> <?><?><?><?>.

       RRD::GETVAR variable
               <?><?><?><?><?> GETENV<?> <?><?><?> <?><?><?><?>
               <?><?><?><?><?><?><?><?> <?><?><?><?>.

       RRD::TIME::LAST rrd-file strftime-format
               <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
               <?><?><?><?><?> RRD <?><?><?><?><?><?><?><?><?><?>
               <?><?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?> <?><?>
               <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
               <?><?><?><?><?><?><?> <?><?><?> <?> <?><?> <?><?><?><?>
               strftime <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       RRD::TIME::NOW strftime-format
               <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
               <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>.
               <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
               <?><?> <?><?><?><?><?><?><?> <?> <?><?> <?><?><?><?> strftime
               <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.

               <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
               <?><?> <?><?><?><?> strftime <?><?><?> <?><?> <?><?><?><?> (:)
               <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
               <?><?><?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
               <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
               GRAPH <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
               <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> \
               <?><?> <?><?><?><?><?> <?><?><?><?> (escape)
               <?><?><?><?><?><?>.

       RRD::TIME::STRFTIME START|END start-spec end-spec strftime-format
               <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
               <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> strftime
               <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
               strftime-format <?><?><?> start-spec <?><?> end-spec
               (<?><?><?><?> <?><?> <?><?><?> <?><?> START <?><?> END
               <?><?><?><?> <?><?><?> <?><?><?><?>) <?><?><?><?><?><?><?>
               <?><?><?><?><?><?>. <?><?> <?><?> <?><?><?><?><?> start-spec
               <?> end-spec <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
               <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
               <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?>
               <?><?><?><?><?>. <?><?><?> <?><?> <?><?><?> <?><?><?><?>
               <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
               <?><?><?> <?><?><?><?><?><?><?><?> <?><?>
               <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?>
               <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
               <?><?> RRDtool <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
               <<-2weeks>> <?><?><?><?>.

               <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
               <?><?> <?><?><?> <?><?> <?><?><?><?> strftime <?><?><?> <?><?>
               <?><?><?><?> (:) <?><?><?><?><?><?><?><?><?><?><?><?><?><?>
               <?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?> <?><?>
               <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
               <?><?><?><?><?> GRAPH <?><?><?><?><?><?><?> <?><?><?><?>
               <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
               <?><?><?><?><?><?><?> <?><?> \ <?><?> <?><?> <?><?><?><?>
               <?><?><?><?><?><?>.

       RRD::GRAPH rrdgraph arguments
               <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> RRD
               <?><?><?><?><?><?><?><?><?> <?><?>
               <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
               <?><?><?><?> <?> <?><?><?> <?><?> <?><?> <?><?><?><?><?>
               <?><?><?><?><?> <IMG ... > <?><?> <?><?> <?><?><?><?><?><?>
               <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
               <?><?><?><?><?><?>. <?><?><?><?><?> --lazy <?><?> rrdgraph
               <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
               <?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
               <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>
               <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
               <?><?><?><?><?><?><?> <?><?><?>.
               <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> RRD::GRAPH
               <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
               <?><?> <?><?><?><?> <?><?><?><?><?><?><?> rrdgraph <?><?><?>
               <?><?><?><?><?><?><?>.

               <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?>
               <?><?><?><?> <?><?> <?><?><?><?><?> --lazy <?><?>
               <?><?><?><?><?><?><?><?><?> RRD::GRAPH <?><?><?><?><?><?><?>
               <?><?><?><?>. <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
               <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?>
               <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
               <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
               <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.

               <?><?><?> <?><?><?><?> --imginfo <?><?><?><?><?><?><?>
               <?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
               <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>:

                <IMG SRC="%s" WIDTH="%lu" HEIGHT="%lu">

               <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> %s
               <?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?>
               <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?>
               <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?>
               <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
               <?><?><?><?> PNG <?><?><?><?><?><?> <?><?><?><?><?>
               <?><?><?><?><?><?> <?><?>.

       RRD::PRINT number
               <?><?><?> <?><?><?><?><?> RRD::GRAPH <?><?><?><?> <?><?><?><?>
               <?><?><?><?><?><?> <?><?><?><?><?><?><?> PRINT <?><?><?><?>
               <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?>
               <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
               <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>.
               <?><?><?><?><?><?><?> number <?><?> <?><?><?><?><?>
               <?><?><?><?><?><?><?> PRINT <?><?><?><?><?> <?><?><?><?>.
               <?><?><?><?><?><?> PRINT <?><?><?><?><?> <?><?><?><?><?> 0
               <?><?><?>.

       RRD::INTERNAL <var>
               <?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
               <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>.
               <?><?> <?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
               <?><?><?><?><?><?> <?><?><?><?><?><?><?>: VERSION <?>
               COMPILETIME.  <?><?><?> <?><?><?><?><?><?><?>
               <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?>
               <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>.

<?><?><?><?> <?> (EXAMPLE 1)
       <?><?><?><?> <?><?><?> <?><?> <?><?><?><?> <?><?> <?><?> <?><?>
       <?><?><?><?><?><?> RRD <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>.

        #!/usr/local/bin/rrdcgi
        <HTML>
        <HEAD><TITLE>RRDCGI Demo</TITLE></HEAD>
        <BODY>
        <H1>RRDCGI Example Page</H1>
        <P>
        <RRD::GRAPH demo.png --lazy --title="Temperatures"
                 DEF:cel=demo.rrd:exhaust:AVERAGE
                 LINE2:cel#00a000:"D. Celsius">

        </P>
        </BODY>
        </HTML>

<?><?><?><?> <?> (EXAMPLE 2)
       <?><?><?> <?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?>
       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> RRD_NAME <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>. <?><?><?>
       <?><?> RRD_NAME <?><?><?><?> <?><?><?><?><?><?> RRD <?><?><?><?>
       <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

        #!/usr/local/bin/rrdcgi
        <HTML>
        <HEAD><TITLE>RRDCGI Demo</TITLE></HEAD>
        <BODY>
        <H1>RRDCGI Example Page for <RRD::CV RRD_NAME></H1>
        <H2>Selection</H2>
        <FORM><INPUT NAME=RRD_NAME TYPE=RADIO VALUE=roomA> Room A,
              <INPUT NAME=RRD_NAME TYPE=RADIO VALUE=roomB> Room B.
              <INPUT TYPE=SUBMIT></FORM>
        <H2>Graph</H2>
        <P>
        <RRD::GRAPH <RRD::CV::PATH RRD_NAME>.png --lazy
                 --title "Temperatures for "<RRD::CV::QUOTE RRD_NAME>
                 DEF:cel=<RRD::CV::PATH RRD_NAME>.rrd:exhaust:AVERAGE
                 LINE2:cel#00a000:"D. Celsius">

        </P>
        </BODY>
        </HTML>

<?><?><?><?> <?> (EXAMPLE 3)
       <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
       <?><?> <?><?><?><?><?><?><?><?> RRD<?> <?><?><?><?><?><?><?><?> <?>
       cgi-bin<?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>.

        #!/.../bin/rrdcgi
        <HTML>
        <HEAD><TITLE>RRDCGI Demo</TITLE></HEAD>
        <BODY>
        <H1>RRDCGI test Page</H1>
        <RRD::GRAPH
         /.../web/pngs/testhvt.png
         --imginfo '<IMG SRC=/.../pngs/%s WIDTH=%lu HEIGHT=%lu >'
         --lazy --start -1d --end now
         DEF:http_src=/.../rrds/test.rrd:http_src:AVERAGE
         AREA:http_src#00ff00:http_src
        >
        </BODY>
        </HTML>

       <?><?><?><?> <?>: <?><?><?> /.../ <?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?>.

       <?><?><?><?> <?>: <?><?><?><?><?> SRC=/.../pngs <?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?>/<?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?> (AUTHOR)
       Tobias Oetiker <tobi@oetiker.ch>

1.11.0                            2026-08-08                         RRDCGI(1)