From sacadmin Thu Jan 15 16:07:48 2009
Received: from tethys.sfbay.sun.com (tethys.SFBay.Sun.COM [129.146.226.92])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n0G07mkR022629;
	Thu, 15 Jan 2009 16:07:48 -0800 (PST)
Received: from tethys.sfbay.sun.com (localhost [127.0.0.1])
	by tethys.sfbay.sun.com (8.14.3+Sun/8.14.3) with ESMTP id n0G02Xm9003041;
	Thu, 15 Jan 2009 16:02:33 -0800 (PST)
Received: (from jg@localhost)
	by tethys.sfbay.sun.com (8.14.3+Sun/8.14.3/Submit) id n0G02XPo003037;
	Thu, 15 Jan 2009 16:02:33 -0800 (PST)
Date: Thu, 15 Jan 2009 16:02:33 -0800 (PST)
From: Jerry Gilliam <jg@tethys.sfbay.sun.com>
Message-Id: <200901160002.n0G02XPo003037@tethys.sfbay.sun.com>
To: PSARC-record@sac.sfbay.sun.com
Subject: update_drv(1M) -n option [PSARC/2009/031 FastTrack timeout 01/15/2009]
Status: RO
Content-Length: 555


Template Version: @(#)sac_nextcase %I% %G% SMI
This information is Copyright 2009 Sun Microsystems
1. Introduction
    1.1. Project/Component Working Name:
	 update_drv(1M) -n option
    1.2. Name of Document Author/Supplier:
	 Author:  Jerry Gilliam
    1.3  Date of This Document:
	15 January, 2009
4. Technical Description
    See the case directory for more detail

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 jg@jurassic.sfbay.Sun.COM Thu Jan 15 18:21:10 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 n0G2L9cA010120
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 15 Jan 2009 18:21:10 -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.2) with ESMTP id n0G2L66T042486;
	Thu, 15 Jan 2009 19:21:08 -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 <0KDJ00K1ZL784W00@nwk-avmta-1.sfbay.Sun.COM>; Thu,
 15 Jan 2009 18:21:08 -0800 (PST)
Received: from jurassic.eng.sun.com ([129.146.226.31])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KDJ00ESAL77DHB0@nwk-avmta-1.sfbay.Sun.COM>; Thu,
 15 Jan 2009 18:21:07 -0800 (PST)
Received: from tethys (tethys.SFBay.Sun.COM [129.146.226.92])
	by jurassic.eng.sun.com (8.13.8+Sun/8.13.8) with SMTP id n0G2L6Gg200548; Thu,
 15 Jan 2009 18:21:06 -0800 (PST)
