This is the mail archive of the
mailing list for the glibc project.
Re: Adding reentrancy information to safety notes?
- From: "Michael Kerrisk (man-pages)" <mtk dot manpages at gmail dot com>
- To: Carlos O'Donell <carlos at redhat dot com>, Peng Haitao <penght at cn dot fujitsu dot com>, Alexandre Oliva <aoliva at redhat dot com>, "linux-man at vger dot kernel dot org" <linux-man at vger dot kernel dot org>, GNU C Library <libc-alpha at sourceware dot org>
- Cc: mtk dot manpages at gmail dot com
- Date: Tue, 30 Dec 2014 20:53:05 +0100
- Subject: Re: Adding reentrancy information to safety notes?
- Authentication-results: sourceware.org; auth=none
- References: <54A2C8A6 dot 9050100 at redhat dot com>
You better turn on the spell checker in your mailer (or update
its dictionary) ;-). ("Ree_n_tran*")
On 12/30/2014 04:45 PM, Carlos O'Donell wrote:
> Michael, Peng, Alex,
> We have had some recent discussions about reetrancy safety
> of dlopen. My goal is going to be to ensure that dlopen
> and in general the intefaces in libdl remain reetrant to
> allow user implemented malloc to use these interfaces to
> load libraries that themselves may have reetrant helper
> This raises the question: How do we clearly document which
> functions are reetrant?
> My thoughts are as follows:
> * Add some introductory text about reetrancy in the safety
> section. This text will discuss that AS-safe functions
> are reetrant because they must be to be AS-safe. Note that
> reetrant functions need not be AS-safe nor MT-safe.
Sounds good to me.
> * Add a "R-Safe" and "R-Unsafe" to indicate safety with respect
> to reetrancy.
Sounds odd to me. Why not just say "Reentrant" and "Nonreentrant",
rather than add new terms?
> * Immediately annotate all AS-safe functions as R-Safe.
Okay -- modulo preceding point
> * Review all of the "_r" functions for reetrance safety.
> My review of other Unices indicates this is probably the
> last type of safety that documented by other systems.
I am not quite clear what you mean by "last...documented".
Do you mean: few other systems document it?
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/