From John.Forte@Sun.COM Thu Jan 22 13:16:33 2009 Received: from dm-sfbay-02.sfbay.sun.com (dm-sfbay-02.SFBay.Sun.COM [129.146.11.31]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n0MLGXpr018397 for ; Thu, 22 Jan 2009 13:16:33 -0800 (PST) Received: from brmea-mail-4.sun.com (brmea-mail-4.Sun.COM [192.18.98.36]) by dm-sfbay-02.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id n0MLGXoO053908 for ; Thu, 22 Jan 2009 13:16:33 -0800 (PST) Received: from fe-amer-09.sun.com ([192.18.109.79]) by brmea-mail-4.sun.com (8.13.6+Sun/8.12.9) with ESMTP id n0MLGXcQ007011 for ; Thu, 22 Jan 2009 21:16:33 GMT Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) id <0KDW00M014CA3K00@mail-amer.sun.com> (original mail from John.Forte@Sun.COM) for psarc-ext@sac.sfbay.sun.com; Thu, 22 Jan 2009 14:16:33 -0700 (MST) Received: from [129.146.56.52] by mail-amer.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) with ESMTPSA id <0KDW00IM25R5DG30@mail-amer.sun.com> for psarc-ext@sac.sfbay.sun.com; Thu, 22 Jan 2009 14:16:18 -0700 (MST) Date: Thu, 22 Jan 2009 13:12:34 -0800 From: John Forte Subject: T11 Storage Management HBA API(SM-HBA) [PSARC/2008/687 FastTrack timeout 01/29/2009]] Sender: John.Forte@Sun.COM To: psarc-ext@sac.sfbay.sun.com Cc: Hyon Kim Message-id: <4978E142.6020108@sun.com> MIME-version: 1.0 Content-type: text/plain; format=flowed; charset=ISO-8859-1 Content-transfer-encoding: 7BIT User-Agent: Thunderbird 2.0.0.17 (X11/20081014) Status: RO Content-Length: 19146 I am sponsoring this fasttrack for Hyon Kim. Requested binding is Patch, timeout is 01/29/2009. - John This information is Copyright 2009 Sun Microsystems 1. Introduction 1.1. Project/Component Working Name: T11 Storage Management HBA API(SM-HBA) 1.2. Name of Document Author/Supplier: Author: Hyon Kim 1.3 Date of This Document: 22 January, 2009 4. Technical Description - Problem Area: The currently released Serial Attached SCSI(SAS) HBAs are supported through HBA vendor specific utilities. As Sun is working on release of next generation SAS HBAs the administrator may have to deal with additional vendor specific utilities without common Solaris management support. This project is to deliver T11 Storage Management HBA API(SM-HBA) support and provide standard based SAS management utility for upcoming Sun's SAS-2 compliant (SAS Gen-2) HBAs. Note that a draft of SM-HBA-2 is published but it is not mature enough to guide product implementation according to T11. It is currently put on hold. The project team is requesting micro/patch binding. - Technical description 1. Deliverables: The SM-HBA support comprised of SM-HBA common library, a vendor specific library(VSL) for SAS Gen-2 HBAs and CLI which consumes SM-HBA interfaces and reports SAS HBAs and target configuration. libsmhba.so : SM-HBA common library Exports standard defined interfaces for use by utilities, SMI-S agents and any other 3rd party vendor application. libsun_sas.so : Vendor Specific Library(VSL) for SAS Gen-2 HBAs sasinfo.1M : SM-HBA based CLI for SAS HBA configuration discovery. +===============+ +---------------+ || sasinfo.1M || | other clients | +===============+ +---------------+ | | +==================================+ || libsmhba.so(SM-HBA standards) || +==================================+ | +==========================+ || libsun_sas.so(SAS VSL) || +==========================+ | | ______________|______|_____________________________________________ | | For SCSI passthru | +-----------------------------+ private ioctl | | libdevinfo(PSARC/2004/169) | | | libkstat(PSARC/1999/495) | | | libsysevent(PSARC/2001/076) | | +-----------------------------+ | | | | Generating devinfo nodes/properties, | | kstat counter and sysevent. | | +--------------------------------------+ | PSARC/2008/672 thebe SAS/SATA driver | | PSARC/2008/448 LSI MPT 2.0 support | | SAS Gen-2 HBA driver | +--------------------------------------+ 2. In Scope: The SM-HBA standard has been evolved from its predecessor FC-HBA to allow an application to manage both SAS and Fibre Channel HBAs through common interfaces. This project is to take advantage of those newly defined interfaces for SAS HBA management and will be providing VSL and CLI for Sun's SAS Gen-2 HBA support. Even though the SM-HBA standard includes the functionality of FC-HBA for FC HBA support, interface-wise it doesn't provide backward compatibility for FC-HBA clients. Thus the SM-HBA library will be handled as a major new release over the existing FC-HBA library. 3. Out of Scope: The FC HBA support through SM-HBA on existing FC HBAs not part of this project. They will be supported through existing libhbaapi.3LIB and fcinfo.1M. Since the functionality for FC support is same as FC-HBA there is no real benefit of migrating current FC-HBA support to SM-HBA. The current FC-HBA clients can continue to use FC-HBA library and if there is any client which needs to manage both FC and SAS through common interfaces in the future, the migration for the current FC-HBA support will be considered. 4. Interfaces: Interfaces Imported -------------+--------------------+------------------------- Interface | Classification | Comments -------------+--------------------+------------------------- | | Libraries listed | | section 4.8 | Committed | | | Events listed in | | section 4.8 | Consolidation | | private | Interfaces Exported -------------+--------------------+------------------------- Interface | Classification | Comments -------------+--------------------+------------------------- | | libsmhba interfaces | Committed | Implements SM-HBA standards | | Section 4.1 | | /etc/smhba.conf | Committed | To store library name and location | | at Vendor Library installation | | time. Section 4.2 | | sasinfo.1M command | Committed | Consumes libsmhba interfaces. | | section 4.3 | | sasinfo output | Not an interface | | | SAS related event | project private | Section 4.4 | | SEND_SCSI_CMD ioctl | project private | Section 4.5 | | kstat class name/ | project private | Section 4.6 phy stat structure | | | | SAS devinfo prop | project private | Section 4.7 | | 4.1 SM-HBA Interfaces The following list shows the interfaces that are defined in SM-HBA standards (Section 8.1). The common library(libsmhba.so) will implement all these interfaces and the Support column indicates whether Sun VSL for SAS HBA(libsun_sas.so) would support the particular interface or not. In general, all mandatory interfaces and attributes are supported and a subset of optional ones are also supported based on the need of Sun SAS management. All supported interfaces and attributes below are committed. API Support Note --- ------- ---- - GetVersion Yes Mandatory - LoadLibrary Yes Mandatory - FreeLibrary Yes Mandatory - RegisterLibrary Yes Mandatory - GetNumberofAdapters Yes Mandatory - RefreshInformation Yes Mandatory - RefreshAdapterConfiguration Yes Mandatory - GetWrapperLibraryAttributes Yes Mandatory - GetVendorLibraryAttributes Yes Mandatory - GetAdapterName Yes Mandatory - OpenAdapter Yes Mandatory - CloseAdapter Yes Mandatory - GetAdapterAttributes Yes Mandatory - SMHBA_ADAPTERATTRIBUTES Partial (*) - Manufacturer Yes Mandatory - SerialNumber Yes Mandatory - Model Yes Mandatory - ModelDescription No - HardwareVersion Yes - DriverVersion Yes - OptionROMVersion Yes - FirmwareVersion Yes - VendorSpecificID No - HBASymbolicName No - DriverName Yes - RedundantOptionROMVersion No - RedundantFirmwareVersion No - GetNumberofPorts Yes Mandatory - GetPortType Yes Mandatory - GetAdapterPortAttributes Yes Mandatory - SMHBA_PORTATTRIBUTES Yes - SMHBA_SAS_PORT Yes - GetDiscoveredPortAttributes Yes Mandatory - SMHBA_PORTATTRIBUTES Yes - All the attributes in SMHBA_PORTATTRIBUTES and SMHBA_SAS_PORT are supported except NumberofDiscoveredPorts and NumberofPhys which are not applicable for a discovered port. - GetPortAttributesByWWN Yes - GetPhyAttributtes Yes Mandatory - SMHBA_SAS_PHY attributes Yes - SMHBA_FC_PHY No Only for FC support - GetProtocolStatistics No No driver/firmware support - GetphyStatistics Yes Mandatory - SMHBA_SASPHYSTATISTICS Partial(*) - SecondsSinceLastReset Yes - TxFrames No No driver/firmware support - TxWords No No driver/firmware support - RxFrames No No driver/firmware support - RxWords No No driver/firmware support - InvalidDwordCount Yes Mandatory - RunningDisparityErrorCount Yes Mandatory - LossofDwordSyncCount Yes Mandatory - PhyResetProblemCount Yes Mandatory - GetPortAttributesbyWWN Yes - GetBindingCapability No No administrative binding support - GetBindingSupport No No administrative binding support - SetBindingSupport No No administrative binding support - GetTargetMapping Yes - GetPersistentBinding No No administrative binding support - SetPersistentBinding No No administrative binding support - RemovePersistentBindings No No administrative binding support - RemoveAllPersistentBindings No No administrative binding support - GetLUNStatistics No No driver/firmware support - SendScsiInquiry Yes - SendReportLuns Yes - SendReadCapacity Yes - SendSMPPassThru Yes - SendCTPassThruV2 No Only for FC support - SetRNIDMgmtInfo No Only for FC support - GetRNIDMgmtInfo No Only for FC support - SendRNIDV2 No Only for FC support - SendRPL No Only for FC support - SendRPS No Only for FC support - SendSRL No Only for FC support - SendLIRR No Only for FC support - SendRLS No Only for FC support - SendTEST No Only for FC support - SendECHO No Only for FC support - RegisterForAdapterAddEvents Yes - RegisterForAdapterEvents Yes - RegisterForAdapterPortEvents Yes - RegisterForAdapterPortStatEvents No No driver/FC support - RegisterForAdapterPhyStatEvents No No driver/FC support - RegisterForTargetEvents Yes - RegisterForLinkEvents Yes - RemoveCallback Yes * Interface is implemented, but not all attributes are supported. 4.2 Repository for SM-HBA Vendor Specific Library(VSL) The libsmhba.so loads the VSLs from the repository. - /etc/smhba.conf committed 4.3 CLI interfaces - sasinfo hba-port committed - sasinfo remote-port committed - sasinfo logical-unit committed The output of sasinfo is not an interface. 4.4 The SAS related event The following events are defined per SM-HBA standards and project private. Event class: EC_HBA Event subclass: ESC_sas_phy_event payload: port driver name, port SAS address, instance number, devfs path, phy id, domain Port Address, event type(one of events below) "phy_online" : Operational use of a phy device supported by the HBA API has been restored. "phy_offline" : Operational use of a phy device supported by the HBA API has become impossible. "phy_remove" : A phy device supported by the HBA API has been removed from the fabric. Event class: EC_HBA Event subclass: ESC_sas_hba_port_broadcast payload: driver name, port SAS address, instance #, devfs path, event type(one of events below) "port_broadcast_change" An HBA on the local system supported by the SM-HBA API has received a SAS Broadcast (CHANGE) primitive (see SAS-2). "port_broadcast_ses" An HBA on the local system supported by the SM-HBA-2 API has received a SAS BROADCAST (SES) primitive (see SAS-2). "port_broadcast_d24_0" An HBA on the local system supported by the SM-HBA-2 API has received a SAS BROADCAST (RESERVED CHANGE 0) primitive (see SAS-2). "port_broadcast_d27_4" An HBA on the local system supported by the SM-HBA API has received a SAS BROADCAST (RESERVED CHANGE 1) primitive (see SAS-2). "port_broadcast_d01_4" An HBA on the local system supported by the SM-HBA API has received a SAS BROADCAST (RESERVED 1) primitive (see SAS-2). "port_broadcast_d04_7" An HBA on the local system supported by the SM-HBA API has received a SAS BROADCAST (RESERVED 2) primitive (see SAS-2). "port_broadcast_d16_7" An HBA on the local system supported by the SM-HBA API has received a SAS BROADCAST (RESERVED 3) primitive (see SAS-2). "port_broadcast_d29_7" An HBA on the local system supported by the SM-HBA API has received a SAS BROADCAST (RESERVED 4) primitive (see SAS-2). 4.5 SCSI passthru icotl ioctl: SEND_SCSI_CMD struct sas_scsi_cmd { uint64_t target_sas_addr; /* SAS address of target device */ uint64_t domain_port_sas_addr; /* SAS address for SAS domain. */ uint64_t scsi_lun; /* 8 byte SCSI LUN */ uint32_t scsi_sas_status; /* SCSI status */ uint32_t scsi_sas_rspcode; /* SAS response code */ uchar_t scsi_pkt_state; /* state of the request */ uchar_t scsi_pkt_action; /* corrective action */ uint32_t scsi_pkt_reason; /* reason for the state */ uint32_t scsi_flags; /* data flow direction */ uint32_t scsi_timeout; /* command timeout length */ unit64_t scsi_cdbaddr; /* SCSI CDB */ uint32_t scsi_cdblen; /* length of the CDB */ unint64_t scsi_bufaddr; /* data buffer for the request */ uint32_t scsi_buflen; /* buffer length */ int32_t scsi_bufresid; /* buffer residual */ uint32_t scsi_status; /* buffer status */ uint64_t scsi_rqbufaddr; /* sense data buffer */ uint32_t scsi_rqlen; /* sense data length */ int32_t scsi_rqresid; /* sense data residual */ } sas_scsi_cmd_t; 4.6 kstat related definition #define KSTAT_SAS_PHY_CLASS "SAS_phy_stat" /* class for kstat_t(kstat.3KSTAT)*/ /* PHY - kstat structure definition */ typedef struct sas_phy_stats { kstat_named_t seconds_since_last_reset; kstat_named_t tx_frames; kstat_named_t tx_words; kstat_named_t rx_frames; kstat_named_t rx_words; kstat_named_t invalid_dword_count; kstat_named_t running_disparity_error_count; kstat_named_t loss_of_dword_sync_count; kstat_named_t phy_reset_problem_count; } sas_phy_stats_t; 4.7 Devinfo node property SAS HBA devinfo node: initiator-port uint8 array /* SAS address of SAS HBA */ sm-hba-supported boolean /* indicate if a sm-hba is*/ /* supported or not */ supported-protocol int /* indicates SSP, STP, SMP*/ /* or SATA support */ FirmwareVersion char array /* firmware version */ DriverVersion char array /* driver version */ HardwareVersion char array /* hardware version */ NumberOfPhys int /* number of phys on HBA node */ AttachedSASAddress uint8 array /* SAS address of the other */ /* end of link */ Phy related: PhyIdentifier uint8 /* Phy id */ PhyNegotiatedLinkRate int /* negotiated phy speed */ PhyProgrammedMinLinkRate int /* programmed minimum phy speed */ PhyHardwareMinLinkRate int /* hardware minimum speed */ PhyProgrammedMaxLinkRate int /* programmed maximum phy speed */ PhyHardwareMaxLinkRate int /* hardware maximum phy speed */ PhyDomainPortWWN uint8 array /* SAS address for SAS /* domain */ SAS Target device devinfo node: SATA-target boolean /* indicate if SATA target or /* not */ AttachedSASAddress uint8 array /* SAS address of the other end /* of link */ target-port uint8 array /* SAS address of SAS target */ sam-lun uint8 array /* 8 bytes SCSI LUN per SAM-4 */ 4.8 Imported interface The project uses libc libpthreads libsysevent libdevinfo libkstat EC_DEV event from PSARC/2002/611 EC_DR event from PSARC/2007/326 5. Doc Impact: Man pages for the common library and CLI will be provided. 6. Admin/Config Impact: A new admin CLI will be provided. No changes on existing product. 7. Packaging & Delivery: Two new packages will be delivered. SUNWsmhba: contains userland libraries and CLI SUNWsmhbar: contains a config file(in /etc) to store VSL list. 8. Security Impact: The project will add the following line to /etc/security/exec_attr to allow a privileged user or process to run the command. File System Management:solaris:cmd:::/usr/sbin/sasinfo:privs=sys_devices - Reference Documents: T11 Storage Management HBA API (SM-HBA) http://www.t11.org/ftp/t11/pub/sm/hba/06-382v1.pdf) T10 Serial Attached SCSI - 2 (SAS-2) http://www.t10.org/cgi-bin/ac.pl?t=f&f=sas2r15.pdf FC HBA-API cases SHARC/2004/054 Enhanced support for T11 FC-HBA PSARC/2002/644 FibreChannel HBA API V2 PSARC/2001/481 Sun SNIA HBA API library From gdamore@sun.com Thu Jan 22 13:53:52 2009 Received: from dm-sfbay-01.sfbay.sun.com (dm-sfbay-01.SFBay.Sun.COM [129.145.155.118]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n0MLrqnp018908 for ; Thu, 22 Jan 2009 13:53:52 -0800 (PST) Received: from sca-es-mail-2.sun.com (sca-es-mail-2.Sun.COM [192.18.43.133]) by dm-sfbay-01.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id n0MLrq3h004008 for ; Thu, 22 Jan 2009 13:53:52 -0800 (PST) Received: from fe-sfbay-10.sun.com ([192.18.43.129]) by sca-es-mail-2.sun.com (8.13.7+Sun/8.12.9) with ESMTP id n0MLrlqt016491 for ; Thu, 22 Jan 2009 13:53:47 -0800 (PST) Received: from conversion-daemon.fe-sfbay-10.sun.com by fe-sfbay-10.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) id <0KDW00M016X9VL00@fe-sfbay-10.sun.com> (original mail from gdamore@sun.com) for psarc-ext@sac.sfbay.sun.com; Thu, 22 Jan 2009 13:53:47 -0800 (PST) Received: from [10.7.251.172] by fe-sfbay-10.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) with ESMTPSA id <0KDW00FDR7HM3340@fe-sfbay-10.sun.com> for psarc-ext@sac.sfbay.sun.com; Thu, 22 Jan 2009 13:53:46 -0800 (PST) Date: Thu, 22 Jan 2009 13:43:41 -0800 From: "Garrett D'Amore" Subject: Re: T11 Storage Management HBA API(SM-HBA) [PSARC/2008/687 FastTrack timeout 01/29/2009]] In-reply-to: <4978E142.6020108@sun.com> Sender: Garrett.Damore@sun.com To: John Forte Cc: psarc-ext@sac.sfbay.sun.com, Hyon Kim Message-id: <4978E88D.9050500@sun.com> MIME-version: 1.0 Content-type: text/plain; format=flowed; charset=ISO-8859-1 Content-transfer-encoding: 7BIT References: <4978E142.6020108@sun.com> User-Agent: Thunderbird 2.0.0.14 (X11/20080616) Status: RO Content-Length: 19966 Apparently there is a man page for sasinfo in the materials directory. Might have been nice to note that in the text of the case proper. The rest looks OK. Are we anticipating future projects to use this library, or 3rd party consumption of the library? - Garrett John Forte wrote: > I am sponsoring this fasttrack for Hyon Kim. Requested binding is Patch, > timeout is 01/29/2009. > > - John > > > This information is Copyright 2009 Sun Microsystems > 1. Introduction > 1.1. Project/Component Working Name: > T11 Storage Management HBA API(SM-HBA) > 1.2. Name of Document Author/Supplier: > Author: Hyon Kim > 1.3 Date of This Document: > 22 January, 2009 > 4. Technical Description > > > - Problem Area: > > The currently released Serial Attached SCSI(SAS) HBAs are supported > through HBA vendor specific utilities. As Sun is working on release > of next generation SAS HBAs the administrator may have to deal with > additional vendor specific utilities without common Solaris management > support. > > This project is to deliver T11 Storage > Management HBA API(SM-HBA) support and provide standard based SAS > management utility for upcoming Sun's SAS-2 compliant (SAS Gen-2) > HBAs. > > Note that a draft of SM-HBA-2 is published but it is not mature enough > to guide product implementation according to T11. It is currently put > on hold. > > The project team is requesting micro/patch binding. > > - Technical description > > 1. Deliverables: > > The SM-HBA support comprised of SM-HBA common library, a vendor > specific library(VSL) for SAS Gen-2 HBAs and CLI which consumes > SM-HBA interfaces and reports SAS HBAs and target configuration. > > libsmhba.so : SM-HBA common library > Exports standard defined interfaces for use by utilities, > SMI-S agents and any other 3rd party vendor application. > libsun_sas.so : Vendor Specific Library(VSL) for SAS Gen-2 HBAs > sasinfo.1M : SM-HBA based CLI for SAS HBA configuration discovery. > > +===============+ +---------------+ > || sasinfo.1M || | other clients | > +===============+ +---------------+ > | | > +==================================+ > || libsmhba.so(SM-HBA standards) || > +==================================+ > | > +==========================+ > || libsun_sas.so(SAS VSL) || > +==========================+ > | | > ______________|______|_____________________________________________ > | | > For SCSI passthru | +-----------------------------+ > private ioctl | | libdevinfo(PSARC/2004/169) | > | | libkstat(PSARC/1999/495) | > | | libsysevent(PSARC/2001/076) | > | +-----------------------------+ > | | > | | Generating devinfo nodes/properties, > | | kstat counter and sysevent. > | | > +--------------------------------------+ > | PSARC/2008/672 thebe SAS/SATA driver | > | PSARC/2008/448 LSI MPT 2.0 support | > | SAS Gen-2 HBA driver | > +--------------------------------------+ > > 2. In Scope: > > The SM-HBA standard has been evolved from its predecessor FC-HBA to > allow an application to manage both SAS and Fibre Channel HBAs through > common interfaces. > > This project is to take advantage of those newly defined interfaces > for SAS HBA management and will be providing VSL and CLI for Sun's SAS > Gen-2 HBA support. > > Even though the SM-HBA standard includes the functionality of FC-HBA > for FC HBA support, interface-wise it doesn't provide backward > compatibility for FC-HBA clients. Thus the SM-HBA library will be > handled as a major new release over the existing FC-HBA library. > > 3. Out of Scope: > > The FC HBA support through SM-HBA on existing FC HBAs not part > of this project. They will be supported through existing > libhbaapi.3LIB and fcinfo.1M. Since the functionality for FC support > is same as FC-HBA there is no real benefit of migrating current FC-HBA > support to SM-HBA. The current FC-HBA clients can continue to use > FC-HBA library and if there is any client which needs to manage both > FC and SAS through common interfaces in the future, the migration for > the current FC-HBA support will be considered. > > 4. Interfaces: > > Interfaces Imported > -------------+--------------------+------------------------- > Interface | Classification | Comments > -------------+--------------------+------------------------- > | | > Libraries listed | | > section 4.8 | Committed | > | | > Events listed in | | > section 4.8 | Consolidation | > | private | > > > > Interfaces Exported > -------------+--------------------+------------------------- > Interface | Classification | Comments > -------------+--------------------+------------------------- > | | > libsmhba interfaces | Committed | Implements SM-HBA standards > | | Section 4.1 > | | > /etc/smhba.conf | Committed | To store library name and > location > | | at Vendor Library > installation > | | time. Section 4.2 > | | > sasinfo.1M command | Committed | Consumes libsmhba interfaces. > | | section 4.3 > | | > sasinfo output | Not an interface | > | | > SAS related event | project private | Section 4.4 > | | > SEND_SCSI_CMD ioctl | project private | Section 4.5 > | | > kstat class name/ | project private | Section 4.6 > phy stat structure | | > | | > SAS devinfo prop | project private | Section 4.7 > | | > > 4.1 SM-HBA Interfaces > > The following list shows the interfaces that are defined in SM-HBA > standards (Section 8.1). The common library(libsmhba.so) will implement > all these interfaces and the Support column indicates whether Sun VSL > for SAS HBA(libsun_sas.so) would support the particular interface or > not. In general, all mandatory interfaces and attributes are supported > and a subset of optional ones are also supported based on the need of > Sun SAS management. > > All supported interfaces and attributes below are committed. > > API Support Note > --- ------- ---- > - GetVersion Yes Mandatory > - LoadLibrary Yes Mandatory > - FreeLibrary Yes Mandatory > - RegisterLibrary Yes Mandatory > - GetNumberofAdapters Yes Mandatory > - RefreshInformation Yes Mandatory > - RefreshAdapterConfiguration Yes Mandatory > - GetWrapperLibraryAttributes Yes Mandatory > - GetVendorLibraryAttributes Yes Mandatory > - GetAdapterName Yes Mandatory > - OpenAdapter Yes Mandatory > - CloseAdapter Yes Mandatory > - GetAdapterAttributes Yes Mandatory > - SMHBA_ADAPTERATTRIBUTES Partial (*) > - Manufacturer Yes Mandatory > - SerialNumber Yes Mandatory > - Model Yes Mandatory > - ModelDescription No > - HardwareVersion Yes > - DriverVersion Yes > - OptionROMVersion Yes > - FirmwareVersion Yes > - VendorSpecificID No > - HBASymbolicName No > - DriverName Yes > - RedundantOptionROMVersion No > - RedundantFirmwareVersion No > - GetNumberofPorts Yes Mandatory > - GetPortType Yes Mandatory > - GetAdapterPortAttributes Yes Mandatory > - SMHBA_PORTATTRIBUTES Yes > - SMHBA_SAS_PORT Yes > - GetDiscoveredPortAttributes Yes Mandatory > - SMHBA_PORTATTRIBUTES Yes > - All the attributes in SMHBA_PORTATTRIBUTES and SMHBA_SAS_PORT > are supported except NumberofDiscoveredPorts and NumberofPhys > which are not applicable for a discovered port. > - GetPortAttributesByWWN Yes > - GetPhyAttributtes Yes Mandatory > - SMHBA_SAS_PHY attributes Yes > - SMHBA_FC_PHY No Only for FC support > - GetProtocolStatistics No No driver/firmware support > - GetphyStatistics Yes Mandatory > - SMHBA_SASPHYSTATISTICS Partial(*) > - SecondsSinceLastReset Yes > - TxFrames No No driver/firmware support > - TxWords No No driver/firmware support > - RxFrames No No driver/firmware support > - RxWords No No driver/firmware support > - InvalidDwordCount Yes Mandatory > - RunningDisparityErrorCount Yes Mandatory > - LossofDwordSyncCount Yes Mandatory > - PhyResetProblemCount Yes Mandatory > - GetPortAttributesbyWWN Yes > - GetBindingCapability No No administrative binding support > - GetBindingSupport No No administrative binding support > - SetBindingSupport No No administrative binding support > - GetTargetMapping Yes > - GetPersistentBinding No No administrative binding support > - SetPersistentBinding No No administrative binding support > - RemovePersistentBindings No No administrative binding support > - RemoveAllPersistentBindings No No administrative binding support > - GetLUNStatistics No No driver/firmware support > - SendScsiInquiry Yes > - SendReportLuns Yes > - SendReadCapacity Yes > - SendSMPPassThru Yes > - SendCTPassThruV2 No Only for FC support > - SetRNIDMgmtInfo No Only for FC support > - GetRNIDMgmtInfo No Only for FC support > - SendRNIDV2 No Only for FC support > - SendRPL No Only for FC support > - SendRPS No Only for FC support > - SendSRL No Only for FC support > - SendLIRR No Only for FC support > - SendRLS No Only for FC support > - SendTEST No Only for FC support > - SendECHO No Only for FC support > - RegisterForAdapterAddEvents Yes > - RegisterForAdapterEvents Yes > - RegisterForAdapterPortEvents Yes > - RegisterForAdapterPortStatEvents No No driver/FC support > - RegisterForAdapterPhyStatEvents No No driver/FC support > - RegisterForTargetEvents Yes > - RegisterForLinkEvents Yes > - RemoveCallback Yes > > * Interface is implemented, but not all attributes are supported. > > 4.2 Repository for SM-HBA Vendor Specific Library(VSL) > > The libsmhba.so loads the VSLs from the repository. > > - /etc/smhba.conf committed > > 4.3 CLI interfaces > > - sasinfo hba-port committed > - sasinfo remote-port committed > - sasinfo logical-unit committed > > The output of sasinfo is not an interface. > > 4.4 The SAS related event > > The following events are defined per SM-HBA standards and project > private. > > Event class: EC_HBA > Event subclass: ESC_sas_phy_event > > payload: port driver name, port SAS address, instance number, > devfs path, phy id, domain Port Address, event type(one of > events below) > > "phy_online" : > Operational use of a phy device supported by the HBA API has been > restored. > "phy_offline" : > Operational use of a phy device supported by the > HBA API has become impossible. > > "phy_remove" : > A phy device supported by the HBA API has been removed from the > fabric. > > Event class: EC_HBA > Event subclass: ESC_sas_hba_port_broadcast > > payload: driver name, port SAS address, instance #, devfs path, > event type(one of events below) > "port_broadcast_change" > An HBA on the local system supported by the SM-HBA API has > received a SAS Broadcast (CHANGE) primitive (see SAS-2). > "port_broadcast_ses" > An HBA on the local system supported by the > SM-HBA-2 API has received a SAS BROADCAST (SES) primitive > (see SAS-2). > "port_broadcast_d24_0" > An HBA on the local system supported by the > SM-HBA-2 API has received a SAS BROADCAST (RESERVED CHANGE > 0) primitive (see SAS-2). > "port_broadcast_d27_4" > An HBA on the local system supported by the SM-HBA API has > received a SAS BROADCAST (RESERVED CHANGE 1) > primitive (see SAS-2). > "port_broadcast_d01_4" > An HBA on the local system supported by the SM-HBA API has > received a SAS BROADCAST (RESERVED 1) primitive (see > SAS-2). > "port_broadcast_d04_7" > An HBA on the local system supported by the SM-HBA API has > received a SAS BROADCAST (RESERVED 2) primitive (see > SAS-2). > "port_broadcast_d16_7" > An HBA on the local system supported by the SM-HBA API has > received a SAS BROADCAST (RESERVED 3) primitive (see > SAS-2). > "port_broadcast_d29_7" > An HBA on the local system supported by the SM-HBA API has > received a SAS BROADCAST (RESERVED 4) primitive (see > SAS-2). > > 4.5 SCSI passthru icotl > > ioctl: SEND_SCSI_CMD > > struct sas_scsi_cmd { > uint64_t target_sas_addr; /* SAS address of target device */ > uint64_t domain_port_sas_addr; /* SAS address for SAS domain. */ > uint64_t scsi_lun; /* 8 byte SCSI LUN */ > uint32_t scsi_sas_status; /* SCSI status */ > uint32_t scsi_sas_rspcode; /* SAS response code */ > uchar_t scsi_pkt_state; /* state of the request */ > uchar_t scsi_pkt_action; /* corrective action */ > uint32_t scsi_pkt_reason; /* reason for the state */ > uint32_t scsi_flags; /* data flow direction */ > uint32_t scsi_timeout; /* command timeout length */ > unit64_t scsi_cdbaddr; /* SCSI CDB */ > uint32_t scsi_cdblen; /* length of the CDB */ > unint64_t scsi_bufaddr; /* data buffer for the request */ > uint32_t scsi_buflen; /* buffer length */ > int32_t scsi_bufresid; /* buffer residual */ > uint32_t scsi_status; /* buffer status */ > uint64_t scsi_rqbufaddr; /* sense data buffer */ > uint32_t scsi_rqlen; /* sense data length */ > int32_t scsi_rqresid; /* sense data residual */ > } sas_scsi_cmd_t; > > > 4.6 kstat related definition > > #define KSTAT_SAS_PHY_CLASS "SAS_phy_stat" /* class for > kstat_t(kstat.3KSTAT)*/ > > /* PHY - kstat structure definition */ > typedef struct sas_phy_stats { > kstat_named_t seconds_since_last_reset; > kstat_named_t tx_frames; > kstat_named_t tx_words; > kstat_named_t rx_frames; > kstat_named_t rx_words; > kstat_named_t invalid_dword_count; > kstat_named_t running_disparity_error_count; > kstat_named_t loss_of_dword_sync_count; > kstat_named_t phy_reset_problem_count; > } sas_phy_stats_t; > > 4.7 Devinfo node property > > SAS HBA devinfo node: > initiator-port uint8 array /* SAS address of SAS HBA */ > sm-hba-supported boolean /* indicate if a sm-hba is*/ > /* supported or not */ > supported-protocol int /* indicates SSP, STP, SMP*/ > /* or SATA support */ > FirmwareVersion char array /* firmware version */ > DriverVersion char array /* driver version */ > HardwareVersion char array /* hardware version */ > > NumberOfPhys int /* number of phys on HBA node */ > AttachedSASAddress uint8 array /* SAS address of the other */ > /* end of link */ > Phy related: > PhyIdentifier uint8 /* Phy id */ > PhyNegotiatedLinkRate int /* negotiated phy speed */ > PhyProgrammedMinLinkRate int /* programmed minimum phy speed */ > PhyHardwareMinLinkRate int /* hardware minimum speed */ > PhyProgrammedMaxLinkRate int /* programmed maximum phy speed */ > PhyHardwareMaxLinkRate int /* hardware maximum phy speed */ > PhyDomainPortWWN uint8 array /* SAS address for SAS > /* domain */ > > SAS Target device devinfo node: > SATA-target boolean /* indicate if SATA target or > /* not */ > AttachedSASAddress uint8 array /* SAS address of the other end > /* of link */ > target-port uint8 array /* SAS address of SAS target */ > sam-lun uint8 array /* 8 bytes SCSI LUN per SAM-4 */ > > 4.8 Imported interface > > The project uses > libc > libpthreads > libsysevent > libdevinfo > libkstat > > EC_DEV event from PSARC/2002/611 > EC_DR event from PSARC/2007/326 > > > 5. Doc Impact: > > Man pages for the common library and CLI will be provided. > > 6. Admin/Config Impact: > > A new admin CLI will be provided. No changes on existing product. > > 7. Packaging & Delivery: > > Two new packages will be delivered. > SUNWsmhba: contains userland libraries and CLI > SUNWsmhbar: contains a config file(in /etc) to store VSL list. > 8. Security Impact: > > The project will add the following line to /etc/security/exec_attr to > allow a privileged user or process to run the command. > File System > Management:solaris:cmd:::/usr/sbin/sasinfo:privs=sys_devices > > - Reference Documents: > > T11 Storage Management HBA API (SM-HBA) > http://www.t11.org/ftp/t11/pub/sm/hba/06-382v1.pdf) > > T10 Serial Attached SCSI - 2 (SAS-2) > http://www.t10.org/cgi-bin/ac.pl?t=f&f=sas2r15.pdf > > FC HBA-API cases > SHARC/2004/054 Enhanced support for T11 FC-HBA > PSARC/2002/644 FibreChannel HBA API V2 > PSARC/2001/481 Sun SNIA HBA API library > From gdamore@sun.com Thu Jan 22 13:59:00 2009 Received: from dm-sfbay-01.sfbay.sun.com (dm-sfbay-01.SFBay.Sun.COM [129.145.155.118]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n0MLwx04019179 for ; Thu, 22 Jan 2009 13:58:59 -0800 (PST) Received: from sca-es-mail-1.sun.com (sca-es-mail-1.Sun.COM [192.18.43.132]) by dm-sfbay-01.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id n0MLwxAX007187 for ; Thu, 22 Jan 2009 13:58:59 -0800 (PST) Received: from fe-sfbay-10.sun.com ([192.18.43.129]) by sca-es-mail-1.sun.com (8.13.7+Sun/8.12.9) with ESMTP id n0MLwsTe029130 for ; Thu, 22 Jan 2009 13:58:54 -0800 (PST) Received: from conversion-daemon.fe-sfbay-10.sun.com by fe-sfbay-10.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) id <0KDW004016LS5100@fe-sfbay-10.sun.com> (original mail from gdamore@sun.com) for psarc-ext@sac.sfbay.sun.com; Thu, 22 Jan 2009 13:58:54 -0800 (PST) Received: from [10.7.251.172] by fe-sfbay-10.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) with ESMTPSA id <0KDW00FQS7PY3360@fe-sfbay-10.sun.com> for psarc-ext@sac.sfbay.sun.com; Thu, 22 Jan 2009 13:58:46 -0800 (PST) Date: Thu, 22 Jan 2009 13:48:41 -0800 From: "Garrett D'Amore" Subject: Re: T11 Storage Management HBA API(SM-HBA) [PSARC/2008/687 FastTrack timeout 01/29/2009]] In-reply-to: <4978E88D.9050500@sun.com> Sender: Garrett.Damore@sun.com To: John Forte Cc: psarc-ext@sac.sfbay.sun.com, Hyon Kim Message-id: <4978E9B9.7050707@sun.com> MIME-version: 1.0 Content-type: text/plain; format=flowed; charset=ISO-8859-1 Content-transfer-encoding: 7BIT References: <4978E142.6020108@sun.com> <4978E88D.9050500@sun.com> User-Agent: Thunderbird 2.0.0.14 (X11/20080616) Status: RO Content-Length: 20516 Garrett D'Amore wrote: > Apparently there is a man page for sasinfo in the materials > directory. Might have been nice to note that in the text of the case > proper. > > The rest looks OK. > > Are we anticipating future projects to use this library, or 3rd party > consumption of the library? In case it wasn't clear, +1. :-) -- Garrett > > - Garrett > > John Forte wrote: >> I am sponsoring this fasttrack for Hyon Kim. Requested binding is Patch, >> timeout is 01/29/2009. >> >> - John >> >> >> This information is Copyright 2009 Sun Microsystems >> 1. Introduction >> 1.1. Project/Component Working Name: >> T11 Storage Management HBA API(SM-HBA) >> 1.2. Name of Document Author/Supplier: >> Author: Hyon Kim >> 1.3 Date of This Document: >> 22 January, 2009 >> 4. Technical Description >> >> >> - Problem Area: >> >> The currently released Serial Attached SCSI(SAS) HBAs are supported >> through HBA vendor specific utilities. As Sun is working on release >> of next generation SAS HBAs the administrator may have to deal with >> additional vendor specific utilities without common Solaris management >> support. >> >> This project is to deliver T11 Storage >> Management HBA API(SM-HBA) support and provide standard based SAS >> management utility for upcoming Sun's SAS-2 compliant (SAS Gen-2) >> HBAs. >> >> Note that a draft of SM-HBA-2 is published but it is not mature enough >> to guide product implementation according to T11. It is currently put >> on hold. >> >> The project team is requesting micro/patch binding. >> >> - Technical description >> >> 1. Deliverables: >> >> The SM-HBA support comprised of SM-HBA common library, a vendor >> specific library(VSL) for SAS Gen-2 HBAs and CLI which consumes >> SM-HBA interfaces and reports SAS HBAs and target configuration. >> >> libsmhba.so : SM-HBA common library >> Exports standard defined interfaces for use by utilities, >> SMI-S agents and any other 3rd party vendor application. >> libsun_sas.so : Vendor Specific Library(VSL) for SAS Gen-2 HBAs >> sasinfo.1M : SM-HBA based CLI for SAS HBA configuration discovery. >> >> +===============+ +---------------+ >> || sasinfo.1M || | other clients | >> +===============+ +---------------+ >> | | >> +==================================+ >> || libsmhba.so(SM-HBA standards) || >> +==================================+ >> | >> +==========================+ >> || libsun_sas.so(SAS VSL) || >> +==========================+ >> | | >> ______________|______|_____________________________________________ >> | | >> For SCSI passthru | +-----------------------------+ >> private ioctl | | libdevinfo(PSARC/2004/169) | >> | | libkstat(PSARC/1999/495) | >> | | libsysevent(PSARC/2001/076) | >> | +-----------------------------+ >> | | >> | | Generating devinfo nodes/properties, >> | | kstat counter and sysevent. >> | | >> +--------------------------------------+ >> | PSARC/2008/672 thebe SAS/SATA driver | >> | PSARC/2008/448 LSI MPT 2.0 support | >> | SAS Gen-2 HBA driver | >> +--------------------------------------+ >> >> 2. In Scope: >> >> The SM-HBA standard has been evolved from its predecessor FC-HBA to >> allow an application to manage both SAS and Fibre Channel HBAs through >> common interfaces. >> >> This project is to take advantage of those newly defined interfaces >> for SAS HBA management and will be providing VSL and CLI for Sun's SAS >> Gen-2 HBA support. >> >> Even though the SM-HBA standard includes the functionality of FC-HBA >> for FC HBA support, interface-wise it doesn't provide backward >> compatibility for FC-HBA clients. Thus the SM-HBA library will be >> handled as a major new release over the existing FC-HBA library. >> >> 3. Out of Scope: >> >> The FC HBA support through SM-HBA on existing FC HBAs not part >> of this project. They will be supported through existing >> libhbaapi.3LIB and fcinfo.1M. Since the functionality for FC support >> is same as FC-HBA there is no real benefit of migrating current FC-HBA >> support to SM-HBA. The current FC-HBA clients can continue to use >> FC-HBA library and if there is any client which needs to manage both >> FC and SAS through common interfaces in the future, the migration for >> the current FC-HBA support will be considered. >> >> 4. Interfaces: >> >> Interfaces Imported >> -------------+--------------------+------------------------- >> Interface | Classification | Comments >> -------------+--------------------+------------------------- >> | | >> Libraries listed | | >> section 4.8 | Committed | >> | | >> Events listed in | | >> section 4.8 | Consolidation | >> | private | >> >> >> >> Interfaces Exported >> -------------+--------------------+------------------------- >> Interface | Classification | Comments >> -------------+--------------------+------------------------- >> | | >> libsmhba interfaces | Committed | Implements SM-HBA standards >> | | Section 4.1 >> | | >> /etc/smhba.conf | Committed | To store library name and >> location >> | | at Vendor Library >> installation >> | | time. Section 4.2 >> | | >> sasinfo.1M command | Committed | Consumes libsmhba >> interfaces. >> | | section 4.3 >> | | >> sasinfo output | Not an interface | >> | | >> SAS related event | project private | Section 4.4 >> | | >> SEND_SCSI_CMD ioctl | project private | Section 4.5 >> | | >> kstat class name/ | project private | Section 4.6 >> phy stat structure | | >> | | >> SAS devinfo prop | project private | Section 4.7 >> | | >> >> 4.1 SM-HBA Interfaces >> >> The following list shows the interfaces that are defined in SM-HBA >> standards (Section 8.1). The common library(libsmhba.so) will implement >> all these interfaces and the Support column indicates whether Sun VSL >> for SAS HBA(libsun_sas.so) would support the particular interface or >> not. In general, all mandatory interfaces and attributes are supported >> and a subset of optional ones are also supported based on the need of >> Sun SAS management. >> >> All supported interfaces and attributes below are committed. >> >> API Support Note >> --- ------- ---- >> - GetVersion Yes Mandatory >> - LoadLibrary Yes Mandatory >> - FreeLibrary Yes Mandatory >> - RegisterLibrary Yes Mandatory >> - GetNumberofAdapters Yes Mandatory >> - RefreshInformation Yes Mandatory >> - RefreshAdapterConfiguration Yes Mandatory >> - GetWrapperLibraryAttributes Yes Mandatory >> - GetVendorLibraryAttributes Yes Mandatory >> - GetAdapterName Yes Mandatory >> - OpenAdapter Yes Mandatory >> - CloseAdapter Yes Mandatory >> - GetAdapterAttributes Yes Mandatory >> - SMHBA_ADAPTERATTRIBUTES Partial (*) >> - Manufacturer Yes Mandatory >> - SerialNumber Yes Mandatory >> - Model Yes Mandatory >> - ModelDescription No >> - HardwareVersion Yes >> - DriverVersion Yes >> - OptionROMVersion Yes >> - FirmwareVersion Yes >> - VendorSpecificID No >> - HBASymbolicName No >> - DriverName Yes >> - RedundantOptionROMVersion No >> - RedundantFirmwareVersion No >> - GetNumberofPorts Yes Mandatory >> - GetPortType Yes Mandatory >> - GetAdapterPortAttributes Yes Mandatory >> - SMHBA_PORTATTRIBUTES Yes >> - SMHBA_SAS_PORT Yes >> - GetDiscoveredPortAttributes Yes Mandatory >> - SMHBA_PORTATTRIBUTES Yes >> - All the attributes in SMHBA_PORTATTRIBUTES and SMHBA_SAS_PORT >> are supported except NumberofDiscoveredPorts and NumberofPhys >> which are not applicable for a discovered port. >> - GetPortAttributesByWWN Yes >> - GetPhyAttributtes Yes Mandatory >> - SMHBA_SAS_PHY attributes Yes >> - SMHBA_FC_PHY No Only for FC support >> - GetProtocolStatistics No No driver/firmware support >> - GetphyStatistics Yes Mandatory >> - SMHBA_SASPHYSTATISTICS Partial(*) >> - SecondsSinceLastReset Yes >> - TxFrames No No driver/firmware support >> - TxWords No No driver/firmware support >> - RxFrames No No driver/firmware support >> - RxWords No No driver/firmware support >> - InvalidDwordCount Yes Mandatory >> - RunningDisparityErrorCount Yes Mandatory >> - LossofDwordSyncCount Yes Mandatory >> - PhyResetProblemCount Yes Mandatory >> - GetPortAttributesbyWWN Yes >> - GetBindingCapability No No administrative binding support >> - GetBindingSupport No No administrative binding support >> - SetBindingSupport No No administrative binding support >> - GetTargetMapping Yes >> - GetPersistentBinding No No administrative binding support >> - SetPersistentBinding No No administrative binding support >> - RemovePersistentBindings No No administrative binding support >> - RemoveAllPersistentBindings No No administrative binding support >> - GetLUNStatistics No No driver/firmware support >> - SendScsiInquiry Yes >> - SendReportLuns Yes >> - SendReadCapacity Yes >> - SendSMPPassThru Yes >> - SendCTPassThruV2 No Only for FC support >> - SetRNIDMgmtInfo No Only for FC support >> - GetRNIDMgmtInfo No Only for FC support >> - SendRNIDV2 No Only for FC support >> - SendRPL No Only for FC support >> - SendRPS No Only for FC support >> - SendSRL No Only for FC support >> - SendLIRR No Only for FC support >> - SendRLS No Only for FC support >> - SendTEST No Only for FC support >> - SendECHO No Only for FC support >> - RegisterForAdapterAddEvents Yes >> - RegisterForAdapterEvents Yes >> - RegisterForAdapterPortEvents Yes >> - RegisterForAdapterPortStatEvents No No driver/FC support >> - RegisterForAdapterPhyStatEvents No No driver/FC support >> - RegisterForTargetEvents Yes >> - RegisterForLinkEvents Yes >> - RemoveCallback Yes >> >> * Interface is implemented, but not all attributes are supported. >> >> 4.2 Repository for SM-HBA Vendor Specific Library(VSL) >> >> The libsmhba.so loads the VSLs from the repository. >> >> - /etc/smhba.conf committed >> >> 4.3 CLI interfaces >> >> - sasinfo hba-port committed >> - sasinfo remote-port committed >> - sasinfo logical-unit committed >> >> The output of sasinfo is not an interface. >> >> 4.4 The SAS related event >> >> The following events are defined per SM-HBA standards and project >> private. >> >> Event class: EC_HBA >> Event subclass: ESC_sas_phy_event >> >> payload: port driver name, port SAS address, instance number, >> devfs path, phy id, domain Port Address, event type(one of >> events below) >> >> "phy_online" : >> Operational use of a phy device supported by the HBA API has been >> restored. >> "phy_offline" : >> Operational use of a phy device supported by the >> HBA API has become impossible. >> >> "phy_remove" : >> A phy device supported by the HBA API has been removed from the >> fabric. >> >> Event class: EC_HBA >> Event subclass: ESC_sas_hba_port_broadcast >> >> payload: driver name, port SAS address, instance #, devfs path, >> event type(one of events below) >> "port_broadcast_change" >> An HBA on the local system supported by the SM-HBA API has >> received a SAS Broadcast (CHANGE) primitive (see SAS-2). >> "port_broadcast_ses" >> An HBA on the local system supported by the >> SM-HBA-2 API has received a SAS BROADCAST (SES) primitive >> (see SAS-2). >> "port_broadcast_d24_0" >> An HBA on the local system supported by the >> SM-HBA-2 API has received a SAS BROADCAST (RESERVED CHANGE >> 0) primitive (see SAS-2). >> "port_broadcast_d27_4" >> An HBA on the local system supported by the SM-HBA API has >> received a SAS BROADCAST (RESERVED CHANGE 1) >> primitive (see SAS-2). >> "port_broadcast_d01_4" >> An HBA on the local system supported by the SM-HBA API has >> received a SAS BROADCAST (RESERVED 1) primitive (see >> SAS-2). >> "port_broadcast_d04_7" >> An HBA on the local system supported by the SM-HBA API has >> received a SAS BROADCAST (RESERVED 2) primitive (see >> SAS-2). >> "port_broadcast_d16_7" >> An HBA on the local system supported by the SM-HBA API has >> received a SAS BROADCAST (RESERVED 3) primitive (see >> SAS-2). >> "port_broadcast_d29_7" >> An HBA on the local system supported by the SM-HBA API has >> received a SAS BROADCAST (RESERVED 4) primitive (see >> SAS-2). >> >> 4.5 SCSI passthru icotl >> >> ioctl: SEND_SCSI_CMD >> >> struct sas_scsi_cmd { >> uint64_t target_sas_addr; /* SAS address of target device */ >> uint64_t domain_port_sas_addr; /* SAS address for SAS domain. */ >> uint64_t scsi_lun; /* 8 byte SCSI LUN */ >> uint32_t scsi_sas_status; /* SCSI status */ >> uint32_t scsi_sas_rspcode; /* SAS response code */ >> uchar_t scsi_pkt_state; /* state of the request */ >> uchar_t scsi_pkt_action; /* corrective action */ >> uint32_t scsi_pkt_reason; /* reason for the state */ >> uint32_t scsi_flags; /* data flow direction */ >> uint32_t scsi_timeout; /* command timeout length */ >> unit64_t scsi_cdbaddr; /* SCSI CDB */ >> uint32_t scsi_cdblen; /* length of the CDB */ >> unint64_t scsi_bufaddr; /* data buffer for the request */ >> uint32_t scsi_buflen; /* buffer length */ >> int32_t scsi_bufresid; /* buffer residual */ >> uint32_t scsi_status; /* buffer status */ >> uint64_t scsi_rqbufaddr; /* sense data buffer */ >> uint32_t scsi_rqlen; /* sense data length */ >> int32_t scsi_rqresid; /* sense data residual */ >> } sas_scsi_cmd_t; >> >> >> 4.6 kstat related definition >> >> #define KSTAT_SAS_PHY_CLASS "SAS_phy_stat" /* class for >> kstat_t(kstat.3KSTAT)*/ >> >> /* PHY - kstat structure definition */ >> typedef struct sas_phy_stats { >> kstat_named_t seconds_since_last_reset; >> kstat_named_t tx_frames; >> kstat_named_t tx_words; >> kstat_named_t rx_frames; >> kstat_named_t rx_words; >> kstat_named_t invalid_dword_count; >> kstat_named_t running_disparity_error_count; >> kstat_named_t loss_of_dword_sync_count; >> kstat_named_t phy_reset_problem_count; >> } sas_phy_stats_t; >> >> 4.7 Devinfo node property >> >> SAS HBA devinfo node: >> initiator-port uint8 array /* SAS address of SAS HBA */ >> sm-hba-supported boolean /* indicate if a sm-hba is*/ >> /* supported or not */ >> supported-protocol int /* indicates SSP, STP, SMP*/ >> /* or SATA support */ >> FirmwareVersion char array /* firmware version */ >> DriverVersion char array /* driver version */ >> HardwareVersion char array /* hardware version */ >> >> NumberOfPhys int /* number of phys on HBA node */ >> AttachedSASAddress uint8 array /* SAS address of the other */ >> /* end of link */ >> Phy related: >> PhyIdentifier uint8 /* Phy id */ >> PhyNegotiatedLinkRate int /* negotiated phy speed */ >> PhyProgrammedMinLinkRate int /* programmed minimum phy speed */ >> PhyHardwareMinLinkRate int /* hardware minimum speed */ >> PhyProgrammedMaxLinkRate int /* programmed maximum phy speed */ >> PhyHardwareMaxLinkRate int /* hardware maximum phy speed */ >> PhyDomainPortWWN uint8 array /* SAS address for SAS >> /* domain */ >> >> SAS Target device devinfo node: >> SATA-target boolean /* indicate if SATA target or >> /* not */ >> AttachedSASAddress uint8 array /* SAS address of the other end >> /* of link */ >> target-port uint8 array /* SAS address of SAS target */ >> sam-lun uint8 array /* 8 bytes SCSI LUN per SAM-4 */ >> >> 4.8 Imported interface >> >> The project uses >> libc >> libpthreads >> libsysevent >> libdevinfo >> libkstat >> >> EC_DEV event from PSARC/2002/611 >> EC_DR event from PSARC/2007/326 >> >> >> 5. Doc Impact: >> >> Man pages for the common library and CLI will be provided. >> >> 6. Admin/Config Impact: >> >> A new admin CLI will be provided. No changes on existing product. >> >> 7. Packaging & Delivery: >> >> Two new packages will be delivered. >> SUNWsmhba: contains userland libraries and CLI >> SUNWsmhbar: contains a config file(in /etc) to store VSL list. >> 8. Security Impact: >> >> The project will add the following line to /etc/security/exec_attr to >> allow a privileged user or process to run the command. >> File System >> Management:solaris:cmd:::/usr/sbin/sasinfo:privs=sys_devices >> >> - Reference Documents: >> >> T11 Storage Management HBA API (SM-HBA) >> http://www.t11.org/ftp/t11/pub/sm/hba/06-382v1.pdf) >> >> T10 Serial Attached SCSI - 2 (SAS-2) >> http://www.t10.org/cgi-bin/ac.pl?t=f&f=sas2r15.pdf >> >> FC HBA-API cases >> SHARC/2004/054 Enhanced support for T11 FC-HBA >> PSARC/2002/644 FibreChannel HBA API V2 >> PSARC/2001/481 Sun SNIA HBA API library >> > From John.Forte@Sun.COM Thu Jan 22 14:45:12 2009 Received: from dm-sfbay-01.sfbay.sun.com (dm-sfbay-01.SFBay.Sun.COM [129.145.155.118]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n0MMjCXQ020039 for ; Thu, 22 Jan 2009 14:45:12 -0800 (PST) Received: from brmea-mail-1.sun.com (brmea-mail-1.Sun.COM [192.18.98.31]) by dm-sfbay-01.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id n0MMjBKE038707 for ; Thu, 22 Jan 2009 14:45:11 -0800 (PST) Received: from fe-amer-10.sun.com ([192.18.109.80]) by brmea-mail-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id n0MMjBVW002986 for ; Thu, 22 Jan 2009 22:45:11 GMT Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) id <0KDW004019KEB700@mail-amer.sun.com> (original mail from John.Forte@Sun.COM) for psarc-ext@sac.sfbay.sun.com; Thu, 22 Jan 2009 15:45:11 -0700 (MST) Received: from [129.146.56.52] by mail-amer.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) with ESMTPSA id <0KDW00DF29U8JA00@mail-amer.sun.com> for psarc-ext@sac.sfbay.sun.com; Thu, 22 Jan 2009 15:44:32 -0700 (MST) Date: Thu, 22 Jan 2009 14:40:47 -0800 From: John Forte Subject: Re: T11 Storage Management HBA API(SM-HBA) [PSARC/2008/687 FastTrack timeout 01/29/2009]] In-reply-to: <4978E88D.9050500@sun.com> Sender: John.Forte@Sun.COM To: "Garrett D'Amore" Cc: psarc-ext@sac.sfbay.sun.com, Hyon Kim Message-id: <4978F5EF.20907@sun.com> MIME-version: 1.0 Content-type: text/plain; format=flowed; charset=ISO-8859-1 Content-transfer-encoding: 7BIT References: <4978E142.6020108@sun.com> <4978E88D.9050500@sun.com> User-Agent: Thunderbird 2.0.0.17 (X11/20081014) Status: RO Content-Length: 728 Garrett D'Amore wrote: > Apparently there is a man page for sasinfo in the materials > directory. Might have been nice to note that in the text of the case > proper. Agreed. That's my fault, sorry. > > The rest looks OK. > > Are we anticipating future projects to use this library, or 3rd party > consumption of the library? > FC-HBA (libhbaapi(3LIB)) has a few consumers in the OpenSolaris source today, such as cfgadm, fcinfo and luxadm, and also has a number of 3rd party consumers of which we're aware so we would expect the same for this library down the road. One likely future candidate I can think of would be the host SMI-S providers for Fibre Channel and SAS when that eventually gets off the ground. - John From John.Forte@sun.com Wed Jan 28 12:51:35 2009 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 n0SKpZww001347 for ; Wed, 28 Jan 2009 12:51:35 -0800 (PST) Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74]) by sunmail2sca.sfbay.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id n0SKpWCq027981 for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Wed, 28 Jan 2009 12:51:35 -0800 (PST) Received: from pmxchannel-daemon.nwk-avmta-1.sfbay.Sun.COM by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0KE700B1L8LZX200@nwk-avmta-1.sfbay.Sun.COM> for PSARC-ext@sun.com (ORCPT PSARC-ext@Sun.Com); Wed, 28 Jan 2009 12:51:35 -0800 (PST) Received: from brmea-mail-1.sun.com ([192.18.98.31]) by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0KE70088K8LY6F80@nwk-avmta-1.sfbay.Sun.COM> for PSARC-ext@sun.com (ORCPT PSARC-ext@Sun.Com); Wed, 28 Jan 2009 12:51:34 -0800 (PST) Received: from fe-amer-09.sun.com ([192.18.109.79]) by brmea-mail-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id n0SKpYrk009431 for ; Wed, 28 Jan 2009 20:51:34 +0000 (GMT) Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) id <0KE700H017YZCT00@mail-amer.sun.com> (original mail from John.Forte@Sun.COM) for PSARC-ext@Sun.Com (ORCPT PSARC-ext@Sun.Com); Wed, 28 Jan 2009 13:51:34 -0700 (MST) Received: from [129.146.56.52] by mail-amer.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) with ESMTPSA id <0KE700MVN8LSTB70@mail-amer.sun.com> for PSARC-ext@Sun.Com (ORCPT PSARC-ext@Sun.Com); Wed, 28 Jan 2009 13:51:28 -0700 (MST) Date: Wed, 28 Jan 2009 12:47:39 -0800 From: John Forte Subject: PSARC/2008/687 T11 Storage Management HBA API(SM-HBA) Sender: John.Forte@sun.com To: Hyon Kim Cc: PSARC-ext@sun.com Message-id: <4980C46B.5050400@sun.com> MIME-version: 1.0 Content-type: text/plain; format=flowed; charset=ISO-8859-1 Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 User-Agent: Thunderbird 2.0.0.17 (X11/20081014) Status: RO Content-Length: 52 This fasttrack was approved in PSARC today. - John From John.Forte@Sun.COM Tue May 5 16:23:08 2009 Received: from dm-sfbay-02.sfbay.sun.com (dm-sfbay-02.SFBay.Sun.COM [129.146.11.31]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n45NN7xf012299 for ; Tue, 5 May 2009 16:23:07 -0700 (PDT) Received: from brmea-mail-1.sun.com (brmea-mail-1.Sun.COM [192.18.98.31]) by dm-sfbay-02.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id n45NN7sK054523 for ; Tue, 5 May 2009 16:23:07 -0700 (PDT) Received: from fe-amer-10.sun.com ([192.18.109.80]) by brmea-mail-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id n45NN6ac007567 for ; Tue, 5 May 2009 23:23:06 GMT MIME-version: 1.0 Content-transfer-encoding: 7BIT Content-type: text/plain; format=flowed; charset=ISO-8859-1 Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com (Sun Java(tm) System Messaging Server 7.0-5.01 64bit (built Feb 19 2009)) id <0KJ7008001THOP00@mail-amer.sun.com> for psarc-ext@sac.sfbay.sun.com; Tue, 05 May 2009 17:23:06 -0600 (MDT) Received: from [129.146.56.52] ([unknown] [129.146.56.52]) by mail-amer.sun.com (Sun Java(tm) System Messaging Server 7.0-5.01 64bit (built Feb 19 2009)) with ESMTPSA id <0KJ700KQ72AICS60@mail-amer.sun.com> for psarc-ext@sac.sfbay.sun.com; Tue, 05 May 2009 17:23:06 -0600 (MDT) Date: Tue, 05 May 2009 16:17:34 -0700 From: John Forte Subject: Re: T11 Storage Management HBA API(SM-HBA) [PSARC/2008/687 FastTrack timeout 01/29/2009]] In-reply-to: <4978E142.6020108@sun.com> Sender: John.Forte@Sun.COM To: psarc-ext@sac.sfbay.sun.com Cc: Hyon Kim Message-id: <4A00C90E.5000605@sun.com> References: <4978E142.6020108@sun.com> User-Agent: Thunderbird 2.0.0.17 (X11/20081014) Status: RO Content-Length: 938 The project team would like to make an amendment to this fasttrack as specified below. I believe this qualifies for self-review and does not need a separate fasttrack. The project has not yet integrated. An updated fasttrack has been placed in the materials directory. Let me know if there are any technical objections. - John =========================================================== Remove support for SM-HBA Event Related APIs The fasttrack PSARC/2008/687 was submitted for T11 Storage Management HBA API(SM-HBA) support on Solaris. Support for the following optional interfaces will not be provided at this time and will be added and ARC'ed at a later date: - RegisterForAdapterAddEvents - RegisterForAdapterEvents - RegisterForAdapterPortEvents - RegisterForTargetEvents - RegisterForLinkEvents - RemoveCallback No other areas are affected by this change. =========================================================== From John.Forte@sun.com Thu May 28 11:03:14 2009 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 n4SI3EHJ007384 for ; Thu, 28 May 2009 11:03:14 -0700 (PDT) Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6]) by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id n4SI3A8q027335 for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Thu, 28 May 2009 12:03:14 -0600 (MDT) 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 <0KKD00I118TC9400@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@Sun.Com); Thu, 28 May 2009 11:03:12 -0700 (PDT) Received: from brmea-mail-2.sun.com ([192.18.98.43]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0KKD00HF28TB6O10@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@Sun.Com); Thu, 28 May 2009 11:03:11 -0700 (PDT) Received: from fe-amer-10.sun.com ([192.18.109.80]) by brmea-mail-2.sun.com (8.13.6+Sun/8.12.9) with ESMTP id n4SI3BLg027952 for ; Thu, 28 May 2009 18:03:11 +0000 (GMT) Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com (Sun Java(tm) System Messaging Server 7u2-7.02 64bit (built Apr 16 2009)) id <0KKD005008RC3J00@mail-amer.sun.com> for PSARC-ext@Sun.Com (ORCPT PSARC-ext@Sun.Com); Thu, 28 May 2009 12:03:11 -0600 (MDT) Received: from [129.146.56.52] ([unknown] [129.146.56.52]) by mail-amer.sun.com (Sun Java(tm) System Messaging Server 7u2-7.02 64bit (built Apr 16 2009)) with ESMTPSA id <0KKD00J658T7LH30@mail-amer.sun.com> for PSARC-ext@Sun.Com (ORCPT PSARC-ext@Sun.Com); Thu, 28 May 2009 12:03:08 -0600 (MDT) Date: Thu, 28 May 2009 11:02:11 -0700 From: John Forte Subject: Re: T11 Storage Management HBA API(SM-HBA) [PSARC/2008/687 FastTrack timeout 06/04/2009] Sender: John.Forte@sun.com To: PSARC-ext@sun.com Cc: Hyon Kim Message-id: <4A1ED1A3.7040709@sun.com> MIME-version: 1.0 Content-type: text/plain; CHARSET=US-ASCII; format=flowed Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 User-Agent: Thunderbird 2.0.0.17 (X11/20081014) Status: RO Content-Length: 4656 The project team would like to make an amendment to this fasttrack as specified below. The project has not yet delivered. I'm reopening the fasttrack and setting the timeout for 06/04/2009. I've placed the updated materials in the case directory. - John ------------------------------------------------------------------------------- sasinfo enhancements for HBA and expander representation The sasinfo utility is provided as part of SAS HBA management project(PSARC/2008/687). Originally it provided subcommands for Host Bus Adapter(HBA) ports, remote ports, logical units. As the project copes with the associated SAS device management framework, the need for more granular discovery is identified to help an admin discover SAS topology through the utility. The enhancements are to add - HBA discovery to properly report dynamic HBA port creation/removal of SAS HBA. - explicit expander layer discovery to better handle SAS configuration with multiple layers of expanders - target port centric topology view. Note that the remote-port subcommand which used to cover both expander devices and target ports is removed and the logical-unit subcommand remains the same. - Subcommand Details Note that the comment section indicate if a subcommand or an option is new. ---------------------+-----------------+------------------------- subcommands/options | Classification | Comments ---------------------+-----------------+------------------------- | | sasinfo hba | Committed | reports HBA list. subcommand | | | | -v, --verbose | Committed | reports HBA list with | | details. | | (new subcommand) | | sasinfo hba-port | Committed | reports HBA port list. subcommand | | | | -v, --verbose | Committed | reports HBA list with | | details. | | -a, --hba | Committed | filters HBA ports per the | | given | | HBA name. (new option) | | sasinfo expander | Committed | reports expanders subcommand | | discovered on | | an HBA port.(new | | subcommand) | | -v, --verbose | Committed | reports expanders | | discovered on | | an HBA port with details. | | -p, --hba-port | Committed | filters expanders per the | | given HBA port name. | | -t, --target-port| Committed | reports discovered target | | ports on an expander. | | sasinfo target-port | Committed | reports target port list subcommand | | discovered on a host. | | (new subcommand) | | -v, --verbose | Committed | reports target port list | | discovered on a host with | | details | | -s, --scsi | Committed | reports target-port list | | discovered on a host with | | SCSI information. | | sasinfo logical-unit| Committed | reports logical unit list. subcommand | | | | -v, --verbose | Committed | reports logical unit list | | discovered on a host with | | details | | sasinfo output |Not an interface | From Mark.Carlson@sun.com Thu Jun 4 15:00:45 2009 Received: from sunmail5.uk.sun.com (sunmail5.UK.Sun.COM [129.156.85.165]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n54M0il6005776 for ; Thu, 4 Jun 2009 15:00:44 -0700 (PDT) Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6]) by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id n54M0U3h023315 for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Thu, 4 Jun 2009 23:00:43 +0100 (BST) 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 <0KKQ00H15IH5XG00@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu, 04 Jun 2009 15:00:41 -0700 (PDT) Received: from brmea-mail-4.sun.com ([192.18.98.36]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0KKQ00ASJIH49M80@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu, 04 Jun 2009 15:00:40 -0700 (PDT) Received: from fe-amer-10.sun.com ([192.18.109.80]) by brmea-mail-4.sun.com (8.13.6+Sun/8.12.9) with ESMTP id n54M0eP9010911 for ; Thu, 04 Jun 2009 22:00:40 +0000 (GMT) Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com (Sun Java(tm) System Messaging Server 7u2-7.02 64bit (built Apr 16 2009)) id <0KKQ00M00IBRJY00@mail-amer.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu, 04 Jun 2009 16:00:40 -0600 (MDT) Received: from dhcp-199-4.ucsc.edu ([unknown] [128.114.199.4]) by mail-amer.sun.com (Sun Java(tm) System Messaging Server 7u2-7.02 64bit (built Apr 16 2009)) with ESMTPSA id <0KKQ00785IGMMCA0@mail-amer.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu, 04 Jun 2009 16:00:23 -0600 (MDT) Date: Thu, 04 Jun 2009 16:00:22 -0600 From: "Mark A. Carlson" Subject: Re: T11 Storage Management HBA API(SM-HBA) [PSARC/2008/687 FastTrack timeout 06/04/2009] In-reply-to: <4A1ED1A3.7040709@sun.com> Sender: Mark.Carlson@sun.com To: John Forte Cc: PSARC-ext@sun.com, Hyon Kim Message-id: <4A2843F6.9080902@sun.com> MIME-version: 1.0 Content-type: multipart/alternative; boundary="Boundary_(ID_5YfjA0GgWbE4gEg1J12Kig)" X-PMX-Version: 5.4.1.325704 References: <4A1ED1A3.7040709@sun.com> User-Agent: Thunderbird 2.0.0.21 (Macintosh/20090302) Status: RO Content-Length: 20830 This is a multi-part message in MIME format. --Boundary_(ID_5YfjA0GgWbE4gEg1J12Kig) Content-type: text/plain; CHARSET=US-ASCII; format=flowed Content-transfer-encoding: 7BIT +1 -- mark John Forte wrote: > The project team would like to make an amendment to this fasttrack as > specified below. The project has not yet delivered. I'm reopening the > fasttrack and setting the timeout for 06/04/2009. I've placed the > updated materials in the case directory. > > - John > > > ------------------------------------------------------------------------------- > > > sasinfo enhancements for HBA and expander representation > > The sasinfo utility is provided as part of SAS HBA management > project(PSARC/2008/687). Originally it provided subcommands for Host > Bus Adapter(HBA) ports, remote ports, logical units. As the project > copes with the associated SAS device management framework, the need > for more granular discovery is identified to help an admin discover > SAS topology through the utility. > > The enhancements are to add > > - HBA discovery to properly report dynamic HBA port creation/removal > of SAS HBA. > - explicit expander layer discovery to better handle SAS > configuration with multiple layers of expanders > - target port centric topology view. > > Note that the remote-port subcommand which used to cover both expander > devices and target ports is removed and the logical-unit subcommand > remains the same. > > - Subcommand Details > > Note that the comment section indicate if a subcommand or an option > is new. > > ---------------------+-----------------+------------------------- > subcommands/options | Classification | Comments > ---------------------+-----------------+------------------------- > | | > sasinfo hba | Committed | reports HBA list. > subcommand | | > | | > -v, --verbose | Committed | reports HBA list with > | | details. > | | (new subcommand) > | | > sasinfo hba-port | Committed | reports HBA port list. > subcommand | | > | | > -v, --verbose | Committed | reports HBA list with > | | details. > | | > -a, --hba | Committed | filters HBA ports per the > | | given > | | HBA name. (new option) > | | > sasinfo expander | Committed | reports expanders > subcommand | | discovered on > | | an HBA port.(new > | | subcommand) > | | > -v, --verbose | Committed | reports expanders > | | discovered on > | | an HBA port with details. > | | > -p, --hba-port | Committed | filters expanders per the > | | given HBA port name. > | | > -t, --target-port| Committed | reports discovered target > | | ports on an expander. > | | > sasinfo target-port | Committed | reports target port list > subcommand | | discovered on a host. > | | (new subcommand) > | | > -v, --verbose | Committed | reports target port list > | | discovered on a host with > | | details > | | > -s, --scsi | Committed | reports target-port list > | | discovered on a host with > | | SCSI information. > | | > sasinfo logical-unit| Committed | reports logical unit list. > subcommand | | > | | > -v, --verbose | Committed | reports logical unit list > | | discovered on a host with > | | details > | | > sasinfo output |Not an interface | > > > > _______________________________________________ > opensolaris-arc mailing list > opensolaris-arc@opensolaris.org -- * Mark A. Carlson * Sr. Architect *Systems Group* Phone x69559 / 303-223-6139 Email Mark.Carlson@Sun.COM --Boundary_(ID_5YfjA0GgWbE4gEg1J12Kig) Content-type: text/html; CHARSET=US-ASCII Content-transfer-encoding: 7BIT +1

