From cth@sac.sfbay.sun.com Tue May 20 18:33:54 2008
Received: from sunmail4.singapore.sun.com (sunmail4.Singapore.Sun.COM [129.158.71.19])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m4L1XrhR018864
	for <psarc-ext@sac.sfbay.Sun.COM>; Tue, 20 May 2008 18:33:53 -0700 (PDT)
Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74])
	by sunmail4.singapore.sun.com (8.13.4+Sun/8.13.3/ENSMAIL,v2.2) with ESMTP id m4L1Xptp016171;
	Wed, 21 May 2008 09:33:52 +0800 (SGT)
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 <0K170080930C7H00@nwk-avmta-1.sfbay.Sun.COM>; Tue,
 20 May 2008 18:33:48 -0700 (PDT)
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 <0K1700K6I30BGUC0@nwk-avmta-1.sfbay.Sun.COM>; Tue,
 20 May 2008 18:33:47 -0700 (PDT)
Received: from sac.sfbay.sun.com (new-sac.SFBay.Sun.COM [129.146.175.65])
	by dm-sfbay-01.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2)
 with ESMTP id m4L1Xl4I018381; Tue, 20 May 2008 18:33:47 -0700 (PDT)
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 m4L1Xkae018833; Tue,
 20 May 2008 18:33:46 -0700 (PDT)
Received: (from cth@localhost)	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8/Submit)
 id m4L1Xk1m018829; Tue, 20 May 2008 18:33:46 -0700 (PDT)
Date: Tue, 20 May 2008 18:33:46 -0700 (PDT)
From: Christopher Horne <cth@sac.sfbay.sun.com>
Subject: scsi-self-identifying [PSARC/2008/337 FastTrack timeout 05/28/2008]
To: PSARC-ext@sun.com
Message-id: <200805210133.m4L1Xk1m018829@sac.sfbay.sun.com>
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
Status: RO
Content-Length: 4394

I am sponsoring the following fasttrack for Javen Wu with a timeout of
05/28/2008.  It introduces a new 'add_drv -c' driver class for scsi(4)
SCSA HBA drivers that support self-identifying children.  The proposed
release binding is micro/patch.  Additional referenced material is in
the case directory.

-Chris

