statfsdev(3c) [hpux man page]

statfsdev(3C)															     statfsdev(3C)

NAME

       statfsdev(), fstatfsdev() - get file system statistics

SYNOPSIS

DESCRIPTION

       returns information about the file system contained in the file specified by path.

       buf  is	a pointer to a structure into which information is placed concerning the file system.  The contents of the structure pointed to by
       buf include the following members:

       The fields and are expressed in terms of blocks of size

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

       returns the same information as above, but about the open file referred to by file descriptor fildes.

RETURN VALUE

       Upon successful completion, and return zero.  Otherwise, they return -1 and set the global variable to indicate the error.

ERRORS

       fails if one or more of the following conditions are encountered:

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

	      The file exists, enforcement mode file/record locking is set, and there are
			     outstanding record locks on the file.

	      path	     points to an invalid address.

	      Too many symbolic links are encountered in translating the path name.

	      The maximum number of file descriptors allowed are currently open.

	      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 system file table is full.

	      The named file does not exist.

	      A component of the path prefix is not a directory.

	      The device specified by the named special file does not exist.

	      Result would overflow one or more fields of the
			     struct.

       fails if one or more of the following is true:

	      fildes	     is not a valid open file descriptor.

	      filedes	     points to an invalid address.

       Both and fail if one or more of the following is true:

	      Enforcement-mode record locking was set, and there was a blocking write lock.

	      A resource deadlock would occur as a result of this operation.

	      A system call was interrupted by a signal.

	      The file specified by
			     path or filedes does not contain a file system of any known type.

	      The system lock table was full,
			     so the read could not go to sleep until the blocking write lock was removed.

	      Contact your system administrator to make sure the
			     is running properly on the system.

WARNINGS

       and are deprecated and should be used only by legacy 32-bit applications.  and are the recommended replacements.  See fgetpos64(3S).

AUTHOR

       and were developed by HP.

FILES

SEE ALSO

       bdf(1M), df(1M), stat(2), statfs(2), thread_safety(5).

																     statfsdev(3C)

statfs(2)							System Calls Manual							 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 created 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 privileges.

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 translation.

	      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)