fallocate.2: Document EINVAL for FALLOC_FL_COLLAPSE_RANGE on non-regular file

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2014-04-19 08:13:29 +02:00
parent 85ad779b17
commit 2af4d967af
1 changed files with 14 additions and 3 deletions

View File

@ -238,9 +238,20 @@ mode contains both
and other flags;
no other flags are permitted with
.BR FALLOC_FL_COLLAPSE_RANGE .
.\" FIXME Document error when FALLOC_FL_COLLAPSE_RANGE
.\" is given a nonregular file. As at 3.15-rc1, XFS gives
.\" EINVAL, but ext4 gives EOPNOTSUPP.
.TP EINVAL
.I mode
is
.BR FALLOC_FL_COLLAPSE_RANGE ,
but the file referred to by
.I fd
is not a regular file.
.\" There was a inconsistency in 3.15-rc1, that should be resolved so that all
.\" filesystems use this error for this case. (Tytso says ex4 will change.)
.\" http://thread.gmane.org/gmane.comp.file-systems.xfs.general/60485/focus=5521
.\" From: Michael Kerrisk (man-pages <mtk.manpages@...>
.\" Subject: Re: [PATCH v5 10/10] manpage: update FALLOC_FL_COLLAPSE_RANGE flag in fallocate
.\" Newsgroups: gmane.linux.man, gmane.linux.file-systems
.\" Date: 2014-04-17 13:40:05 GMT
.TP
.B EIO
An I/O error occurred while reading from or writing to a filesystem.