Subject: KMFAPI Interface Taxonomy Change [PSARC/2007/426 FastTrack timeout 08/01/2007]
To:      PSARC-ext@Sun.Com
Cc:      kmf-core@sun.com
Bcc:     one-pager-list@sac.sfbay one-pager-log@sac.sfbay sac-bar@sac.sfbay


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