df.1 (1985B)
- .\" utils-std: Collection of commonly available Unix tools
- .\" Copyright 2017 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
- .\" SPDX-License-Identifier: MPL-2.0
- .Dd 2024-03-31
- .Dt DF 1
- .Os
- .Sh NAME
- .Nm df
- .Nd display mounted filesystems usage
- .Sh SYNOPSIS
- .Nm
- .Op Fl ahilPkT
- .Op Fl t Ar mnt_type
- .Op Fl x Ar mnt_type
- .Op Ar file...
- .Sh DESCRIPTION
- .Nm
- displays the current usage and mountpoints of mounted filesystems in a space-separated list containing:
- Filesystem, Total, Used, Available, Use percentage, Mountpoint.
- If
- .Ar file
- is given
- .Nm
- filters to the first filesystem containing each
- .Ar file .
- .Pp
- Unlike some implementations the table formatting isn't perfect, you might want to use
- .Xr column 1
- to get more readable output.
- Also padding is disabled when output isn't a TTY so you can more easily use tools like
- .Xr cut 1 .
- .Sh OPTIONS
- .Bl -tag -width Ds
- .It Fl a
- Display all mounted filesystems, otherwise
- .Nm
- deduplicates filesystems and skips ones with a blocksize of zero.
- .It Fl h
- Print human readable sizes.
- .It Fl i
- Print inode usage statistics.
- .It Fl l
- Exclude known remote filesystems.
- .It Fl P
- POSIX Formatting, prints in blocks of 512 when
- .It Fl k
- Forces printing in blocks of 1024.
- .Fl k
- is also passed, disables
- .Fl h .
- .It Fl T
- Print filesystem type right after the Filesystem column.
- .It Fl t Ar mnt_type
- Include only selected filesystems matching
- .Ar mnt_type .
- For example
- .Qq nfs4 .
- Option can be passed multiple times to include multiple types.
- .It Fl x Ar mnt_type
- Exclude filesystems types matching
- .Ar mnt_type .
- For example
- .Qq nfs4 .
- Option can be passed multiple times to exclude multiple types.
- .El
- .Sh EXIT STATUS
- .Ex -std
- .Sh SEE ALSO
- .Xr statvfs 3
- .Sh STANDARDS
- .Nm
- should be compliant with the
- IEEE Std 1003.1-2024 (“POSIX.1”)
- specification.
- .Pp
- .Fl i ,
- .Fl l ,
- .Fl t
- and
- .Fl x
- are extensions inspired by other implementations such as FreeBSD and GNU.
- .Sh AUTHORS
- .An Haelwenn (lanodan) Monnier Aq Mt contact+utils@hacktivis.me