This is the mail archive of the
libc-alpha@sourceware.org
mailing list for the glibc project.
Re: Futex error handling
- From: "Carlos O'Donell" <carlos at redhat dot com>
- To: Darren Hart <dvhart at infradead dot org>, Rich Felker <dalias at libc dot org>
- Cc: Torvald Riegel <triegel at redhat dot com>, GLIBC Devel <libc-alpha at sourceware dot org>, Michael Kerrisk <mtk dot manpages at gmail dot com>
- Date: Thu, 30 Oct 2014 02:50:59 -0400
- Subject: Re: Futex error handling
- Authentication-results: sourceware.org; auth=none
- References: <1410881785 dot 4967 dot 292 dot camel at triegel dot csb> <20140916165607 dot GZ23797 at brightrain dot aerifal dot cx> <1410891158 dot 4967 dot 303 dot camel at triegel dot csb> <20140916185457 dot GA23797 at brightrain dot aerifal dot cx> <1411043195 dot 27838 dot 32 dot camel at triegel dot csb> <20140918173953 dot GD23797 at brightrain dot aerifal dot cx> <1411063065 dot 27838 dot 35 dot camel at triegel dot csb> <20140918204055 dot GE23797 at brightrain dot aerifal dot cx> <20141030015508 dot GE14609 at vmdeb7>
On 10/29/2014 09:55 PM, Darren Hart wrote:
> On Thu, Sep 18, 2014 at 04:40:55PM -0400, Rich Felker wrote:
>> Oh, I agree entirely on this. The lack of documentation of the futex
>> interfaces makes it rather unsafe to rely on _anything_ about it right
>
> Where do you want to see this documented? Thomas recently added a lot of state
> documentation to futex.c, and he and I both responded to Michael Kerrisk's
> request for documented error codes. Are we refering to the man page? If so, I
> believe that is in the works already.
Yes, it is in the works, but it isn't done yet. Torvald Riegel was following
up on some of this.
The linux kernel man pages maintained by Michael Kerrisk is the canonical
place we look to for kernel API documentation for linux-specific syscalls.
If we can get everything well documented there, then we are off to the
races. We want it documented there also so we can agree upon what error
codes mean what.
Cheers,
Carlos.