From: Seth McDonald <sethmcmail@pm.me>
Date: Mon, 26 Jan 2026 12:28:59 +0000 (+0000)
Subject: man/man2/lseek.2: HISTORY: Update appearances of SEEK_{DATA,HOLE}
X-Git-Tag: man-pages-6.17~2^2~14
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=7c2f0c1a3105c2faf02b92a2a7604e30773c7986;p=thirdparty%2Fman-pages.git

man/man2/lseek.2: HISTORY: Update appearances of SEEK_{DATA,HOLE}

SEEK_DATA and SEEK_HOLE appeared in Solaris no later than 2005-12-12,
when a ZFS developer stated in a blog post that "[a]t this [time of]
writing, SEEK_HOLE and SEEK_DATA are Solaris-specific."[1]  The release
notes for Solaris 10 are dated to 2005-12.[2]  So the constants were
likely added in Solaris 10.

They were added to FreeBSD on 2007-04-05,[3] before being released in
FreeBSD 7.0 - the release notes stating that "[s]upport for Sun's ZFS
has been added" for amd64, i386, and pc98.[4]

They were also added to DragonFly BSD on 2009-04-07,[5] before being
released in DragonFly BSD 2.3.1 (which strangely seems to have no
release notes).[6]

The commit adding the constants to DragonFly BSD states that the commit
contents were obtained from FreeBSD.[5]  So chronologically FreeBSD is
listed before DragonFly BSD.  And the commit adding them to FreeBSD
references their implementation in OpenSolaris.[3]  So chronologically
Solaris is listed before FreeBSD.

POSIX.1-2024 is also moved to the end of the list, since it was released
decades after any system discussed here.

[1] Bonwick, Jeff (12 Dec 2005).  "SEEK_HOLE and SEEK_DATA for sparse
files".  Jeff Bonwick's Weblog.  Archived on 25 Oct 2006.
<https://web.archive.org/web/20061025161241/http://blogs.sun.com/bonwick/entry/seek_hole_and_seek_data>
[2] Oracle (Dec 2005).  "Solaris 10 Release Notes".
<https://docs.oracle.com/cd/E19253-01/html/817-0552/index.html>
[3] Dawidek, Pawel Jakub (5 Apr 2007).  "Implement SEEK_DATA and
SEEK_HOLE extensions to lseek(2) as found in".  FreeBSD source tree (Git
repository).
<https://cgit.freebsd.org/src/commit/?id=f6521d1c31810b096dd15afff12cf194d1989a0a>
[4] The FreeBSD Project (15 May 2021).  "FreeBSD 7.0-RELEASE Release
Notes".  Section 2.2.5 "File Systems".
<https://www.freebsd.org/releases/7.0R/relnotes>
[5] Avalos, Peter (7 Apr 2009).  "Clean up sysconf and associated
headers".  DragonFly Project Source (Git repository).
<https://gitweb.dragonflybsd.org/dragonfly.git/commit/9d66746cf7a1da0544550266a1c5cb53e776aa01>
[6] Schubert, Simon (7 May 2009).  "Roll DragonFly 2.3.1".  DragonFly
Project Source (Git repository).
<https://gitweb.dragonflybsd.org/dragonfly.git/commit/33a70342dc4e7f9a4ad7c120a827234a33153ca4>

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <bcf9f5113f3c88ec1a3fa2bd9ec7a397b603f7c0.1769429341.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
---

diff --git a/man/man2/lseek.2 b/man/man2/lseek.2
index 1c52c39d5..6c1e6d9d5 100644
--- a/man/man2/lseek.2
+++ b/man/man2/lseek.2
@@ -211,8 +211,10 @@ POSIX.1-2001, SVr4, 4.3BSD.
 .B SEEK_DATA
 .TQ
 .B SEEK_HOLE
-POSIX.1-2024;
-Solaris, FreeBSD, DragonFly BSD.
+Solaris 10,
+FreeBSD 7.0,
+DragonFly BSD 2.3.1,
+POSIX.1-2024.
 .SH NOTES
 See
 .BR open (2)