[Python-checkins] cpython (3.5): issue27021 - Document SC_IOV_MAX limitation imposed by OS on os.writev.

Sat Jun 18 14:23:09 EDT 2016

https://hg.python.org/cpython/rev/eddbf14f451b
changeset: 102091:eddbf14f451b
branch: 3.5
parent: 102086:2e48c2c4c733
user: Senthil Kumaran <senthil at uthcode.com>
date: Sat Jun 18 11:21:50 2016 -0700
summary:
 issue27021 - Document SC_IOV_MAX limitation imposed by OS on os.writev.
Patch contributed Марк Коренберг.
files:
 Doc/library/os.rst | 6 +++++-
 1 files changed, 5 insertions(+), 1 deletions(-)

diff --git a/Doc/library/os.rst b/Doc/library/os.rst
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -1195,7 +1195,11 @@
 .. 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.
 
-- 
Repository URL: https://hg.python.org/cpython
