doc/rrdlastupdate.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   2 <html xmlns="http://www.w3.org/1999/xhtml">
   3 <head>
   4 <title>rrdlastupdate</title>
   5 <link rev="made" href="mailto:root@localhost" />
   6 </head>
   7
   8 <body style="background-color: white">
   9
  10 <p><a name="__index__"></a></p>
  11 <!-- INDEX BEGIN -->
  12 <!--
  13
  14 <ul>
  15
  16         <li><a href="#name">NAME</a></li>
  17         <li><a href="#synopsis">SYNOPSIS</a></li>
  18         <li><a href="#description">DESCRIPTION</a></li>
  19         <li><a href="#environment_variables">ENVIRONMENT VARIABLES</a></li>
  20         <li><a href="#author">AUTHOR</a></li>
  21 </ul>
  22 -->
  23 <!-- INDEX END -->
  24
  25 <p>
  26 </p>
  27 <h1><a name="name">NAME</a></h1>
  28 <p>rrdlastupdate - Return the most recent update to an RRD</p>
  29 <p>
  30 </p>
  31 <hr />
  32 <h1><a name="synopsis">SYNOPSIS</a></h1>
  33 <p><strong>rrdtool</strong> <strong>lastupdate</strong> <em>filename</em>
  34 [<strong>--daemon</strong>&nbsp;<em>address</em>]</p>
  35 <p>
  36 </p>
  37 <hr />
  38 <h1><a name="description">DESCRIPTION</a></h1>
  39 <p>The <strong>lastupdate</strong> function returns the UNIX timestamp and the
  40 value stored for each datum in the most recent update of an RRD.</p>
  41 <dl>
  42 <dt><strong><a name="item_filename"><em>filename</em></a></strong><br />
  43 </dt>
  44 <dd>
  45 The name of the <strong>RRD</strong> that contains the data.
  46 </dd>
  47 <p></p>
  48 <dt><strong><a name="item__2d_2ddaemon_address"><strong>--daemon</strong> <em>address</em></a></strong><br />
  49 </dt>
  50 <dd>
  51 Address of the <a href="././rrdcached.html">the rrdcached manpage</a> daemon. If specified, a <code>flush</code> command is sent
  52 to the server before reading the RRD files. This allows <strong>rrdtool</strong> to return
  53 fresh data even if the daemon is configured to cache values for a long time.
  54 For a list of accepted formats, see the <strong>-l</strong> option in the <a href="././rrdcached.html">the rrdcached manpage</a> manual.
  55 </dd>
  56 <dd>
  57 <pre>
  58  rrdtool lastupdate --daemon unix:/var/run/rrdcached.sock /var/lib/rrd/foo.rrd</pre>
  59 </dd>
  60 <p></p></dl>
  61 <p>
  62 </p>
  63 <hr />
  64 <h1><a name="environment_variables">ENVIRONMENT VARIABLES</a></h1>
  65 <p>The following environment variables may be used to change the behavior of
  66 <code>rrdtoollastupdate</code>:</p>
  67 <dl>
  68 <dt><strong><a name="item_rrdcached_address"><strong>RRDCACHED_ADDRESS</strong></a></strong><br />
  69 </dt>
  70 <dd>
  71 If this environment variable is set it will have the same effect as specifying
  72 the <code>--daemon</code> option on the command line. If both are present, the command
  73 line argument takes precedence.
  74 </dd>
  75 <p></p></dl>
  76 <p>
  77 </p>
  78 <hr />
  79 <h1><a name="author">AUTHOR</a></h1>
  80 <p>Andy Riebs &lt;<a href="mailto:andy.riebs@hp.com">andy.riebs@hp.com</a>&gt;</p>
  81
  82 </body>
  83
  84 </html>