Austin Group Defect Tracker

Aardvark Mark IV


Viewing Issue Simple Details Jump to Notes ] Issue History ] Print ]
ID Category Severity Type Date Submitted Last Update
0000324 [1003.1(2008)/Issue 7] System Interfaces Editorial Clarification Requested 2010-09-26 02:50 2013-04-16 13:06
Reporter mattmccutchen View Status public  
Assigned To ajosey
Priority normal Resolution Accepted As Marked  
Status Closed  
Name Matt McCutchen
Organization
User Reference https://lists.samba.org/archive/rsync/2010-September/025606.html [^]
Section open
Page Number 1382
Line Number 45329
Interp Status ---
Final Accepted Text See Note: 0000576
Summary 0000324: Clarify that ENOTDIR is for existing non-directory files
Description Most system interfaces that take one or more paths as arguments document the following error (the wording may vary slightly):

[ENOTDIR] A component of the path prefix is not a directory

It is unclear whether this condition includes the case where a component of the path prefix does not exist, e.g., whether open("missing/foo", O_CREAT, 0600) is allowed to fail with ENOTDIR.

The general description of ENOTDIR (line 16420) suggests that the case is excluded:

[ENOTDIR] Not a directory. A component of the specified pathname exists, but it is not a directory, when a directory was expected.

It would be good to clarify this every place the error is documented.
Desired Action Replace every occurrence of the following documented error for a system interface:

[ENOTDIR] A component of the path prefix is not a directory

or minor variations, such as "either path prefix", with the appropriate variation of:

[ENOTDIR] A component of the path prefix exists, but it is not a directory
Tags tc1-2008
Attached Files

- Relationships

-  Notes
(0000572)
msbrown (manager)
2010-10-13 21:13

ENOTDIR instances in Issue 7 which meet this requirement for change:

p236 line 7740 (errno.h definition)
p561 line 19482 access()
p588 line 20264 alphasort()
p617 line 21088 bind()
p640 line 21719 catopen()
p653 line 22116 chdir()
p656 line 22199 chmod()
p660 line 22367 chown()
p691 line 23411 connect()
p777 line 25912 exec()
p795 line 26553 fattach()
p816 line 27274 fdetach()
p823 line 27494 fdopendir()
p878 line 29184 fopen()
p888 line 29567 fpathconf()
p924 line 30927 freopen()
p946 line 31709 fstatat()
p951 line 31896 fstatvfs()
p958 line 32106 ftok()
p965 line 32299 ftw()
p970 line 32446 futimens()
p1206 line 39847 lchown()
p1217 line 40158 link()
p1290 line 42346 mkdir()
p1293 line 42454 mkdtemp()
p1296 line 42541 mkfifo()
p1299 line 42693 mknod()
p1370 line 44944 nftw()
p1382 line 45329 open()
p1749 line 55880 readlink()
p1756 line 56108 realpath()
p1783 line 57005 rename()
p1791 line 57290 rmdir()
p1848 line 59085 sendmsg()
p1852 line 59210 sendto()
p2058 line 65102 symlink()
p2136 line 67591 truncate()
p2155 line 68050 unlink()
p2164 line 68355 utime()
(0000576)
Don Cragun (manager)
2010-10-14 15:57
edited on: 2010-10-14 16:08

We believe that this is an editorial issue clarifying what was always the intent of the
standard. Therefore, we do not believe an interpretation is required.

Change:
    "A component of the path prefix is not a direcory"
in all of the cases listed in Note: 0000572 to:
    "A component of the path prefix names an existing file that is neither a directory
     nor a symbolic link to a directory".
with minor variations where the interface uses multiple path arguments.



- Issue History
Date Modified Username Field Change
2010-09-26 02:50 mattmccutchen New Issue
2010-09-26 02:50 mattmccutchen Status New => Under Review
2010-09-26 02:50 mattmccutchen Assigned To => ajosey
2010-09-26 02:50 mattmccutchen Name => Matt McCutchen
2010-09-26 02:50 mattmccutchen User Reference => https://lists.samba.org/archive/rsync/2010-September/025606.html [^]
2010-09-26 02:50 mattmccutchen Section => open
2010-09-26 02:50 mattmccutchen Page Number => 1382
2010-09-26 02:50 mattmccutchen Line Number => 45329
2010-10-13 21:13 msbrown Note Added: 0000572
2010-10-14 15:57 Don Cragun Interp Status => ---
2010-10-14 15:57 Don Cragun Note Added: 0000576
2010-10-14 15:57 Don Cragun Resolution Open => Accepted As Marked
2010-10-14 15:58 Don Cragun Note Edited: 0000576
2010-10-14 16:01 Don Cragun Final Accepted Text => See Note: 0000576
2010-10-14 16:01 Don Cragun Status Under Review => Resolved
2010-10-14 16:03 Don Cragun Tag Attached: tc1-2008
2010-10-14 16:08 Don Cragun Note Edited: 0000576
2012-09-12 17:58 emaste Issue Monitored: emaste
2013-04-16 13:06 ajosey Status Resolved => Closed


Mantis 1.1.6[^]
Copyright © 2000 - 2008 Mantis Group
Powered by Mantis Bugtracker