From jforte@sac.sfbay.sun.com Wed Nov 18 09:33:25 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 nAIHXPG8015247 for ; Wed, 18 Nov 2009 09:33:25 -0800 (PST) Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74]) by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id nAIHWobD015335; Wed, 18 Nov 2009 17:33:24 GMT 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 <0KTB00725FFNDU00@nwk-avmta-1.sfbay.Sun.COM>; Wed, 18 Nov 2009 09:33:23 -0800 (PST) Received: from dm-sfbay-01.sfbay.sun.com ([129.145.155.118]) by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0KTB0085EFFLJJA0@nwk-avmta-1.sfbay.Sun.COM>; Wed, 18 Nov 2009 09:33:21 -0800 (PST) Received: from sac.sfbay.sun.com (sac.SFBay.Sun.COM [129.146.226.132]) by dm-sfbay-01.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id nAIHXL9l028484; Wed, 18 Nov 2009 09:33:21 -0800 (PST) Received: from sac.sfbay.sun.com (localhost [127.0.0.1]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id nAIHXJbV015242; Wed, 18 Nov 2009 09:33:19 -0800 (PST) Received: (from jforte@localhost) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8/Submit) id nAIHXIXg015238; Wed, 18 Nov 2009 09:33:18 -0800 (PST) Date: Wed, 18 Nov 2009 09:33:18 -0800 (PST) From: John Forte Subject: COMSTAR SRPT Port Provider Management [PSARC/2009/634 FastTrack timeout 11/25/2009] To: PSARC-ext@sun.com Cc: susan.gleeson@sun.com Message-id: <200911181733.nAIHXIXg015238@sac.sfbay.sun.com> Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 Status: RO Content-Length: 10547 I am sponsoring this fasttrack for Sue Gleeson. Requested binding is minor. Timeout is set for 11/25/2009. - John Template Version: @(#)sac_nextcase 1.68 02/23/09 SMI This information is Copyright 2009 Sun Microsystems 1. Introduction 1.1. Project/Component Working Name: COMSTAR SRPT Port Provider Management 1.2. Name of Document Author/Supplier: Author: Susan Gleeson 1.3 Date of This Document: 18 November, 2009 4. Technical Description The COMSTAR Infiniband SRP Target project (PSARC/2009/111 [1]) introduced the SRP protocol port provider to Solaris. When the SRP port provider SMF service is enabled, COMSTAR targets are created for every Infiniband HCA discovered on the system. It has become clear that a finer level of control is required, and this set of interfaces will allow for changing the default behavior when the service is activated as well as enabling and disabling SRP services on a per-HCA basis. This case introduces a new library, libsrpt and a new CLI, srptadm as described below. 4.1 Interfaces Minor binding. -------------+-----------------------+------------------------- Interface Classification Comments -------------+-----------------------+------------------------- libsrpt | Committed | srptadm | Committed 4.2 srpt_SetDefaultState/srpt_GetDefaultState NAME srpt_SetDefaultState, srpt_GetDefaultState - set and retrieve the default state setting for the SRP Target service. SYNOPSIS cc [ flag... ] file... -lsrpt [ library... ] #include int srpt_SetDefaultState(boolean_t enabled); int srpt_GetDefaultState(boolean_t *enabled); PARAMETERS enabled boolean value indicating whether COMSTAR SRP targets should be created. DESCRIPTION The srpt_SetDefaultState() function sets the default behavior of the SRP Target service. If enabled is B_TRUE, SRP targets will be created for all discovered HCAs that have not been specifically disabled. If enabled is B_FALSE, targets will not be created unless the HCA has been specifically enabled. See also srpt_SetTargetState() for enabling or disabling specific HCAs. If the default state is changed when the SRP service is online, the state of existing targets is not changed until the service is restarted. The srpt_GetDefaultState() function returns the current value for enabled. RETURN VALUES ENOMEM Could not allocate resources EINVAL Invalid parameter ATTRIBUTES See attributes(5) for descriptions of the following attri- butes: ____________________________________________________________ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | |_____________________________|_____________________________| | Interface Stability | Committed | |_____________________________|_____________________________| | MT-Level | MT-Safe | |_____________________________|_____________________________| SEE ALSO srpt_SetTargetState(3SRPT), libsrpt(3LIB) 4.3 srpt_SetTargetState/srpt_GetTargetState NAME srpt_SetTargetState, srpt_GetTargetState, srpt_ResetTarget - set and retrieve SRP Target state for a specific HCA. SYNOPSIS cc [ flag... ] file... -lsrpt [ library... ] #include int srpt_SetTargetState(char *hca_guid, boolean_t enabled); int srpt_GetTargetState(char *hca_guid, boolean_t *enabled); int srpt_ResetTarget(char *hca_guid); PARAMETERS hc_guid HCA GUID. Must be in one of the following forms: 3BA000100CD18 - base hex form 0003BA000100CD18 - base hex form with leading zeroes hca:3BA000100CD18 - form from cfgadm eui.0003BA000100CD18 - EUI form enabled boolean value indicating whether a COMSTAR SRP target should be created for this HCA. DESCRIPTION The srpt_SetTargetState() function controls whether a COMSTAR SRP target will be created for the specified HCA. If enabled is B_TRUE, an SRP target will be created for this HCA. If enabled is B_FALSE, a target will not be created. This function overrides the default setting for the SRP Target service as set by srpt_SetDefaultState(). Changing the target state takes effect immediately if the SRP target service is online. Targets set to disabled will be offlined and removed; targets set to enabled will be immediately created. The srpt_GetTargetState() function retrieves the current setting for the specified HCA. The srpt_ResetTarget() function clears HCA-specific settings. The service-wide defaults will control SRP Target creation for this HCA. RETURN VALUES ENOMEM Could not allocate resources EINVAL Invalid parameter ATTRIBUTES See attributes(5) for descriptions of the following attri- butes: ____________________________________________________________ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | |_____________________________|_____________________________| | Interface Stability | Committed | |_____________________________|_____________________________| | MT-Level | MT-Safe | |_____________________________|_____________________________| SEE ALSO srpt_SetDefaultState(3SRPT), libsrpt(3LIB) 4.4 srptadm System Administration Commands srptadm(1M) NAME srptadm - administer SRP Targets SYNOPSIS srptadm modify-target [-e, --enable] [-d, --disable] [-r, --reset] srptadm list-target [] srptadm modify-defaults [-e, --enable] [-d, --disable] srptadm list-defaults ARGUMENTS hca_guid GUID of the InfiniBand Host Channel Adapter (HCA) on this system for which SRP Target Services may be provided. The GUID must be in one of the following forms: 3BA000100CD18 - base hex form 0003BA000100CD18 - base hex form with leading zeroes hca:3BA000100CD18 - form from cfgadm eui.0003BA000100CD18 - EUI form DESCRIPTION The srptadm command manages SRP target ports within the SCSI Target Mode Framework described in stmfadm(1M) and libstmf(3LIB). This allows SRP initiators to access STMF logical units using the iSCSI protocol. srptadm is implemented as a set of subcommands with options and operands for each subcommand. These subcommands are described in their own section, below. SUBCOMMANDS srptadm modify-defaults [-e, --enable] [-d, --disable] Modify default parameters. Options are as follows. -e, --enable Enable SRP target creation for all HCAs that have not been explicitly disabled with modify-target. -d, --disable Disable SRP target creation for all HCAs that have not been explicitly enabled with modify-target. srptadm list-defaults Lists information about the default properties. This subcommand has no options. srptadm modify-target Sets SRP Target properties for the specified HCA. Options are as follows. -e, --enable enables SRP target creation on this HCA -d, --disable disables SRP target creation on this HCA -r, --reset clears HCA-specific information and resets to defaults. The SRP Target, if any, associated with this HCA will not be modified as a result of this option until the SRP Target SMF service is restarted. srptadm list-target [hca_guid] If hca_guid is specified, lists the properties of the target HCA. Otherwise, properties are listed for all HCAs. NOTES: If the default state is changed when the SRP service is online, the state of existing targets is not changed until the service is restarted. Changing the target state takes effect immediately if the SRP target service is online. Targets set to disabled will be offlined and removed; targets set to enabled will be immediately created. EXAMPLES: List the default SRP Target Service properties: # srptadm list-defaults SRP Target Service Default Properties: Target creation enabled by default: true Change the default behavior of the SRP Target service to not create SRP Targets when the service is enabled: # srptadm modify-defaults -d List SRP Target properties for a specific HCA: # cfgadm | grep hca hca:3BA000100CD18 IB-HCA connected configured ok hca:3BA000100D030 IB-HCA connected configured ok # srptadm list-target hca:3BA000100CD18 Target HCA 3BA000100CD18: Enabled : true SRP Target Name : eui.0003BA000100CD18 Operational Status : online Disable SRP Target services for a specific HCA: # srptadm modify-target -d 3BA000100CD18 Use the same list command to see the changes: # srptadm list-target hca:3BA000100CD18 Target HCA 3BA000100CD18: Enabled : false SRP Target Name : eui.0003BA000100CD18 Operational Status : - Re-enable SRP Target services, and look at the SRP and STMF target properties: # srptadm modify-target -e 3BA000100CD18 # srptadm list-target hca:3BA000100CD18 Target HCA 3BA000100CD18: Enabled : true SRP Target Name : eui.0003BA000100CD18 Operational Status : online # stmfadm list-target -v eui.0003BA000100CD18 Target: eui.0003BA000100CD18 Operational Status: Online Provider Name : srpt Alias : - Protocol : SRP Sessions : 0 ATTRIBUTES See attributes(5) for descriptions of the following attri- butes: ____________________________________________________________ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | |_____________________________|_____________________________| | Availability | SUNWsrptu | |_____________________________|_____________________________| | Interface Stability | Committed | |_____________________________|_____________________________| SEE ALSO stmfadm(1M), srpt(7D), libsrpt(3LIB), attributes(5) 5. Reference Documents: SRP Target PSARC case (PSARC/2009/111) http://arc.opensolaris.org/caselog/PSARC/2009/111/ 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 John.Forte@sun.com Tue Dec 1 07:37:21 2009 Received: from sunmail3mpk.sfbay.sun.com (sunmail3mpk.SFBay.Sun.COM [129.146.11.52]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id nB1FbKea023825 for ; Tue, 1 Dec 2009 07:37:20 -0800 (PST) Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11]) by sunmail3mpk.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id nB1FbIO8000698 for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Tue, 1 Dec 2009 07:37:20 -0800 (PST) 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 <0KTZ00L0XCQ8F600@brm-avmta-1.central.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@Sun.Com); Tue, 01 Dec 2009 08:37:20 -0700 (MST) Received: from brmea-mail-1.sun.com ([192.18.98.31]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0KTZ005G1CQ8IEB0@brm-avmta-1.central.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@Sun.Com); Tue, 01 Dec 2009 08:37:20 -0700 (MST) 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 nB1FbJ2A026670 for ; Tue, 01 Dec 2009 15:37:19 +0000 (GMT) Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com (Sun Java(tm) System Messaging Server 7u2-7.04 64bit (built Jul 2 2009)) id <0KTZ00H00CIQL300@mail-amer.sun.com> for PSARC-ext@Sun.Com (ORCPT PSARC-ext@Sun.Com); Tue, 01 Dec 2009 08:37:19 -0700 (MST) Received: from [129.146.56.52] ([unknown] [129.146.56.52]) by mail-amer.sun.com (Sun Java(tm) System Messaging Server 7u2-7.04 64bit (built Jul 2 2009)) with ESMTPSA id <0KTZ006GCCQ7Q3C0@mail-amer.sun.com> for PSARC-ext@Sun.Com (ORCPT PSARC-ext@Sun.Com); Tue, 01 Dec 2009 08:37:19 -0700 (MST) Date: Tue, 01 Dec 2009 07:32:46 -0800 From: John Forte Subject: Re: COMSTAR SRPT Port Provider Management [PSARC/2009/634 FastTrack timeout 11/25/2009] In-reply-to: <200911181733.nAIHXIXg015238@sac.sfbay.sun.com> Sender: John.Forte@sun.com To: PSARC-ext@sun.com Cc: Susan.Gleeson@sun.com Message-id: <4B15371E.3030800@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: <200911181733.nAIHXIXg015238@sac.sfbay.sun.com> User-Agent: Thunderbird 2.0.0.17 (X11/20081014) Status: RO Content-Length: 91 This case timed out on 11/25 without any +1. Can a PSARC member please review it? - John From Mark.Carlson@sun.com Tue Dec 1 08:39:28 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 nB1GdSkC025258 for ; Tue, 1 Dec 2009 08:39:28 -0800 (PST) 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.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id nB1GdRAG010819 for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Tue, 1 Dec 2009 08:39:27 -0800 (PST) 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 <0KTZ00403FLR5C00@brm-avmta-1.central.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Tue, 01 Dec 2009 09:39:27 -0700 (MST) Received: from brmea-mail-4.sun.com ([192.18.98.36]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0KTZ0016YFLRPW40@brm-avmta-1.central.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Tue, 01 Dec 2009 09:39:27 -0700 (MST) 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 nB1GdQve014999 for ; Tue, 01 Dec 2009 16:39:26 +0000 (GMT) Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com (Sun Java(tm) System Messaging Server 7u2-7.04 64bit (built Jul 2 2009)) id <0KTZ00E00F8I5300@mail-amer.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Tue, 01 Dec 2009 09:39:26 -0700 (MST) Received: from vpn-129-150-65-66.east.sun.com ([unknown] [129.150.65.66]) by mail-amer.sun.com (Sun Java(tm) System Messaging Server 7u2-7.04 64bit (built Jul 2 2009)) with ESMTPSA id <0KTZ00EWWFLP8540@mail-amer.sun.com>; Tue, 01 Dec 2009 09:39:26 -0700 (MST) Date: Tue, 01 Dec 2009 09:39:24 -0700 From: "Mark A. Carlson" Subject: Re: COMSTAR SRPT Port Provider Management [PSARC/2009/634 FastTrack timeout 11/25/2009] In-reply-to: <200911181733.nAIHXIXg015238@sac.sfbay.sun.com> Sender: Mark.Carlson@sun.com To: John Forte Cc: PSARC-ext@sun.com, Susan.Gleeson@sun.com Message-id: <4B1546BC.7010509@sun.com> MIME-version: 1.0 Content-type: multipart/alternative; boundary="Boundary_(ID_2QVbmv0N+3R2Z2CvGwIDYg)" X-PMX-Version: 5.4.1.325704 References: <200911181733.nAIHXIXg015238@sac.sfbay.sun.com> User-Agent: Thunderbird 2.0.0.23 (Macintosh/20090812) Status: RO Content-Length: 23948 This is a multi-part message in MIME format. --Boundary_(ID_2QVbmv0N+3R2Z2CvGwIDYg) Content-type: text/plain; CHARSET=US-ASCII; format=flowed Content-transfer-encoding: 7BIT +1 -- mark John Forte wrote: > I am sponsoring this fasttrack for Sue Gleeson. Requested binding is minor. Timeout is set for 11/25/2009. > > - John > > > Template Version: @(#)sac_nextcase 1.68 02/23/09 SMI > This information is Copyright 2009 Sun Microsystems > 1. Introduction > 1.1. Project/Component Working Name: > COMSTAR SRPT Port Provider Management > 1.2. Name of Document Author/Supplier: > Author: Susan Gleeson > 1.3 Date of This Document: > 18 November, 2009 > 4. Technical Description > > The COMSTAR Infiniband SRP Target project (PSARC/2009/111 [1]) introduced > the SRP protocol port provider to Solaris. When the SRP port provider > SMF service is enabled, COMSTAR targets are created for every Infiniband > HCA discovered on the system. It has become clear that a finer level of > control is required, and this set of interfaces will allow for changing > the default behavior when the service is activated as well as enabling > and disabling SRP services on a per-HCA basis. > > This case introduces a new library, libsrpt and a new CLI, srptadm as > described below. > > 4.1 Interfaces > > Minor binding. > > -------------+-----------------------+------------------------- > Interface Classification Comments > -------------+-----------------------+------------------------- > libsrpt | Committed | > srptadm | Committed > > > 4.2 srpt_SetDefaultState/srpt_GetDefaultState > > NAME > srpt_SetDefaultState, srpt_GetDefaultState - set and retrieve the default > state setting for the SRP Target service. > > SYNOPSIS > cc [ flag... ] file... -lsrpt [ library... ] > #include > > int srpt_SetDefaultState(boolean_t enabled); > > int srpt_GetDefaultState(boolean_t *enabled); > > PARAMETERS > > enabled boolean value indicating whether COMSTAR SRP targets should > be created. > > DESCRIPTION > The srpt_SetDefaultState() function sets the default behavior of the > SRP Target service. If enabled is B_TRUE, SRP targets will be created for > all discovered HCAs that have not been specifically disabled. If enabled > is B_FALSE, targets will not be created unless the HCA has been specifically > enabled. See also srpt_SetTargetState() for enabling or disabling specific > HCAs. If the default state is changed when the SRP service is online, > the state of existing targets is not changed until the service is > restarted. > > The srpt_GetDefaultState() function returns the current value for enabled. > > RETURN VALUES > > ENOMEM Could not allocate resources > EINVAL Invalid parameter > > ATTRIBUTES > > See attributes(5) for descriptions of the following attri- > butes: > > ____________________________________________________________ > | ATTRIBUTE TYPE | ATTRIBUTE VALUE | > |_____________________________|_____________________________| > | Interface Stability | Committed | > |_____________________________|_____________________________| > | MT-Level | MT-Safe | > |_____________________________|_____________________________| > > SEE ALSO > srpt_SetTargetState(3SRPT), libsrpt(3LIB) > > 4.3 srpt_SetTargetState/srpt_GetTargetState > > NAME > srpt_SetTargetState, srpt_GetTargetState, srpt_ResetTarget - set and > retrieve SRP Target state for a specific HCA. > > SYNOPSIS > cc [ flag... ] file... -lsrpt [ library... ] > #include > > int srpt_SetTargetState(char *hca_guid, boolean_t enabled); > int srpt_GetTargetState(char *hca_guid, boolean_t *enabled); > int srpt_ResetTarget(char *hca_guid); > > PARAMETERS > > hc_guid HCA GUID. Must be in one of the following forms: > 3BA000100CD18 - base hex form > 0003BA000100CD18 - base hex form with leading zeroes > hca:3BA000100CD18 - form from cfgadm > eui.0003BA000100CD18 - EUI form > > enabled boolean value indicating whether a COMSTAR SRP target should > be created for this HCA. > > DESCRIPTION > The srpt_SetTargetState() function controls whether a COMSTAR SRP target > will be created for the specified HCA. If enabled is B_TRUE, an SRP target > will be created for this HCA. If enabled is B_FALSE, a target will not be > created. This function overrides the default setting for the SRP Target > service as set by srpt_SetDefaultState(). Changing the target state takes > effect immediately if the SRP target service is online. Targets set to > disabled will be offlined and removed; targets set to enabled will be > immediately created. > > The srpt_GetTargetState() function retrieves the current setting for the > specified HCA. > > The srpt_ResetTarget() function clears HCA-specific settings. The > service-wide defaults will control SRP Target creation for this HCA. > > RETURN VALUES > > ENOMEM Could not allocate resources > EINVAL Invalid parameter > > ATTRIBUTES > > See attributes(5) for descriptions of the following attri- > butes: > > ____________________________________________________________ > | ATTRIBUTE TYPE | ATTRIBUTE VALUE | > |_____________________________|_____________________________| > | Interface Stability | Committed | > |_____________________________|_____________________________| > | MT-Level | MT-Safe | > |_____________________________|_____________________________| > > SEE ALSO > srpt_SetDefaultState(3SRPT), libsrpt(3LIB) > > 4.4 srptadm > > System Administration Commands srptadm(1M) > > NAME > srptadm - administer SRP Targets > > SYNOPSIS > srptadm modify-target [-e, --enable] [-d, --disable] > [-r, --reset] > > srptadm list-target [] > > srptadm modify-defaults [-e, --enable] [-d, --disable] > > srptadm list-defaults > > ARGUMENTS > > hca_guid GUID of the InfiniBand Host Channel Adapter > (HCA) on this system for which SRP Target Services > may be provided. The GUID must be in one of the > following forms: > > 3BA000100CD18 - base hex form > 0003BA000100CD18 - base hex form with leading zeroes > hca:3BA000100CD18 - form from cfgadm > eui.0003BA000100CD18 - EUI form > > DESCRIPTION > > The srptadm command manages SRP target ports within the SCSI Target Mode > Framework described in stmfadm(1M) and libstmf(3LIB). This allows SRP > initiators to access STMF logical units using the iSCSI protocol. > > srptadm is implemented as a set of subcommands with options > and operands for each subcommand. These subcommands are > described in their own section, below. > > SUBCOMMANDS > srptadm modify-defaults [-e, --enable] [-d, --disable] > Modify default parameters. Options are as follows. > > -e, --enable > Enable SRP target creation for all HCAs that > have not been explicitly disabled with modify-target. > > -d, --disable > Disable SRP target creation for all HCAs that > have not been explicitly enabled with modify-target. > > srptadm list-defaults > Lists information about the default properties. This > subcommand has no options. > > srptadm modify-target > Sets SRP Target properties for the specified HCA. Options > are as follows. > > -e, --enable > enables SRP target creation on this HCA > -d, --disable > disables SRP target creation on this HCA > -r, --reset > clears HCA-specific information and resets > to defaults. The SRP Target, if any, associated > with this HCA will not be modified as a result > of this option until the SRP Target SMF service > is restarted. > > srptadm list-target [hca_guid] > If hca_guid is specified, lists the properties of the > target HCA. Otherwise, properties are listed for all > HCAs. > > NOTES: > If the default state is changed when the SRP service is online, > the state of existing targets is not changed until the service is > restarted. > > Changing the target state takes effect immediately if the SRP target > service is online. Targets set to disabled will be offlined and removed; > targets set to enabled will be immediately created. > > EXAMPLES: > > List the default SRP Target Service properties: > > # srptadm list-defaults > SRP Target Service Default Properties: > > Target creation enabled by default: true > > Change the default behavior of the SRP Target service to > not create SRP Targets when the service is enabled: > > # srptadm modify-defaults -d > > List SRP Target properties for a specific HCA: > # cfgadm | grep hca > hca:3BA000100CD18 IB-HCA connected configured ok > hca:3BA000100D030 IB-HCA connected configured ok > > # srptadm list-target hca:3BA000100CD18 > Target HCA 3BA000100CD18: > Enabled : true > SRP Target Name : eui.0003BA000100CD18 > Operational Status : online > > Disable SRP Target services for a specific HCA: > > # srptadm modify-target -d 3BA000100CD18 > > Use the same list command to see the changes: > > # srptadm list-target hca:3BA000100CD18 > Target HCA 3BA000100CD18: > Enabled : false > SRP Target Name : eui.0003BA000100CD18 > Operational Status : - > > Re-enable SRP Target services, and look at the SRP and STMF > target properties: > > # srptadm modify-target -e 3BA000100CD18 > # srptadm list-target hca:3BA000100CD18 > Target HCA 3BA000100CD18: > Enabled : true > SRP Target Name : eui.0003BA000100CD18 > Operational Status : online > > # stmfadm list-target -v eui.0003BA000100CD18 > Target: eui.0003BA000100CD18 > Operational Status: Online > Provider Name : srpt > Alias : - > Protocol : SRP > Sessions : 0 > > ATTRIBUTES > See attributes(5) for descriptions of the following attri- > butes: > > ____________________________________________________________ > | ATTRIBUTE TYPE | ATTRIBUTE VALUE | > |_____________________________|_____________________________| > | Availability | SUNWsrptu | > |_____________________________|_____________________________| > | Interface Stability | Committed | > |_____________________________|_____________________________| > > > SEE ALSO > stmfadm(1M), srpt(7D), libsrpt(3LIB), attributes(5) > > > 5. Reference Documents: > > SRP Target PSARC case (PSARC/2009/111) > http://arc.opensolaris.org/caselog/PSARC/2009/111/ > > 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 > opensolaris-arc@opensolaris.org > -- * Mark A. Carlson * Sr. Architect *Systems Group* Phone x69559 / 303-223-6139 Email Mark.Carlson@Sun.COM --Boundary_(ID_2QVbmv0N+3R2Z2CvGwIDYg) Content-type: text/html; CHARSET=US-ASCII Content-transfer-encoding: 7BIT +1

-- mark

John Forte wrote: 
I am sponsoring this fasttrack for Sue Gleeson. Requested binding is minor. Timeout is set for 11/25/2009.

- John


Template Version: @(#)sac_nextcase 1.68 02/23/09 SMI
This information is Copyright 2009 Sun Microsystems
1. Introduction
    1.1. Project/Component Working Name:
	 COMSTAR SRPT Port Provider Management
    1.2. Name of Document Author/Supplier:
	 Author:  Susan Gleeson
    1.3  Date of This Document:
	18 November, 2009
4. Technical Description

The COMSTAR Infiniband SRP Target project (PSARC/2009/111 [1]) introduced
the SRP protocol port provider to Solaris.   When the SRP port provider
SMF service is enabled, COMSTAR targets are created for every Infiniband
HCA discovered on the system.  It has become clear that a finer level of
control is required, and this set of interfaces will allow for changing
the default behavior when the service is activated as well as enabling
and disabling SRP services on a per-HCA basis.

This case introduces a new library, libsrpt and a new CLI, srptadm as
described below.

4.1 Interfaces

    Minor binding.

        -------------+-----------------------+-------------------------
        Interface        Classification         Comments
        -------------+-----------------------+-------------------------
        libsrpt      |   Committed           |
        srptadm      |   Committed


4.2 srpt_SetDefaultState/srpt_GetDefaultState

 NAME
    srpt_SetDefaultState, srpt_GetDefaultState - set and retrieve the default
    state setting for the SRP Target service.

 SYNOPSIS
    cc [ flag... ] file... -lsrpt [ library... ]
    #include <libsrpt.h>

    int srpt_SetDefaultState(boolean_t enabled);

    int srpt_GetDefaultState(boolean_t *enabled);

 PARAMETERS

     enabled	boolean value indicating whether COMSTAR SRP targets should
                be created.

 DESCRIPTION
    The srpt_SetDefaultState() function sets the default behavior of the
    SRP Target service.  If enabled is B_TRUE, SRP targets will be created for
    all discovered HCAs that have not been specifically disabled.  If enabled
    is B_FALSE, targets will not be created unless the HCA has been specifically
    enabled.  See also srpt_SetTargetState() for enabling or disabling specific
    HCAs.   If the default state is changed when the SRP service is online,
    the state of existing targets is not changed until the service is
    restarted.

    The srpt_GetDefaultState() function returns the current value for enabled.

 RETURN VALUES

     ENOMEM	Could not allocate resources
     EINVAL	Invalid parameter

 ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

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

 SEE ALSO
     srpt_SetTargetState(3SRPT), libsrpt(3LIB)

4.3  srpt_SetTargetState/srpt_GetTargetState

 NAME
    srpt_SetTargetState, srpt_GetTargetState, srpt_ResetTarget - set and
    retrieve SRP Target state for a specific HCA.

 SYNOPSIS
    cc [ flag... ] file... -lsrpt [ library... ]
    #include <libsrpt.h>

    int srpt_SetTargetState(char *hca_guid, boolean_t enabled);
    int srpt_GetTargetState(char *hca_guid, boolean_t *enabled);
    int srpt_ResetTarget(char *hca_guid);

 PARAMETERS

     hc_guid     HCA GUID.  Must be in one of the following forms:
 		    3BA000100CD18	- base hex form
 		    0003BA000100CD18	- base hex form with leading zeroes
 		    hca:3BA000100CD18	- form from cfgadm
 		    eui.0003BA000100CD18 - EUI form

     enabled	boolean value indicating whether a COMSTAR SRP target should
                be created for this HCA.

 DESCRIPTION
    The srpt_SetTargetState() function controls whether a COMSTAR SRP target
    will be created for the specified HCA.  If enabled is B_TRUE, an SRP target
    will be created for this HCA.  If enabled is B_FALSE, a target will not be
    created.  This function overrides the default setting for the SRP Target
    service as set by srpt_SetDefaultState().  Changing the target state takes
    effect immediately if the SRP target service is online.  Targets set to
    disabled will be offlined and removed; targets set to enabled will be
    immediately created.

    The srpt_GetTargetState() function retrieves the current setting for the
    specified HCA.

    The srpt_ResetTarget() function clears HCA-specific settings.  The
    service-wide defaults will control SRP Target creation for this HCA.

 RETURN VALUES

     ENOMEM	Could not allocate resources
     EINVAL	Invalid parameter

 ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

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

 SEE ALSO
     srpt_SetDefaultState(3SRPT), libsrpt(3LIB)

4.4  srptadm

System Administration Commands					srptadm(1M)

NAME
	srptadm - administer SRP Targets

SYNOPSIS
	srptadm modify-target [-e, --enable] [-d, --disable]
	   [-r, --reset] <hca_guid>

	srptadm list-target [<hca_guid>]

	srptadm modify-defaults [-e, --enable] [-d, --disable]

	srptadm list-defaults

ARGUMENTS

	hca_guid  GUID of the InfiniBand Host Channel Adapter
		  (HCA) on this system for which SRP Target Services
		  may be provided.  The GUID must be in one of the
		  following forms:

		  3BA000100CD18       - base hex form
		  0003BA000100CD18    - base hex form with leading zeroes
		  hca:3BA000100CD18   - form from cfgadm
		  eui.0003BA000100CD18 - EUI form

DESCRIPTION

 The srptadm command manages SRP target ports within the SCSI Target Mode
 Framework  described  in stmfadm(1M) and libstmf(3LIB).  This allows SRP
 initiators to access STMF logical units using the iSCSI protocol.

 srptadm is implemented as a set of  subcommands  with  options
 and  operands  for  each  subcommand.  These subcommands are
 described in their own section, below.

SUBCOMMANDS
	srptadm modify-defaults [-e, --enable] [-d, --disable]
		Modify default parameters.  Options are as follows.

		-e, --enable
			Enable SRP target creation for all HCAs that
			have not been explicitly disabled with modify-target.

		-d, --disable
			Disable SRP target creation for all HCAs that
			have not been explicitly enabled with modify-target.

	srptadm list-defaults
		Lists information about the default properties.  This
		subcommand has no options.

	srptadm modify-target <hca_guid>
		Sets SRP Target properties for the specified HCA.  Options
		are as follows.

		-e, --enable
			enables SRP target creation on this HCA
		-d, --disable
			disables SRP target creation on this HCA
		-r, --reset
			clears HCA-specific information and resets
			to defaults.  The SRP Target, if any, associated
			with this HCA will not be modified as a result
			of this option until the SRP Target SMF service
			is restarted.
			
	srptadm list-target [hca_guid]
		If hca_guid is specified, lists the properties of the
		target HCA.  Otherwise, properties are listed for all
		HCAs.

NOTES:
    If the default state is changed when the SRP service is online,
    the state of existing targets is not changed until the service is
    restarted.

    Changing the target state takes effect immediately if the SRP target
    service is online.  Targets set to disabled will be offlined and removed;
    targets set to enabled will be immediately created.

EXAMPLES:

	List the default SRP Target Service properties:

	# srptadm list-defaults
	SRP Target Service Default Properties:

	    Target creation enabled by default: true

	Change the default behavior of the SRP Target service to
	not create SRP Targets when the service is enabled:

	# srptadm modify-defaults -d

	List SRP Target properties for a specific HCA:
	# cfgadm | grep hca
hca:3BA000100CD18              IB-HCA       connected    configured   ok
hca:3BA000100D030              IB-HCA       connected    configured   ok

	# srptadm list-target hca:3BA000100CD18
	Target HCA 3BA000100CD18:
	    Enabled             : true
	    SRP Target Name     : eui.0003BA000100CD18
	    Operational Status  : online

	Disable SRP Target services for a specific HCA:

	# srptadm modify-target -d 3BA000100CD18

	Use the same list command to see the changes:

	# srptadm list-target hca:3BA000100CD18
	Target HCA 3BA000100CD18:
	    Enabled             : false
	    SRP Target Name     : eui.0003BA000100CD18
	    Operational Status  : -

	Re-enable SRP Target services, and look at the SRP and STMF
	target properties:

	# srptadm modify-target -e 3BA000100CD18
	# srptadm list-target hca:3BA000100CD18
	Target HCA 3BA000100CD18:
	    Enabled             : true
	    SRP Target Name     : eui.0003BA000100CD18
	    Operational Status  : online

	# stmfadm list-target -v eui.0003BA000100CD18
	Target: eui.0003BA000100CD18
	    Operational Status: Online
	    Provider Name     : srpt
	    Alias             : -
	    Protocol          : SRP
	    Sessions          : 0

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWsrptu                   |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|


SEE ALSO
	stmfadm(1M), srpt(7D), libsrpt(3LIB), attributes(5)


5. Reference Documents:

SRP Target PSARC case (PSARC/2009/111)
http://arc.opensolaris.org/caselog/PSARC/2009/111/

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
opensolaris-arc@opensolaris.org

--
Mark A. Carlson
Sr. Architect

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

--Boundary_(ID_2QVbmv0N+3R2Z2CvGwIDYg)-- From John.Forte@sun.com Wed Dec 2 12:05:28 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 nB2K5SrA027968 for ; Wed, 2 Dec 2009 12:05:28 -0800 (PST) Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74]) by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.4) with ESMTP id nB2K5FFH039506 for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Wed, 2 Dec 2009 13:05:27 -0700 (MST) 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 <0KU1006VJJT1UN00@nwk-avmta-1.sfbay.Sun.COM> for PSARC-ext@sun.com (ORCPT PSARC-ext@Sun.Com); Wed, 02 Dec 2009 12:05:25 -0800 (PST) Received: from brmea-mail-4.sun.com ([192.18.98.36]) by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0KU100HKMJRE74C0@nwk-avmta-1.sfbay.Sun.COM> for PSARC-ext@sun.com (ORCPT PSARC-ext@Sun.Com); Wed, 02 Dec 2009 12:04:26 -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 nB2K4Q8p001421 for ; Wed, 02 Dec 2009 20:04:26 +0000 (GMT) Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com (Sun Java(tm) System Messaging Server 7u2-7.04 64bit (built Jul 2 2009)) id <0KU100200JH6ZI00@mail-amer.sun.com> for PSARC-ext@Sun.Com (ORCPT PSARC-ext@Sun.Com); Wed, 02 Dec 2009 13:04:26 -0700 (MST) Received: from [129.146.56.52] ([unknown] [129.146.56.52]) by mail-amer.sun.com (Sun Java(tm) System Messaging Server 7u2-7.04 64bit (built Jul 2 2009)) with ESMTPSA id <0KU1003FLJRAU9F0@mail-amer.sun.com> for PSARC-ext@Sun.Com (ORCPT PSARC-ext@Sun.Com); Wed, 02 Dec 2009 13:04:22 -0700 (MST) Date: Wed, 02 Dec 2009 11:59:48 -0800 From: John Forte Subject: Re: COMSTAR SRPT Port Provider Management [PSARC/2009/634 FastTrack timeout 11/25/2009] In-reply-to: <200911181733.nAIHXIXg015238@sac.sfbay.sun.com> Sender: John.Forte@sun.com To: Susan.Gleeson@sun.com Cc: PSARC-ext@sun.com Message-id: <4B16C734.4090802@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: <200911181733.nAIHXIXg015238@sac.sfbay.sun.com> User-Agent: Thunderbird 2.0.0.17 (X11/20081014) Status: RO Content-Length: 47 This case was approved at PSARC today. - John