Received: by 2002:a25:1985:0:0:0:0:0 with SMTP id 127csp3004061ybz; Mon, 27 Apr 2020 08:19:47 -0700 (PDT) X-Google-Smtp-Source: APiQypIH+0XoOOvvTqhr3wLVb1ffCNkxvJ9bPbvdp9NNPodrBsTb9aTl9TxE6O704BCLdj3lrGWh X-Received: by 2002:a17:906:4bc9:: with SMTP id x9mr19687794ejv.27.1588000787032; Mon, 27 Apr 2020 08:19:47 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1588000787; cv=none; d=google.com; s=arc-20160816; b=buKMb2yaRBlE5/YiwM0zgszROBwTvDBHv5GwEYEL3i4qOiD+pocFRRPc/E0bQ/KZ7c E0slEfbJFVaoDPHWl62TgUb31F+V4YKgxmXhuVvNl2MjcAdOsLtVIGGsZUE4q5xDbs/m 1ugXJhecbyPMHad9485ooRWuwGUvIOKaCQbNu5KohNoTuequNqarSYHJW/DINQc4hNVI ikEGT+guQGHdtNGiz64/8hQYSRPJnFx9EllqSrhwW4yranob/vpzFrSiHskg/mGAL6zD eubqC3aCxrfyGST9NVDZrOkZ46KNDsTuS2jh79dmVc0RWk93xS/Iq7Z3BZuurFQTP4se AgvQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:thread-index :thread-topic:mime-version:subject:references:in-reply-to:message-id :cc:to:from:date:dkim-signature:dkim-filter; bh=HRC42XoOjwALWIYwKPwdLOKu7onToKlMl4PH+oSwd6A=; b=QKpupj0RVETN9yCa+usoCRcYPtU0P/HO6Qyq1hfiBjfZT+6zwsPt2cnFrlG80ePhsa w+ADffvSOlX/o9LJdjDMIbh8iqy06VpTohQ9gn1NG1PdedxmSN0i7fFu+hyzrzavc+KT 5TO0lhxe4UXaPBEB3/IdxbZ3btJ4An7e/6Y7E/pfue8S9GDQjdqUJ898H5pk45fSx1KB iqiOnaEfhI+p3GvSFg7pkgEvR/bZkS38ALx5ayGXvNSn6jZApDgobxRucSE+i5tihvzR dlJBiM2NQTYLHS89cRt9K9bytJ29u4b/H0ri7flIANEu989bHmuWQQDY3Z1S4ZkpNWot Sl/g== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@efficios.com header.s=default header.b=MDCvH6+C; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=efficios.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id v2si9259135ejx.85.2020.04.27.08.19.22; Mon, 27 Apr 2020 08:19:47 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@efficios.com header.s=default header.b=MDCvH6+C; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=efficios.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728071AbgD0PPO (ORCPT + 99 others); Mon, 27 Apr 2020 11:15:14 -0400 Received: from mail.efficios.com ([167.114.26.124]:51410 "EHLO mail.efficios.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1727771AbgD0PPO (ORCPT ); Mon, 27 Apr 2020 11:15:14 -0400 Received: from localhost (localhost [127.0.0.1]) by mail.efficios.com (Postfix) with ESMTP id E6280258C3B; Mon, 27 Apr 2020 11:15:09 -0400 (EDT) Received: from mail.efficios.com ([127.0.0.1]) by localhost (mail03.efficios.com [127.0.0.1]) (amavisd-new, port 10032) with ESMTP id Mfcr2dhcfhe2; Mon, 27 Apr 2020 11:15:08 -0400 (EDT) Received: from localhost (localhost [127.0.0.1]) by mail.efficios.com (Postfix) with ESMTP id 7A0D7259002; Mon, 27 Apr 2020 11:15:08 -0400 (EDT) DKIM-Filter: OpenDKIM Filter v2.10.3 mail.efficios.com 7A0D7259002 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=efficios.com; s=default; t=1588000508; bh=HRC42XoOjwALWIYwKPwdLOKu7onToKlMl4PH+oSwd6A=; h=Date:From:To:Message-ID:MIME-Version; b=MDCvH6+C5YGcaVUGYb1YOX20vFMIGlGcqBPDybrCzWIXHsHbdwu2lmnRQavisCdLr UqM16uQtgHrefdsbkrCxcgU0fExX756+PFhIJa7ZGN1PAtgVFMhQoOorOh2oXKHi0G yubzpwl72p6oLz2gBUa+8Aefw4uompGyF+oqcI27DHBAjUjhgpQmi3CDTyvRFSDkRG Zx1pZUOFAVfH1DRSuKdXoYdcXNBN+lPjLNt/ibEJwZLtDn1L5CQfFFozA7mfiO6sBw MbqQjtwKeNI29jPo4rJpYsvw7zWWgcbRuTFPgmmWg1qq6rl/jQ4tJW4uv+32fPecc9 H0VrrWfrIZVZA== X-Virus-Scanned: amavisd-new at efficios.com Received: from mail.efficios.com ([127.0.0.1]) by localhost (mail03.efficios.com [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id XITWGiWN5NEy; Mon, 27 Apr 2020 11:15:08 -0400 (EDT) Received: from mail03.efficios.com (mail03.efficios.com [167.114.26.124]) by mail.efficios.com (Postfix) with ESMTP id 54519258343; Mon, 27 Apr 2020 11:15:08 -0400 (EDT) Date: Mon, 27 Apr 2020 11:15:08 -0400 (EDT) From: Mathieu Desnoyers To: Michael Kerrisk Cc: linux-kernel , linux-api , Peter Zijlstra , Paul , Boqun Feng , Andy Lutomirski , Dave Watson , Paul Turner , Andrew Morton , Russell King , Thomas Gleixner , Ingo Molnar , "H. Peter Anvin" , Andi Kleen , Chris Lameter , Ben Maurer , rostedt , Josh Triplett , Linus Torvalds , Catalin Marinas , Will Deacon , carlos , Florian Weimer Message-ID: <2021826204.69809.1588000508294.JavaMail.zimbra@efficios.com> In-Reply-To: <211707091.921.1551722548347.JavaMail.zimbra@efficios.com> References: <20181206144228.9656-1-mathieu.desnoyers@efficios.com> <211707091.921.1551722548347.JavaMail.zimbra@efficios.com> Subject: Re: [PATCH man-pages] Add rseq manpage MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 X-Originating-IP: [167.114.26.124] X-Mailer: Zimbra 8.8.15_GA_3918 (ZimbraWebClient - FF75 (Linux)/8.8.15_GA_3895) Thread-Topic: Add rseq manpage Thread-Index: mDJv6ZaDzUr5+/+kUddTibB0qMWYrREokXmH Content-Transfer-Encoding: quoted-printable Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org ----- On Mar 4, 2019, at 1:02 PM, Mathieu Desnoyers mathieu.desnoyers@eff= icios.com wrote: > ----- On Feb 28, 2019, at 3:42 AM, Michael Kerrisk mtk.manpages@gmail.c= om wrote: >=20 >> On 12/6/18 3:42 PM, Mathieu Desnoyers wrote: >>> [ Michael, rseq(2) was merged into 4.18. Can you have a look at this >>> patch which adds rseq documentation to the man-pages project ? ] >> Hi Matthieu >>=20 >> Sorry for the long delay. I've merged this page into a private >> branch and have done quite a lot of editing. I have many >> questions :-). >=20 > No worries, thanks for looking into it! >=20 >>=20 >> In the first instance, I think it is probably best to have >> a free-form text discussion rather than firing patches >> back and forward. Could you take a look at the questions below >> and respond? >=20 > Sure, Hi Michael, Gentle bump of this email in your inbox, since I suspect you might have forgotten about it altogether. A year ago I you had an heavily edited man page for rseq(2). I provided the requested feedback, but I did not hear back from you since then. We are now close to integrate rseq into glibc, and having an official man page would be useful. Thanks, Mathieu >=20 >>=20 >> Thanks, >>=20 >> Michael >>=20 >>=20 >> RSEQ(2) Linux Programmer's Manual = RSEQ(2) >>=20 >> NAME >> rseq - Restartable sequences and CPU number cache >>=20 >> SYNOPSIS >> #include >>=20 >> int rseq(struct rseq *rseq, uint32_t rseq_len, int flags, uint32= _t sig); >>=20 >> DESCRIPTION >> =E2=94=8C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=90 >> =E2=94=82FIXME =E2= =94=82 >> =E2=94=9C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=A4 >> =E2=94=82Imagine you are someone who is pretty new to this =E2= =94=82 >> =E2=94=82idea... What is notably lacking from this page is =E2= =94=82 >> =E2=94=82an overview explaining: =E2= =94=82 >> =E2=94=82 =E2= =94=82 >> =E2=94=82 * What a restartable sequence actually is. =E2= =94=82 >> =E2=94=82 =E2= =94=82 >> =E2=94=82 * An outline of the steps to perform when using =E2= =94=82 >> =E2=94=82 restartable sequences / rseq(2). =E2= =94=82 >> =E2=94=82 =E2= =94=82 >> =E2=94=82I.e., something along the lines of Jon Corbet's =E2= =94=82 >> =E2=94=82https://lwn.net/Articles/697979/. Can you come up =E2= =94=82 >> =E2=94=82with something? (Part of it might be at the start of =E2= =94=82 >> =E2=94=82this page, and the rest in NOTES; it need not be all =E2= =94=82 >> =E2=94=82in one place.) =E2= =94=82 >> =E2=94=94=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=98 >=20 > We recently published a blog post about rseq, which might contain just = the > right level of information we are looking for here: >=20 > https://www.efficios.com/blog/2019/02/08/linux-restartable-sequences/ >=20 > Could something along the following lines work ? >=20 > "A restartable sequence is a sequence of instructions guaranteed to be > executed atomically with respect to other threads and signal handlers o= n the > current CPU. If its execution does not complete atomically, the kernel = changes > the execution flow by jumping to an abort handler defined by user-space= for > that restartable sequence. >=20 > Using restartable sequences requires to register a __rseq_abi thread-lo= cal > storage > data structure (struct rseq) through the rseq(2) system call. Only one > __rseq_abi > can be registered per thread, so user-space libraries and applications = must > follow > a user-space ABI defining how to share this resource. The ABI defining = how to > share > this resource between applications and libraries is defined by the C li= brary. >=20 > The __rseq_abi contains a rseq_cs field which points to the currently e= xecuting > critical section. For each thread, a single rseq critical section can r= un at any > given point. Each critical section need to be implemented in assembly." >=20 >=20 >> The rseq() ABI accelerates user-space operations on per-CPU = data by >> defining a shared data structure ABI between each user-space thr= ead and >> the kernel. >>=20 >> It allows user-space to perform update operations on per-CPU dat= a with=E2=80=90 >> out requiring heavy-weight atomic operations. >>=20 >> =E2=94=8C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=90 >> =E2=94=82FIXME =E2= =94=82 >> =E2=94=9C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=A4 >> =E2=94=82In the following para: "a hardware execution con=E2=80= =90 =E2=94=82 >> =E2=94=82text"? What is the contrast being drawn here? It =E2= =94=82 >> =E2=94=82would be good to state it more explicitly. =E2= =94=82 >> =E2=94=94=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=98 >=20 > Here I'm trying to clarify what we mean by "CPU" in this document. We d= efine > a CPU as having its own number returned by sched_getcpu(), which I thin= k is > sometimes referred to as "logical cpu". This is the current hyperthread= on > the current core, on the current "physical CPU", in the current socket. >=20 >=20 >> The term CPU used in this documentation refers to a hardware ex= ecution >> context. >>=20 >> Restartable sequences are atomic with respect to preemption (ma= king it >> atomic with respect to other threads running on the same CPU), a= s well >> as signal delivery (user-space execution contexts nested over t= he same >> thread). They either complete atomically with respect to preemp= tion on >> the current CPU and signal delivery, or they are aborted. >>=20 >> =E2=94=8C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=90 >> =E2=94=82FIXME =E2= =94=82 >> =E2=94=9C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=A4 >> =E2=94=82In the preceding sentence, we need a definition of =E2= =94=82 >> =E2=94=82"current CPU". =E2= =94=82 >> =E2=94=94=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=98 >=20 > Not sure how to word it. If a thread or signal handler execution contex= t can > possibly run and issue, for instance, "sched_getcpu()" between the begi= nning > and the end of the critical section and get the same logical CPU number= as the > current thread, then we are guaranteed to abort. Of course, sched_getcp= u() is > just one way to get the CPU number, considering that we can also read i= t > from the __rseq_abi cpu_id and cpu_id_start fields. >=20 >>=20 >> =E2=94=8C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=90 >> =E2=94=82FIXME =E2= =94=82 >> =E2=94=9C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=A4 >> =E2=94=82In the following, does "It is" means "Restartable =E2= =94=82 >> =E2=94=82sequences are"? =E2= =94=82 >> =E2=94=94=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=98 >> It is suited for update operations on per-CPU data. >=20 > Yes. >=20 >=20 >>=20 >> =E2=94=8C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=90 >> =E2=94=82FIXME =E2= =94=82 >> =E2=94=9C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=A4 >> =E2=94=82In the following, does "It is" means "Restartable =E2= =94=82 >> =E2=94=82sequences are"? =E2= =94=82 >> =E2=94=94=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=98 >=20 > "Restartable sequences can be..." >=20 >> It can be used on data structures shared between threads wi= thin a >> process, and on data structures shared between threads across di= fferent >> processes. >>=20 >> Some examples of operations that can be accelerated or improved = by this >> ABI: >>=20 >> =C2=B7 Memory allocator per-CPU free-lists >>=20 >> =C2=B7 Querying the current CPU number >>=20 >> =C2=B7 Incrementing per-CPU counters >>=20 >> =C2=B7 Modifying data protected by per-CPU spinlocks >>=20 >> =C2=B7 Inserting/removing elements in per-CPU linked-lists >>=20 >> =C2=B7 Writing/reading per-CPU ring buffers content >>=20 >> =C2=B7 Accurately reading performance monitoring unit counters = with respect >> to thread migration >>=20 >> Restartable sequences must not perform system calls. Doing = so may >> result in termination of the process by a segmentation fault. >>=20 >> The rseq argument is a pointer to the thread-local rseq structur= e to be >> shared between kernel and user-space. The layout of this struct= ure is >> shown below. >>=20 >> The rseq_len argument is the size of the struct rseq to register= . >>=20 >> The flags argument is 0 for registration, or RSEQ_FLAG_UNREGIS= TER for >> unregistration. >>=20 >> The sig argument is the 32-bit signature to be expected befo= re the >> abort handler code. >>=20 >> The rseq structure >> The struct rseq is aligned on a 32-byte boundary. This struc= ture is >> extensible. Its size is passed as parameter to the rseq() syste= m call. >>=20 >> =E2=94=8C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=90 >> =E2=94=82FIXME =E2= =94=82 >> =E2=94=9C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=A4 >> =E2=94=82Below, I added the structure definition (in abbrevi=E2=80= =90 =E2=94=82 >> =E2=94=82ated form). Is there any reason not to do this? =E2= =94=82 >> =E2=94=94=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=98 >=20 > It seems appropriate. >=20 >>=20 >> struct rseq { >> __u32 cpu_id_start; >> __u32 cpu_id; >> union { >> __u64 ptr64; >> #ifdef __LP64__ >> __u64 ptr; >> #else >> .... >> #endif >> } rseq_cs; >> __u32 flags; >> } __attribute__((aligned(4 * sizeof(__u64)))); >>=20 >> =E2=94=8C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=90 >> =E2=94=82FIXME =E2= =94=82 >> =E2=94=9C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=A4 >> =E2=94=82In the text below, I think it would be helpful to =E2= =94=82 >> =E2=94=82explicitly note which of these fields are set by the =E2= =94=82 >> =E2=94=82kernel (on return from the reseq() call) and which =E2= =94=82 >> =E2=94=82are set by the caller (before calling rseq()). Is =E2= =94=82 >> =E2=94=82the following correct: =E2= =94=82 >> =E2=94=82 =E2= =94=82 >> =E2=94=82 cpu_id_start - initialized by caller to possible =E2= =94=82 >> =E2=94=82 CPU number (e.g., 0), updated by kernel =E2= =94=82 >> =E2=94=82 on return =E2= =94=82 >=20 > "initialized by caller to possible CPU number (e.g., 0), updated > by the kernel on return, and updated by the kernel on return after > thread migration to a different CPU" >=20 >> =E2=94=82 =E2= =94=82 >> =E2=94=82 cpu_id - initialized to -1 by caller, =E2= =94=82 >> =E2=94=82 updated by kernel on return =E2= =94=82 >=20 > "initialized to -1 by caller, updated by the kernel on return, and > updated by the kernel on return after thread migration to a different > CPU" >=20 >> =E2=94=82 =E2= =94=82 >> =E2=94=82 rseq_cs - initialized by caller, either to NULL =E2= =94=82 >> =E2=94=82 or a pointer to an 'rseq_cs' structure =E2= =94=82 >> =E2=94=82 that is initialized by the caller =E2= =94=82 >=20 > "initialized by caller to NULL, then, after returning from successful > registration, updated to a pointer to an "rseq_cs" structure by user-sp= ace. > Set to NULL by the kernel when it restarts a rseq critical section, > when it preempts or deliver a signal outside of the range targeted by t= he > rseq_cs. Set to NULL by user-space before reclaiming memory that > contains the targeted struct rseq_cs." >=20 >=20 >> =E2=94=82 =E2= =94=82 >> =E2=94=82 flags - initialized by caller, used by kernel =E2= =94=82 >> =E2=94=94=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=98 >>=20 >> The structure fields are as follows: >>=20 >> =E2=94=8C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=90 >> =E2=94=82FIXME =E2= =94=82 >> =E2=94=9C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=A4 >> =E2=94=82In the following paragraph, and in later places, I =E2= =94=82 >> =E2=94=82changed "current thread" to "calling thread". Okay? =E2= =94=82 >> =E2=94=94=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=98 >=20 > Yes. >=20 >>=20 >> cpu_id_start >> Optimistic cache of the CPU number on which the calling = thread >> is running. The value in this field is guaranteed to al= ways be >> a possible CPU number, even when rseq is not initialized= . The >> value it contains should always be confirmed by read= ing the >> cpu_id field. >>=20 >> =E2=94=8C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=90 >> =E2=94=82FIXME = =E2=94=82 >> =E2=94=9C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=A4 >> =E2=94=82What does the last sentence mean? = =E2=94=82 >> =E2=94=94=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=98 >=20 > It means the caller thread can always use __rseq_abi.cpu_id_start to in= dex an > array of per-cpu data and this won't cause an out-of-bound access on lo= ad, but > it > does not mean it really contains the current CPU number. For instance, = if rseq > registration failed, it will contain "0". >=20 > Therefore, it's fine to use cpu_is_start to fetch per-cpu data, but the= cpu_id > field should be used to compare the cpu_is_start value, so the case whe= re rseq > is not registered is caught. In that case, cpu_id_start=3D0, but cpu_id= =3D-1 or -2, > which differ, and therefore the critical section needs to jump to the a= bort > handler. >=20 >>=20 >> This field is an optimistic cache in the sense that it is= always >> guaranteed to hold a valid CPU number in the range [0..(= nr_pos=E2=80=90 >> sible_cpus - 1)]. It can therefore be loaded by user-spa= ce and >> used as an offset in per-CPU data structures without ha= ving to >> check whether its value is within the valid bounds compa= red to >> the number of possible CPUs in the system. >>=20 >> For user-space applications executed on a kernel witho= ut rseq >> support, the cpu_id_start field stays initialized at 0, w= hich is >> indeed a valid CPU number. It is therefore valid to us= e it as >> an offset in per-CPU data structures, and only validate = whether >> it's actually the current CPU number by comparing it w= ith the >> cpu_id field within the rseq critical section. >>=20 >> If the kernel does not provide rseq support, that cpu_id= field >> stays initialized at -1, so the comparison always fa= ils, as >> intended. It is then up to user-space to use a fall-back= mecha=E2=80=90 >> nism, considering that rseq is not available. >>=20 >> =E2=94=8C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=90 >> =E2=94=82FIXME = =E2=94=82 >> =E2=94=9C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=A4 >> =E2=94=82The last sentence is rather difficult to grok.= Can =E2=94=82 >> =E2=94=82we say some more here? = =E2=94=82 >> =E2=94=94=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=98 >=20 > Perhaps we could use the explanation I've written above in my reply ? >=20 >>=20 >> cpu_id Cache of the CPU number on which the calling thread is r= unning. >> -1 if uninitialized. >>=20 >> rseq_cs >> The rseq_cs field is a pointer to a struct rseq_cs (de= scribed >> below). It is NULL when no rseq assembly block critical = section >> is active for the calling thread. Setting it to poi= nt to a >> critical section descriptor (struct rseq_cs) marks the be= ginning >> of the critical section. >>=20 >> flags Flags indicating the restart behavior for the calling = thread. >> This is mainly used for debugging purposes. Can be eithe= r: >>=20 >> RSEQ_CS_FLAG_NO_RESTART_ON_PREEMPT >=20 > Inhibit instruction sequence block restart on preemption for this threa= d. >=20 >>=20 >> RSEQ_CS_FLAG_NO_RESTART_ON_SIGNAL >=20 > Inhibit instruction sequence block restart on signal delivery for this = thread. > Restart on signal can only be inhibited when restart on preemption and = restart > on migration are inhibited too, else it will terminate the offending pr= ocess > with > a segmentation fault. >=20 >>=20 >> RSEQ_CS_FLAG_NO_RESTART_ON_MIGRATE >=20 > Inhibit instruction sequence block restart on migration for this thread= . >=20 >>=20 >> =E2=94=8C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=90 >> =E2=94=82FIXME =E2= =94=82 >> =E2=94=9C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=A4 >> =E2=94=82Each of the above values needs an explanation. =E2= =94=82 >> =E2=94=82 =E2= =94=82 >> =E2=94=82Is it correct that only one of the values may be =E2= =94=82 >> =E2=94=82specified in 'flags'? I ask because in the 'rseq_cs' =E2= =94=82 >> =E2=94=82structure below, the 'flags' field is a bit mask =E2= =94=82 >> =E2=94=82where any combination of these flags may be ORed =E2= =94=82 >> =E2=94=82together. =E2= =94=82 >> =E2=94=82 =E2= =94=82 >> =E2=94=94=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=98 >=20 > Those are also masks and can be ORed. >=20 >=20 >>=20 >> The rseq_cs structure >> The struct rseq_cs is aligned on a 32-byte boundary and has a= fixed >> size of 32 bytes. >>=20 >> =E2=94=8C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=90 >> =E2=94=82FIXME =E2= =94=82 >> =E2=94=9C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=A4 >> =E2=94=82Below, I added the structure definition (in abbrevi=E2=80= =90 =E2=94=82 >> =E2=94=82ated form). Is there any reason not to do this? =E2= =94=82 >> =E2=94=94=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=98 >=20 > It's fine. >=20 >>=20 >> struct rseq_cs { >> __u32 version; >> __u32 flags; >> __u64 start_ip; >> __u64 post_commit_offset; >> __u64 abort_ip; >> } __attribute__((aligned(4 * sizeof(__u64)))); >>=20 >> The structure fields are as follows: >>=20 >> version >> Version of this structure. >>=20 >> =E2=94=8C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=90 >> =E2=94=82FIXME = =E2=94=82 >> =E2=94=9C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=A4 >> =E2=94=82What does 'version' need to be initialized to? = =E2=94=82 >> =E2=94=94=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=98 >=20 > Currently version needs to be 0. Eventually, if we implement support fo= r new > flags to rseq(), > we could add feature flags which register support for newer versions of= struct > rseq_cs. >=20 >>=20 >> flags Flags indicating the restart behavior of this structure. = Can be >> a combination of: >>=20 >> RSEQ_CS_FLAG_NO_RESTART_ON_PREEMPT >=20 > Inhibit instruction sequence block restart on preemption for this threa= d. >=20 >>=20 >> RSEQ_CS_FLAG_NO_RESTART_ON_SIGNAL >=20 > Inhibit instruction sequence block restart on signal delivery for this = thread. > Restart on signal can only be inhibited when restart on preemption and = restart > on migration are inhibited too, else it will terminate the offending pr= ocess > with > a segmentation fault. >=20 >>=20 >> RSEQ_CS_FLAG_NO_RESTART_ON_MIGRATE >=20 > Inhibit instruction sequence block restart on migration for this thread= . >=20 >>=20 >> =E2=94=8C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=90 >> =E2=94=82FIXME =E2= =94=82 >> =E2=94=9C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=A4 >> =E2=94=82Each of the above values needs an explanation. =E2= =94=82 >> =E2=94=94=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=98 >>=20 >> start_ip >> Instruction pointer address of the first instruction= of the >> sequence of consecutive assembly instructions. >>=20 >> post_commit_offset >> Offset (from start_ip address) of the address after th= e last >> instruction of the sequence of consecutive assembly i= nstruc=E2=80=90 >> tions. >>=20 >> abort_ip >> Instruction pointer address where to move the execution f= low in >> case of abort of the sequence of consecutive assembly i= nstruc=E2=80=90 >> tions. >>=20 >> NOTES >> A single library per process should keep the rseq structure= in a >> thread-local storage variable. The cpu_id field should be init= ialized >> to -1, and the cpu_id_start field should be initialized to a p= ossible >> CPU value (typically 0). >=20 > The part above is not quite right. All applications/libraries wishing t= o > register > rseq must follow the ABI specified by the C library. It can be defined = within > more > that a single application/library, but in the end only one symbol will = be chosen > for the process's global symbol table. >=20 >>=20 >> Each thread is responsible for registering and unregistering i= ts rseq >> structure. No more than one rseq structure address can be reg= istered >> per thread at a given time. >>=20 >> =E2=94=8C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=90 >> =E2=94=82FIXME =E2= =94=82 >> =E2=94=9C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=A4 >> =E2=94=82In the following paragraph, what is the difference =E2= =94=82 >> =E2=94=82between "freed" and "reclaim"? I'm supposing they =E2= =94=82 >> =E2=94=82mean the same thing, but it's not clear. And if they =E2= =94=82 >> =E2=94=82do mean the same thing, then the first two sentences =E2= =94=82 >> =E2=94=82appear to contain contradictory information. =E2= =94=82 >> =E2=94=94=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=98 >=20 > The mean the same thing, and they are subtly not contradictory. >=20 > The first states that memory of a _registered_ rseq object must not > be freed before the thread exits. >=20 > The second states that memory of a rseq object must not be freed before > it is unregistered or the thread exits. >=20 > Do you have an alternative wording in mind to make this clearer ? >=20 >>=20 >> Memory of a registered rseq object must not be freed before the= thread >> exits. Reclaim of rseq object's memory must only be done after = either >> an explicit rseq unregistration is performed or after the thread= exits. >> Keep in mind that the implementation of the Thread-Local Stor= age (C >> language __thread) lifetime does not guarantee existence of = the TLS >> area up until the thread exits. >>=20 >> In a typical usage scenario, the thread registering the rseq st= ructure >> will be performing loads and stores from/to that structure. It = is how=E2=80=90 >> ever also allowed to read that structure from other threads. Th= e rseq >> field updates performed by the kernel provide relaxed atomicity= seman=E2=80=90 >> tics, which guarantee that other threads performing relaxed = atomic >> reads of the CPU number cache will always observe a consistent v= alue. >>=20 >> =E2=94=8C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=90 >> =E2=94=82FIXME =E2= =94=82 >> =E2=94=9C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=A4 >> =E2=94=82In the preceding paragraph, can we reasonably add =E2= =94=82 >> =E2=94=82some words to explain "relaxed atomicity semantics" =E2= =94=82 >> =E2=94=82and "relaxed atomic reads"? =E2= =94=82 >> =E2=94=94=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=98 >=20 > Not sure how to word this exactly, but here it means the stores and loa= ds need > to be done atomically, but don't require nor provide any ordering guara= ntees > with respect to other loads/stores (no memory barriers). >=20 >>=20 >> RETURN VALUE >> A return value of 0 indicates success. On error, -1 is return= ed, and >> errno is set appropriately. >>=20 >> ERRORS >> EBUSY Restartable sequence is already registered for this threa= d. >>=20 >> EFAULT rseq is an invalid address. >>=20 >> EINVAL Either flags contains an invalid value, or rseq conta= ins an >> address which is not appropriately aligned, or rseq_len c= ontains >> a size that does not match the size received on registrat= ion. >>=20 >> =E2=94=8C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=90 >> =E2=94=82FIXME = =E2=94=82 >> =E2=94=9C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=A4 >> =E2=94=82The last case "rseq_len contains a size that = does =E2=94=82 >> =E2=94=82not match the size received on registration"= can =E2=94=82 >> =E2=94=82occur only on RSEQ_FLAG_UNREGISTER, tight? = =E2=94=82 >> =E2=94=94=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=98 >>=20 >> ENOSYS The rseq() system call is not implemented by this kernel. >>=20 >> EPERM The sig argument on unregistration does not match the si= gnature >> received on registration. >>=20 >> VERSIONS >> The rseq() system call was added in Linux 4.18. >>=20 >> =E2=94=8C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=90 >> =E2=94=82FIXME =E2= =94=82 >> =E2=94=9C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=A4 >> =E2=94=82What is the current state of library support? =E2= =94=82 >> =E2=94=94=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=98 >=20 > After going through a few RFC rounds, it's been posted as non-rfc a > few weeks ago. It is pending review from glibc maintainers. I currently > aim for inclusion of the rseq TLS registration by glibc for glibc 2.30: >=20 > https://sourceware.org/ml/libc-alpha/2019-02/msg00317.html > https://sourceware.org/ml/libc-alpha/2019-02/msg00320.html > https://sourceware.org/ml/libc-alpha/2019-02/msg00319.html > https://sourceware.org/ml/libc-alpha/2019-02/msg00318.html > https://sourceware.org/ml/libc-alpha/2019-02/msg00321.html >=20 > Note that the C library will define a user-space ABI which states how > applications/libraries wishing to register the rseq TLS need to behave = so they > are compatible with the C library when it gets updated to a new version > providing > rseq registration support. It seems like an important point to document= , > perhaps even here in the rseq(2) man page. >=20 >=20 >>=20 >> CONFORMING TO >> rseq() is Linux-specific. >>=20 >> =E2=94=8C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=90 >> =E2=94=82FIXME =E2= =94=82 >> =E2=94=9C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=A4 >> =E2=94=82Is there any example code that can reasonably be =E2= =94=82 >> =E2=94=82included in this manual page? Or some example code =E2= =94=82 >> =E2=94=82that can be referred to? =E2= =94=82 >> =E2=94=94=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=98 >>=20 >=20 > The per-cpu counter example we have here seems compact enough: >=20 > https://www.efficios.com/blog/2019/02/08/linux-restartable-sequences/ >=20 > Thanks, >=20 > Mathieu >=20 >=20 >> SEE ALSO >> sched_getcpu(3), membarrier(2) >>=20 >> -- >> Michael Kerrisk >> Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ >> Linux/UNIX System Programming Training: http://man7.org/training/ >=20 > -- > Mathieu Desnoyers > EfficiOS Inc. > http://www.efficios.com --=20 Mathieu Desnoyers EfficiOS Inc. http://www.efficios.com