xref: /minix/external/bsd/top/dist/machine/m_sunos5.man (revision b89261ba)
1.SH "SUNOS 5 NOTES"
2CPU percentage is calculated as a fraction of total available computing
3resources.  Hence on a multiprocessor machine a single threaded process
4can never consume cpu time in excess of 1 divided by the number of processors.
5For example, on a 4 processor machine, a single threaded process will
6never show a cpu percentage higher than 25%.  The CPU percentage column
7will always total approximately 100, regardless of the number of processors.
8
9The kernel summary line shows the following information, all displayed
10as a per-second rate:
11.TP 9
12.B ctxsw
13Context switches.
14.TP 9
15.B trap
16Number of traps.
17.TP 9
18.B intr
19Number of interrupts.
20.TP 9
21.B syscall
22Number of system calls.
23.TP 9
24.B fork
25Number of forks and vforks.
26.TP 9
27.B flt
28Number of page faults.
29.TP 9
30.B pgin
31Number of kilobytes paged in to physical memory.
32.TP 9
33.B pgout
34Number of kilobytes paged out from physical memory.
35.PP
36The memory summary line displays the following:
37.TP 14
38.B "phys mem"
39Total amount of physical memory that can be allocated for use by processes
40(it does not include memory reserved for the kernel's use).
41.TP 14
42.B "free mem"
43The amount of unallocated physical memory.
44.TP 14
45.B "total swap"
46The total amount of swap area allocated on disk.
47.TP 14
48.B "free swap"
49The amount of swap area on disk that is still available.
50.PP
51Unlike previous versions of
52.IR top ,
53the swap figures will differ from the summary output of
54.IR swap (1M)
55since the latter includes physical memory as well.
56.PP
57The column
58.B NLWP
59indicates the number of lightweight processes in a process.
60This usually corresponds to the number of threads in that process.
61.PP
62The display of individual threads can be toggled with the
63synonymous commands
64.B t
65and
66.BR H.
67Information about state, priority, CPU time and percent CPU are
68shown for each individual thread.  Other information is identical
69for all threads in the same process.  In this display the column
70.B LWP
71replaces
72.B NLWP
73and shows the lightweight process id.  The
74column names
75.B LWP
76and
77.B NLWP
78are consistent with
79.IR ps (1).
80.PP
81In BSD Unix, process priority was represented internally as a signed
82offset from a zero value with an unsigned value.  The "zero" value
83was usually something like 20, allowing for a range of priorities
84from -20 to 20.  As implemented on SunOS 5, older versions of top
85continued to interpret process priority in this manner, even though
86it was no longer correct.  Starting with top version 3.5, this was
87changed to agree with the rest of the system.
88.PP
89Long options are not currently available in Solaris.
90.PP
91The SunOS 5 (Solaris 2) port was originally written by Torsten Kasch,
92<torsten@techfak.uni-bielefeld.de>.  Many contributions have been
93provided by Casper Dik <Casper.Dik@sun.com>.
94Support for multi-cpu, calculation of CPU% and memory stats provided by
95Robert Boucher <boucher@sofkin.ca>, Marc Cohen <marc@aai.com>,
96Charles Hedrick <hedrick@geneva.rutgers.edu>, and
97William L. Jones <jones@chpc>.
98