From sacadmin Tue May  2 15:17:33 2006
Received: from sunmail5.uk.sun.com (sunmail5.UK.Sun.COM [129.156.85.165])
	by sac.sfbay.sun.com (8.12.9+Sun/8.12.9) with ESMTP id k42MHWIQ026106
	for <psarc@sac.eng.sun.com>; Tue, 2 May 2006 15:17:33 -0700 (PDT)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by sunmail5.uk.sun.com (8.13.4+Sun/8.13.3/ENSMAIL,v2.2) with ESMTP id k42MHSLd026719
	for <@sunmail1brm.central.sun.com:psarc@sun.com>; Tue, 2 May 2006 23:17:31 +0100 (BST)
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 <0IYN00201SL55Z00@brm-avmta-1.central.sun.com> for psarc@sun.com
 (ORCPT psarc@sun.com); Tue, 02 May 2006 16:17:29 -0600 (MDT)
Received: from sfbaymail1sca.SFBay.Sun.COM ([129.145.154.35])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0IYN00JBISL4TT50@brm-avmta-1.central.sun.com> for psarc@sun.com
 (ORCPT psarc@sun.com); Tue, 02 May 2006 16:17:29 -0600 (MDT)
Received: from billybob.sfbay.sun.com
 (billybob.SFBay.Sun.COM [129.146.224.123])	by sfbaymail1sca.SFBay.Sun.COM
 (8.12.10+Sun/8.12.10/ENSMAIL,v2.2) with ESMTP id k42MHSoc023503; Tue,
 02 May 2006 15:17:28 -0700 (PDT)
Received: from billybob (billybob [129.146.224.123])	by billybob.sfbay.sun.com
 (8.13.6+Sun/8.13.6) with SMTP id k42MKsvf143136; Tue,
 02 May 2006 15:20:54 -0700 (PDT)
