From gd78059@sac.sfbay.sun.com Sat Jun  2 15:04:13 2007
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 l52M4DkO029123
	for <psarc-ext@sac.sfbay.sun.com>; Sat, 2 Jun 2007 15:04:13 -0700 (PDT)
Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6])
	by sunmail3mpk.sfbay.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id l52M2nGJ000230;
	Sat, 2 Jun 2007 15:02:50 -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 <0JJ10080F3WP5I00@nwk-avmta-2.sfbay.sun.com>; Sat,
 02 Jun 2007 15:02:49 -0700 (PDT)
Received: from sfbaymail2sca.sfbay.sun.com ([129.145.155.42])
 by nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0JJ100FX03WIRK80@nwk-avmta-2.sfbay.sun.com>; Sat,
 02 Jun 2007 15:02:42 -0700 (PDT)
Received: from sac.sfbay.sun.com (sac.SFBay.Sun.COM [129.146.226.132])
	by sfbaymail2sca.sfbay.sun.com (8.13.6+Sun/8.12.10/ENSMAIL,v2.2)
 with ESMTP id l52M2gCe017592; Sat, 02 Jun 2007 15:02:42 -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 l52M443V029118; Sat,
 02 Jun 2007 15:04:04 -0700 (PDT)
Received: (from gd78059@localhost)
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8/Submit) id l52M44Px029114; Sat,
 02 Jun 2007 15:04:04 -0700 (PDT)
Date: Sat, 02 Jun 2007 15:04:04 -0700 (PDT)
From: "Garrett D'Amore - sun microsystems" <gd78059@sac.sfbay.sun.com>
Subject: EOF of SUNWhmdu and hme ioctls [PSARC/2007/325 Self Review]
To: PSARC-ext@sun.com
Message-id: <200706022204.l52M44Px029114@sac.sfbay.sun.com>
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.2.0.264296
Status: RO
Content-Length: 1747


Template Version: @(#)sac_nextcase 1.61 05/24/07 SMI
This information is Copyright 2007 Sun Microsystems
1. Introduction
    1.1. Project/Component Working Name:
	 EOF of SUNWhmdu and hme ioctls
    1.2. Name of Document Author/Supplier:
	 Author:  Garrett D'Amore
    1.3  Date of This Document:
	02 June, 2007
4. Technical Description
PROBLEM
-------

The SUNWhmdu package contains header files that are used exclusively by the
fas and hme kernel drivers.  There is only one API for userland programs that
is supplied by this, which is both undocumented and, as far as we call tell,
not used anywhere else.  We are unaware of any cases where it has ever been
used outside of NSN engineering.

SOLUTION
--------

The ioctls in question, HME_IOC_GET_SPEED, and HME_IOC_SET_SPEED, are
undocumented, and not used anywhere else.  Additionally, much richer
link configuration support is available in the form of NDD tunables (and
we hope that by making this a GLDv3 driver, it will benefit from the
Brussels link administration project which is currently a work in progress.)

We want to remove support for these ioctls as part of the work that we are
doing for PSARC 2007/319 (the conversion of hme to GLDv3.)  

While here, we notice that the SUNWhmdu package which delivers the hme headers
also delivers some headers for the "fas" SCSI driver.  Nothing in those
headers is useful to userland, or indeed outside ouf the fas driver itself.

We intend therefore to remove the SUNWhmdu package altogether, as it provides
no value and only wastes disk space on the systems where it is installed.

6. Resources and Schedule
    6.4. Steering Committee requested information
   	6.4.1. Consolidation C-team Name:
		ON
    6.5. ARC review type: Automatic

