diff options
Diffstat (limited to 'man2/write.2')
| -rw-r--r-- | man2/write.2 | 24 |
1 files changed, 13 insertions, 11 deletions
diff --git a/man2/write.2 b/man2/write.2 index 01675c91dc..bf430072db 100644 --- a/man2/write.2 +++ b/man2/write.2 @@ -11,7 +11,7 @@ .\" manual under the conditions for verbatim copying, provided that the .\" entire resulting derived work is distributed under the terms of a .\" permission notice identical to this one. -.\" +.\" .\" Since the Linux kernel and libraries are constantly changing, this .\" manual page may be incorrect or out-of-date. The author(s) assume no .\" responsibility for errors or omissions, or for damages resulting from @@ -19,7 +19,7 @@ .\" have taken the same level of care in the production of this manual, .\" which is licensed free of charge, as they might when working .\" professionally. -.\" +.\" .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" @@ -46,12 +46,14 @@ bytes to the file referenced by the file descriptor from the buffer starting at .IR buf . POSIX requires that a \fBread\fP() which can be proved to occur after a -\fBwrite\fP() has returned returns the new data. Note that not all file +\fBwrite\fP() has returned returns the new data. +Note that not all file systems are POSIX conforming. .SH "RETURN VALUE" On success, the number of bytes written are returned (zero indicates -nothing was written). On error, \-1 is returned, and \fIerrno\fP is set -appropriately. +nothing was written). +On error, \-1 is returned, and \fIerrno\fP is set +appropriately. If \fIcount\fP is zero and .I fd @@ -63,7 +65,7 @@ If no errors are detected, If \fIcount\fP is zero and .I fd -refers to a file other than a regular file, +refers to a file other than a regular file, the results are not specified. .SH ERRORS .TP @@ -91,7 +93,7 @@ The call was interrupted by a signal before any data was written. .B EINVAL .I fd is attached to an object which is unsuitable for writing; -or the file was opened with the +or the file was opened with the .B O_DIRECT flag, and either the address specified in .IR buf , @@ -109,8 +111,8 @@ has no room for the data. .TP .B EPIPE .I fd -is connected to a pipe or socket whose reading end is closed. When this -happens the writing process will also receive a +is connected to a pipe or socket whose reading end is closed. +When this happens the writing process will also receive a .B SIGPIPE signal. (Thus, the write return value is seen only if the program @@ -119,12 +121,12 @@ catches, blocks or ignores this signal.) Other errors may occur, depending on the object connected to .IR fd . .SH "CONFORMING TO" -SVr4, 4.3BSD, POSIX.1-2001. +SVr4, 4.3BSD, POSIX.1-2001. .\" SVr4 documents additional error .\" conditions EDEADLK, ENOLCK, ENOLNK, ENOSR, ENXIO, or ERANGE. Under SVr4 a write may be interrupted and return EINTR at any point, -not just before any data is written. +not just before any data is written. .SH NOTES A successful return from .BR write () |