-- mark

John Forte wrote:
The project team would like to make an amendment to this fasttrack as
specified below. The project has not yet delivered. I'm reopening the
fasttrack and setting the timeout for 06/04/2009. I've placed the
updated materials in the case directory.

- John


-------------------------------------------------------------------------------

      sasinfo enhancements for HBA and expander representation

  The sasinfo utility is provided as part of SAS HBA management
  project(PSARC/2008/687).  Originally it provided subcommands for Host
  Bus Adapter(HBA) ports, remote ports, logical units.  As the project
  copes with the associated SAS device management framework, the need
  for more granular discovery is identified to help an admin discover
  SAS topology through the utility.

  The enhancements are to add

    - HBA discovery to properly report dynamic HBA port creation/removal
      of SAS HBA.
    - explicit expander layer discovery to better handle SAS
      configuration with multiple layers of expanders
    - target port centric topology view.

  Note that the remote-port subcommand which used to cover both expander
  devices and target ports is removed and the logical-unit subcommand
  remains the same.

- Subcommand Details

    Note that the comment section indicate if a subcommand or an option
    is new.

    ---------------------+-----------------+-------------------------
     subcommands/options | Classification  | Comments
    ---------------------+-----------------+-------------------------
                         |                 |
      sasinfo hba        | Committed       | reports HBA list.
      subcommand         |                 |
                         |                 |
         -v, --verbose   | Committed       | reports HBA list with
                         |                 | details.
                         |                 | (new subcommand)
                         |                 |
      sasinfo hba-port   | Committed       | reports HBA port list.
      subcommand         |                 |
                         |                 |
         -v, --verbose   | Committed       | reports HBA list with
                         |                 | details.
                         |                 |
         -a, --hba       | Committed       | filters HBA ports per the
                         |                 | given
                         |                 | HBA name. (new option)
                         |                 |
      sasinfo expander   | Committed       | reports expanders
      subcommand         |                 | discovered on
                         |                 | an HBA port.(new
                         |                 | subcommand)
                         |                 |
         -v, --verbose   | Committed       | reports expanders
                         |                 | discovered on
                         |                 | an HBA port with details.
                         |                 |
         -p, --hba-port  | Committed       | filters expanders per the
                         |                 | given HBA port name.
                         |                 |
        -t, --target-port| Committed       | reports discovered target
                         |                 | ports on an expander.
                         |                 |
    sasinfo target-port  | Committed       | reports target port list
       subcommand        |                 | discovered on a host.
                         |                 | (new subcommand)
                         |                 |
         -v, --verbose   | Committed       | reports target port list
                         |                 | discovered on a host with
                         |                 | details
                         |                 |
         -s, --scsi      | Committed       | reports target-port list
                         |                 | discovered on a host with
                         |                 | SCSI information.
                         |                 |
     sasinfo logical-unit| Committed       | reports logical unit list.
        subcommand       |                 |
                         |                 |
         -v, --verbose   | Committed       | reports logical unit list
                         |                 | discovered on a host with
                         |                 | details
                         |                 |
     sasinfo output      |Not an interface |



