aboutsummaryrefslogtreecommitdiff
path: root/bin/df/df.1
diff options
context:
space:
mode:
Diffstat (limited to 'bin/df/df.1')
-rw-r--r--bin/df/df.135
1 files changed, 28 insertions, 7 deletions
diff --git a/bin/df/df.1 b/bin/df/df.1
index 6221f4c43726..ceb1bb45babf 100644
--- a/bin/df/df.1
+++ b/bin/df/df.1
@@ -26,10 +26,7 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" @(#)df.1 8.3 (Berkeley) 5/8/95
-.\" $FreeBSD$
-.\"
-.Dd October 5, 2020
+.Dd March 29, 2023
.Dt DF 1
.Os
.Sh NAME
@@ -109,6 +106,9 @@ In conjunction with the
or
.Fl H
options, the number of inodes is scaled by powers of 1000.
+In case the filesystem has no inodes then
+.Sq -
+is displayed instead of the usage percentage.
.It Fl k
Use 1024 byte (1 Kibibyte) blocks rather than the default.
This overrides the
@@ -117,7 +117,11 @@ option and any
.Ev BLOCKSIZE
specification from the environment.
.It Fl l
-Only display information about locally-mounted file systems.
+Select a locally-mounted file system for display.
+If used in combination with the
+.Fl t Ar type
+option, file system types will be added or excluded according to the
+parameters of that option.
.It Fl m
Use 1048576 byte (1 Mebibyte) blocks rather than the default.
This overrides any
@@ -142,14 +146,20 @@ option.
The
.Fl k
option overrides this option.
-.It Fl t
-Only print out statistics for file systems of the specified types.
+.It Fl t Ar type
+Select file systems to display.
More than one type may be specified in a comma separated list.
The list of file system types can be prefixed with
.Dq no
to specify the file system types for which action should
.Em not
be taken.
+If used in combination with the
+.Fl l
+option, the parameters of this option will modify the list of
+locally-mounted file systems selected by the
+.Fl l
+option.
For example, the
.Nm
command:
@@ -233,6 +243,17 @@ $ df -h /dev/ada1p2
Filesystem Size Used Avail Capacity Mounted on
/dev/ada1p2 213G 152G 44G 78% /
.Ed
+.Sh NOTES
+For non-Unix file systems, the reported values of used and free inodes
+may have a different meaning than that of used and available files and
+directories.
+An example is msdosfs, which in the case of FAT12 or FAT16 file systems
+reports the number of available and free root directory entries instead
+of inodes
+.Po
+where 1 to 21 such directory entries are required to store
+each file or directory name or disk label
+.Pc .
.Sh SEE ALSO
.Xr lsvfs 1 ,
.Xr quota 1 ,