GNU bug report logs - #20501
Include EINVAL in mkdir(2) man page

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 20501 in the body.
You can then email your comments to 20501 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Raghavendra Prabhu <me <at> rdprabhu.com>
To: bug-coreutils <at> gnu.org
Subject: Include EINVAL in mkdir(2) man page
Date: Mon, 4 May 2015 20:01:31 +0530

[Message part 1 (text/plain, inline)]

Hi,

It is possible for mkdir(2) to return EINVAL in certain circumstances.
However, the man page mkdir(2) doesn't mention that.

I am hitting it on overlayfs. Other instances reported:

http://stackoverflow.com/questions/10015377/mkdir-pathname-with-symbol
http://lists.opensuse.org/opensuse-bugs/2009-05/msg01771.html

So, it needs to be documented in man page for mkdir(2).

------
Raghavendra

[Message part 2 (text/html, inline)]

Message #12 received at 20501-done <at> debbugs.gnu.org (full text, mbox):

From: Eric Blake <eblake <at> redhat.com>
To: Raghavendra Prabhu <me <at> rdprabhu.com>, 20501-done <at> debbugs.gnu.org
Subject: Re: bug#20501: Include EINVAL in mkdir(2) man page
Date: Mon, 04 May 2015 09:44:39 -0600

[Message part 1 (text/plain, inline)]

tag 20501 notabug
thanks

On 05/04/2015 08:31 AM, Raghavendra Prabhu wrote:
> Hi,
> 
> It is possible for mkdir(2) to return EINVAL in certain circumstances.
> However, the man page mkdir(2) doesn't mention that.

Unfortunately, the mkdir(2) man page is owned by the kernel man pages
project, not by coreutils.  We can do nothing about it here.  As such,
I'm closing this bug report from the coreutils bug database, although
you should still feel free to comment here as desired.

> 
> I am hitting it on overlayfs. Other instances reported:
> 
> http://stackoverflow.com/questions/10015377/mkdir-pathname-with-symbol
> http://lists.opensuse.org/opensuse-bugs/2009-05/msg01771.html
> 
> So, it needs to be documented in man page for mkdir(2).

In general, POSIX allows any interface to return additional errors other
than what is strictly documented, as long as those additional errors
make sense and as long as a documented error is not missed.  So
well-written code should never assume that only documented errors can be
returned.

-- 
Eric Blake   eblake redhat com    +1-919-301-3266
Libvirt virtualization library http://libvirt.org

[signature.asc (application/pgp-signature, attachment)]

Message #15 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Raghavendra Prabhu <me <at> rdprabhu.com>
To: bug-coreutils <at> gnu.org
Subject: Re: Include EINVAL in mkdir(2) man page
Date: Mon, 4 May 2015 20:06:42 +0530

[Message part 1 (text/plain, inline)]

Apologies for the report.  Looks like mkdir(2) man page is maintained by
man-pages project, I will report it there.  Thanks.

On Mon, May 4, 2015 at 8:01 PM, Raghavendra Prabhu <me <at> rdprabhu.com> wrote:

> Hi,
>
> It is possible for mkdir(2) to return EINVAL in certain circumstances.
> However, the man page mkdir(2) doesn't mention that.
>
> I am hitting it on overlayfs. Other instances reported:
>
> http://stackoverflow.com/questions/10015377/mkdir-pathname-with-symbol
> http://lists.opensuse.org/opensuse-bugs/2009-05/msg01771.html
>
> So, it needs to be documented in man page for mkdir(2).
>
> ------
> Raghavendra
>
>

[Message part 2 (text/html, inline)]

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.