Bug 197581
| Summary: | writev/readv man pages are not accurate. | ||
|---|---|---|---|
| Product: | Red Hat Enterprise Linux 4 | Reporter: | Jose Plans <jplans> |
| Component: | man-pages | Assignee: | Ivana Varekova <varekova> |
| Status: | CLOSED ERRATA | QA Contact: | Ben Levenson <benl> |
| Severity: | medium | Docs Contact: | |
| Priority: | medium | ||
| Version: | 4.0 | CC: | tao |
| Target Milestone: | --- | ||
| Target Release: | --- | ||
| Hardware: | All | ||
| OS: | Linux | ||
| Whiteboard: | |||
| Fixed In Version: | RHBA-2006-0647 | Doc Type: | Bug Fix |
| Doc Text: | Story Points: | --- | |
| Clone Of: | Environment: | ||
| Last Closed: | 2006-09-14 04:45:35 UTC | Type: | --- |
| Regression: | --- | Mount Type: | --- |
| Documentation: | --- | CRM: | |
| Verified Versions: | Category: | --- | |
| oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |
| Cloudforms Team: | --- | Target Upstream Version: | |
| Embargoed: | |||
| Bug Depends On: | |||
| Bug Blocks: | 198868, 201655 | ||
Easyfix An advisory has been issued which should help the problem described in this bug report. This report is therefore being closed with a resolution of ERRATA. For more information on the solution and/or where to find the updated files, please follow the link below. You may reopen this bug report if the solution does not work for you. http://rhn.redhat.com/errata/RHBA-2006-0647.html |
* Following the Bugzilla number : 146238. When using readv() and writev(), the return code is not always the one described on the man page, this has been fixed in FC5 man pages for both vfs calls. It is true these functions are meant to be wrapped by FS functions calling these from the VFS layer, but still the man pages should be as accurate as possible to help understanding the developpers. Description: readv() and writev() does not return EINVAL when count is zero. But readv/writev man pages describe as follows: --- ERRORS The errors are as given for read(2) and write(2). Additionally the following error is defined. EINVAL The sum of the iov_len values overflows an ssize_t value. Or, the vector count count is zero or greater than IOV_MAX. --- This should be a problem in readv/writev man pages. Actually, FC5's man page has been modified: --- ERRORS The errors are as given for read(2) and write(2). Additionally the following error is defined: EINVAL The sum of the iov_len values overflows an ssize_t value. Or, the vector count count is less than zero or greater than the permitted maximum. --- Please change RHEL4 man-pages as well.