Bug 8399

Summary:	Documentation for readv(2) is inaccurate
Product:	Other	Reporter:	Kyle Sluder (kyle.sluder)
Component:	Other	Assignee:	Michael Kerrisk (michael.kerrisk)
Status:	CLOSED CODE_FIX
Severity:	low	CC:	bunk
Priority:	P2
Hardware:	i386
OS:	Linux
Kernel Version:	2.6.17	Subsystem:
Regression:	---	Bisected commit-id:

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.