IEEE Standards Interpretation for IEEE Std 1003.1™-2001 IEEE Standard Standard for Information Technology -- Portable Operating System Interface (POSIX®)
Copyright © 2006 by the Institute of Electrical and Electronics Engineers, Inc. 3 Park Avenue New York, New York 10016-5997 USA All Rights Reserved.
Interpretations are issued to explain and clarify the intent of a standard and do not constitute an alteration to the original standard. In addition, interpretations are not intended to supply consulting information. Permission is hereby granted to download and print one copy of this document. Individuals seeking permission to reproduce and/or distribute this document in its entirety or portions of this document must contact the IEEE Standards Department for the appropriate license. Use of the information contained in this document is at your own risk.
IEEE Standards Department Copyrights and Permissions 445 Hoes Lane, Piscataway, New Jersey 08855-1331, USA
Interpretation Request #59
Topic: readdir_r errors Relevant Sections: XSH readdir_r Page: 1198 Line: 37516-37523
The errors section for readdir() and readdir_r() has a shall fail EOVERFLOW error for readdir(), but not for readdir_r(). The same condition applies to both functions and should be a shall fail error for both functions.
Similarly, EBADF and ENOENT are listed as may fail errors for readdir(), but only EBADF is listed as a may fail error for readdir_r(). The ENOENT condition should apply to both functions.
Change "readdir() function" on P1198, L37516 to "readdir() and readdir_r() functions".
Change "readdir() function" on P1198, L37519 to "readdir() and readdir_r() functions".
Delete P1198, L37522-37523.
Interpretation Response #59
The standards states the requirements for errors for readdir() and readdir_r(), and conforming implementations must conform to this. However, concerns have been raised about this which are being referred to the sponsor.
Rationale for Interpretation