Skip site navigation (1)Skip section navigation (2)
Date:      Fri, 24 Apr 2026 02:15:04 +0000
From:      Greg Lehey <grog@FreeBSD.org>
To:        src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org
Subject:   git: 32b0dfb32659 - main - Explain relationship between file storage size and EOF.
Message-ID:  <69ead228.31574.2f9cec5c@gitrepo.freebsd.org>

index | next in thread | raw e-mail

The branch main has been updated by grog:

URL: https://cgit.FreeBSD.org/src/commit/?id=32b0dfb326593b8dae31cc2bdc1e2d08ea70e9d7

commit 32b0dfb326593b8dae31cc2bdc1e2d08ea70e9d7
Author:     Greg Lehey <grog@FreeBSD.org>
AuthorDate: 2026-04-24 02:14:20 +0000
Commit:     Greg Lehey <grog@FreeBSD.org>
CommitDate: 2026-04-24 02:14:20 +0000

    Explain relationship between file storage size and EOF.
---
 usr.bin/du/du.1 | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/usr.bin/du/du.1 b/usr.bin/du/du.1
index 3b330de7bc5b..3b5c5f4df7bb 100644
--- a/usr.bin/du/du.1
+++ b/usr.bin/du/du.1
@@ -25,7 +25,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd April 15, 2026
+.Dd July 16, 2025
 .Dt DU 1
 .Os
 .Sh NAME
@@ -51,6 +51,14 @@ argument.
 If no file is specified, the block usage of the hierarchy rooted in
 the current directory is displayed.
 .Pp
+Normally block usage closely resembles the file size, but this is
+not always the case.
+For files with an incomplete last block, the size will be larger.
+The size includes any metadata such as indirect blocks, though not the
+inode.
+For sparse files or file systems that defer writing data to disk the
+count will be less than the file size.
+.Pp
 The options are as follows:
 .Bl -tag -width indent
 .It Fl -libxo
@@ -225,8 +233,8 @@ Also display a grand total at the end:
 .Xr chflags 2 ,
 .Xr fts 3 ,
 .Xr libxo 3 ,
-.Xr symlink 7 ,
 .Xr xo_options 7 ,
+.Xr symlink 7 ,
 .Xr quot 8
 .Sh STANDARDS
 The


home | help

Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?69ead228.31574.2f9cec5c>