sun
   microsystems              Systems Architecture Committee

_________________________________________________________________

Subject:       COMSTAR

Submitted by:  Sumit Gupta

File:          PSARC/2007/523/opinion.txt

Date:          Feb 6, 2008

Committee:     Mark  Carlson  (Rick Matthews),  James  D.
               Carlson, Bill Sommerfeld, Gary Winiger, Joseph Kowalski.

Product Approval Committee:

               Solaris PAC
               solaris-pac-opinion

1.  Summary

COMSTAR is a software framework that enables a Solaris host to be
used as a SCSI target platform. 

2.  Decision & Precedence Information

The project is approved as specified in reference  [1]

The project may be delivered in a patch binding

3.  Interfaces
The project exports the following interfaces.

		Interfaces Exported
	 -------------+--------------------+-------------------------
	 Interface    | Classification     | Comments
	 -------------+--------------------+-------------------------
	              |                    |           
	 LU Provider  | Committed          | Implements functionality of
	              |                    | a SCSI LU.
	              |                    |           
	 Port provider| Committed          | Implements functionality of
	              |                    | a SCSI Target port. 
	              |                    |           
	 stmf         | Committed          | Framework functions for LU
	              |                    | providers and port providers. 
	              |                    |           
	 ioctls for   | Project private    | Interface between stmf and
	 libstmf      |                    | libstmf 
	              |                    |           
	 libstmf      | Committed          | Library interfaces for managing
	              |                    | LUN mappings.
	              |                    |           
	 stmfadm      | Committed          | CLI options.
	 output of    | not-an-interface   |
	  stmfadm     |                    |
	              |                    |           
	smf schema    | Project private    | To store LUN mappings.


The project imports the following interfaces.

			Interfaces Imported
	 -------------+--------------------+-------------------------
	 Interface    | Classification     | Comments
	 -------------+--------------------+-------------------------
	              |                    |           
	Solaris DDI   | Committed          | Interfaces defined in section
	              |                    | 9E and 9F of solaris man pages.
   Libraries defined  |                    |           
   section 11 of this | Committed          |           
   document           |                    |           
	              |                    |           



4.  Opinion

The committee voted to approve the case during inception without the need for a
commitment review under the provision that the FMA ereport definitions were
provided. Since inception, the project team has determined that there is
already work ongoing to define FMA for storage.  A response to this issue can
be found in full at reference [2].


5.  Minority Opinion(s)

none

6.  Advisory Information



7.  Appendices

7.1.  Appendix A: Technical Changes Required

none


7.2.  Appendix B: Technical Changes Advised

none

7.3.  Appendix C: Reference Material

Unless stated otherwise, path names are relative to the case
directory PSARC/2007/523.

     1    commit.materials/libstmf_v1.1.pdf
          commit.materials/stmf_interface_spec.pdf
          commit.materials/stmfadm.pdf
     2    commit.materials/jdc-2.response

Further supplementary material may be found in the following
files:
	commit.materials/comstar.portfolio-p0
	inception.materials/smf_service_props.txt
	inception.materials/Security.txt