summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorSenthil Kumaran <senthil@uthcode.com>2016-06-18 18:23:04 (GMT)
committerSenthil Kumaran <senthil@uthcode.com>2016-06-18 18:23:04 (GMT)
commit4c3e6877453591d6146ed313f674f35d28c8eb27 (patch)
tree3166c7df8a6dc3202095d40cc2f682ff56fb52e0
parent977b3ac1c1cf18ce8967503ac7a8638a819a5c22 (diff)
parentd37de3c41de46ebda801d60b171875352267977d (diff)
downloadcpython-4c3e6877453591d6146ed313f674f35d28c8eb27.zip
cpython-4c3e6877453591d6146ed313f674f35d28c8eb27.tar.gz
cpython-4c3e6877453591d6146ed313f674f35d28c8eb27.tar.bz2
[merge from 3.5] - issue27021 - Document SC_IOV_MAX limitation imposed by OS on os.writev.
Patch contributed Марк Коренберг.
-rw-r--r--Doc/library/os.rst6
1 files changed, 5 insertions, 1 deletions
diff --git a/Doc/library/os.rst b/Doc/library/os.rst
index 62e4bda..465b218 100644
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -1228,7 +1228,11 @@ or `the MSDN <https://msdn.microsoft.com/en-us/library/z0kc8e3z.aspx>`_ on Windo
.. function:: writev(fd, buffers)
Write the contents of *buffers* to file descriptor *fd*. *buffers* must be a
- sequence of :term:`bytes-like objects <bytes-like object>`.
+ sequence of :term:`bytes-like objects <bytes-like object>`. Buffers are
+ processed in array order. Entire contents of first buffer is written before
+ proceeding to second, and so on. The operating system may set a limit
+ (sysconf() value SC_IOV_MAX) on the number of buffers that can be used.
+
:func:`~os.writev` writes the contents of each object to the file descriptor
and returns the total number of bytes written.