View Issue Details
| ID | Project | Category | View Status | Date Submitted | Last Update |
|---|---|---|---|---|---|
| 0000143 | 1003.1(2008)/Issue 7 | System Interfaces | public | 2009-09-05 14:03 | 2013-04-16 13:06 |
| Reporter | eblake | Assigned To | ajosey | ||
| Priority | normal | Severity | Objection | Type | Error |
| Status | Closed | Resolution | Accepted | ||
| Name | Eric Blake | ||||
| Organization | N/A | ||||
| User Reference | ebb.readlinkat | ||||
| Section | readlink | ||||
| Page Number | 1749 | ||||
| Line Number | 55865 | ||||
| Interp Status | Approved | ||||
| Final Accepted Text | 0000143:0000234 | ||||
| Summary | 0000143: readlinkat return value | ||||
| Description | The standard says that readlinkat returns 0 on success, rather than the resulting buffer length. This is a gratuitous difference from readlink, and makes the interface impossible to use (the standard is clear that the buffer of readlink() need not be NULL-terminated, so an application can't even trust strlen() after readlinkat). It also disagrees with implementation practice. | ||||
| Desired Action | Replace the two paragraphs at 55865-55869: Upon successful completion, readlink( ) shall return the count of bytes placed in the buffer. Otherwise, it shall return a value of −1, leave the buffer unchanged, and set errno to indicate the error. Upon successful completion, the readlinkat( ) function shall return 0. Otherwise, it shall return −1 and set errno to indicate the error. with one paragraph: Upon successful completion, these functions shall return the count of bytes placed in the buffer. Otherwise, these functions shall return a value of −1, leave the buffer unchanged, and set errno to indicate the error. | ||||
| Tags | tc1-2008 | ||||
|
|
Interpretation response ------------------------ The standard states the requirements for readlinkat() and conforming implementations must conform to this. However, concerns have been raised about this which are being referred to the sponsor. Rationale: ------------- None. Notes to the Editor (not part of this interpretation): ------------------------------------------------------- Make changes as suggested by the submitter |
| Date Modified | Username | Field | Change |
|---|---|---|---|
| 2009-09-05 14:03 | eblake | New Issue | |
| 2009-09-05 14:03 | eblake | Status | New => Under Review |
| 2009-09-05 14:03 | eblake | Assigned To | => ajosey |
| 2009-09-05 14:03 | eblake | Name | => Eric Blake |
| 2009-09-05 14:03 | eblake | Organization | => N/A |
| 2009-09-05 14:03 | eblake | User Reference | => ebb.readlinkat |
| 2009-09-05 14:03 | eblake | Section | => readlink |
| 2009-09-05 14:03 | eblake | Page Number | => 1749 |
| 2009-09-05 14:03 | eblake | Line Number | => 55865 |
| 2009-09-17 16:17 | ajosey | Interp Status | => Pending |
| 2009-09-17 16:17 | ajosey | Note Added: 0000234 | |
| 2009-09-17 16:17 | ajosey | Status | Under Review => Interpretation Required |
| 2009-09-17 16:17 | ajosey | Resolution | Open => Accepted |
| 2009-09-17 16:18 | ajosey | Final Accepted Text | => 0000143:0000234 |
| 2009-11-07 07:33 | ajosey | Interp Status | Pending => Proposed |
| 2009-12-07 16:56 | ajosey | Interp Status | Proposed => Approved |
| 2010-09-21 11:14 | geoffclare | Tag Attached: tc1-2008 | |
| 2013-04-16 13:06 | ajosey | Status | Interpretation Required => Closed |