Template Version: @(#)sac_nextcase 1.66 04/17/08 SMI
This information is Copyright 2008 Sun Microsystems
1. Introduction
    1.1. Project/Component Working Name:
	 scsi-self-identifying
    1.2. Name of Document Author/Supplier:
	 Author:  Javen Wu
    1.3  Date of This Document:
	20 May, 2008
4. Technical Description

4.1 Summary

    To perform devid discovery from scratch, the IO framework needs to
    be able to identify 'sticks' of the device tree where the
    configuration of the stick might result in the registration of
    devids. The 'ddi-devid-registrant' [1] property names the leaf
    drivers that might generate devids, and stub nodes defined in the
    leaf driver.conf file identify HBAs that might have children that
    bind to the driver.  These two things together allow the IO
    framework to identify 'all sticks' to configure when trying to
    discover the paths to a device with a particular devid.  Accurate
    'all sticks' information is important when more efficient
    devid-path discovery methods, like [2], fail.

    Recently, there are more and more self-identifying SCSI HBA
    drivers, as defined by [3], which are not of class=scsi. Currently,
    we have to add parent="<driver-name>" to the leaf driver.conf files
    (sd/ssd) for every self-identifying HBA driver. This
    parent="<driver-name>" technique causes cross-driver pollution in
    the .conf files of leaf drivers (causing issues with things like
    driver class-action scripts). Also, people are forgetting that they
    need to do this to ensure proper devid discovery.

    So far, we have a lot of HBA drivers that add specific 'stub'
    configuration nodes (with parent="<driver_name>") to the leaf
    driver.conf files. The examples are the following 'stub' nodes in
    sd.conf file and ssd.conf file:

    sd.conf:(i386)
      name="sd" parent="nv_sata";
      name="sd" parent="ahci";
      name="sd" parent="si3124";
      name="sd" parent="marvell88sx";

    ssd.conf:(sparc)
      name="ssd" parent="sf" target=0;
      name="ssd" parent="fp" target=0;
      name="ssd" parent="scsi_vhci" target=0;

    Currently, more pollution occurs each time we add a
    self-identifying HBA driver to Solaris.

    As a solution, this case proposes the introduction of a new class
    (ala /etc/driver_classes) called 'scsi-self-identifying'. With this
    change, all SCSA self-identifying HBA drivers will be part of the
    new class, with a single generic "parent=scsi-self-identifying"
    stub node in the leaf .conf files.

4.2 Proposal

    The proposed new driver class 'scsi-self-identifying' can be
    resisted by self-identifying SCSI HBA drivers during add_drv(1M) or
    BFU/upgrade.

    At the same time, a generic 'stub' node will be added into
    sd.conf/ssd.conf instead of the 'stub' nodes only with parent
    property like below:

    sd.conf (both x86 and sparc)
      name="sd" class="scsi-self-identifying";

    ssd.conf
      name="ssd" class="scsi-self-identifying";


4.3 Interface Summary

    Interface                 Level        Comments
    -------------------------------------------------------------------------
    scsi-self-identifying  Committed    driver class  to indicate a
					SCSA compliant nexus driver
					which is not of class=scsi and
					is able to dynamically create
					self-identifying scsi(4) device
					children.

4.4 References

    [1] PSARC/2007/477 Drivers Registering Devids
    <http://sac.sfbay/PSARC/2007/477>
    <http://www.opensolaris.org/os/community/arc/caselog/2007/447>

    [2] PSARC/2004/064 Devid Cache
    <http://sac.sfbay/PSARC/2004/064/>
    <http://www.opensolaris.org/os/community/arc/caselog/2004/064>

    [3] PSARC/2004/116 SCSI target compatible property
    <http://sac.sfbay/PSARC/2004/116/>
    <http://www.opensolaris.org/os/community/arc/caselog/2004/116>

    [4] Manpage of scsi(4)


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 Chris.Horne@sun.com Wed May 28 10:35:34 2008
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 m4SHZXds011746
	for <psarc-ext@sac.sfbay.sun.com>; Wed, 28 May 2008 10:35:34 -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 m4SHZTZv005564
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Wed, 28 May 2008 18:35:32 +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 <0K1L00809A78L000@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@Sun.Com); Wed, 28 May 2008 10:35:32 -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 <0K1L005XOA76QU40@nwk-avmta-2.sfbay.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@Sun.Com); Wed,
 28 May 2008 10:35:30 -0700 (PDT)
Received: from fe-amer-09.sun.com ([192.18.109.79])
	by brmea-mail-2.sun.com (8.13.6+Sun/8.12.9) with ESMTP id m4SHZUMo024132	for
 <PSARC-ext@Sun.Com>; Wed, 28 May 2008 17:35:30 +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 <0K1L00E017LS4O00@mail-amer.sun.com>
 (original mail from Chris.Horne@Sun.COM)
 for PSARC-ext@Sun.Com (ORCPT PSARC-ext@Sun.Com); Wed,
 28 May 2008 11:35:30 -0600 (MDT)
Received: from [172.20.25.50] by mail-amer.sun.com
 (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007))
 with ESMTPSA id <0K1L005GVA6N3TG0@mail-amer.sun.com> for PSARC-ext@Sun.Com
 (ORCPT PSARC-ext@Sun.Com); Wed, 28 May 2008 11:35:11 -0600 (MDT)
Date: Wed, 28 May 2008 11:30:25 -0600
From: Chris Horne <Chris.Horne@sun.com>
Subject: Re: scsi-self-identifying [PSARC/2008/337 FastTrack timeout 05/28/2008]
In-reply-to: <200805210133.m4L1Xk1m018829@sac.sfbay.sun.com>
Sender: Chris.Horne@sun.com
To: PSARC-ext@sun.com
Cc: Javen Wu <Javen.Wu@sun.com>
Message-id: <483D96B1.7060009@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
References: <200805210133.m4L1Xk1m018829@sac.sfbay.sun.com>
User-Agent: Thunderbird 1.5.0.8 (X11/20061204)
Status: RO
Content-Length: 57

This case was approved at todays PSARC meeting.

-Chris


