From sacadmin Wed Aug  6 14:30:34 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 m76LUXEx027931
	for <psarc@sac.eng.Sun.COM>; Wed, 6 Aug 2008 14:30:34 -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 m76LUUcP023430
	for <@sunmail2sca.sfbay.sun.com:psarc@sun.com>; Thu, 7 Aug 2008 05:30:32 +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 <0K5700K017QUNG00@brm-avmta-1.central.sun.com> for psarc@sun.com
 (ORCPT psarc@Sun.COM); Wed, 06 Aug 2008 15:30:30 -0600 (MDT)
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 <0K5700B3L7QT3570@brm-avmta-1.central.sun.com> for psarc@sun.com
 (ORCPT psarc@Sun.COM); Wed, 06 Aug 2008 15:30:29 -0600 (MDT)
Received: from fe-amer-10.sun.com ([192.18.109.80])
	by brmea-mail-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id m76LUTPC020560	for
 <psarc@Sun.COM>; Wed, 06 Aug 2008 21:30:29 +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 <0K570070172O0I00@mail-amer.sun.com> (original mail from Aarti.Pai@Sun.COM)
 for psarc@Sun.COM (ORCPT psarc@Sun.COM); Wed, 06 Aug 2008 15:30:29 -0600 (MDT)
Received: from [129.145.154.105] by mail-amer.sun.com
 (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007))
 with ESMTPSA id <0K57003717QKYT40@mail-amer.sun.com> for psarc@Sun.COM
 (ORCPT psarc@Sun.COM); Wed, 06 Aug 2008 15:30:21 -0600 (MDT)
Date: Wed, 06 Aug 2008 14:30:20 -0700
From: Aarti Pai <Aarti.Pai@sun.com>
Subject: Materials for NWAM Phase 0.5 (picea) (2008/482)
Sender: Aarti.Pai@sun.com
To: psarc@sun.com
Cc: Darren Kenny <Darren.Kenny@sun.com>
Reply-to: Aarti.Pai@sun.com
Message-id: <489A17EC.6010000@Sun.COM>
MIME-version: 1.0
Content-type: multipart/alternative;
 boundary="Boundary_(ID_GhnsfJ9MlNmeOLvTujKQfA)"
X-PMX-Version: 5.4.1.325704
User-Agent: Thunderbird 2.0.0.12 (X11/20080228)
Status: RO
Content-Length: 1463

This is a multi-part message in MIME format.

--Boundary_(ID_GhnsfJ9MlNmeOLvTujKQfA)
Content-type: text/plain; format=flowed; charset=ISO-8859-1
Content-transfer-encoding: 7BIT

NOTE: This inception review is on next week's 8/13 PSARC Agenda.

sac% pwd
/shared/sac/Archives/CaseLog/arc/PSARC/2008/482
sac% ls -l inception.materials
total 235
-rw-r--r--   1 carlsonj sac        10787 Aug  6 13:30 nwam-ui.html
-rw-r--r--   1 carlsonj sac        18279 Aug  6 14:06 picea-20q.txt
-rw-r--r--   1 carlsonj sac        88322 Aug  6 13:31 picea-on-design.pdf

Aarti


--Boundary_(ID_GhnsfJ9MlNmeOLvTujKQfA)
Content-type: text/html; charset=ISO-8859-1
Content-transfer-encoding: 7BIT

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
</head>
<body bgcolor="#ffffff" text="#000000">
<font size="-1">NOTE: This inception review is on next week's 8/13
PSARC Agenda.<br>
<br>
sac% pwd<br>
/shared/sac/Archives/CaseLog/arc/PSARC/2008/482<br>
sac% ls -l inception.materials<br>
total 235<br>
-rw-r--r--&nbsp;&nbsp; 1 carlsonj sac&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 10787 Aug&nbsp; 6 13:30 nwam-ui.html<br>
-rw-r--r--&nbsp;&nbsp; 1 carlsonj sac&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 18279 Aug&nbsp; 6 14:06 picea-20q.txt<br>
-rw-r--r--&nbsp;&nbsp; 1 carlsonj sac&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 88322 Aug&nbsp; 6 13:31
picea-on-design.pdf<br>
<br>
Aarti<br>
<br>
</font>
</body>
</html>

--Boundary_(ID_GhnsfJ9MlNmeOLvTujKQfA)--

From sac-owner Wed Aug 13 12:33:57 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 m7DJXu0V013648
	for <all-arcs@sac.sfbay.sun.com>; Wed, 13 Aug 2008 12:33:57 -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 m7DJXOtw022607
	for <@sunmail2sca.sfbay.sun.com:All-ARCs@sun.com>; Thu, 14 Aug 2008 03:33:55 +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 <0K5K00N0110H3V00@nwk-avmta-1.sfbay.Sun.COM> for All-ARCs@sun.com
 (ORCPT All-ARCs@sun.com); Wed, 13 Aug 2008 12:33:53 -0700 (PDT)
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 <0K5K00DOR10GZ3B0@nwk-avmta-1.sfbay.Sun.COM> for
 All-ARCs@sun.com (ORCPT All-ARCs@sun.com); Wed,
 13 Aug 2008 12:33:53 -0700 (PDT)
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 m7DJXqxV011350	for
 <All-ARCs@sun.com>; Wed, 13 Aug 2008 19:33:52 +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 <0K5J00C01YR92500@mail-amer.sun.com> (original mail from Aarti.Pai@Sun.COM)
 for All-ARCs@sun.com (ORCPT All-ARCs@sun.com); Wed,
 13 Aug 2008 13:33:52 -0600 (MDT)
Received: from [129.150.34.247] by mail-amer.sun.com
 (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007))
 with ESMTPSA id <0K5K00EIX10BWYC0@mail-amer.sun.com> for All-ARCs@sun.com
 (ORCPT All-ARCs@sun.com); Wed, 13 Aug 2008 13:33:48 -0600 (MDT)
Date: Wed, 13 Aug 2008 12:33:48 -0700
From: Aarti Pai <Aarti.Pai@sun.com>
Subject: PSARC Approved NWAM Phase 0.5 (picea) (2008/482)
Sender: Aarti.Pai@sun.com
To: Aarti.Pai@sun.com
Message-id: <48A3371C.70204@Sun.com>
MIME-version: 1.0
Content-type: multipart/alternative;
 boundary="Boundary_(ID_Sxf3YGeW9q1BG9lTiIheUA)"
X-PMX-Version: 5.4.1.325704
User-Agent: Thunderbird 2.0.0.9 (Windows/20071031)
Status: RO
Content-Length: 1022

This is a multi-part message in MIME format.

--Boundary_(ID_Sxf3YGeW9q1BG9lTiIheUA)
Content-type: text/plain; format=flowed; charset=ISO-8859-1
Content-transfer-encoding: 7BIT

