On 2012.06.08 19:04, Konstantin Belousov wrote:
On Fri, Jun 08, 2012 at 02:51:09PM +0200, Jan Sieka wrote:
Hello group!
I have a few questions regarding adding symbols to
lib/libc/arch/Symbol.map, so that function signatures are exported:
- what are the conventions regarding putting symbols in FBSD_X.Y or
FBSDprivate_X.Y sections of the aforementioned files?
FBSD_X.Y are for public interfaces, i.e. non-system code is supposed to
link to symbols from that versions. FBSDprivate is for exclusive base
system use (so to say). We do not guarantee ABI stability for private.
- when it is necessary to bump X.Y numbers?
Currently, it is done when major branch is created.
- what is the difference between FBSD_X.Y and FBSDprivate_X.Y sections?
This is a repeat.
The above questions arose from the discussion on freebsd-arm@
(http://lists.freebsd.org/pipermail/freebsd-arm/2012-June/003555.html)
which concerns fixing Perl on ARM. The fix is to add __flt_rounds
function signature to lib/libc/arm/Symbols.map. Regarding this fix it
appears (after Symbols.map files analysis and checking their SVN
history) that adding this symbol is just a bug fix and should be put to
FBSD_1.0 section without incrementing numbers. But I don't have more
in-depth explanation so sending this email.
No, since you are adding it in the CURRENT-10 timeframe, it goes
to FBSD_1.3.
Anyone can comment on the above questions or point to some documentation
(I've searched Developer's Handbook and Internet but found nothing)?
http://people.freebsd.org/~deischen/symver/freebsd_versioning.txt
In fact, I do not like this policy, and would some day write a proposal,
which essentially requests creation of separate version for each ABI change.
But what is referenced is the current accepted project policy.
Thanks for response and hints. I have prepared patch according to the
above guidelines and sent it for comments in the aforementioned thread
on freebsd-arm@ (I also have CC-ed it to current@).
Best regards,
Jan Sieka
___
freebsd-current@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-current
To unsubscribe, send any mail to freebsd-current-unsubscr...@freebsd.org