doc/rrdlast.html

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