PSARC approved on 08/13/2008:

  Case:     NWAM Phase 0.5 (picea) (2008/482 
<http://sac.eng/arc/PSARC/2008/482/>)
  Incompatible Changes: none
  Precedent: none

If more information is needed, please contact the case owner/intern.

--Boundary_(ID_Sxf3YGeW9q1BG9lTiIheUA)
Content-type: text/html; charset=ISO-8859-1
Content-transfer-encoding: 7BIT

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
</head>
<body bgcolor="#ffffff" text="#000000">
PSARC approved on 08/13/2008:
<br>
<br>
&nbsp; Case:&nbsp;&nbsp;&nbsp;&nbsp; NWAM Phase 0.5 (picea) (<a
 href="http://sac.eng/arc/PSARC/2008/482/">2008/482</a>)<br>
&nbsp; Incompatible Changes: none
<br>
&nbsp; Precedent: none
<br>
<br>
If more information is needed, please contact the case owner/intern.
<br>
</body>
</html>

--Boundary_(ID_Sxf3YGeW9q1BG9lTiIheUA)--

From sacadmin Wed Aug 13 13:41:00 2008
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 m7DKf0A7016724
	for <psarc@sac.eng.sun.com>; Wed, 13 Aug 2008 13:41:00 -0700 (PDT)
Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74])
	by sunmail2sca.sfbay.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id m7DKf08i026022
	for <@sunmail2sca.sfbay.sun.com:psarc@sun.com>; Wed, 13 Aug 2008 13:41:00 -0700 (PDT)
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 <0K5K0070L44BK000@nwk-avmta-1.sfbay.Sun.COM> for psarc@sun.com
 (ORCPT psarc@sun.com); Wed, 13 Aug 2008 13:40:59 -0700 (PDT)
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 <0K5K004FM44BWK50@nwk-avmta-1.sfbay.Sun.COM> for psarc@sun.com
 (ORCPT psarc@sun.com); Wed, 13 Aug 2008 13:40:59 -0700 (PDT)
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 m7DKexNq010230	for
 <psarc@sun.com>; Wed, 13 Aug 2008 20:40:59 +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 <0K5K00K013SQYD00@mail-amer.sun.com> (original mail from Aarti.Pai@Sun.COM)
 for psarc@sun.com (ORCPT psarc@sun.com); Wed, 13 Aug 2008 14:40:59 -0600 (MDT)
Received: from [129.150.34.247] by mail-amer.sun.com
 (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007))
 with ESMTPSA id <0K5K00BW944AA6B0@mail-amer.sun.com> for psarc@sun.com
 (ORCPT psarc@sun.com); Wed, 13 Aug 2008 14:40:59 -0600 (MDT)
Date: Wed, 13 Aug 2008 13:40:57 -0700
From: Aarti Pai <Aarti.Pai@sun.com>
Subject: Meeting Minutes for PSARC - 08/13/2008  [2008/482]
Sender: Aarti.Pai@sun.com
To: psarc@sun.com
Cc: Darren.Kenny@sun.com
Reply-to: Aarti.Pai@sun.com
Message-id: <48A346D9.5030708@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
User-Agent: Thunderbird 2.0.0.9 (Windows/20071031)
Status: RO
Content-Length: 607

Minutes/Audio for PSARC - 08/13/2008 are now available:

- Open Arc Business:  
http://sac.sfbay/Archives/Minutes/PSARC/2008/20080813.arcbiz.open
    Open Audio:  
http://sac.sfbay/Archives/Minutes/PSARC/2008/20080813.arcbiz.open.mp3

- Open Inception Case  NWAM Phase 0.5 (picea) (2008/482 
<http://sac.eng/arc/PSARC/2008/482/>)
     Minutes: 
http://sac.sfbay/Archives/Minutes/PSARC/2008/20080813.2008.482.inception
    Audio:  
http://sac.sfbay/Archives/Minutes/PSARC/2008/20080813.2008.482.inception.mp3

Please contact me directly if you require any corrections/modifications
to these minutes.

Aarti


From John.Fischer@sun.com Wed Aug 20 11:50:05 2008
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 m7KIo5Jf025872
	for <psarc-ext@sac.sfbay.sun.com>; Wed, 20 Aug 2008 11:50:05 -0700 (PDT)
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.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id m7KIo3XS029916
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Wed, 20 Aug 2008 11:50:05 -0700 (PDT)
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 <0K5W00F0BXNGBS00@brm-avmta-1.central.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Wed, 20 Aug 2008 12:50:04 -0600 (MDT)
Received: from brmea-mail-2.sun.com ([192.18.98.43])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0K5W00822XNF9O60@brm-avmta-1.central.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Wed,
 20 Aug 2008 12:50:03 -0600 (MDT)
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 m7KIo36i002759	for
 <PSARC-ext@sun.com>; Wed, 20 Aug 2008 18:50:03 +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 <0K5W00B01UTXY800@mail-amer.sun.com>
 (original mail from John.Fischer@Sun.COM)
 for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Wed,
 20 Aug 2008 12:50:03 -0600 (MDT)
Received: from 129.145.154.66 ([129.145.154.66])
 by mail-amer.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28
 2007)) with ESMTPSA id <0K5W00GTQXN5ZH60@mail-amer.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Wed,
 20 Aug 2008 12:49:54 -0600 (MDT)
Date: Wed, 20 Aug 2008 11:49:53 -0700
From: John Fischer <John.Fischer@sun.com>
Subject: /PSARC/2008/482 - NWAM Phase 0.5 (picea)
Sender: John.Fischer@sun.com
To: PSARC-ext@sun.com
Cc: John Fischer <John.Fischer@sun.com>, Darren.Kenny@sun.com
Reply-to: John.Fischer@sun.com
Message-id: <1219258192.9503.76.camel@sr1-umpk-16>
MIME-version: 1.0
X-Mailer: Ximian Evolution 1.4.6.301
Content-type: multipart/mixed; boundary="Boundary_(ID_4n74N7NcD92x4lgCVTAGtA)"
X-PMX-Version: 5.4.1.325704
Status: RO
Content-Length: 7512


--Boundary_(ID_4n74N7NcD92x4lgCVTAGtA)
Content-type: text/plain; charset=ASCII
Content-transfer-encoding: 7BIT

All,

Here is the draft opinion for the NWAM case that
was reviewed last week.  The case directory contains
the attached text version and an nroff version.
Feedback welcomed.

Thanks,

John



--Boundary_(ID_4n74N7NcD92x4lgCVTAGtA)
Content-type: text/plain; charset=ASCII; name=draft-opinion.txt
Content-transfer-encoding: 7BIT
Content-disposition: attachment; filename=draft-opinion.txt


 sun microsystems              System Architecture Committee
________________________________________________________________
Subject:       NWAM Phase 0.5 (picea)

Submitted by:  Darren Kenny

File:          PSARC/2008/482/opinion.ms

Date:          August 13th, 2008

Committee:     John Fischer, Kais Belgaied, James  D.  Carl-
               son, Glenn Skinner, Gary Winiger.

Product Approval Committee:

               Solaris PAC
               solaris-pac@sun.com

1.  Summary

NWAM Phase 0.5 (picea) separates out the GUI from  the  NWAM
daemon.   This  will  allow the users to better observe what
the NWAM daemon is doing thus  giving  them  better  control
over what is taking place.

