From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <linux-kernel-owner@vger.kernel.org>
Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand
	id S1754791AbbCaOqR (ORCPT <rfc822;w@1wt.eu>);
	Tue, 31 Mar 2015 10:46:17 -0400
Received: from cantor2.suse.de ([195.135.220.15]:48982 "EHLO mx2.suse.de"
	rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP
	id S1753179AbbCaOqP (ORCPT <rfc822;linux-kernel@vger.kernel.org>);
	Tue, 31 Mar 2015 10:46:15 -0400
Message-ID: <1427813146.20009.2.camel@stgolabs.net>
Subject: Re: Revised futex(2) man page for review
From: Davidlohr Bueso <dave@stgolabs.net>
To: Peter Zijlstra <peterz@infradead.org>
Cc: "Michael Kerrisk (man-pages)" <mtk.manpages@gmail.com>,
        Thomas Gleixner <tglx@linutronix.de>,
        Darren Hart <dvhart@linux.intel.com>,
        "Carlos O'Donell" <carlos@redhat.com>, Ingo Molnar <mingo@elte.hu>,
        Jakub Jelinek <jakub@redhat.com>,
        "linux-man@vger.kernel.org" <linux-man@vger.kernel.org>,
        lkml <linux-kernel@vger.kernel.org>, Arnd Bergmann <arnd@arndb.de>,
        Steven Rostedt <rostedt@goodmis.org>,
        Linux API <linux-api@vger.kernel.org>,
        Torvald Riegel <triegel@redhat.com>,
        Roland McGrath <roland@hack.frob.com>,
        Darren Hart <dvhart@infradead.org>, Anton Blanchard <anton@samba.org>,
        Eric Dumazet <edumazet@google.com>,
        bill o gallmeister <bgallmeister@gmail.com>,
        Jan Kiszka <jan.kiszka@siemens.com>, Daniel Wagner <wagi@monom.org>,
        Rich Felker <dalias@libc.org>, Andy Lutomirski <luto@amacapital.net>,
        bert hubert <bert.hubert@netherlabs.nl>,
        Rusty Russell <rusty@rustcorp.com.au>,
        Heinrich Schuchardt <xypron.glpk@gmx.de>
Date: Tue, 31 Mar 2015 07:45:46 -0700
In-Reply-To: <20150328114725.GJ27490@worktop.programming.kicks-ass.net>
References: <55166C01.7000803@gmail.com>
	 <20150328114725.GJ27490@worktop.programming.kicks-ass.net>
Content-Type: text/plain; charset="UTF-8"
X-Mailer: Evolution 3.12.9 
Mime-Version: 1.0
Content-Transfer-Encoding: 8bit
Sender: linux-kernel-owner@vger.kernel.org
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org

On Sat, 2015-03-28 at 12:47 +0100, Peter Zijlstra wrote:

>        The condition is represented by the futex word, which is an address  in
>        memory  supplied to the futex() system call, and the value at this mem‐
>        ory location.  (While the virtual addresses for the same memory in sep‐
>        arate  processes  may  not be equal, the kernel maps them internally so
>        that the same memory mapped in different locations will correspond  for
>        futex() calls.)
> 
>        When  executing  a futex operation that requests to block a thread, the
>        kernel will only block if the futex word has the value that the calling

Given the use of "word", you should probably state right away that
futexes are only 32bit.

Thanks,
Davidlohr