# filesystem.statfs

Return stats from the filesystem of a given path.

Raises: CallError(ENOENT) - Path not found

Type: object

##

Type: array
No Additional Items

#### Tuple Validation

##### Parameter 1: path

#### path

Type: string

Path on the filesystem to get statistics for.

Must be at least `1` characters long

##

#### FilesystemStatfsData

Type: object

Filesystem statistics and mount information.

No Additional Properties

##

#### Flags

Type: array

Combined per-mount options and per-superblock options for mounted filesystem.

No Additional Items

##### Each item of this array must be:

## Any of

Type: enum (of string)

##### Must be one of:

- "RW"
- "RO"
- "XATTR"
- "NOACL"
- "NFS4ACL"
- "POSIXACL"
- "CASESENSITIVE"
- "CASEINSENSITIVE"
- "NOATIME"
- "RELATIME"
- "NOSUID"
- "NODEV"
- "NOEXEC"

Type: object

##

#### Fsid

Type: string

Unique filesystem ID as returned by statvfs.

Must be at least `1` characters long

##

#### Fstype

String representation of filesystem type from mountinfo.

## Any of

Type: enum (of string)

##### Must be one of:

- "RW"
- "RO"
- "XATTR"
- "NOACL"
- "NFS4ACL"
- "POSIXACL"
- "CASESENSITIVE"
- "CASEINSENSITIVE"
- "NOATIME"
- "RELATIME"
- "NOSUID"
- "NODEV"
- "NOEXEC"

Type: object

##

#### Source

Type: string

Source for the mounted filesystem. For ZFS this will be dataset name.

Must be at least `1` characters long

##

#### Dest

Type: string

Local path on which filesystem is mounted.

Must be at least `1` characters long

##

#### Blocksize

Type: integer

Filesystem block size as reported by statvfs.

##

#### Total Blocks

Type: integer

Filesystem size as reported in blocksize blocks as reported by statvfs.

##

#### Free Blocks

Type: integer

Number of free blocks as reported by statvfs.

##

#### Avail Blocks

Type: integer

Number of available blocks as reported by statvfs.

##

#### Total Blocks Str

Type: string

Total filesystem size in blocks as a human-readable string.

Must be at least `1` characters long

##

#### Free Blocks Str

Type: string

Free blocks available as a human-readable string.

Must be at least `1` characters long

##

#### Avail Blocks Str

Type: string

Available blocks for unprivileged users as a human-readable string.

Must be at least `1` characters long

##

#### Files

Type: integer

Number of inodes in use as reported by statvfs.

##

#### Free Files

Type: integer

Number of free inodes as reported by statvfs.

##

#### Name Max

Type: integer

Maximum filename length as reported by statvfs.

##

#### Total Bytes

Type: integer

Total filesystem size in bytes.

##

#### Free Bytes

Type: integer

Free space available in bytes.

##

#### Avail Bytes

Type: integer

Available space for unprivileged users in bytes.

##

#### Total Bytes Str

Type: string

Total filesystem size in bytes as a human-readable string.

Must be at least `1` characters long

##

#### Free Bytes Str

Type: string

Free space available in bytes as a human-readable string.

Must be at least `1` characters long

##

#### Avail Bytes Str

Type: string

Available space for unprivileged users in bytes as a human-readable string.

Must be at least `1` characters long

Required roles: FILESYSTEM_ATTRS_READ