2.  Decision & Precedence Information

The project is approved as specified in references [1],  [2]
& [3].

The project may be delivered in a Minor release of Solaris.

3.  Interfaces

The project exports the following interfaces.

__________________________________________________________________
                       Interfaces Exported
__________________________________________________________________
 Interface                     Classification    Comments
__________________________________________________________________
 NWAM Manager                  Uncommitted       New
                                                 control/status
                                                 GUI
 libnwam.so.1                  Project Private   Wrapper  library
                                                 for GUI
 SUNWnwamintr, SUNWnwamintu    Project Private   Internal-only
                                                 packages
 libnwam.h                     Project Private   Library   header
                                                 file
 /var/nwam/door                Project Private   
 "priority"                    Uncommitted       New 
                                                 /etc/nwam/llp
                                                 keyword
 /usr/lib/nwam-manager         Uncommitted       User   Interface
                                                 Daemon
 /usr/share/nwam-manager       Project Private   Project   Icons,
                                                 etc.
 /usr/share/gnome/autostart/   Uncommitted       GNOME  Autostart
     nwam-manager.desktop                        Launcher
 SUNWgnome-nwam-manager        Uncommitted       End User package
 SUNWgnome-nwam-manager-root   Uncommitted       Root package
__________________________________________________________________

The project imports the following interfaces.

___________________________________________________
                Interfaces Imported
___________________________________________________
 Interface         Classification   Comments
___________________________________________________

 Defining Works-   Committed        PSARC/2008/034
 tation    Owner
 Infrastructure
___________________________________________________

4.  Opinion


4.1.  libnwam_{open|close}_door() Function Name

The choice of the name of the interface is  too  tied  to  a
particular choice of an IPC.  The purpose of these two func-
tions seem to initialize/dismantle a context for the calling
process  used for subsequent communications with nwamd.  The
committee suggested that the project  team  remove  the  IPC
name  from  the  function name.  The project team agreed and
has updated the design document [2].

4.2.  libnwam_set_llp_priority() Function

The parameter prio is declared as a signed int.  This  would
allow  for  a  negative  value being passed to the function.
The committee asked if there was  any  significance  to  the
value  being  negative.   The project team stated that there
are no negative priorities.  The committee suggest that  the
defined  type for the variable be changed to an unsigned int
or that errors be defined. The committee also noted that the
function  can return either ENOENT or ENXIO stating that the
later was more appropriate.   The  project  team  agreed  to
define errors and has updated the design document [2].

4.3.  User Interface

The committee noted that unless the end  user  was  familiar
with NWAM and Gnome it might be difficult for them to under-
stand what they are seeing in the User Interface.  The  com-
mittee  suggested  that  the  new interface be clearly docu-
mented.  This issue resulted in Advisory information.

4.4.  Authorization

This project  introduces  a  new  authorization  in  Network
Management Rights Profile.  However, it was not clear if the
console user would inherit the new authorization.  The  pro-
ject team stated that the console user would inherit the new
authorization.  The specification  also  was  not  clear  on
which  events required authorization.  The project team made
it clear that all the events require the new  authorization.
The project team will update the design document [2] to make
the authorization more clear.  The committee was  fine  with
this issue.

4.5.  Solaris Audit records

The design document seems to imply that there is no auditing
taking  place  when  authorization  is  granted and does not
describe why this is okay.  The project team stated that  in
NWAM Phase 1.0 there will be auditing.  However, the specif-
ication for what will be recorded has not been defined  yet.
Because the Phase 1 solution is not yet known in detail, and
the auditing events it will need are not known, this project
team  was  not planning to implement auditing in this phase.
The project team should consider implementing Solaris Audit-
ing records when authorizations are granted.

4.6.  Other Window Managers

The committee noted that the design seems to be  Gnome  cen-
tric  and  was  concerned about the user not having the same
feedback  in  other  Window  Mangers  like  the  KDE  window
manager.   The  project  team pointed out that the mechanism
being used is part of  the  Free  Desktop  Foundation  which
Gnome, KDE and XFE conform with.  In the event that the Win-
dow Manager does not conform with the Free  Desktop  Founda-
tion specification then the user feedback will appear within
a window on the desktop.  The committee was fine  with  this
issue.

5.  Minority Opinion(s)

None

6.  Advisory Information

It would be very beneficial for the user if the User  Inter-
face is clearly documented.

7.  Appendices

7.1.  Appendix A: Technical Changes Required

None

7.2.  Appendix B: Technical Changes Advised

1.   Auditing should be added to the daemon when  authoriza-
     tion is granted.

7.3.  Appendix C: Reference Material

Unless stated otherwise, path names are relative to the case
directory PSARC/2008/482.

1.   PSARC      20      Questions      document.       File:
     final.materials/picea-20q.txt

2.   Final      PICEA      Design      document.       File:
     final.materials/picea-on-design.pdf

3.   NWAM   User   Interface   Design    document.     File:
     final.materials/nwam-ui.html

--Boundary_(ID_4n74N7NcD92x4lgCVTAGtA)--

From John.Fischer@sun.com Wed Aug 27 10:14:15 2008
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 m7RHEFVJ014804
	for <psarc-ext@sac.sfbay.sun.com>; Wed, 27 Aug 2008 10:14:15 -0700 (PDT)
Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74])
	by sunmail2sca.sfbay.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id m7RHEEvC000344
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Wed, 27 Aug 2008 10:14:15 -0700 (PDT)
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 <0K6900313RVOUO00@nwk-avmta-1.sfbay.Sun.COM> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Wed, 27 Aug 2008 10:14:12 -0700 (PDT)
Received: from brmea-mail-1.sun.com ([192.18.98.31])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0K6900D57RVA3AA0@nwk-avmta-1.sfbay.Sun.COM> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Wed,
 27 Aug 2008 10:13:58 -0700 (PDT)
Received: from fe-amer-10.sun.com ([192.18.109.80])
	by brmea-mail-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id m7RHDvlb014998	for
 <PSARC-ext@sun.com>; Wed, 27 Aug 2008 17:13:57 +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 <0K6900601QD81I00@mail-amer.sun.com>
 (original mail from John.Fischer@Sun.COM)
 for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Wed,
 27 Aug 2008 11:13:57 -0600 (MDT)
Received: from 129.145.154.66 ([129.145.154.66])
 by mail-amer.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28
 2007)) with ESMTPSA id <0K69006PMRV02550@mail-amer.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Wed,
 27 Aug 2008 11:13:49 -0600 (MDT)
Date: Wed, 27 Aug 2008 10:13:48 -0700
From: John Fischer <John.Fischer@sun.com>
Subject: Re: /PSARC/2008/482 - NWAM Phase 0.5 (picea)
In-reply-to: <1219258192.9503.76.camel@sr1-umpk-16>
Sender: John.Fischer@sun.com
To: PSARC-ext@sun.com
Cc: John Fischer <John.Fischer@sun.com>, Darren.Kenny@sun.com
Reply-to: John.Fischer@sun.com
Message-id: <1219857228.51279.139.camel@sr1-umpk-16>
MIME-version: 1.0
X-Mailer: Ximian Evolution 1.4.6.301
Content-type: text/plain
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
References: <1219258192.9503.76.camel@sr1-umpk-16>
Status: RO
Content-Length: 388

