It might be informative to know where the features that prstat offers
will vary from those offered by the FOSS top. (I'm more concerned about
top compiled on Solaris, not running on some other platform.)
If the discrepancies are large (I don't think they are, but I haven't
surveyed them), then it might be more problematic to ship the symbolic
link. (One of the features I have sometimes used -- not recently -- is
top's ability to kill a process (press "k"). This used with an "exec"
has let me occasionally recover from an otherwise horked system (due to
some other run away process.) I can't do that with prstat, so I wonder
if the "surprise" here might be detrimental (I'd have exec'ed away what
might have been my only useful shell into a tool that won't let me do
anything except *look*.) Granted, I expect such usage is rather atypical.
In any case, a comparison would be good information to have in the
top.1m manual page.
-- Garrett
Don Cragun wrote:
> I'm sponsoring this case for Craig Mohrman.
> The project team is requesting a minor release binding.
> The timer expires Tuesday, August 26, 2008.
>
> Cheers,
> Don
>
> Template Version: @(#)onepager.txt 1.35 07/11/07 SMI
> Copyright 2008 Sun Microsystems
>
> 1. Introduction
> 1.1. Project/Component Working Name:
> prstat utility enhancements to look and act more like top
>
> 1.2. Name of Document Author/Supplier:
> Craig Mohrman
>
> 1.3. Date of This Document:
> 19 August 2008
>
> 1.4. Name of Major Document Customer(s)/Consumer(s):
> 1.4.2. The ARC(s) you expect to review your project:
> PSARC
> 1.4.3. The Director/VP who is "Sponsoring" this project:
> tim.cramer at sun.com
>
> 1.5. Email Aliases:
> 1.5.1. Responsible Manager: tim.sparlin at sun.com
> 1.5.2. Responsible Engineer: craig.mohrman at sun.com
>
>
> 2. Project Summary
> 2.1. Project Description:
> Create a utility called top which is actually an enhanced
> version of the utility prstat.
>
>
> 3. Business Summary
> 3.1. Problem Area:
> A familiar command for users unfamiliar with OpenSolaris to
> gain an understanding of what is going on with processes inside
> their machine.
>
> 3.5. Opportunity Window/Exposure:
> Time to market is critical for this project. We are targetting
> the next release of OpenSolaris, 2008.11. Therefore this
> project is being kept small and doable in the time given.
>
>
> 4. Technical Description:
> 4.1. Details:
> The top utility available on Linux systems is not provided on
> Solaris systems. Since top is the Linux utility most requested
> by users running OpenSolaris systems, we need to provide a top
> utility in OpenSolaris 2008.11. In many cases, output from top
> is very similar to output produced by the Solaris prstat
> utility. We will not be able to provide all of the features of
> the various Linux top utilities (features and options vary
> between Linux systems) in time for 2008.11, so we plan to
> provide top in two phases. This case describes phase 1. A
> later case will provide phase 2.
>
> Phase 1 will make top be a link to prstat. It will simply
> invoke prstat as is. An accompanying man page for top will
> indicate what we have done and note that we are working on a
> "top like" implementation. (See top.1m in the materials
> directory.)
>
> The intent for Phase 2 will be to add features to prstat so
> that when prstat is invoked with the name top it will look and
> behave similar to the top that comes from:
> http://www.unixtop.org/
>
> 4.2. Bug/RFE Number(s):
> TBD...
>
> 4.5. Interfaces:
> A link from /usr/bin/top to /usr/bin/prstat.
>
> 4.6. Doc Impact:
> Create the man page top.1.
> prstat.1 will have a SEE ALSO note.
>
> 5. Reference Documents:
> materials/top.1: Phase 1 top(1) man page
> PSARC 2000/488: Solaris/Linux Commands Compatibility
> PSARC 2005/185: Enabling Serendipitous Discovery
>
> 6. Resources and Schedule:
> 6.4. Product Approval Committee requested information:
> 6.4.1. Consolidation or Component Name:
> ON
> 6.4.7. Target RTI Date/Release:
> onnv_98 or onnv_99
>
> 6.5. ARC review type: FastTrack
> 6.6. ARC Exposure: open
>
>
