Summary of changes:
[rrdtool.git] / doc / rrdfirst.pod
1 =head1 NAME
2
3 rrdfirst - Return the date of the first data sample in an RRA within an RRD
4
5 =head1 SYNOPSIS
6
7 B<rrdtool> B<first> I<filename> [I<--rraindex number>] [B<--daemon> I<address>]
8
9 =head1 DESCRIPTION
10
11 The B<first> function returns the UNIX timestamp of the first data
12 sample entered into the specified RRA of the RRD file.
13
14 =over 8
15
16 =item I<filename>
17
18 The name of the B<RRD> that contains the data.
19
20 =item I<--rraindex number>
21
22 The index number of the B<RRA> that is to be examined. If not specified, the
23 index defaults to zero. B<RRA> index numbers can be determined through
24 B<rrdtool info>.
25
26 =item B<--daemon> I<address>
27
28 Address of the L<rrdcached> daemon.  For a list of accepted formats, see 
29 the B<-l> option in the L<rrdcached> manual.
30
31  rrdtool first --daemon unix:/var/run/rrdcached.sock /var/lib/rrd/foo.rrd
32
33 =back
34
35 =head1 AUTHOR
36
37 Burton Strauss <Burton@ntopSupport.com>
38 Daemon support added by Steve Shipway <steve@steveshipway.org>
39