All,

Having received no comment on this opinion and a week
has passed I am going to forward this to SAC.

Thanks,

John

On Wed, 2008-08-20 at 11:49, John Fischer wrote:
> All,
> 
> Here is the draft opinion for the NWAM case that
> was reviewed last week.  The case directory contains
> the attached text version and an nroff version.
> Feedback welcomed.
> 
> Thanks,
> 
> John
> 
> 


From carlsonj@phorcys.east.sun.com Wed Aug 27 10:23:18 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 m7RHNHH5015294
	for <psarc-ext@sac.sfbay.sun.com>; Wed, 27 Aug 2008 10:23:18 -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 m7RHNBPS015829;
	Wed, 27 Aug 2008 18:23:15 +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 <0K6900E0VSAQNY00@nwk-avmta-2.sfbay.sun.com>; Wed,
 27 Aug 2008 10:23:14 -0700 (PDT)
Received: from phorcys.east.sun.com ([129.148.174.143])
 by nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0K6900DO0SAQB320@nwk-avmta-2.sfbay.sun.com>; Wed,
 27 Aug 2008 10:23:14 -0700 (PDT)
Received: from phorcys.east.sun.com (localhost [127.0.0.1])
	by phorcys.east.sun.com (8.14.3+Sun/8.14.3) with ESMTP id m7RHNEp2002905; Wed,
 27 Aug 2008 13:23:14 -0400 (EDT)
Received: (from carlsonj@localhost)
	by phorcys.east.sun.com (8.14.3+Sun/8.14.3/Submit) id m7RHNE64002902; Wed,
 27 Aug 2008 13:23:14 -0400 (EDT)
Date: Wed, 27 Aug 2008 13:23:14 -0400
From: James Carlson <james.d.carlson@sun.com>
Subject: Re: /PSARC/2008/482 - NWAM Phase 0.5 (picea)
In-reply-to: <1219857228.51279.139.camel@sr1-umpk-16>
To: John.Fischer@sun.com
Cc: PSARC-ext@sun.com, Darren.Kenny@sun.com
Message-id: <18613.36226.141840.46524@gargle.gargle.HOWL>
MIME-version: 1.0
X-Mailer: VM 7.01 under Emacs 21.3.1
Content-type: text/plain; charset=us-ascii
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
References: <1219258192.9503.76.camel@sr1-umpk-16>
 <1219857228.51279.139.camel@sr1-umpk-16>
Status: RO
Content-Length: 586

John Fischer writes:
> Having received no comment on this opinion and a week
> has passed I am going to forward this to SAC.

There are two contracts on the way.  I don't think they affect much
(one for use of libbsm and the other between the GUI and ON teams
within the project), but as a procedural bit, I think they should be
there before the case is closed.

-- 
James Carlson, Solaris Networking              <james.d.carlson@sun.com>
Sun Microsystems / 35 Network Drive        71.232W   Vox +1 781 442 2084
MS UBUR02-212 / Burlington MA 01803-2757   42.496N   Fax +1 781 442 1677

From johnf@sr1-umpk-16.sfbay.sun.com Wed Aug 27 10:25:51 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 m7RHPpke015374
	for <psarc-ext@sac.sfbay.sun.com>; Wed, 27 Aug 2008 10:25:51 -0700 (PDT)
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 m7RHPihh016867
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Wed, 27 Aug 2008 18:25:50 +0100 (BST)
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 <0K6900503SF01K00@nwk-avmta-1.sfbay.Sun.COM> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Wed, 27 Aug 2008 10:25:48 -0700 (PDT)
Received: from dm-sfbay-02.sfbay.sun.com ([129.146.11.31])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0K6900DDXSF03AA0@nwk-avmta-1.sfbay.Sun.COM> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Wed,
 27 Aug 2008 10:25:48 -0700 (PDT)
Received: from sr1-umpk-16.sfbay.sun.com
 (sr1-umpk-16.SFBay.Sun.COM [129.145.154.66])	by dm-sfbay-02.sfbay.sun.com
 (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id m7RHPk2C028115; Wed,
 27 Aug 2008 10:25:46 -0700 (PDT)
Received: from sr1-umpk-16.sfbay.sun.com (localhost [127.0.0.1])
	by sr1-umpk-16.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m7RHPj5Q008172;
 Wed, 27 Aug 2008 10:25:45 -0700 (PDT)
Received: (from johnf@localhost)	by sr1-umpk-16.sfbay.sun.com
 (8.13.8+Sun/8.13.8/Submit) id m7RHPjJJ008171; Wed,
 27 Aug 2008 10:25:45 -0700 (PDT)
Date: Wed, 27 Aug 2008 10:25:45 -0700 (PDT)
From: John Fischer <johnf@sr1-umpk-16.sfbay.sun.com>
Subject: Re: /PSARC/2008/482 - NWAM Phase 0.5 (picea)
To: John.Fischer@sun.com, james.d.carlson@sun.com
Cc: Darren.Kenny@sun.com, PSARC-ext@sun.com
Message-id: <200808271725.m7RHPjJJ008171@sr1-umpk-16.sfbay.sun.com>
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
Status: RO
Content-Length: 19

James,

OK.

John


From gww@eng.sun.com Wed Aug 27 10:28:55 2008
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 m7RHSs0C015432
	for <psarc-ext@sac.sfbay.sun.com>; Wed, 27 Aug 2008 10:28:55 -0700 (PDT)
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 m7RHSfvQ032620
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Wed, 27 Aug 2008 11:28:54 -0600 (MDT)
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 <0K690051RSK4C400@nwk-avmta-1.sfbay.Sun.COM> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Wed, 27 Aug 2008 10:28:52 -0700 (PDT)
Received: from dm-eng-02.sfbay.sun.com ([129.146.11.32])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0K6900DX0SK332B0@nwk-avmta-1.sfbay.Sun.COM> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Wed,
 27 Aug 2008 10:28:51 -0700 (PDT)
Received: from marduk.eng.sun.com (marduk.SFBay.Sun.COM [129.146.108.224])
	by dm-eng-02.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2)
 with ESMTP id m7RHSohS030404; Wed, 27 Aug 2008 10:28:50 -0700 (PDT)
Received: from marduk.eng.sun.com (localhost [127.0.0.1])
	by marduk.eng.sun.com (8.13.6+Sun/8.12.11) with ESMTP id m7RHP7oJ018714; Wed,
 27 Aug 2008 10:25:07 -0700 (PDT)
Received: (from gww@localhost)
	by marduk.eng.sun.com (8.13.6+Sun/8.12.11/Submit) id m7RHP73X018713; Wed,
 27 Aug 2008 10:25:07 -0700 (PDT)
