----- On Jun 3, 2020, at 1:22 PM, Joseph Myers joseph@xxxxxxxxxxxxxxxx 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@xxxxxxxxxxxx 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
