diff options
| author | Alejandro Colomar <alx@kernel.org> | 2024-11-17 18:47:53 +0100 |
|---|---|---|
| committer | Alejandro Colomar <alx@kernel.org> | 2024-11-17 21:51:23 +0100 |
| commit | 18e7c4597c4e72fa5210c7887273e363c456c9ee (patch) | |
| tree | 97cfd22e731a4c859ae71783d70943ff72e6cb60 /man/man3/posix_fallocate.3 | |
| parent | 8fc6fdd8291d906e58a175b5e1b20da680aaeb4a (diff) | |
| download | man-pages-18e7c4597c4e.tar.gz | |
man/: Terminology consistency reforms (n, size, length)
Use 'length' for the lenght of a string.
Use 'n' for the number of elements.
Use 'size' for the number of bytes. (And in wide-character string
functions, 'size' also refers to the number of wide characters.)
The change is quite large, and I might have made some mistakes.
But overall, this should improve consistency in use of these terms.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Diffstat (limited to 'man/man3/posix_fallocate.3')
| -rw-r--r-- | man/man3/posix_fallocate.3 | 16 |
1 files changed, 8 insertions, 8 deletions
diff --git a/man/man3/posix_fallocate.3 b/man/man3/posix_fallocate.3 index 29bd8f72f6..4cbd947d6d 100644 --- a/man/man3/posix_fallocate.3 +++ b/man/man3/posix_fallocate.3 @@ -13,7 +13,7 @@ Standard C library .nf .B #include <fcntl.h> .P -.BI "int posix_fallocate(int " fd ", off_t " offset ", off_t " len ); +.BI "int posix_fallocate(int " fd ", off_t " offset ", off_t " size ); .fi .P .ad l @@ -35,7 +35,7 @@ file descriptor for the bytes in the range starting at .I offset and continuing for -.I len +.I size bytes. After a successful call to .BR posix_fallocate (), @@ -43,7 +43,7 @@ subsequent writes to bytes in the specified range are guaranteed not to fail because of lack of disk space. .P If the size of the file is less than -.IR offset + len , +.IR offset + size , then the file is increased to this size; otherwise the file size is left unchanged. .SH RETURN VALUE @@ -59,7 +59,7 @@ is not set. is not a valid file descriptor, or is not opened for writing. .TP .B EFBIG -.I offset+len +.I offset+size exceeds the maximum file size. .TP .B EINTR @@ -68,7 +68,7 @@ A signal was caught during execution. .B EINVAL .I offset was less than 0, or -.I len +.I size was less than or equal to 0, or the underlying filesystem does not support the operation. .TP @@ -120,7 +120,7 @@ POSIX.1-2008 says that an implementation give the .B EINVAL error if -.I len +.I size was 0, or .I offset was less than 0. @@ -129,13 +129,13 @@ POSIX.1-2001 says that an implementation give the .B EINVAL error if -.I len +.I size is less than 0, or .I offset was less than 0, and .I may give the error if -.I len +.I size equals zero. .SH CAVEATS In the glibc implementation, |