Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1756144AbbDOK3H (ORCPT ); Wed, 15 Apr 2015 06:29:07 -0400 Received: from mx1.redhat.com ([209.132.183.28]:57874 "EHLO mx1.redhat.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1754551AbbDOK2z (ORCPT ); Wed, 15 Apr 2015 06:28:55 -0400 Subject: Re: Revised futex(2) man page for review From: Torvald Riegel To: Thomas Gleixner Cc: Peter Zijlstra , "Michael Kerrisk (man-pages)" , Darren Hart , "Carlos O'Donell" , Ingo Molnar , Jakub Jelinek , "linux-man@vger.kernel.org" , lkml , Davidlohr Bueso , Arnd Bergmann , Steven Rostedt , Linux API , Roland McGrath , Darren Hart , Anton Blanchard , Eric Dumazet , bill o gallmeister , Jan Kiszka , Daniel Wagner , Rich Felker , Andy Lutomirski , bert hubert , Rusty Russell , Heinrich Schuchardt In-Reply-To: References: <55166C01.7000803@gmail.com> <20150328114725.GJ27490@worktop.programming.kicks-ass.net> Content-Type: text/plain; charset="UTF-8" Date: Wed, 15 Apr 2015 12:28:45 +0200 Message-ID: <1429093725.2909.29.camel@triegel.csb> Mime-Version: 1.0 Content-Transfer-Encoding: 7bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 1327 Lines: 30 On Tue, 2015-04-14 at 23:40 +0200, Thomas Gleixner wrote: > On Sat, 28 Mar 2015, Peter Zijlstra wrote: > > On Sat, Mar 28, 2015 at 09:53:21AM +0100, Michael Kerrisk (man-pages) wrote: > > > So, please take a look at the page below. At this point, > > > I would most especially appreciate help with the FIXMEs. > > > > For people who cannot read that troff gibberish (me).. > > Ditto :) > > > NOTES > > Glibc does not provide a wrapper for this system call; call it using > > syscall(2). > > You might mention that pthread_mutex, pthread_condvar interfaces are > high level wrappers for the syscall and recommended to be used for > normal use cases. IIRC unnamed semaphores are implemented with futexes > as well. If we add this, I'd rephrase it to something like that there are high-level programming abstractions such as the pthread_condvar interfaces or semaphores that are implemented using the syscall and that are typically a better fit for normal use cases. I'd consider only the condvars as something like a wrapper, or targeting a similar use case. -- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/