linux-api.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
From: "Michael Kerrisk (man-pages)" <mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
To: Davidlohr Bueso <dave-h16yJtLeMjHk1uMJSBkQmQ@public.gmane.org>,
	Peter Zijlstra <peterz-wEGCiKHe2LqWVfeAwA7xHQ@public.gmane.org>
Cc: mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org,
	Thomas Gleixner <tglx-hfZtesqFncYOwBW4kG4KsQ@public.gmane.org>,
	Darren Hart <dvhart-VuQAYsv1563Yd54FQh9/CA@public.gmane.org>,
	Carlos O'Donell <carlos-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org>,
	Ingo Molnar <mingo-X9Un+BFzKDI@public.gmane.org>,
	Jakub Jelinek <jakub-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org>,
	"linux-man-u79uwXL29TY76Z2rM5mHXA@public.gmane.org"
	<linux-man-u79uwXL29TY76Z2rM5mHXA@public.gmane.org>,
	lkml <linux-kernel-u79uwXL29TY76Z2rM5mHXA@public.gmane.org>,
	Arnd Bergmann <arnd-r2nGTMty4D4@public.gmane.org>,
	Steven Rostedt <rostedt-nx8X9YLhiw1AfugRpC6u6w@public.gmane.org>,
	Linux API <linux-api-u79uwXL29TY76Z2rM5mHXA@public.gmane.org>,
	Torvald Riegel <triegel-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org>,
	Roland McGrath <roland-/Z5OmTQCD9xF6kxbq+BtvQ@public.gmane.org>,
	Darren Hart <dvhart-wEGCiKHe2LqWVfeAwA7xHQ@public.gmane.org>,
	Anton Blanchard <anton-eUNUBHrolfbYtjvyW6yDsg@public.gmane.org>,
	Eric Dumazet <edumazet-hpIqsD4AKlfQT0dZR+AlfA@public.gmane.org>,
	bill o gallmeister
	<bgallmeister-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>,
	Jan Kiszka <jan.kiszka-kv7WeFo6aLtBDgjK7y7TUQ@public.gmane.org>,
	Daniel Wagner <wagi-kQCPcA+X3s7YtjvyW6yDsg@public.gmane.org>,
	Rich Felker <dalias-8zAoT0mYgF4@public.gmane.org>,
	Andy Lutomirski <luto-kltTT9wpgjJwATOyAt5JVQ@public.gmane.org>,
	bert hubert <bert.hubert-dxZxOz86jR8sYtaaK7K+xw@public.gmane.org>,
	Rusty Russell <rusty-8n+1lVoiYb80n/F98K4Iww@public.gmane.org>,
	Heinrich Schuchardt <xypron>
Subject: Re: Revised futex(2) man page for review
Date: Mon, 27 Jul 2015 13:10:43 +0200	[thread overview]
Message-ID: <55B611B3.7030005@gmail.com> (raw)
In-Reply-To: <1427813146.20009.2.camel-h16yJtLeMjHk1uMJSBkQmQ@public.gmane.org>

Hi David,

On 03/31/2015 04:45 PM, Davidlohr Bueso wrote:
> 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.

So, I made the opening sentence here:

       The  condition  is  represented  by  the  futex word, which is an
       address in memory supplied to the futex() system  call,  and  the
       32-bit  value  at  this  memory  location. 

Okay?

Cheers,

Michael

-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/

  parent reply	other threads:[~2015-07-27 11:10 UTC|newest]

Thread overview: 22+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2015-03-28  8:53 Revised futex(2) man page for review Michael Kerrisk (man-pages)
     [not found] ` <55166C01.7000803-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
2015-03-28  8:56   ` Michael Kerrisk (man-pages)
2015-03-28 11:47   ` Peter Zijlstra
     [not found]     ` <20150328114725.GJ27490-IIpfhp3q70z/8w/KjCw3T+5/BudmfyzbbVWyRVo5IupeoWH0uzbU5w@public.gmane.org>
2015-03-28 12:03       ` Peter Zijlstra
     [not found]         ` <20150328120337.GB32047-IIpfhp3q70xoDWY/xQGDymt3HXsI98Cx0E9HWUfgJXw@public.gmane.org>
2015-03-31 20:36           ` Davidlohr Bueso
     [not found]             ` <1427834205.20009.19.camel-h16yJtLeMjHk1uMJSBkQmQ@public.gmane.org>
