+1

I have reviewed and found no issues.

-- mark

On 6/11/10 11:55 AM, John Forte wrote:
I am sponsoring this fasttrack for Vijitha. Requested binding is minor. Timeout
is 06/18/2010.

- John

Template Version: @(#)sac_nextcase 1.70 03/30/10 SMI
This information is Copyright (c) 2010, Oracle and/or its affiliates. All 
rights reserved.
1. Introduction
     1.1. Project/Component Working Name:
         libstmf interfaces for setting stmf properties
     1.2. Name of Document Author/Supplier:
         Author:  Vijitha Dugganapalli
     1.3  Date of This Document:
        11 June, 2010

4. Technical Description

4.1 Summary

     This case is to add two new interfaces to libstmf (PSARC 2007/523) that
     can be used to define/set the default stmf properties

4.2 Problem

    Currently, there is no mechanism in stmf which allows users to specify the
    default behavior for logical units/targets as per their requirement

4.3 Proposal

     The proposed solution is adding two new interfaces to libstmf
     (PSARC 2007/523) for setting and retrieving default stmf properties to
     logical units and targets, allowing user to set/define the default behavior
     for logical units/targets that needs to be configured during new
     registrations or starting up stmf service

4.5 Interfaces

     ------------------------------------------------------------------
     Interface Name             Comm.Level      Comments
     ------------------------------------------------------------------

     stmfSetStmfProp(3STMF)      Committed        To set the default propeties

     stmfGetStmfProp(3STMF)      Committed        To get the default propeties


     Prototype:

     int stmfSetStmfProp(uint8_t propType, char *propVal)
     int stmfGetStmfProp(uint8_t propType, char *propVal)

4.6 Man page changes:

     New manpages stmfSetStmfProp(3STMF), stmfGetStmfProp(3STMF) are required
     see Appendix A

4.7 Release Binding

     Minor binding is requested.

4.8 References

     libstmf(3LIB) PSARC 2007/523


Appendix A:  manpage for stmfSetStmfProp(3STMF)

SCSI Target Mode Framework Library Functions
                                 stmfGetStmfProp(3STMF)

NAME
         stmfSetStmfProp - set default stmf properties
         for luns and targets.

SYNOPSIS
         cc [ flag... ] file... -lstmf [ library... ]
         #include<libstmf.h>

         int stmfSetStmfProp(uint8_t propType, char *propVal);

PARAMETERS

         propType        A property type value. See DESCRIPTION for
                         valid types.

         propVal         A property value.

DESCRIPTION
         This function sets the default properties for specified property
         type. All  property values are expressed in human-readable form.
         The propType argument can be one of the following values:

         STMF_DEFAULT_LU_STATE

         Sets the  default state for luns. The new setting will
        only take effect after a service enable/restart on
        the stmf service. Valid propVal are "online" or "offline"

         STMF_DEFAULT_TARGET_PORT_STATE

         Sets the default state for target ports The new setting
        will only take effect after a service enable/restart on
        the stmf service. Valid propVal are "online" or "offline"

RETURN VALUES
         The following values are returned:

         STMF_STATUS_SUCCESS

                 The API call was successful.

         STMF_ERROR_INVALID_ARG

                 propType is invalid.



ATTRIBUTES
         See attributes(5) for descriptions of the  following  attributes

______________________________________________________________________
     |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
     |_____________________________|_____________________________|
     | Interface Stability         | Committed                   |
     |_____________________________|_____________________________|
     | MT-Level                    | Safe                        |
     |_____________________________|_____________________________|



SEE ALSO
         libstmf(3LIB), stmfGetStmfProp(3STMF), attributes(5)



Manpage for stmfGetStmfProp(3STMF)

SCSI Target Mode Framework Library Functions
                                 stmfGetStmfProp(3STMF)

NAME
         stmfGetStmfProp - retrieves default stmf properties
         for luns and targets.

SYNOPSIS
         cc [ flag... ] file... -lstmf [ library... ]
         #include<libstmf.h>

         int stmfGetStmfProp(uint8_t propType, char *propVal);

PARAMETERS

         propType        A property type value. See DESCRIPTION for
                         valid values.

         propVal         A property value.

DESCRIPTION
         This function gets the default properties for specified property
         type. All  property values are expressed in human-readable form.
         The propType argument can be one of the following values:

         STMF_DEFAULT_LU_STATE

         propType to retrieve the current default state for luns

         Default propVal: "online"

         STMF_DEFAULT_TARGET_PORT_STATE

         propType to retrieve the current default state for target ports

         Default propVal: "online"

RETURN VALUES
         The following values are returned:

         STMF_STATUS_SUCCESS

                 The API call was successful.

         STMF_ERROR_INVALID_ARG

                 Either propType or propVal is unrecognized.

         STMF_ERROR_NOT_FOUND

                 Specified propType not found in the system


ATTRIBUTES
         See attributes(5) for descriptions of the  following  attributes

______________________________________________________________________
     |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
     |_____________________________|_____________________________|
     | Interface Stability         | Committed                   |
     |_____________________________|_____________________________|
     | MT-Level                    | Safe                        |
     |_____________________________|_____________________________|



SEE ALSO
         libstmf(3LIB), stmfSetStmfProp(3STMF), attributes(5)






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

_______________________________________________
opensolaris-arc mailing list
[email protected]
_______________________________________________
opensolaris-arc mailing list
[email protected]

Reply via email to