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;
IronPort-SDR: gYEvL9RR6n7QuRr4AOQdxKkoG3j4KYQnpN5LtnvvTLPutPLTJhhGYtjFwooi5fRBEJYrGT4Vx3
 /xSFbDYpQgKXJk/4JvHhdB8p664K6hjxjRuKWv3p9xQrKqV25UcxPai5c9377T7gBj2/kfm1q4
 nRW+kR1+T+GCM5+pKVrc59pCwgy6ENqZeGYgDWwBOWmoCtFvpoRgeqMf5I2HL33hlNT8FZn0gP
 frm5n3SvdT7MByoj5t4b9GCzmD4iakIDr8pbniPWtP2HoMPIay2lDtGcSRAQxgakhiQT/qW0Ka
 aPs=
IronPort-SDR: VYzD3cG7OQGM/KCsYl7lBRJK8hLhcfaZSJgsx65378x1byGXgOeApjsXtUHPOtwzuUEEHDYhSd
 HaAA9gm9gVdG0Q3Ee/XfNDoGsCkLSRP9ofe4Gw0AhgBbLQgp7lnhnBZaCWrt7BRppp0J8R9B+o
 J4ojxl1Pm/Yqtlyt016eclFV+cvZd2Pb56PDz5RvCorz/a3QTOFL2aGHP/UYmTQUS5FUz2DLRz
 Wa8HdvNcTmAGSPQ8iFBel4T+xGp4S//oYEjDdSOjW4fWyYBUAxVfSZJA3k09eIYfw+wKdXIQfi
 o3k=
Date:   Wed, 3 Jun 2020 17:22:47 +0000
From:   Joseph Myers <joseph@codesourcery.com>
To:     Florian Weimer <fweimer@redhat.com>
CC:     Mathieu Desnoyers <mathieu.desnoyers@efficios.com>,
        Rich Felker <dalias@libc.org>, <libc-alpha@sourceware.org>,
        <linux-api@vger.kernel.org>, Boqun Feng <boqun.feng@gmail.com>,
        Will Deacon <will.deacon@arm.com>,
        <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 E. McKenney" <paulmck@linux.vnet.ibm.com>,
        Paul Turner <pjt@google.com>
Subject: Re: [PATCH glibc 1/3] glibc: Perform rseq registration at C startup
 and thread creation (v20)
In-Reply-To: <87d06gxsla.fsf@oldenburg2.str.redhat.com>
Message-ID: <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>
User-Agent: Alpine 2.21 (DEB 202 2017-01-01)
MIME-Version: 1.0
Content-Type: text/plain; charset="US-ASCII"
Sender: linux-kernel-owner@vger.kernel.org
Precedence: bulk

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".

-- 
Joseph S. Myers
joseph@codesourcery.com