2015-07-27 11:00               ` Michael Kerrisk (man-pages)
2015-07-27 11:10         ` Michael Kerrisk (man-pages)
2015-03-31 14:45       ` Davidlohr Bueso
     [not found]         ` <1427813146.20009.2.camel-h16yJtLeMjHk1uMJSBkQmQ@public.gmane.org>
2015-07-27 11:10           ` Michael Kerrisk (man-pages) [this message]
     [not found]             ` <55B611B3.7030005-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
2015-07-28  3:16               ` Davidlohr Bueso
     [not found]                 ` <1438053377.2249.25.camel-h16yJtLeMjHk1uMJSBkQmQ@public.gmane.org>
2015-07-28  7:44                   ` Michael Kerrisk (man-pages)
     [not found]                     ` <55B732C6.9080905-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
2015-07-28 17:52                       ` Davidlohr Bueso
     [not found]                         ` <1438105974.2249.67.camel-h16yJtLeMjHk1uMJSBkQmQ@public.gmane.org>
2015-07-28 18:09                           ` Michael Kerrisk (man-pages)
2015-04-14 21:40       ` Thomas Gleixner
2015-04-15 10:28         ` Torvald Riegel
     [not found]           ` <1429093725.2909.29.camel-I2ZjUw8blINjztcc/or7kQ@public.gmane.org>
2015-07-27 11:10             ` Michael Kerrisk (man-pages)
2015-04-27 20:37       ` Pavel Machek
2015-07-27 11:10         ` Michael Kerrisk (man-pages)
2015-07-28  2:52       ` Davidlohr Bueso
     [not found]         ` <1438051964.2249.9.camel-h16yJtLeMjHk1uMJSBkQmQ@public.gmane.org>
2015-07-28  6:39           ` Michael Kerrisk (man-pages)
2015-03-31  1:48   ` Rusty Russell
     [not found]     ` <871tk6os1y.fsf-8n+1lVoiYb80n/F98K4Iww@public.gmane.org>
2015-07-27 11:03       ` Michael Kerrisk (man-pages)

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=55B611B3.7030005@gmail.com \
    --to=mtk.manpages-re5jqeeqqe8avxtiumwx3w@public.gmane.org \
    --cc=anton-eUNUBHrolfbYtjvyW6yDsg@public.gmane.org \
    --cc=arnd-r2nGTMty4D4@public.gmane.org \
    --cc=bert.hubert-dxZxOz86jR8sYtaaK7K+xw@public.gmane.org \
    --cc=bgallmeister-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org \
    --cc=carlos-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org \
    --cc=dalias-8zAoT0mYgF4@public.gmane.org \
    --cc=dave-h16yJtLeMjHk1uMJSBkQmQ@public.gmane.org \
    --cc=dvhart-VuQAYsv1563Yd54FQh9/CA@public.gmane.org \
    --cc=dvhart-wEGCiKHe2LqWVfeAwA7xHQ@public.gmane.org \
    --cc=edumazet-hpIqsD4AKlfQT0dZR+AlfA@public.gmane.org \
    --cc=jakub-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org \
    --cc=jan.kiszka-kv7WeFo6aLtBDgjK7y7TUQ@public.gmane.org \
    --cc=linux-api-u79uwXL29TY76Z2rM5mHXA@public.gmane.org \
    --cc=linux-kernel-u79uwXL29TY76Z2rM5mHXA@public.gmane.org \
    --cc=linux-man-u79uwXL29TY76Z2rM5mHXA@public.gmane.org \
    --cc=luto-kltTT9wpgjJwATOyAt5JVQ@public.gmane.org \
    --cc=mingo-X9Un+BFzKDI@public.gmane.org \
    --cc=peterz-wEGCiKHe2LqWVfeAwA7xHQ@public.gmane.org \
    --cc=roland-/Z5OmTQCD9xF6kxbq+BtvQ@public.gmane.org \
    --cc=rostedt-nx8X9YLhiw1AfugRpC6u6w@public.gmane.org \
    --cc=rusty-8n+1lVoiYb80n/F98K4Iww@public.gmane.org \
    --cc=tglx-hfZtesqFncYOwBW4kG4KsQ@public.gmane.org \
    --cc=triegel-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org \
    --cc=wagi-kQCPcA+X3s7YtjvyW6yDsg@public.gmane.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).