aboutsummaryrefslogtreecommitdiffstats
path: root/man2/write.2
diff options
context:
space:
mode:
Diffstat (limited to 'man2/write.2')
-rw-r--r--man2/write.212
1 files changed, 12 insertions, 0 deletions
diff --git a/man2/write.2 b/man2/write.2
index 90ef9b5994..3e8c363ab9 100644
--- a/man2/write.2
+++ b/man2/write.2
@@ -89,6 +89,10 @@ Note that not all filesystems are POSIX conforming.
.SH RETURN VALUE
On success, the number of bytes written is returned (zero indicates
nothing was written).
+It is not an error if this number is smaller than the number of bytes
+requested; this may happen for example because the disk device was filled.
+See also NOTES.
+
On error, \-1 is returned, and \fIerrno\fP is set
appropriately.
@@ -217,6 +221,14 @@ then the call fails with the error
.BR EINTR ;
if it is interrupted after at least one byte has been written,
the call succeeds, and returns the number of bytes written.
+
+On Linux,
+.BR read ()
+(and similar system calls) will transfer at most
+0x7ffff000 (2,147,479,552) bytes,
+returning the number of bytes actually transferred.
+.\" commit e28cc71572da38a5a12c1cfe4d7032017adccf69
+(This is true on both 32-bit and 64-bit systems.)
.SH BUGS
According to POSIX.1-2008/SUSv4 Section XSI 2.9.7
("Thread Interactions with Regular File Operations"):