| Extracted from Pike v7.8 release 866 at 2018-07-18.

[Top]

# Method filesystem_stat()

Method filesystem_stat

  `mapping(string:int) filesystem_stat(string path)`

Description

  Returns a mapping describing the properties of the filesystem containing the path specified by path .

Returns

  If a filesystem cannot be determined `0` (zero) will be returned.

  Otherwise a mapping(string:int) with the following fields will be returned:

  `"blocksize" : int` | Size in bytes of the filesystem blocks.
  `"blocks" : int` | Size of the entire filesystem in blocks.
  `"bfree" : int` | Number of free blocks in the filesystem.
  `"bavail" : int` | Number of available blocks in the filesystem. This is usually somewhat less than the `"bfree"` value, and can usually be adjusted with eg tunefs(1M).
  `"files" : int` | Total number of files (aka inodes) allowed by this filesystem.
  `"ffree" : int` | Number of free files in the filesystem.
  `"favail" : int` | Number of available files in the filesystem. This is usually the same as the `"ffree"` value, and can usually be adjusted with eg tunefs(1M).
  `"fsname" : string` | Name assigned to the filesystem. This item is not available on all systems.
  `"fstype" : string` | Type of filesystem (eg `"nfs"`). This item is not available on all systems.

Note

  Please note that not all members are present on all OSs.

See also

  file_stat()