df command

Synopsis

df [<path>]

Description

The df command displays filesystem usage statistics. With no arguments it shows all mounts. With a path, it shows the filesystem containing that path.

Not all filesystems support statfs. ext4 provides full statistics; FAT and sandbox hostfs show dashes.

path: absolute or relative path within a mounted filesystem (optional)

Example

=> mount -t ext4 host 0:0 /mnt
=> mount hostfs /host
=> df
Filesystem        Blksz      Total       Used       Free  Size
/mnt               4096    2097152     106496    1990656
/host                 -          -          -          -
=> df /mnt
Filesystem        Blksz      Total       Used       Free  Size
/mnt               4096    2097152     106496    1990656  2.0 MiB

Configuration

The df command is available when CONFIG_CMD_VFS=y.

Return value

The return value $? is set to 0 (true) if the statistics were retrieved, 1 (false) otherwise.