doc/rrdlast.pod

   1 =head1 NAME
   2
   3 rrdlast - Return the date of the last data sample in an RRD
   4
   5 =head1 SYNOPSIS
   6
   7 B<rrdtool> B<last> I<filename>
   8 S<[B<--daemon> I<address>]>
   9
  10 =head1 DESCRIPTION
  11
  12 The B<last> function returns the UNIX timestamp of the most recent
  13 update of the RRD.
  14
  15 =over 8
  16
  17 =item I<filename>
  18
  19 The name of the B<RRD> that contains the data.
  20
  21 =item B<--daemon> I<address>
  22
  23 Address of the L<rrdcached> daemon. If specified, a C<flush> command is sent
  24 to the server before reading the RRD files. This allows B<rrdtool> to return
  25 fresh data even if the daemon is configured to cache values for a long time. To
  26 specify a UNIX domain socket use the prefix C<unix:>, see example below. Other
  27 addresses are interpreted as normal network addresses, i.E<nbsp>e. IPv4 or IPv6
  28 addresses in most cases.
  29
  30  rrdtool last --daemon unix:/var/run/rrdcached.sock /var/lib/rrd/foo.rrd
  31
  32 =back
  33
  34 =head1 ENVIRONMENT VARIABLES
  35
  36 The following environment variables may be used to change the behavior of
  37 C<rrdtoolE<nbsp>last>:
  38
  39 =over 4
  40
  41 =item B<RRDCACHED_ADDRESS>
  42
  43 If this environment variable is set it will have the same effect as specifying
  44 the C<--daemon> option on the command line. If both are present, the command
  45 line argument takes precedence.
  46
  47 =back
  48
  49 =head1 AUTHOR
  50
  51 Russ Wright <rwwright@home.com>
  52
  53
  54