_______________________________________________
opensolaris-arc mailing list
opensolaris-arc@opensolaris.org

--
Mark A. Carlson
Sr. Architect

Systems Group
Phone x69559 / 303-223-6139
Email Mark.Carlson@Sun.COM

--Boundary_(ID_5YfjA0GgWbE4gEg1J12Kig)-- From John.Forte@sun.com Fri Jun 5 08:49:21 2009 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 n55FnL87011062 for ; Fri, 5 Jun 2009 08:49:21 -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 n55FnLUp021765 for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Fri, 5 Jun 2009 08:49:21 -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 <0KKR00H01VY9H300@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Fri, 05 Jun 2009 08:49:21 -0700 (PDT) Received: from brmea-mail-2.sun.com ([192.18.98.43]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0KKR00EG6VY73K40@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Fri, 05 Jun 2009 08:49:20 -0700 (PDT) Received: from fe-amer-10.sun.com ([192.18.109.80]) by brmea-mail-2.sun.com (8.13.6+Sun/8.12.9) with ESMTP id n55FnJHv028622 for ; Fri, 05 Jun 2009 15:49:19 +0000 (GMT) Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com (Sun Java(tm) System Messaging Server 7u2-7.02 64bit (built Apr 16 2009)) id <0KKR00600VMFNO00@mail-amer.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Fri, 05 Jun 2009 09:49:19 -0600 (MDT) Received: from [129.146.56.52] ([unknown] [129.146.56.52]) by mail-amer.sun.com (Sun Java(tm) System Messaging Server 7u2-7.02 64bit (built Apr 16 2009)) with ESMTPSA id <0KKR00EX9VY3M8C0@mail-amer.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Fri, 05 Jun 2009 09:49:15 -0600 (MDT) Date: Fri, 05 Jun 2009 08:48:10 -0700 From: John Forte Subject: Re: T11 Storage Management HBA API(SM-HBA) [PSARC/2008/687 FastTrack timeout 06/04/2009] In-reply-to: <4A1ED1A3.7040709@sun.com> Sender: John.Forte@sun.com To: PSARC-ext@sun.com Cc: Hyon Kim Message-id: <4A293E3A.3060406@sun.com> MIME-version: 1.0 Content-type: text/plain; CHARSET=US-ASCII; format=flowed Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 References: <4A1ED1A3.7040709@sun.com> User-Agent: Thunderbird 2.0.0.17 (X11/20081014) Status: RO Content-Length: 94 This case has timed out with a +1 and no issues and has been marked closed approved. - John