Returns virtual file system statistics.
| Item | Description |
|---|---|
| vfsp | Points to the vfs structure being queried. This structure is defined in the /usr/include/sys/vfs.h file. |
| stafsp | Points to a statfs structure. This structure is defined in the /usr/include/sys/statfs.h file. |
| crp | Points to the cred structure. This structure contains data that the file system can use to validate access permission. |
The vfs_stafs entry point is called by the logical file system to obtain file system characteristics. Upon return, the vfs_statfs entry point has filled in the following fields of the statfs structure:
| Field | Description |
|---|---|
| f_blocks | Specifies the number of blocks. |
| f_files | Specifies the total number of file system objects. |
| f_bsize | Specifies the file system block size. |
| f_bfree | Specifies the number of free blocks. |
| f_ffree | Specifies the number of free file system objects. |
| f_fname | Specifies a 32-byte string indicating the file system name. |
| f_fpack | Specifies a 32-byte string indicating a pack ID. |
| f_name_max | Specifies the maximum length of an object name. |
Fields for which a vfs structure has no values are set to 0.
The vfs_statfs entry point can be called from the process environment only.
| Item | Description |
|---|---|
| 0 | Indicates success. |
Nonzero return values are returned from the /usr/include/sys/errno.h file to indicate failure.
The statfs subroutine.
Virtual File System Overview, Virtual File System Kernel Extensions Overview, Understanding Data Structures and Header Files for Virtual File Systems, Logical File System Overview, Understanding Virtual Nodes (V-nodes) in AIX® Version 7.1 Kernel Extensions and Device Support Programming Concepts.