Date: Wed, 27 Aug 2008 10:25:07 -0700 (PDT)
From: Gary Winiger <gww@eng.sun.com>
Subject: Re: /PSARC/2008/482 - NWAM Phase 0.5 (picea)
To: John.Fischer@sun.com, james.d.carlson@sun.com
Cc: PSARC-ext@sun.com, Darren.Kenny@sun.com
Message-id: <200808271725.m7RHP73X018713@marduk.eng.sun.com>
Content-transfer-encoding: 7BIT
X-Sun-Charset: US-ASCII
X-PMX-Version: 5.4.1.325704
Status: RO
Content-Length: 806


> John Fischer writes:
> > Having received no comment on this opinion and a week
> > has passed I am going to forward this to SAC.
> 
> There are two contracts on the way.  I don't think they affect much
> (one for use of libbsm and the other between the GUI and ON teams
> within the project), but as a procedural bit, I think they should be
> there before the case is closed.

	As the SUPPLIER for the audit interfaces (and I expect to do 
	the contract and move it through), I have no issues with the
	architecture of the case moving on to closing out without the
	contract in place.  I still owe Jim code review and doing a
	contract.  I'll do that as it fits into my schedule, likely
	in the next couple days.  Note that the RM for SUPPLIER will
	be on holiday and not available after today.

Gary..

From Leo.Binchy@Sun.COM Thu Aug 28 02:57:35 2008
Received: from dm-sfbay-02.sfbay.sun.com (dm-sfbay-02.SFBay.Sun.COM [129.146.11.31])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m7S9vZvt018671
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 28 Aug 2008 02:57:35 -0700 (PDT)
Received: from gmp-eb-inf-1.sun.com (gmp-eb-inf-1.EU.Sun.COM [192.18.6.21])
	by dm-sfbay-02.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id m7S9vYx7047523
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 28 Aug 2008 02:57:34 -0700 (PDT)
Received: from fe-emea-10.sun.com (gmp-eb-lb-2-fe3.eu.sun.com [192.18.6.12])
	by gmp-eb-inf-1.sun.com (8.13.7+Sun/8.12.9) with ESMTP id m7S9vSNg001081
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 28 Aug 2008 09:57:28 GMT
Received: from conversion-daemon.fe-emea-10.sun.com by fe-emea-10.sun.com
 (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007))
 id <0K6B004011URFX00@fe-emea-10.sun.com>
 (original mail from Leo.Binchy@Sun.COM) for psarc-ext@sac.sfbay.sun.com; Thu,
 28 Aug 2008 10:57:28 +0100 (BST)
Received: from [129.156.226.96] by fe-emea-10.sun.com
 (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007))
 with ESMTPSA id <0K6B00LGG2BDDCH0@fe-emea-10.sun.com>; Thu,
 28 Aug 2008 10:57:14 +0100 (BST)
Date: Thu, 28 Aug 2008 10:57:13 +0100
From: Leontine Binchy <Leo.Binchy@Sun.COM>
Subject: Re: PSARC contract for 2008/482:  NWAM Phase 0.5 (picea)
In-reply-to: <18613.41199.644717.570642@gargle.gargle.HOWL>
Sender: Leo.Binchy@Sun.COM
To: psarc-ext@sac.sfbay.sun.com
Cc: Victor.Nelson@Sun.COM, Darren.Kenny@ireland.sun.com
Message-id: <48B67679.1040504@sun.com>
MIME-version: 1.0
Content-type: text/plain; format=flowed; charset=ISO-8859-1
Content-transfer-encoding: 7BIT
References: <18613.41199.644717.570642@gargle.gargle.HOWL>
User-Agent: Thunderbird 2.0.0.14 (X11/20080519)
Status: RO
Content-Length: 6055

I aprrove

