The top.1 man page should be a .1M page to match prstat.1M. craig
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 > >
