statfs man page on HP-UX

Printed from http://www.polarhome.com/service/man/?qf=statfs&af=0&tf=2&of=HP-UX

statfs(2)							     statfs(2)

NAME
       statfs, fstatfs - get file system statistics

SYNOPSIS
DESCRIPTION
       returns status information for a mounted file system.

       returns similar information for an open file.

       The parameters for the and functions are as follows:

	      path	is  a  pointer	to  a path name of any file within the
			mounted file system.

	      buf	is a pointer to a structure, which is where  the  file
			system status information is stored.

	      fildes	is  a  file descriptor for an open file, which is cre‐
			ated with the successful completion of	an  or	system
			call  (see  open(2),  creat(2),	 dup(2),  fcntl(2), or
			pipe(2)).

       The structure contains the following members:

	      int32_t  f_bavail;  /* free blocks available to non-superusers
				     or users without the LIMIT privilege */
	      int32_t  f_bfree;	  /* free blocks */
	      int32_t  f_blocks;  /* total blocks in file system */
	      int32_t  f_bsize;	  /* fundamental file system block size in bytes */
	      int32_t  f_ffree;	  /* free file nodes in file system */
	      int32_t  f_files;	  /* total file nodes in file system */
	      int32_t  f_type;	  /* type of info, zero for now */
	      fsid_t   f_fsid	  /* file system ID.  f_fsid[1] is the file system
				     type; see sysfs(2) */

       The fields and are expressed in terms of blocks of size

       A file node is a structure in the file system hierarchy that  describes
       a file.

       Fields that are undefined for a particular file system are set to −1.

   Security Restrictions
       The  field  is the number of free blocks available to non-superusers or
       users without the privilege.  See privileges(5)	for  more  information
       about  privileged  access  on  systems that support fine-grained privi‐
       leges.

RETURN VALUE
       and return 0 upon successful completion; otherwise, they return −1  and
       set to indicate the error.

ERRORS
       If fails, is set to one of the following values:

	      Search permission is denied for a component of the path prefix.

	      buf		   or path point to an invalid address.

	      An  I/O error occurred while reading from or writing to the file
	      system.

	      Too many symbolic links are encountered during path-name	trans‐
	      lation.

	      The length of the specified path name exceeds
				   bytes,  or the length of a component of the
				   path name exceeds bytes while is in effect.

	      The named file does not exist (for example,
				   path is null or a component	of  path  does
				   not exist).

	      A component of the path prefix is not a directory.

	      Result would overflow one or more fields of the
				   struct.

       If fails, is set to one of the following values:

	      fildes		   is not a valid open file descriptor.

	      buf		   points to an invalid address.

	      An  I/O  error  occurs while reading from or writing to the file
	      system.

WARNINGS
       is deprecated and should be used only by	 legacy	 32-bit	 applications.
       or are the recommended replacements.

AUTHOR
       and were developed by Sun Microsystems, Inc.

SEE ALSO
       df(1M), stat(2), statvfs(2), ustat(2), privileges(5).

								     statfs(2)
[top]

List of man pages available for HP-UX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net