James Carlson wrote:
> In order to share a private library between ON and the GUI for NWAM,
> we need to have an ARC contract specifying how it'll be used.  I've
> drafted one below based on the information in the PSARC case and
> information from bugster.
>
> It should be fairly straightforward.  Please look it over and either:
>
>   - Reply to the message with a simple "I agree" message.  Note that
>     I've set "Reply-to" on this message to psarc-ext@sac.sfbay.
>
>   - Reply directly to me with questions or comments or concerns about
>     the contract, and I'll update it if necessary.
>
>
>
> @(#)contract	1.8 @(#) /shared/sac/arc/ARC-Templates/contract [1.8 06/12/06]
>
> 	CONTRACT ALLOWING/REQUIRING SPECIAL ARRANGEMENTS FOR INTERFACES
>
> 0.  Number: PSARC/2008/482-01
>
> 1.  This contract is between
> 	a SUPPLIER of INTERFACES and
> 	a CONSUMER of those INTERFACES,
>     both of whom are entities within Sun Microsystems, Incorporated.
>
> 2.  The SUPPLIER (definer and/or implementor) is identified by the following:
>     Product or Bundle:			Solaris
>     Consolidation:			ON
>     Department or Group:		Solaris Networking
>     Bugster Product/Category/SubCategory: solaris/network/config
>     Responsible Manager:		Victor Nelson
>
> 3.  The CONSUMER is identified by the following:
>     Product or Bundle:			JDS
>     Consolidation:			GNOME
>     Department or Group:		Desktop Development
>     Bugster Product/Category/SubCategory: jds/gnome/applets
>     Responsible Manager:		Leo Binchy
>
> 4.  The INTERFACES are:
>
> 	<libnwam.h>		Project Private
> 	/lib/libnwam.so.1	Project Private
>
> 5.  The ARC controlling these INTERFACES is: PSARC
>
> 6.  The CASE describing (Exporting) these INTERFACES is: 2008/482
>
> 7.  The following SPECIAL ARRANGEMENTS are made which modify the rules
>     imposed by the stability levels listed in section 4 above:
>  
> _N_ 7a. Although the stability level doesn't normally restrict it,
>         SUPPLIER promises to only modify INTERFACES in an incompatible
> 	way as follows:
>
> _N_ 7b. Although the stability level doesn't normally allow it, CONSUMER will
>         expose INTERFACES to a PARTNER, which is external to Sun, namely:
> 		Name of Company:
> 		Name of Department or Group within Company:
> 		Responsible Manager:
>
> _Y_ 7c. Although the stability level doesn't normally allow it, CONSUMER will
>         import INTERFACES from a separate consolidation.
>
> _Y_ 7d. If SUPPLIER decides to change (including replace or remove) any
> 	portion of the INTERFACES, SUPPLIER will notify CONSUMER of the
> 	proposed new version, no later than the application for ARC
> 	approval of the new version.
> 	If SUPPLIER and CONSUMER are contained in the same consolidation,
> 	they have the option of arranging for simultaneous conversion
> 	to the new interfaces.  If this is not possible, or if they are
> 	not in the same consolidation, then SUPPLIER will either make best
> 	effort to work with CONSUMER so that CONSUMER can detect which
> 	version of INTERFACES is being supplied, or else SUPPLIER will
> 	make best effort to supply both old and new versions of
> 	INTERFACES.
> 	If SUPPLIER cannot make both versions of INTERFACES available,
> 	and SUPPLIER and CONSUMER cannot devise a method whereby
> 	CONSUMER can detect which version of INTERFACES is being
> 	supplied, and the old version of CONSUMER will not run with the
> 	new version of SUPPLIER, then either the EOL process must be
> 	followed by SUPPLIER, or else a major release of SUPPLIER will
> 	be required, or the change will not be allowed.
>
> 8. If CONSUMER requires changes in INTERFACES, SUPPLIER will make
>    best effort to accommodate such changes, which shall then be
>    treated in accordance with paragraph 7 above.
>
> 9. Notwithstanding paragraphs 7 and 8, a change to any portion
>    of the INTERFACES shall be regarded as a completely new set of
>    INTERFACES which require both ARC approval and execution of
>    a new contract.
>
> 10. SUPPLIER and CONSUMER agree that evolution of INTERFACES shall be
>     handled as follows:
>
>     SUPPLIER will obtain approval for changes from CONSUMER.  CONSUMER
>     will use bugster or informal communication to request changes from
>     SUPPLIER.  Technical coordination will be accomplished using this
>     mailing list:
>
> 	nwam-discuss@opensolaris.org
>
> 11. SUPPLIER and CONSUMER agree that INTERFACES will be supported as
>     follows:
>
>     CONSUMER will file bugs using bugster or request changes
>     informally, as needed.
>
> 12. SUPPLIER and CONSUMER agree that INTERFACES will be documented as
>     follows:
>
>     Design document (archived with case materials and delivered
>     privately to GUI team) is the only documentation.
>
> 13. SUPPLIER and CONSUMER agree that changes to the INTERFACES will be
>     tested as follows:
>
>     SUPPLIER will test interfaces using stand-alone application to
>     exercise components.  CONSUMER and SUPPLER will both test
>     combination of GUI and library on a variety of systems.
>
> 14. SUPPLIER and CONSUMER agree that this contract can be terminated as
>     follows:
>
>     Contract will expire when NWAM Phase 1 (PSARC 2008/532) has been
>     delivered, or by mutual agreement at any earlier date.
>
> 15. This contract is not valid until "signed" via agreement from the
>     SUPPLIER and CONSUMER, and approved by the ARC CASE referenced by
>     this contract.  E-mail agreement to the contract should be archived
>     in the mail archive of CASE; verbal agreement to the contract
>     should be noted in the meeting minutes.  This contract remains
>     valid until superseded or invalidated.
>
> For SUPPLIER:			Date:
> For CONSUMER:			Date:
> For ARC:			Date:
>
>     A copy of this contract shall be deposited in the CASE directory as
>     "contract-<digits>" or in a "contracts" subdirectory.
>
> 16. (Not to be filled in until superseded or invalidated.)
>     This contract was superseded or invalidated by CASE:
>     For ARC:			Date:
>
>   

From sac-owner Fri Aug 29 10:54:51 2008
Received: from dm-sfbay-02.sfbay.sun.com (dm-sfbay-02.SFBay.Sun.COM [129.146.11.31])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m7THsoSp010779
	for <sac-review@sac.sfbay.sun.com>; Fri, 29 Aug 2008 10:54:51 -0700 (PDT)
Received: from brmea-mail-1.sun.com (brmea-mail-1.Sun.COM [192.18.98.31])
	by dm-sfbay-02.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id m7THsoHC015085
	for <sac-review@sac.sfbay.sun.com>; Fri, 29 Aug 2008 10:54:50 -0700 (PDT)
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 m7THsoru017850
	for <sac-review@sac.sfbay.sun.com>; Fri, 29 Aug 2008 17:54:50 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 <0K6D00G01IVVES00@mail-amer.sun.com>
 (original mail from John.Fischer@Sun.COM) for sac-review@sac.sfbay.sun.com;
 Fri, 29 Aug 2008 11:54:50 -0600 (MDT)
Received: from 129.145.154.66 ([129.145.154.66])
 by mail-amer.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28
 2007)) with ESMTPSA id <0K6D00FOXJ37ZI20@mail-amer.sun.com> for
 sac-review@sac.sfbay.sun.com; Fri, 29 Aug 2008 11:54:44 -0600 (MDT)
Date: Fri, 29 Aug 2008 10:54:43 -0700
From: John Fischer <John.Fischer@Sun.COM>
Subject: PSARC/2008/482 - NWAM Phase 0.5 (picea) -- opinion
Sender: John.Fischer@Sun.COM
To: sac-review@sac.sfbay.sun.com
Cc: John Fischer <John.Fischer@Sun.COM>, Darren.Kenny@Sun.COM
Reply-to: John.Fischer@Sun.COM
Message-id: <1220032482.60555.27.camel@sr1-umpk-16>
MIME-version: 1.0
X-Mailer: Ximian Evolution 1.4.6.301
Content-type: multipart/mixed; boundary="Boundary_(ID_kWUqlouEmzMczz0g1ak46g)"
Status: RO
Content-Length: 8405


--Boundary_(ID_kWUqlouEmzMczz0g1ak46g)
Content-type: text/plain
Content-transfer-encoding: 7BIT

All,

Here is the opinion for the NWAM Phase 0.5 (picea)
(PSARC/2008/482) case.  The case director contains
this version and an nroff formated version.  Please 
review.

Thanks,

John


--Boundary_(ID_kWUqlouEmzMczz0g1ak46g)
Content-type: text/plain; charset=ASCII; name=opinion.txt
Content-transfer-encoding: 7BIT
Content-disposition: attachment; filename=opinion.txt


 sun
   microsystems              Systems Architecture Committee

_________________________________________________________________

Subject:       NWAM Phase 0.5 (picea)

Submitted by:  Darren Kenny

File:          PSARC/2008/482/opinion.ms

Date:          August 13th, 2008

Committee:     John Fischer, Kais Belgaied, James  D.  Carl-
               son, Glenn Skinner, Gary Winiger.

Product Approval Committee:

               Solaris PAC
               solaris-pac@sun.com

1.  Summary

NWAM Phase 0.5 (picea) separates out the GUI from  the  NWAM
daemon.   This  will  allow the users to better observe what
the NWAM daemon is doing thus  giving  them  better  control
over what is taking place.

2.  Decision & Precedence Information

The project is approved as specified in references [1],  [2]
& [3].

The project may be delivered in a Minor release of Solaris.

3.  Interfaces

The project exports the following interfaces.

__________________________________________________________________
|                      Interfaces Exported                       |
|___________________________|_________________|__________________|
|Interface                  |  Classification |  Comments        |
|___________________________|_________________|__________________|
|NWAM Manager               |  Uncommitted    |  New             |
|                           |                 |  control/status  |
|                           |                 |  GUI             |
|libnwam.so.1               |  Project Private|  Wrapper  library|
|                           |                 |  for GUI         |
|                           |                 |                  |
|___________________________|_________________|__________________|

PSARC/2008/482

                           - 2 -