Date: Tue, 02 May 2006 15:20:54 -0700 (PDT)
From: Shudong Zhou <szhou@billybob.sfbay.sun.com>
Subject: PSARC 2006/285 MPxIO Driver Properties
To: psarc@sun.com
Cc: ramaswamy.tummala@sun.com
Reply-to: Shudong Zhou <szhou@billybob.sfbay.sun.com>
Message-id: <200605022220.k42MKsvf143136@billybob.sfbay.sun.com>
MIME-version: 1.0
X-Mailer: dtmail 1.3.0 @(#)CDE Version 1.7_13 SunOS 5.11 i86pc i386
Content-type: TEXT/plain; charset=us-ascii
Content-transfer-encoding: 7BIT
Content-MD5: em4XH8wCnHidGYZD92bZ3g==
X-PMX-Version: 5.1.2.240295
Status: RO
Content-Length: 2911

I'm sponsoring the following fasttrack for Ramaswamy Tummala.
The timer is set to expire on 5/9/2006.

The requested release binding is patch.  The immediate consumers
of the interfaces are targeting ON, so there are no contract at
this time. Future contracts are anticipated from NWS consolidation.

Shudong


1. Summary

This case proposes two new properties ddi-vhci-class and ddi-no-root-support
to be specified in a pHCI driver.conf file.

2. Background

MPxIO framework (referred to as MDI henceforth), maintains a private cache
containing vHCI to pHCI mappings for devices under MPxIO. The cache is
persisted across reboots. If the cache is corrupted or deleted or not
available for any reason, MDI automatically rebuilds the cache. To rebuild
the cache MDI needs to attach all pHCI drivers. For this purpose MDI
currently has a hard coded built-in list of all pHCI driver names.

3. Problem

The hard coded list of pHCI driver names is a maintenance overhead as the
list needs to be updated whenever a new pHCI driver is added or the existing
one is removed. To eliminate this overhead the hard coded list needs to be
removed and replaced by a better mechanism.

4. Solution

We propose two new properties ddi-vhci-class and ddi-no-root-support to be
specified in a pHCI driver.conf file. Since MDI can know the pHCI driver
information using these properties, MDI will no longer have to hard code the
pHCI driver names.

4.1 Interface Commitment Level

----------------------------------------------------------------------------
Interface              Level                           Comments
----------------------------------------------------------------------------
ddi-vhci-class         Contracted Consolidation Priv   Property to specify
                                                       vHCI class
ddi-no-root-support        ""                          Property to specify
                                                       no root support.

4.2 Details

The driver.conf file of a pHCI driver must specify the vHCI class it belongs
to using the new ddi-vhci-class string property.

Some pHCI drivers can not safely attach prior to the mounting of the root
in the kernel, possibly because they or their dependent modules need some
config data on the disk that can only be read after the root is mounted.
Such pHCI drivers must also specify ddi-no-root-support integer property
in their driver.conf files. If MDI has a need to build the cache, attach of
pHCI drivers with ddi-no-root-support property will be deferred until after
the root is mounted in the kernel.

Example entries:

fp.conf file would specify:

	ddi-vhci-class="scsi_vhci";

iscsi.conf file would specify:

	ddi-vhci-class="scsi_vhci";
	ddi-no-root-support=1;

tavor.conf file would specify:
	ddi-vhci-class="ib";

5. References

PSARC 2005/583 VHCI Driven Device Enumeration
PSARC 1999/647 Multiplexed I/O Framework



From sacadmin Tue May  9 17:21:04 2006
Received: from sunmail4.Singapore.Sun.COM (sunmail4.Singapore.Sun.COM [129.158.71.19])
	by sac.sfbay.sun.com (8.13.6+Sun/8.13.6) with ESMTP id k4A0L3qb006974
	for <psarc@sac.eng.Sun.COM>; Tue, 9 May 2006 17:21:04 -0700 (PDT)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by sunmail4.Singapore.Sun.COM (8.13.4+Sun/8.13.3/ENSMAIL,v2.2) with ESMTP id k4A0L05N019327
	for <@sunmail1brm.central.sun.com:psarc@sun.com>; Wed, 10 May 2006 08:21:02 +0800 (SGT)
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 <0IZ000A05WYY2G00@brm-avmta-1.central.sun.com> for psarc@sun.com
 (ORCPT psarc@sun.com); Tue, 09 May 2006 18:20:58 -0600 (MDT)
Received: from sfbaymail2sca.sfbay.sun.com ([129.145.155.42])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0IZ0007UVWYYZI10@brm-avmta-1.central.sun.com> for psarc@sun.com
 (ORCPT psarc@sun.com); Tue, 09 May 2006 18:20:58 -0600 (MDT)
Received: from billybob.sfbay.sun.com
 (billybob.SFBay.Sun.COM [129.146.224.123])	by sfbaymail2sca.sfbay.sun.com
 (8.12.10+Sun/8.12.10/ENSMAIL,v2.2) with ESMTP id k4A0KvTF005779; Tue,
 09 May 2006 17:20:57 -0700 (PDT)
Received: from billybob (billybob [129.146.224.123])	by billybob.sfbay.sun.com
 (8.13.6+Sun/8.13.6) with SMTP id k4A0Oe3Q103821; Tue,
 09 May 2006 17:24:40 -0700 (PDT)
Date: Tue, 09 May 2006 17:24:40 -0700 (PDT)
From: Shudong Zhou <szhou@billybob.sfbay.sun.com>
Subject: Re: PSARC 2006/285 MPxIO Driver Properties
To: psarc@sun.com
Cc: ramaswamy.tummala@sun.com
Reply-to: Shudong Zhou <szhou@billybob.sfbay.sun.com>
Message-id: <200605100024.k4A0Oe3Q103821@billybob.sfbay.sun.com>
MIME-version: 1.0
X-Mailer: dtmail 1.3.0 @(#)CDE Version 1.7_13 SunOS 5.11 i86pc i386
Content-type: TEXT/plain; charset=us-ascii
Content-transfer-encoding: 7BIT
Content-MD5: +ELxCCCktk2PVLXqONOmYg==
X-PMX-Version: 5.1.2.240295
Status: RO
Content-Length: 88

The timer expired with no comments. I'm marking this case as
closed approved.

Shudong


