commit: 653994e94021bd28b942697a6a332d1899582f0c
parent 39d8288731b3ee95975229fb36fbe5f41f957eca
Author: Haelwenn (lanodan) Monnier <contact@hacktivis.me>
Date: Sat, 9 Mar 2024 14:29:59 +0100
cmd/df: Add manpage
Diffstat:
| A | cmd/df.1 | 47 | +++++++++++++++++++++++++++++++++++++++++++++++ |
1 file changed, 47 insertions(+), 0 deletions(-)
diff --git a/cmd/df.1 b/cmd/df.1
@@ -0,0 +1,47 @@
+.\" utils-std: Collection of commonly available Unix tools
+.\" Copyright 2017-2024 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
+.\" SPDX-License-Identifier: MPL-2.0
+.Dd 2024-03-09
+.Dt DF 1
+.Os
+.Sh NAME
+.Nm df
+.Nd display mounted filesystems usage
+.Sh SYNOPSIS
+.Nm
+.Op Fl ahPk
+.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.
+.Pp
+Unlike most implementations this one doesn't prints a proper table. You'll need a utility such as
+.Xr column 1
+for this feature.
+.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 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 .
+.El
+.Sh EXIT STATUS
+.Ex -std
+.Sh SEE ALSO
+.Xr statvfs 3
+.Sh STANDARDS
+.Nm
+lacks getting a list of filesystems as argument to be compliant with the
+.St -p1003.1-2008
+specification.
+.Sh AUTHORS
+.An Haelwenn (lanodan) Monnier Aq Mt contact@hacktivis.me