__________________________________________________________________
|                      Interfaces Exported                       |
|___________________________|_________________|__________________|
|Interface                  |  Classification |  Comments        |
|___________________________|_________________|__________________|
|SUNWnwamintr, SUNWnwamintu |  Project Private|  Internal-only   |
|                           |                 |  packages        |
|libnwam.h                  |  Project Private|  Library   header|
|                           |                 |  file            |
|/var/nwam/door             |  Project Private|                  |
|"priority"                 |  Uncommitted    |  New             |
|                           |                 |  /etc/nwam/llp   |
|                           |                 |  keyword         |
|/usr/lib/nwam-manager      |  Uncommitted    |  User   Interface|
|                           |                 |  Daemon          |
|/usr/share/nwam-manager    |  Project Private|  Project   Icons,|
|                           |                 |  etc.            |
|/usr/share/gnome/autostart/|  Uncommitted    |  GNOME  Autostart|
|    nwam-manager.desktop   |                 |  Launcher        |
|SUNWgnome-nwam-manager     |  Uncommitted    |  End User package|
|SUNWgnome-nwam-manager-root|  Uncommitted    |  Root package    |
|___________________________|_________________|__________________|

The project imports the following interfaces.

___________________________________________________
|               Interfaces Imported               |
|_______________|________________|________________|
|Interface      |  Classification|  Comments      |
|_______________|________________|________________|
|Defining Works-|  Committed     |  PSARC/2008/034|
|tation    Owner|                |                |
|Infrastructure |                |                |
|_______________|________________|________________|

4.  Opinion

4.1.  libnwam_{open|close}_door() Function Name

The choice of the name of the interface is  too  tied  to  a
particular choice of an IPC.  The purpose of these two func-
tions seem to initialize/dismantle a context for the calling
process  used for subsequent communications with nwamd.  The
committee suggested that the project  team  remove  the  IPC
name  from  the  function name.  The project team agreed and
has updated the design document [2].

4.2.  libnwam_set_llp_priority() Function

The parameter prio is declared as a signed int.  This  would
allow  for  a  negative  value being passed to the function.

PSARC/2008/482

                           - 3 -

The committee asked if there was  any  significance  to  the
value  being  negative.   The project team stated that there
are no negative priorities.  The committee suggest that  the
defined  type for the variable be changed to an unsigned int
or that errors be defined. The committee also noted that the
function  can return either ENOENT or ENXIO stating that the
later was more appropriate.   The  project  team  agreed  to
define errors and has updated the design document [2].

4.3.  User Interface

The committee noted that unless the end  user  was  familiar
with NWAM and Gnome it might be difficult for them to under-
stand what they are seeing in the User Interface.  The  com-
mittee  suggested  that  the  new interface be clearly docu-
mented.  This issue resulted in Advisory information.

4.4.  Authorization

This project  introduces  a  new  authorization  in  Network
Management Rights Profile.  However, it was not clear if the
console user would inherit the new authorization.  The  pro-
ject team stated that the console user would inherit the new
authorization.  The specification  also  was  not  clear  on
which  events required authorization.  The project team made
it clear that all the events require the new  authorization.
The project team will update the design document [2] to make
the authorization more clear.  The committee was  fine  with
this issue.

4.5.  Solaris Audit records

The design document seems to imply that there is no auditing
taking  place  when  authorization  is  granted and does not
describe why this is okay.  The project team stated that  in
NWAM Phase 1.0 there will be auditing.  However, the specif-
ication for what will be recorded has not been defined  yet.
Because the Phase 1 solution is not yet known in detail, and
the auditing events it will need are not known, this project
team  was  not planning to implement auditing in this phase.
The project team should consider implementing Solaris Audit-
ing records when authorizations are granted.

4.6.  Other Window Managers

The committee noted that the design seems to be  Gnome  cen-
tric  and  was  concerned about the user not having the same
feedback  in  other  Window  Mangers  like  the  KDE  window
manager.   The  project  team pointed out that the mechanism
being used is part of  the  Free  Desktop  Foundation  which
Gnome, KDE and XFE conform with.  In the event that the Win-
dow Manager does not conform with the Free  Desktop  Founda-
tion specification then the user feedback will appear within
a window on the desktop.  The committee was fine  with  this

PSARC/2008/482

                           - 4 -

issue.

5.  Minority Opinion(s)

None

6.  Advisory Information

It would be very beneficial for the user if the User  Inter-
face is clearly documented.

7.  Appendices

7.1.  Appendix A: Technical Changes Required

None

7.2.  Appendix B: Technical Changes Advised

1.   Auditing should be added to the daemon when  authoriza-
     tion is granted.

7.3.  Appendix C: Reference Material

Unless stated otherwise, path names are relative to the case
directory PSARC/2008/482.

1.   PSARC      20      Questions      document.       File:
     final.materials/picea-20q.txt

2.   Final      PICEA      Design      document.       File:
     final.materials/picea-on-design.pdf

3.   NWAM   User   Interface   Design    document.     File:
     final.materials/nwam-ui.html

PSARC/2008/482


--Boundary_(ID_kWUqlouEmzMczz0g1ak46g)--

From Victor.Nelson@Sun.COM Tue Sep  2 12:39:00 2008
Received: from dm-sfbay-01.sfbay.sun.com (dm-sfbay-01.SFBay.Sun.COM [129.145.155.118])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m82Jd0Pa017551
	for <psarc-ext@sac.sfbay.sun.com>; Tue, 2 Sep 2008 12:39:00 -0700 (PDT)
Received: from sca-es-mail-2.sun.com (sca-es-mail-2.Sun.COM [192.18.43.133])
	by dm-sfbay-01.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id m82Jd02Z064355
	for <psarc-ext@sac.sfbay.sun.com>; Tue, 2 Sep 2008 12:39:00 -0700 (PDT)
Received: from fe-sfbay-10.sun.com ([192.18.43.129])
	by sca-es-mail-2.sun.com (8.13.7+Sun/8.12.9) with ESMTP id m82Jct1k027186
	for <psarc-ext@sac.sfbay.sun.com>; Tue, 2 Sep 2008 12:38:55 -0700 (PDT)
Received: from conversion-daemon.fe-sfbay-10.sun.com by fe-sfbay-10.sun.com
 (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007))
 id <0K6L0010121GHD00@fe-sfbay-10.sun.com>
 (original mail from Victor.Nelson@Sun.COM) for psarc-ext@sac.sfbay.sun.com;
 Tue, 02 Sep 2008 12:38:55 -0700 (PDT)
Received: from [129.146.11.144] by fe-sfbay-10.sun.com
 (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007))
 with ESMTPSA id <0K6L001KA2KUZ4E0@fe-sfbay-10.sun.com>; Tue,
 02 Sep 2008 12:38:54 -0700 (PDT)
