From wyllys.ingersoll@sun.com Tue Jul 24 11:23:31 2007 Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id l6OINVaV006252 for ; Tue, 24 Jul 2007 11:23:31 -0700 (PDT) Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11]) by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id l6OIKMM5041058; Tue, 24 Jul 2007 12:20:23 -0600 (MDT) Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0JLP00J054BO9B00@brm-avmta-1.central.sun.com>; Tue, 24 Jul 2007 12:21:24 -0600 (MDT) Received: from jurassic-x4600.sfbay.sun.com ([129.146.17.63]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JLP00FLH4BNMB20@brm-avmta-1.central.sun.com>; Tue, 24 Jul 2007 12:21:24 -0600 (MDT) Received: from [10.7.251.182] (punchin-wyllys.SFBay.Sun.COM [10.7.251.182]) by jurassic-x4600.sfbay.sun.com (8.14.1+Sun/8.14.1) with ESMTP id l6OILMWb759761 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Tue, 24 Jul 2007 11:21:23 -0700 (PDT) Date: Tue, 24 Jul 2007 14:21:03 -0400 From: Wyllys Ingersoll Subject: Re: KMFAPI Interface Taxonomy Change [PSARC/2007/426 FastTrack timeout 08/01/2007] In-reply-to: <200707241814.l6OIEdhT027636@borg.SFBay.Sun.COM> To: Wyllys Ingersoll Cc: PSARC-ext@sun.com, kmf-core@sun.com Message-id: <46A6430F.6090302@sun.com> MIME-version: 1.0 Content-type: text/plain; charset=ISO-8859-1; format=flowed Content-transfer-encoding: 7BIT X-PMX-Version: 5.2.0.264296 References: <200707241814.l6OIEdhT027636@borg.SFBay.Sun.COM> User-Agent: Thunderbird 2.0.0.0 (X11/20070521) Status: RO Content-Length: 2608 The case files (header, reference doc, and man page text) are also available to external reviewers at: http://opensolaris.org/os/project/kmf/files/ -Wyllys Wyllys Ingersoll wrote: > Template Version: @(#)sac_nextcase 1.64 07/13/07 SMI > This information is Copyright 2007 Sun Microsystems > 1. Introduction > 1.1. Project/Component Working Name: > KMFAPI Interface Taxonomy Change > 1.2. Name of Document Author/Supplier: > Author: Wyllys Ingersoll > 1.3 Date of This Document: > 24 July, 2007 > 4. Technical Description > KMFAPI Interface Taxonomy Change > -------------------------------- > This case is to document the changing of the interface taxonomy for the KMF > programming APIs from "consolidation private" to "Committed". > > The release binding of the change will be patch/micro. > > The original KMF APIs were introduced in PSARC 2005/074 - Solaris Key > Management Framework. In the opinion and comments for that case it was > recommended that when we move to a more stable interface, we should make > the interfaces extensible and change the naming conventions to conform with > current ON standards. We have done both. The new interfaces were made extensible > by changing the more complex functions to use arrays of attribute/value pair > records, similar to PKCS#11 (libpkcs11) interfaces, instead of fixed size > parameter structures. The names of the functions were also modified > to meet ON naming conventions. > > The new APIs are documented here: http://borg.sfbay/export/projects/KMF/KMFAPI_Reference.pdf > > The following documents are available in the case directory: > - KMFAPI_Reference.pdf > - libkmf.3LIB - proposed man page > - kmfapi.h - updated header file with new prototypes > > NOTE - the kmfapi.h header file contains some legacy APIs that cannot be > removed yet because the 'elfsign' code depends on them and they cannot > be removed without a flag-day for the elfsign. That code will be removed > at a later date when elfsign is restructured so that it can be changed > without causing a flag day operation for build machine operators. > > Those legacy APIs in the header file will be marked by a comment > discouraging their use and are not covered by the new taxonomy, > we wish for those to remain "consolidation private". > > The man page (libkmf.3LIB) contains the list of APIs to be supported > at the Committed level. > > 6. Resources and Schedule > 6.4. Steering Committee requested information > 6.4.1. Consolidation C-team Name: > ON > 6.5. ARC review type: FastTrack > 6.6. ARC Exposure: open > From Darren.Moffat@Sun.COM Wed Jul 25 02:12:04 2007 Received: from sunmail4.Singapore.Sun.COM (sunmail4.Singapore.Sun.COM [129.158.71.19]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id l6P9C3Jk003675 for ; Wed, 25 Jul 2007 02:12:04 -0700 (PDT) Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11]) by sunmail4.Singapore.Sun.COM (8.13.4+Sun/8.13.3/ENSMAIL,v2.2) with ESMTP id l6P99p2L005400; Wed, 25 Jul 2007 17:09:55 +0800 (SGT) Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0JLQ003059GGFL00@brm-avmta-1.central.sun.com>; Wed, 25 Jul 2007 03:09:52 -0600 (MDT) Received: from gmp-ea-fw-1.sun.com ([129.156.42.5]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JLQ00K0A9GEFMC0@brm-avmta-1.central.sun.com>; Wed, 25 Jul 2007 03:09:51 -0600 (MDT) Received: from d1-emea-09.sun.com (d1-emea-09.sun.com [192.18.2.119]) by gmp-ea-fw-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id l6P99o8X012508; Wed, 25 Jul 2007 09:09:50 +0000 (GMT) Received: from conversion-daemon.d1-emea-09.sun.com by d1-emea-09.sun.com (Sun Java System Messaging Server 6.2-6.01 (built Apr 3 2006)) id <0JLQ00701947PA00@d1-emea-09.sun.com> (original mail from Darren.Moffat@Sun.COM); Wed, 25 Jul 2007 10:09:50 +0100 (BST) Received: from [129.156.173.21] by d1-emea-09.sun.com (Sun Java System Messaging Server 6.2-6.01 (built Apr 3 2006)) with ESMTPSA id <0JLQ00D4O9G8MO30@d1-emea-09.sun.com>; Wed, 25 Jul 2007 10:09:45 +0100 (BST) Date: Wed, 25 Jul 2007 10:09:44 +0100 From: Darren J Moffat Subject: Re: KMFAPI Interface Taxonomy Change [PSARC/2007/426 FastTrack timeout 08/01/2007] In-reply-to: <46A6430F.6090302@sun.com> Sender: Darren.Moffat@Sun.COM To: Wyllys Ingersoll Cc: Wyllys Ingersoll , PSARC-ext@Sun.COM, kmf-core@Sun.COM Message-id: <46A71358.6030800@Sun.COM> MIME-version: 1.0 Content-type: text/plain; format=flowed; charset=ISO-8859-1 Content-transfer-encoding: 7BIT X-PMX-Version: 5.2.0.264296 References: <200707241814.l6OIEdhT027636@borg.SFBay.Sun.COM> <46A6430F.6090302@sun.com> User-Agent: Thunderbird 2.0.0.0 (X11/20070605) Status: RO Content-Length: 94 Are the legacy APIs marked as SUNWprivate symbols in the linker mapfile ? -- Darren J Moffat From wyllys.ingersoll@sun.com Wed Jul 25 06:08:16 2007 Received: from sunmail2sca.sfbay.sun.com (sunmail2sca.SFBay.Sun.COM [129.145.155.234]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id l6PD8GIJ006804 for ; Wed, 25 Jul 2007 06:08:16 -0700 (PDT) Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6]) by sunmail2sca.sfbay.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id l6PD66qn011084; Wed, 25 Jul 2007 06:06:07 -0700 (PDT) Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0JLQ00L1DKE66I00@nwk-avmta-2.sfbay.sun.com>; Wed, 25 Jul 2007 06:06:06 -0700 (PDT) Received: from jurassic-x4600.sfbay.sun.com ([129.146.17.63]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JLQ001S2KE27DE0@nwk-avmta-2.sfbay.sun.com>; Wed, 25 Jul 2007 06:06:02 -0700 (PDT) Received: from [10.7.251.182] (punchin-wyllys.SFBay.Sun.COM [10.7.251.182]) by jurassic-x4600.sfbay.sun.com (8.14.1+Sun/8.14.1) with ESMTP id l6PD5w1l904802 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Wed, 25 Jul 2007 06:05:58 -0700 (PDT) Date: Wed, 25 Jul 2007 09:05:38 -0400 From: Wyllys Ingersoll Subject: Re: KMFAPI Interface Taxonomy Change [PSARC/2007/426 FastTrack timeout 08/01/2007] In-reply-to: <46A71358.6030800@Sun.COM> To: Darren J Moffat Cc: Wyllys Ingersoll , PSARC-ext@sun.com, kmf-core@sun.com Message-id: <46A74AA2.2010604@sun.com> MIME-version: 1.0 Content-type: text/plain; charset=ISO-8859-1; format=flowed Content-transfer-encoding: 7BIT X-PMX-Version: 5.2.0.264296 References: <200707241814.l6OIEdhT027636@borg.SFBay.Sun.COM> <46A6430F.6090302@sun.com> <46A71358.6030800@Sun.COM> User-Agent: Thunderbird 2.0.0.0 (X11/20070521) Status: RO Content-Length: 157 Darren J Moffat wrote: > Are the legacy APIs marked as SUNWprivate symbols in the linker mapfile ? > > -- > Darren J Moffat Now they will be :) -Wyllys From wyllys.ingersoll@sun.com Wed Aug 1 12:10:44 2007 Received: from sunmail2sca.sfbay.sun.com (sunmail2sca.SFBay.Sun.COM [129.145.155.234]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id l71JAi42027511 for ; Wed, 1 Aug 2007 12:10:44 -0700 (PDT) Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11]) by sunmail2sca.sfbay.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id l71J8SLd002755; Wed, 1 Aug 2007 12:08:29 -0700 (PDT) Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0JM30060DZU4BV00@brm-avmta-1.central.sun.com>; Wed, 01 Aug 2007 13:08:29 -0600 (MDT) Received: from jurassic-x4600.sfbay.sun.com ([129.146.17.63]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JM30020GZU4BC70@brm-avmta-1.central.sun.com>; Wed, 01 Aug 2007 13:08:28 -0600 (MDT) Received: from [10.7.251.182] (punchin-wyllys.SFBay.Sun.COM [10.7.251.182]) by jurassic-x4600.sfbay.sun.com (8.14.1+Sun/8.14.1) with ESMTP id l71J8RJk276032 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Wed, 01 Aug 2007 12:08:28 -0700 (PDT) Date: Wed, 01 Aug 2007 15:08:12 -0400 From: Wyllys Ingersoll Subject: PSARC 2007/426 KMFAPI Interface Taxonomy Change To: PSARC-ext@sun.com Message-id: <46B0DA1C.1080102@sun.com> MIME-version: 1.0 Content-type: text/plain; charset=ISO-8859-1; format=flowed Content-transfer-encoding: 7BIT X-PMX-Version: 5.2.0.264296 User-Agent: Thunderbird 2.0.0.0 (X11/20070521) Status: RO Content-Length: 40 This case was approved today. -Wyllys