Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

filesys::statvfs(3pm) [debian man page]

Statvfs(3pm)						User Contributed Perl Documentation					      Statvfs(3pm)

NAME

       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.

AUTHOR

       Ian Guthrie IGuthrie@aol.com

       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.

SEE ALSO

       statvfs(2), fstatvfs(2), Filesys::DfPortable, Filesys::Df

perl v5.14.2							    2006-06-25							      Statvfs(3pm)

Check Out this Related Man Page

explain_fstatvfs_or_die(3)				     Library Functions Manual					explain_fstatvfs_or_die(3)

NAME

       explain_fstatvfs_or_die - get file system statistics and report errors

SYNOPSIS

       #include <libexplain/fstatvfs.h>
       void explain_fstatvfs_or_die(int fildes, struct statvfs *data);
       int explain_fstatvfs_on_error(int fildes, struct statvfs *data);

DESCRIPTION

       The  explain_fstatvfs_or_die  function  is  used  to call the fstatvfs(2) system call. On failure an explanation will be printed to stderr,
       obtained from the explain_fstatvfs(3) function, and then the process terminates by calling exit(EXIT_FAILURE).

       The explain_fstatvfs_on_error function is used to call the fstatvfs(2) system call. On failure an explanation will be  printed  to  stderr,
       obtained from the explain_fstatvfs(3) function, but still returns to the caller.

       fildes  The fildes, exactly as to be passed to the fstatvfs(2) system call.

       data    The data, exactly as to be passed to the fstatvfs(2) system call.

RETURN VALUE

       The  explain_fstatvfs_or_die  function only returns on success, see fstatvfs(2) for more information. On failure, prints an explanation and
       exits, it does not return.

       The explain_fstatvfs_on_error function always returns the value return by the wrapped fstatvfs(2) system call.

EXAMPLE

       The explain_fstatvfs_or_die function is intended to be used in a fashion similar to the following example:
	      explain_fstatvfs_or_die(fildes, data);

SEE ALSO

       fstatvfs(2)
	       get file system statistics

       explain_fstatvfs(3)
	       explain fstatvfs(2) errors

       exit(2) terminate the calling process

COPYRIGHT

       libexplain version 0.52
       Copyright (C) 2010 Peter Miller

															explain_fstatvfs_or_die(3)
Man Page