Date: Tue, 02 Sep 2008 12:38:54 -0700
From: Victor Nelson <Victor.Nelson@Sun.COM>
Subject: Re: PSARC contract for 2008/482:  NWAM Phase 0.5 (picea)
In-reply-to: <18613.41199.644717.570642@gargle.gargle.HOWL>
Sender: Victor.Nelson@Sun.COM
To: psarc-ext@sac.sfbay.sun.com
Cc: Leontine Binchy <Leo.Binchy@Sun.COM>, Darren.Kenny@ireland.sun.com
Reply-to: Victor.Nelson@Sun.COM
Message-id: <48BD964E.1010206@Sun.COM>
MIME-version: 1.0
Content-type: text/plain; format=flowed; charset=ISO-8859-1
Content-transfer-encoding: 7BIT
References: <18613.41199.644717.570642@gargle.gargle.HOWL>
User-Agent: Thunderbird 2.0.0.14 (X11/20080505)
Status: RO
Content-Length: 6113

I agree.

Victor

on 08/27/08 11:46, James Carlson wrote:
> In order to share a private library between ON and the GUI for NWAM,
> we need to have an ARC contract specifying how it'll be used.  I've
> drafted one below based on the information in the PSARC case and
> information from bugster.
> 
> It should be fairly straightforward.  Please look it over and either:
> 
>   - Reply to the message with a simple "I agree" message.  Note that
>     I've set "Reply-to" on this message to psarc-ext@sac.sfbay.
> 
>   - Reply directly to me with questions or comments or concerns about
>     the contract, and I'll update it if necessary.
> 
> 
> 
> @(#)contract	1.8 @(#) /shared/sac/arc/ARC-Templates/contract [1.8 06/12/06]
> 
> 	CONTRACT ALLOWING/REQUIRING SPECIAL ARRANGEMENTS FOR INTERFACES
> 
> 0.  Number: PSARC/2008/482-01
> 
> 1.  This contract is between
> 	a SUPPLIER of INTERFACES and
> 	a CONSUMER of those INTERFACES,
>     both of whom are entities within Sun Microsystems, Incorporated.
> 
> 2.  The SUPPLIER (definer and/or implementor) is identified by the following:
>     Product or Bundle:			Solaris
>     Consolidation:			ON
>     Department or Group:		Solaris Networking
>     Bugster Product/Category/SubCategory: solaris/network/config
>     Responsible Manager:		Victor Nelson
> 
> 3.  The CONSUMER is identified by the following:
>     Product or Bundle:			JDS
>     Consolidation:			GNOME
>     Department or Group:		Desktop Development
>     Bugster Product/Category/SubCategory: jds/gnome/applets
>     Responsible Manager:		Leo Binchy
> 
> 4.  The INTERFACES are:
> 
> 	<libnwam.h>		Project Private
> 	/lib/libnwam.so.1	Project Private
> 
> 5.  The ARC controlling these INTERFACES is: PSARC
> 
> 6.  The CASE describing (Exporting) these INTERFACES is: 2008/482
> 
> 7.  The following SPECIAL ARRANGEMENTS are made which modify the rules
>     imposed by the stability levels listed in section 4 above:
>  
> _N_ 7a. Although the stability level doesn't normally restrict it,
>         SUPPLIER promises to only modify INTERFACES in an incompatible
> 	way as follows:
> 
> _N_ 7b. Although the stability level doesn't normally allow it, CONSUMER will
>         expose INTERFACES to a PARTNER, which is external to Sun, namely:
> 		Name of Company:
> 		Name of Department or Group within Company:
> 		Responsible Manager:
> 
> _Y_ 7c. Although the stability level doesn't normally allow it, CONSUMER will
>         import INTERFACES from a separate consolidation.
> 
> _Y_ 7d. If SUPPLIER decides to change (including replace or remove) any
> 	portion of the INTERFACES, SUPPLIER will notify CONSUMER of the
> 	proposed new version, no later than the application for ARC
> 	approval of the new version.
> 	If SUPPLIER and CONSUMER are contained in the same consolidation,
> 	they have the option of arranging for simultaneous conversion
> 	to the new interfaces.  If this is not possible, or if they are
> 	not in the same consolidation, then SUPPLIER will either make best
> 	effort to work with CONSUMER so that CONSUMER can detect which
> 	version of INTERFACES is being supplied, or else SUPPLIER will
> 	make best effort to supply both old and new versions of
> 	INTERFACES.
> 	If SUPPLIER cannot make both versions of INTERFACES available,
> 	and SUPPLIER and CONSUMER cannot devise a method whereby
> 	CONSUMER can detect which version of INTERFACES is being
> 	supplied, and the old version of CONSUMER will not run with the
> 	new version of SUPPLIER, then either the EOL process must be
> 	followed by SUPPLIER, or else a major release of SUPPLIER will
> 	be required, or the change will not be allowed.
> 
> 8. If CONSUMER requires changes in INTERFACES, SUPPLIER will make
>    best effort to accommodate such changes, which shall then be
>    treated in accordance with paragraph 7 above.
> 
> 9. Notwithstanding paragraphs 7 and 8, a change to any portion
>    of the INTERFACES shall be regarded as a completely new set of
>    INTERFACES which require both ARC approval and execution of
>    a new contract.
> 
> 10. SUPPLIER and CONSUMER agree that evolution of INTERFACES shall be
>     handled as follows:
> 
>     SUPPLIER will obtain approval for changes from CONSUMER.  CONSUMER
>     will use bugster or informal communication to request changes from
>     SUPPLIER.  Technical coordination will be accomplished using this
>     mailing list:
> 
> 	nwam-discuss@opensolaris.org
> 
> 11. SUPPLIER and CONSUMER agree that INTERFACES will be supported as
>     follows:
> 
>     CONSUMER will file bugs using bugster or request changes
>     informally, as needed.
> 
> 12. SUPPLIER and CONSUMER agree that INTERFACES will be documented as
>     follows:
> 
>     Design document (archived with case materials and delivered
>     privately to GUI team) is the only documentation.
> 
> 13. SUPPLIER and CONSUMER agree that changes to the INTERFACES will be
>     tested as follows:
> 
>     SUPPLIER will test interfaces using stand-alone application to
>     exercise components.  CONSUMER and SUPPLER will both test
>     combination of GUI and library on a variety of systems.
> 
> 14. SUPPLIER and CONSUMER agree that this contract can be terminated as
>     follows:
> 
>     Contract will expire when NWAM Phase 1 (PSARC 2008/532) has been
>     delivered, or by mutual agreement at any earlier date.
> 
> 15. This contract is not valid until "signed" via agreement from the
>     SUPPLIER and CONSUMER, and approved by the ARC CASE referenced by
>     this contract.  E-mail agreement to the contract should be archived
>     in the mail archive of CASE; verbal agreement to the contract
>     should be noted in the meeting minutes.  This contract remains
>     valid until superseded or invalidated.
> 
> For SUPPLIER:			Date:
> For CONSUMER:			Date:
> For ARC:			Date:
> 
>     A copy of this contract shall be deposited in the CASE directory as
>     "contract-<digits>" or in a "contracts" subdirectory.
> 
> 16. (Not to be filled in until superseded or invalidated.)
>     This contract was superseded or invalidated by CASE:
>     For ARC:			Date:
> 

