=head1 NAME

rrdfirst - Return the date of the first data sample in an RRA within an RRD

=head1 SYNOPSIS

B<rrdtool> B<first> I<filename> [I<--rraindex number>] [B<--daemon> I<address>]

=head1 DESCRIPTION

The B<first> function returns the UNIX timestamp of the first data
sample entered into the specified RRA of the RRD file.

=over 8

=item I<filename>

The name of the B<RRD> that contains the data.

=item I<--rraindex number>

The index number of the B<RRA> that is to be examined. If not specified, the
index defaults to zero. B<RRA> index numbers can be determined through
B<rrdtool info>.

=item B<--daemon> I<address>

Address of the L<rrdcached> daemon.  For a list of accepted formats, see 
the B<-l> option in the L<rrdcached> manual.

 rrdtool first --daemon unix:/var/run/rrdcached.sock /var/lib/rrd/foo.rrd

=back

=head1 AUTHOR

Burton Strauss <Burton@ntopSupport.com>
Daemon support added by Steve Shipway <steve@steveshipway.org>