Bug 8399

Summary: Documentation for readv(2) is inaccurate
Product: Other Reporter: Kyle Sluder (kyle.sluder)
Component: OtherAssignee: Michael Kerrisk (michael.kerrisk)
Severity: low CC: bunk
Priority: P2    
Hardware: i386   
OS: Linux   
Kernel Version: 2.6.17 Tree: Mainline
Subsystem: Regression: ---

Description Kyle Sluder 2007-04-28 15:42:38 UTC
The documentation for readv(2) states that ``The  readv()  function reads count
blocks from the file associated with the file descriptor fd into the multiple
buffers described by vector.''  This is incorrect; readv() uses the ``count''
parameter to determine the number of iovec structures exist at *iov.  Otherwise
there would be no way to specify multiple buffers, which is the point of readv().

Distribution: Ubuntu 6.10 Edgy Eft
Comment 1 Kyle Sluder 2007-05-09 22:49:48 UTC
Per e-mail from Michael Kerrisk:

>> Hi Adrian,
>> You've rightly assigned the bug to me, but I think I don't have an account
>> on bugzilla.kernel.org, so I will need you to close it, and you can close
>> it now.
>> Andrew: thanks also for forwarding this to me.
>> Kyle: thanks for your report.
>> I agree the page was broken, though rather because the original author had
>> explained things badly (using "block" instead of "buffer"), than because he
>> did not understand things.
>> This report prodded me to more or less completely rewrite the page to fix
>> this problem, and much else.

Marking closed.