This is the mail archive of the libc-alpha@sourceware.org mailing list for the glibc project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: Futex error handling


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.
 


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]