Re: lseek(SEEK_DATA)

Re: lseek(SEEK_DATA)

[Michael Kerrisk (man-pages)]

[CC+=linux-man@]

Hi Matthew,

On Sat, 4 Apr 2020 at 18:57, Matthew Wilcox <willy@infradead.org> wrote:
>
>
> The current (*) text of the lseek manpage is ambiguous about the behaviour
> of lseek(SEEK_DATA) for a file which is entirely a hole (or the end of
> the file is a hole and the pos lies within the hole).  The draft POSIX
> language is specific (ENXIO is returned when whence is SEEK_DATA and
> offset lies within the final hole of the file).  Could I trouble you to
> wordsmith that in?
>
> (*) I'm looking at 5.05 dated 2019-03-06
>
> If you want to look at the draft POSIX text, it's here:
> https://www.austingroupbugs.net/view.php?id=415

Thanks. I applied the patch below.

Cheers,

Michael


diff --git a/man2/lseek.2 b/man2/lseek.2
index 32331aba5..04972c082 100644
--- a/man2/lseek.2
+++ b/man2/lseek.2
@@ -212,7 +212,13 @@ or
 .BR SEEK_HOLE ,
 and
 .I offset
-is beyond the end of the file.
+is beyond the end of the file, or
+.I whence
+is
+.B SEEK_DATA
+and
+.I offset
+is within a hole at the end of the file.
 .TP
 .B EOVERFLOW
 .\" HP-UX 11 says EINVAL for this case (but POSIX.1 says EOVERFLOW)


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/