.de Sc
\\s-1\\$1\\s0\\$2
..
.ds cA 2008/482
.ds aR \s-1PSARC\s0
.LP
.so ../../amac
.Co
.ds LF \fI\*(aR/\*(cA\fP
.if n .ds CF
.IP \fBSubject:\fP 15
NWAM Phase 0.5 (picea)
.IP "\fBSubmitted by:\fP" 15
Darren Kenny
.IP \fBFile:\fP 15
\*(aR/\*(cA/opinion.ms
.IP \fBDate:\fP 15
August 13th, 2008
.IP "\fBCommittee:\fP" 15
John Fischer, Kais Belgaied, James D. Carlson, Glenn Skinner, Gary Winiger.
.IP "\fBProduct Approval Committee:\fP" 15

Solaris PAC
.br
solaris-pac@sun.com

.pn 2
.NH
Summary
.LP
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. 
.NH
Decision & Precedence Information
.LP
The project is approved as specified in references [1], [2] & [3].
.LP
The project may be delivered in a Minor release of Solaris.
.LP

.NH
Interfaces
.LP
The project exports the following interfaces.
.if n .ne 8
.if t .ne 3
.TS H
box;
c s s
l | l | l.
Interfaces Exported
_
Interface	Classification	Comments
_
.TH
NWAM Manager	Uncommitted	T{
New control/status GUI
T}
libnwam.so.1	Project Private	T{
Wrapper library for GUI
T}
SUNWnwamintr, SUNWnwamintu	Project Private	T{
Internal-only packages
T}
libnwam.h	Project Private	T{
Library header file
T}
/var/nwam/door	Project Private	
"priority"	Uncommitted	T{
New /etc/nwam/llp keyword
T}
/usr/lib/nwam-manager	Uncommitted	T{
User Interface Daemon
T}
/usr/share/nwam-manager	Project Private	T{
Project Icons, etc.
T}
T{
.na
/usr/share/gnome/autostart/
    nwam-manager.desktop
T}	Uncommitted	T{
GNOME Autostart Launcher
T}
SUNWgnome-nwam-manager	Uncommitted	End User package
SUNWgnome-nwam-manager-root	Uncommitted	Root package
.TE
.LP
The project imports the following interfaces.
.if n .ne 8
.if t .ne 3
.TS H
box;
c s s
l | l | l.
Interfaces Imported
_
Interface	Classification	Comments
_
.TH
T{
Defining Workstation Owner Infrastructure
T}	Committed	PSARC/2008/034
.TE
.NH
Opinion
.LP
.NH 2
libnwam_{open|close}_door() Function Name
.LP
The choice of the name of the interface is too tied to a particular choice 
of an IPC.  The purpose of these two functions 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].
.NH 2
libnwam_set_llp_priority() Function
.LP
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].  
.NH 2
User Interface
.LP
The committee noted that unless the end user was familiar with NWAM and 
Gnome it might be difficult for them to understand what they are seeing 
in the User Interface.  The committee suggested that the new interface be 
clearly documented.  This issue resulted in Advisory information.
.NH 2
Authorization
.LP
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 project 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.
.NH 2
Solaris Audit records
.LP
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 specification 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 
Auditing records when authorizations are granted.
.NH 2
Other Window Managers
.LP
The committee noted that the design seems to be Gnome centric 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 Window Manager does not conform with the Free Desktop
Foundation specification then the user feedback will appear within a window on
the desktop.  The committee was fine with this issue.
.NH
Minority Opinion(s)
.LP
None
.NH
Advisory Information
.LP
It would be very beneficial for the user if the User Interface is clearly documented.  
.NH
Appendices
.NH 2
Appendix A: Technical Changes Required
.LP
None
.NH 2
Appendix B: Technical Changes Advised
.LP
.IP 1. 
Auditing should be added to the daemon when authorization is granted.
.NH 2
Appendix C: Reference Material
.LP
Unless stated otherwise, path names are relative to the case
directory \*(aR/\*(cA.
.IP 1.
PSARC 20 Questions document.
File:
final.materials/picea-20q.txt
.IP 2.
Final PICEA Design document.
File:
final.materials/picea-on-design.pdf
.IP 3.
NWAM User Interface Design document.
File:
final.materials/nwam-ui.html