INSTALL
TO INSTALL RUN:
                                                                                                                       
        perl Makefile.PL
        make
        make test
        make install
                                                                                                                       
                                                                                                                       
During the 'make test', test.pl will try to test with '/' and then
open test.pl in the current directory and use that for the filehandle
test.
                                                                                                                       
Once installed, run 'perldoc Filesys::Statvfs' for more information.
                                                                                                                       
If you have any problems or questions please email me at IGuthrie@aol.com
with "Filesys::Statvfs" in the subject line. If you run into a build problem,
please include the output of the install commands, the version of Perl
you are using (perl -v), and what operating system you are using.


Module Documentation:
Filesys::Statvfs - Perl extension for statvfs() and fstatvfs()
                                                                                                                     
SYNOPSIS

  use Filesys::Statvfs;
                                                                                                                     
   my($bsize, $frsize, $blocks, $bfree, $bavail,
      $files, $ffree, $favail, $flag, $namemax) = statvfs("/tmp");
                                                                                                                     
   #### Pass an open filehandle. Verify that fileno() returns a defined
   #### value. If you pass undef to fstatvfs you will get unexpected results
   my $fd = fileno(FILE_HANDLE);
   if(defined($fd)) {
	($bsize, $frsize, $blocks, $bfree, $bavail,
         $files, $ffree, $favail, $flag, $namemax) = fstatvfs($fd);
   }


DESCRIPTION

Interface for statvfs() and fstatvfs()
                                                                                                                       
Unless you need access to the bsize, flag, and namemax values,
you should probably look at using Filesys::DfPortable or
Filesys::Df instead. They will generally provide you with more
functionality and portability.
                                                                                                                       
The module should work with all flavors of Unix that implement the
statvfs() and fstatvfs() calls. This would include Linux, *BSD,
HP-UX, AIX, Solaris, Mac OS X, Irix, Cygwin, etc ...
                                                                                                                       
The statvfs() and fstatvfs() functions will return a list of
values, or will return undef and set $! if there was an error.
                                                                                                                       
The values returned are described in the statvfs/fstatvfs header or
the statvfs()/fstatvfs() man page.
                                                                                                                       
The module assumes that if you have statvfs(), fstatvfs() will
also be available.

Copyright (c) 2006 Ian Guthrie. All rights reserved.
               This program is free software; you can redistribute it and/or
               modify it under the same terms as Perl itself.