View Issue Details

IDProjectCategoryView StatusLast Update
00018821003.1(2024)/Issue8System Interfacespublic2024-12-05 16:50
Reportergeoffclare Assigned To 
PrioritynormalSeverityCommentTypeError
Status ResolvedResolutionAccepted 
NameGeoff Clare
OrganizationThe Open Group
User Reference
Sectionread()
Page Number1853
Line Number61099
Interp Status---
Final Accepted Text
Summary0001882: read() EISDIR mentions readdir() but not posix_getdents()
DescriptionThe read() EISDIR error says "The readdir() function should be used instead". Now that posix_getdents() has been added, it should be mentioned too. In fact, it should probably be mentioned first, as it takes an fd like read() does, whereas to use readdir() would require obtaining a directory stream using fdopendir().

Also, the EISDIR error is shaded XSI but I can't see any reason why that should be so. Presumably it ended up that way in the 2001 merge because the error was in SUSv2 but not in POSIX.1-1996, but it includes the condition "and the implementation does not allow the directory to be read", so I think the XSI shading was unnecessary back then.
Desired ActionChange:
The fildes argument refers to a directory and the implementation does not allow the directory to be read using read() or pread(). The readdir() function should be used instead.
to:
The fildes argument refers to a directory and the implementation does not allow the directory to be read using read() or pread(). The posix_getdents() function should be used instead, or fdopendir() followed by readdir().

and remove the XSI shading from the entire [EISDIR] error text.
Tagstc1-2024

Activities

There are no notes attached to this issue.

Issue History

Date Modified Username Field Change
2024-12-03 16:36 geoffclare New Issue
2024-12-03 16:36 geoffclare Name => Geoff Clare
2024-12-03 16:36 geoffclare Organization => The Open Group
2024-12-03 16:36 geoffclare Section => read()
2024-12-03 16:36 geoffclare Page Number => 1853
2024-12-03 16:36 geoffclare Line Number => 61099
2024-12-03 16:36 geoffclare Interp Status => ---
2024-12-05 16:50 Don Cragun Status New => Resolved
2024-12-05 16:50 Don Cragun Resolution Open => Accepted
2024-12-05 16:51 Don Cragun Tag Attached: tc1-2024