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;
Date:   Thu, 4 Jun 2020 07:10:56 -0400 (EDT)
From:   Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
To:     Joseph Myers <joseph@codesourcery.com>,
        Michael Kerrisk <mtk.manpages@gmail.com>
Cc:     Florian Weimer <fweimer@redhat.com>, Rich Felker <dalias@libc.org>,
        libc-alpha <libc-alpha@sourceware.org>,
        linux-api <linux-api@vger.kernel.org>,
        Boqun Feng <boqun.feng@gmail.com>,
        Will Deacon <will.deacon@arm.com>,
        linux-kernel <linux-kernel@vger.kernel.org>,
        Peter Zijlstra <peterz@infradead.org>,
        Ben Maurer <bmaurer@fb.com>, Dave Watson <davejwatson@fb.com>,
        Thomas Gleixner <tglx@linutronix.de>,
        Paul <paulmck@linux.vnet.ibm.com>, Paul Turner <pjt@google.com>
Message-ID: <188671972.53608.1591269056445.JavaMail.zimbra@efficios.com>
In-Reply-To: <alpine.DEB.2.21.2006031718070.7179@digraph.polyomino.org.uk>
References: <20200527185130.5604-1-mathieu.desnoyers@efficios.com> <20200527185130.5604-2-mathieu.desnoyers@efficios.com> <87d06gxsla.fsf@oldenburg2.str.redhat.com> <alpine.DEB.2.21.2006031718070.7179@digraph.polyomino.org.uk>
Subject: Re: [PATCH glibc 1/3] glibc: Perform rseq registration at C startup
 and thread creation (v20)
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit
Thread-Topic: glibc: Perform rseq registration at C startup and thread creation (v20)
Thread-Index: zF49gywpspZcwIriHJ+0g73PGzbsCw==
Sender: linux-kernel-owner@vger.kernel.org
Precedence: bulk

----- On Jun 3, 2020, at 1:22 PM, Joseph Myers joseph@codesourcery.com wrote:

> On Wed, 3 Jun 2020, Florian Weimer via Libc-alpha wrote:
> 
>> I'm still waiting for feedback from other maintainers whether the level
>> of documentation and testing is appropriate.
> 
> Looking at the documentation in the manual, it doesn't look like it has
> enough information for someone to use this functionality, or to know when
> they might want to use it, and nor does it point to external documentation
> of it.  It would seem appropriate at least to include a link to wherever
> the external documentation is of what this functionality is good for, how
> to create and use a "Restartable Sequence critical section", and how to
> "perform rseq registration to the kernel".

That external piece of documentation would be part of the Linux man-pages
project, maintained by Michael Kerrisk. I have submitted a few revisions
of the rseq(2) man page, but have been waiting for Michael to reply for more
than a year now:

  https://lore.kernel.org/r/2021826204.69809.1588000508294.JavaMail.zimbra@efficios.com

I'm thinking about hosting a rseq(2) man-page into my librseq project, would
that make sense ?

librseq is currently a development branch in my own repository for now. It still
needs to be tweaked to adapt to the various changes that went into the glibc rseq
enablement patchset, and then I plan to move it to a more "formal" home:

  https://github.com/compudj/librseq

Thanks,

Mathieu


-- 
Mathieu Desnoyers
EfficiOS Inc.
http://www.efficios.com