Date: Thu, 15 Jan 2009 18:15:52 -0800 (PST)
From: Jerry Gilliam <jg@jurassic.sfbay.Sun.COM>
Subject: update_drv(1M) -n option [PSARC/2009/031 Self Review]
To: PSARC-ext@sun.com
Reply-to: Jerry Gilliam <jg@jurassic.sfbay.Sun.COM>
Message-id: <200901160221.n0G2L6Gg200548@jurassic.eng.sun.com>
MIME-version: 1.0
X-Mailer: dtmail 1.3.0 @(#)CDE Version 1.7_98 SunOS 5.11 sun4u sparc
Content-type: TEXT/plain; charset=us-ascii
Content-transfer-encoding: 7BIT
Content-MD5: QbfRI7jbHaqqN1R67PggBw==
X-PMX-Version: 5.4.1.325704
Status: RO
Content-Length: 1709


I am submitting the following self-review case,
with requested release binding of minor.


Problem
-------

The add_drv(1M) command to add a device driver to the system
provides a '-n' option to modify the various binding files only,
without causing the driver to be loaded and configured on the
running system.

Developers have requested that update_drv(1M) and rem_drv(1M)
also support this occasionally useful ability.


Proposal
--------

Add support for the '-n' argument to update_drv(1M) and rem_drv(1M),
to modify a system's binding files without communicating the
change to the running kernel.

Man page changes included.


NAME
     update_drv - modify device driver attributes

SYNOPSIS
+     update_drv [-f | -v] [-n] driver_module


+     update_drv [-b basedir] [-f | -v] [-n] -a [-m 'permission']
          [-i 'identify-name'] [-P 'privilege'] [-p 'policy'] driver_module


+     update_drv [-b basedir] [-f | -v] [-n] -d [-m 'permission']
          [-i 'identify-name'] [-P 'privilege'] [-p 'policy'] driver_module


OPTIONS
     The following options are supported:

	<....

+     -n                      Do  not  try  to  load  and   attach
+                             device_driver,  just modify the sys-
+                             tem  configuration  files  for   the
+                             device_driver.
+



NAME
     rem_drv - remove a device driver from the system

SYNOPSIS
+     rem_drv [-b basedir] [-n] device_driver

+     -n                      Do  not  try  to  detach and unload
+                             device_driver,  just modify the sys-
+                             tem  configuration  files  for   the
+                             device_driver.
+


From Mark.J.Nelson@sun.com Thu Jan 15 21:51:25 2009
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 n0G5pOGq029895
	for <psarc-ext@sac.sfbay.Sun.COM>; Thu, 15 Jan 2009 21:51:24 -0800 (PST)
Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6])
	by sunmail4.singapore.sun.com (8.13.4+Sun/8.13.3/ENSMAIL,v2.2) with ESMTP id n0G5pCq4018342
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Fri, 16 Jan 2009 13:51:23 +0800 (SGT)
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 <0KDJ00I03UXKP200@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Thu, 15 Jan 2009 21:51:20 -0800 (PST)
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 <0KDJ00FEXUXKQL20@nwk-avmta-2.sfbay.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu,
 15 Jan 2009 21:51:20 -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 n0G5pJov011726	for
 <PSARC-ext@sun.com>; Fri, 16 Jan 2009 05:51:19 +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 <0KDJ00G01UW51T00@mail-amer.sun.com>
 (original mail from Mark.J.Nelson@Sun.COM)
 for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu,
 15 Jan 2009 22:51:19 -0700 (MST)
Received: from [10.0.1.192] ([71.141.104.88])
 by mail-amer.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28
 2007)) with ESMTPSA id <0KDJ005QQUXEACE0@mail-amer.sun.com>; Thu,
 15 Jan 2009 22:51:15 -0700 (MST)
Date: Thu, 15 Jan 2009 22:51:14 -0700
From: "Mark J. Nelson" <Mark.J.Nelson@sun.com>
Subject: Re: update_drv(1M) -n option [PSARC/2009/031 Self Review]
In-reply-to: <200901160221.n0G2L6Gg200548@jurassic.eng.sun.com>
Sender: Mark.J.Nelson@sun.com
To: Jerry Gilliam <jg@jurassic.sfbay.Sun.COM>
Cc: PSARC-ext@sun.com
Message-id: <49702052.4030700@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: <200901160221.n0G2L6Gg200548@jurassic.eng.sun.com>
User-Agent: Thunderbird 2.0.0.18 (X11/20081203)
Status: RO
Content-Length: 2229

Jerry Gilliam wrote:
> I am submitting the following self-review case,
> with requested release binding of minor.

Perhaps, with IPS being the way of the future, it might not matter. 
But: shouldn't this be patch binding?  Ie it will be unusable in svr4 
packaging scripts unless it is backported, because the patch delivering 
this change will be required for liveupgrade?

Isn't this behavior already accomplished (perhaps unintentionally) by 
specifying "-b /" as a basedir?

--Mark

