Adding reentrancy information to safety notes?

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



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

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.

* Add a "R-Safe" and "R-Unsafe" to indicate safety with respect
  to reetrancy.

* Immediately annotate all AS-safe functions as R-Safe.

* Review all of the "_r" functions for reetrance safety.

Thoughts?

My review of other Unices indicates this is probably the
last type of safety that documented by other systems.

Cheers,
Carlos.
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html



[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux