Rename top(1) to mtop(1), import NetBSD top(1)
[minix3.git] / external / bsd / top / dist / machine / m_freebsd.man
blob0acafea17f2a2f1622d41c43b07fc993365d3107
1 .SH "FreeBSD NOTES"
2 Priorities are shown the same as they exist in process data structures,
3 ranging from 0 to 255.  Note that this is not the same as the ps(1) 
4 \*(lqpri\*(rq column, which subtracts 84 from each number before displaying
5 it. Priority numbers fall in to priority classes as follows:
6 .TP 15
7 0 \- 63
8 Interrupt threads
9 .TP 15
10 64 \- 127
11 Top half kernel threads
12 .TP 15
13 128 \- 159
14 Realtime user threads
15 .TP 15
16 160 \- 223
17 Time sharing user threads
18 .TP 15
19 224 \- 255
20 Idle user threads
22 .SH "FreeBSD THREADS"
23 Starting with FreeBSD 8.0 the display of individual threads can be
24 toggled with the synonymous commands
25 .B t
26 and
27 .BR H.
28 Information about state, flags, CPU time and percent cpu are shown
29 for each individual thread.  Other information is identical for all
30 threads in the same process.
32 .SH "FreeBSD ALTERNATE DISPLAY"
33 FreeBSD supports an alternate process display which shows i/o 
34 information.  Since this information is tracked per process and not
35 per thread, the per-thread display is not supported in this mode.
36 All fields calculate the number of operations observed since the
37 last update and are displayed as a per-second rate.
38 The fields in this display are as follows:
39 .TP
40 .B VCSW
41 Voluntary context switches
42 .TP
43 .B IVCSW
44 Involuntary context switches
45 .TP
46 .B READ
47 Number of blocks read
48 .TP
49 .B WRITE
50 Number of blocks written
51 .TP
52 .B FAULT
53 Number of page faults
54 .TP
55 .B TOTAL
56 Total number of i/o operations
57 .TP
58 .B PERCENT
59 Percentage of total i/o attributed to this process.  If no i/o occured
60 then this field is 0 for all processes.
62 .SH "FreeBSD KERNEL SUMMARY"
63 All rates are shown per-second.
64 .TP
65 .B Ctx
66 Number of context switches.
67 .TP
68 .B Trap
69 Number of kernel traps.
70 .TP
71 .B Intr
72 Number of device interrupts.
73 .TP
74 .B Soft
75 Number of software interrupts.
76 .TP
77 .B Fork
78 Number of forks, vforks, and rforks.
79 .TP
80 .B Flt
81 Total number of page faults.
82 .TP
83 .B Pgin
84 Number of pages paged or swapped in to physical memory.
85 .TP
86 .B Pgout
87 Number of pages paged or swapped out from physical memory.
88 .TP
89 .B Fr
90 Total number of pages freed.
91 .SH "FreeBSD MEMORY SUMMARY"
92 Memory: 10M Act 1208K Inact 3220K Wired 132K Free 25% Swap, 2924Kin 2604Kout
93 .TP
94 .B K: 
95 Kilobyte
96 .TP
97 .B M: 
98 Megabyte
99 .TP
100 .B G:
101 Gigabyte
103 .B %: 
104 1/100
107 .B Act: 
108 number of pages active
110 .B Inact: 
111 number of pages inactive
113 .B Wired: 
114 number of pages wired down
116 .B Free: 
117 number of pages free
119 .B Swap: 
120 swap usage
121 .TP 
122 .B Kin: 
123 kilobytes swap pager pages paged in (last interval)
125 .B Kout: 
126 kilobytes swap pager pages paged out  (last interval)
129 See /usr/include/sys/vmmeter.h and  /sys/vm/vm_meter.c.
131 Contributors: Christos Zoulas, Steven Wallace, Wolfram Schneider,
132 Monte Mitzelfelt.
134 This module was retrofitted from FreeBSD 4.6.2 sources.