> Problem
> -------
> 
> The add_drv(1M) command to add a device driver to the system
> provides a '-n' option to modify the various binding files only,
> without causing the driver to be loaded and configured on the
> running system.
> 
> Developers have requested that update_drv(1M) and rem_drv(1M)
> also support this occasionally useful ability.
> 
> 
> Proposal
> --------
> 
> Add support for the '-n' argument to update_drv(1M) and rem_drv(1M),
> to modify a system's binding files without communicating the
> change to the running kernel.
> 
> Man page changes included.
> 
> 
> NAME
>      update_drv - modify device driver attributes
> 
> SYNOPSIS
> +     update_drv [-f | -v] [-n] driver_module
> 
> 
> +     update_drv [-b basedir] [-f | -v] [-n] -a [-m 'permission']
>           [-i 'identify-name'] [-P 'privilege'] [-p 'policy'] driver_module
> 
> 
> +     update_drv [-b basedir] [-f | -v] [-n] -d [-m 'permission']
>           [-i 'identify-name'] [-P 'privilege'] [-p 'policy'] driver_module
> 
> 
> OPTIONS
>      The following options are supported:
> 
> 	<....
> 
> +     -n                      Do  not  try  to  load  and   attach
> +                             device_driver,  just modify the sys-
> +                             tem  configuration  files  for   the
> +                             device_driver.
> +
> 
> 
> 
> NAME
>      rem_drv - remove a device driver from the system
> 
> SYNOPSIS
> +     rem_drv [-b basedir] [-n] device_driver
> 
> +     -n                      Do  not  try  to  detach and unload
> +                             device_driver,  just modify the sys-
> +                             tem  configuration  files  for   the
> +                             device_driver.
> +
> 


From jg@jurassic.sfbay.Sun.COM Fri Jan 16 13:23:33 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 n0GLNXd4026525
	for <psarc-ext@sac.sfbay.sun.com>; Fri, 16 Jan 2009 13:23:33 -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.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id n0GLNWpE024284;
	Fri, 16 Jan 2009 13:23:33 -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 <0KDL00I05237CV00@brm-avmta-1.central.sun.com>; Fri,
 16 Jan 2009 14:23:31 -0700 (MST)
Received: from jurassic.eng.sun.com ([129.146.56.36])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KDL00DCD236MX30@brm-avmta-1.central.sun.com>; Fri,
 16 Jan 2009 14:23:30 -0700 (MST)
Received: from tethys (tethys.SFBay.Sun.COM [129.146.226.92])
	by jurassic.eng.sun.com (8.13.8+Sun/8.13.8) with SMTP id n0GLNURf227092; Fri,
 16 Jan 2009 13:23:30 -0800 (PST)
Date: Fri, 16 Jan 2009 13:18:15 -0800 (PST)
From: Jerry Gilliam <jg@jurassic.sfbay.Sun.COM>
Subject: Re: update_drv(1M) -n option [PSARC/2009/031 Self Review]
To: Mark.J.Nelson@sun.com
Cc: PSARC-ext@sun.com
Reply-to: Jerry Gilliam <jg@jurassic.sfbay.Sun.COM>
Message-id: <200901162123.n0GLNURf227092@jurassic.eng.sun.com>
MIME-version: 1.0
X-Mailer: dtmail 1.3.0 @(#)CDE Version 1.7_98 SunOS 5.11 sun4u sparc
Content-type: TEXT/plain; charset=us-ascii
Content-transfer-encoding: 7BIT
Content-MD5: ZkkAjm/VgA3U3rkNsVPatQ==
X-PMX-Version: 5.4.1.325704
Status: RO
Content-Length: 1150


Mark,

>
>> I am submitting the following self-review case,
>> with requested release binding of minor.
>
>Perhaps, with IPS being the way of the future, it might not matter. 
>But: shouldn't this be patch binding?  Ie it will be unusable in svr4 
>packaging scripts unless it is backported, because the patch delivering 
>this change will be required for liveupgrade?
>

No packaging script need use this option.  Packaging should
continue specifying -b <altroot> as before.  -n is really intended
as a useful option for developers working a driver or testing.

There's no technical reason this couldn't be given patch binding
though.

>
>Isn't this behavior already accomplished (perhaps unintentionally) by 
>specifying "-b /" as a basedir?
>

Actually, no, '-b /' is special-cased in the code specifically
to communicate the change to the kernel.  This was done so that
scripts could simply use '-b /$BASEDIR' to always get the
correct behavior, without needing to test is it this, is it
that.  (Not that many scripts have been updated accordingly,
older releases may not have the updates yet, and the man page
still documents the hack.)


-jg


