From owner-freebsd-current@FreeBSD.ORG Fri Jun 8 17:05:06 2012 Return-Path: Delivered-To: freebsd-current@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id DAC201065674 for ; Fri, 8 Jun 2012 17:05:05 +0000 (UTC) (envelope-from kostikbel@gmail.com) Received: from mail.zoral.com.ua (mx0.zoral.com.ua [91.193.166.200]) by mx1.freebsd.org (Postfix) with ESMTP id 6A5898FC16 for ; Fri, 8 Jun 2012 17:05:05 +0000 (UTC) Received: from skuns.kiev.zoral.com.ua (localhost [127.0.0.1]) by mail.zoral.com.ua (8.14.2/8.14.2) with ESMTP id q58H4msO095744; Fri, 8 Jun 2012 20:04:48 +0300 (EEST) (envelope-from kostikbel@gmail.com) Received: from deviant.kiev.zoral.com.ua (kostik@localhost [127.0.0.1]) by deviant.kiev.zoral.com.ua (8.14.5/8.14.5) with ESMTP id q58H4mJF038083; Fri, 8 Jun 2012 20:04:48 +0300 (EEST) (envelope-from kostikbel@gmail.com) Received: (from kostik@localhost) by deviant.kiev.zoral.com.ua (8.14.5/8.14.5/Submit) id q58H4lMZ038082; Fri, 8 Jun 2012 20:04:47 +0300 (EEST) (envelope-from kostikbel@gmail.com) X-Authentication-Warning: deviant.kiev.zoral.com.ua: kostik set sender to kostikbel@gmail.com using -f Date: Fri, 8 Jun 2012 20:04:47 +0300 From: Konstantin Belousov To: Jan Sieka Message-ID: <20120608170447.GH85127@deviant.kiev.zoral.com.ua> References: <4FD1F53D.4030409@semihalf.com> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="AeHkbrJcO8giN/MO" Content-Disposition: inline In-Reply-To: <4FD1F53D.4030409@semihalf.com> User-Agent: Mutt/1.4.2.3i X-Virus-Scanned: clamav-milter 0.95.2 at skuns.kiev.zoral.com.ua X-Virus-Status: Clean X-Spam-Status: No, score=-4.0 required=5.0 tests=ALL_TRUSTED,AWL,BAYES_00 autolearn=ham version=3.2.5 X-Spam-Checker-Version: SpamAssassin 3.2.5 (2008-06-10) on skuns.kiev.zoral.com.ua Cc: Ian Lepore , freebsd-current@freebsd.org, gjb@semihalf.com, Rafal Jaworowski Subject: Re: How to add symbol to be exported in lib/libc/arm/Symbol.map X-BeenThere: freebsd-current@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Discussions about the use of FreeBSD-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 08 Jun 2012 17:05:06 -0000 --AeHkbrJcO8giN/MO Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Fri, Jun 08, 2012 at 02:51:09PM +0200, Jan Sieka wrote: > Hello group! >=20 > I have a few questions regarding adding symbols to > lib/libc//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. >=20 > 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. >=20 > 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. --AeHkbrJcO8giN/MO Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.12 (FreeBSD) iEYEARECAAYFAk/SMK8ACgkQC3+MBN1Mb4io0gCfZCkvXfL/2wRasZi5Ohj178XF V2QAoL3eK86xpkjTNeoER16wAncXPyNU =NS07 -----END PGP SIGNATURE----- --AeHkbrJcO8giN/MO--