Penguin
Recent Changes
Annotated edit history of procinfo(8) version 1, including all changes. View license author blame.
Rev Author # Line
1 JohnMcPherson 1 !!NAME
2 procinfo - display system status gathered from /proc
3
4
5
6 !!SYNOPSIS
7 __procinfo__ [[ ''-fsmadiDSbrChv'' ] [[ ''-n'' N ] [[ ''-F'' file ]
8
9
10
11 !!DESCRIPTION
12 __procinfo__ gathers some system data from the __/proc__ directory and prints it nicely formatted on the standard output device.
13
14 The meanings of the fields are as follows:
15
16
17
18 __Memory:__
19 ;: See the man page for free(1) (preferably the proc-version of free (If you weren't around during the Linux 1.x days, that's the only version of free you'll have)).
20
21
22
23 __Bootup:__
24 ;: The time the system was booted.
25
26
27
28 __Load__ ''average:''
29 ;: The average number of jobs running, followed by the number of runnable processes and the total number of processes (if your kernel is recent enough), followed by the PID of the last process run (idem).
30
31
32
33 __user:__
34 ;: The amount of time spent running jobs in user space.
35
36
37
38 __nice:__
39 ;: The amount of time spent running niced jobs in user space.
40
41
42
43 __system:__
44 ;: The amount of time spent running in kernel space. __Note:__ the time spent servicing interrupts is not counted by the kernel (and nothing that __procinfo__ can do about it).
45
46
47
48 __idle:__
49 ;: The amount of time spent doing nothing.
50
51
52
53 __uptime:__
54 ;: The time that the system has been up. The above four should more or less add up to this one.
55
56
57
58 __page__ ''in:''
59 ;: The number of disk block paged into core from disk. (A block is almost always 1 kilobyte).
60
61
62
63 __page__ ''out:''
64 ;: The reverse of the above. (What does that mean, anyways?)
65
66
67
68 __swap__ ''in:''
69 ;: The number of memory pages paged in from swapspace.
70
71
72
73 __swap__ ''out:''
74 ;: The number of memory pages paged out to swapspace.
75
76
77
78 __context:__
79 ;: The total number of context switches since bootup.
80
81
82
83 __disk__ ''1-4:''
84 ;: The number of times your hard disks have been accessed. This won't work for 1.0.x/1.1.x kernels unless you have applied the diskstat patch available elsewhere to your kernel, and might give surprising results if all your hard disks are of the same type (e.g. all IDE, all SCSI). [[I'm not sure to what extend this is still true with recent kernels, but I don't have a mixed system so I can't check.]
85
86
87
88 __Interrupts:__
89 ;: This is either a single number for all IRQ channels together if your kernel is older than version 1.0.5, or two rows of numbers for each IRQ channel if your kernel is at version 1.0.5 or later. On Intel architecture there are sixteen different IRQ channels, and their default meanings are as follows:
90
91
92 __0__ Timer channel 0
93 __1__ Keyboard
94 __2__ Cascade for controller 2 (which controls IRQ 8-15)
95 __3__ Serial Port 2
96 __4__ Serial Port 1
97 __5__ Parallel Port 2
98 __6__ Floppy Diskette Controller
99 __7__ Parallel Port 1
100 __8__ Real-time Clock
101 __9__ Redirected to IRQ2
102 __10__ --
103 __11__ --
104 __12__ --
105 __13__ Math Coprocessor
106 __14__ Hard Disk Controller
107 __15__ --
108
109
110 Note that the meanings of the IRQ channels for parallel ports, serial ports and those left empty may have been changed depending on your hardware setup. If that's the case on your machine, you're probably aware of it. If you're not, upgrade to at least Linux 1.1.43 and let __procinfo__ enlighten you about who uses what.
111
112
113
114
115 __Modules:__
116 ;: The modules (loadable device drivers) installed on your machine, with their sizes in kilobytes. (Only with __-m__ or __-a__ option). Modules with a use count larger than 0 are marked with an asterisk.
117
118 Deleted modules are marked with a `d', uninitialized modules with a `u', and modules with a bad state flag with a `b'.
119
120
121
122 __Character__ ''and'' __Block__ ''Devices:''
123 ;: All available devices with their major numbers. (Only with __-m__ or __-a__ option).
124
125
126
127 __File__ ''Systems:''
128 ;: All available file systems. (Only with __-m__ or __-a__ option). Those that do not require an actual device (like procfs itself) are noted between square brackets.
129
130
131
132 !!OPTIONS
133
134
135
136 ;__-f__ : Run __procinfo__ continuously full-screen.
137
138
139 ;__-n__ ''N'' : Pause N second between updates. This option implies __-f. It may contain a decimal point.__ The default is 5 seconds. When run by root with a pause of 0 seconds, the program will run at the highest possible priority level.
140
141
142 ;__-m__ : Show info about modules and device drivers instead of CPU and memory stats.
143
144
145 ;__-a__ : Show all information that __procinfo__ knows how to find.
146
147
148 ;__-d__ : For memory, CPU times, paging, swapping, disk, context and interrupt stats, display values per second rather than totals. This option implies __-f.__
149
150
151 ;__-D__ : Same as __-d,__ except that memory stats are displayed as totals.
152
153
154 ;__-S__ : When running with __-d__ or __-D,__ always show values per second, even when running with __-n N__ with __N__ greater than one second.
155
156
157 ;__-F__ ''file'' : Redirect output to __file__ (usually a tty). Nice if, for example, you want to run __procinfo__ permanently on a virtual console or on a terminal, by starting it from init(8) with a line like:
158
159 __p8:23:respawn:/usr/bin/procinfo -biDn1 -F/dev/tty8__
160
161
162
163
164 ;__-b__ : If your kernel is recent enough to display separate read and write numbers for disk I/O, the __-b__ flag makes __procinfo__ display numbers of blocks rather that numbers of I/O requests (neither of which is, alas, reliably translatable into kilobytes).
165
166
167 ;__-i__ : Normally the IRQ portion of the display is squeezed to only display non-zero IRQ channels. With this option you'll get the full list, but on Alphas and on Intel boxen with 2.1.104 kernels or later __procinfo__ won't fit inside a 80x24 screen anymore. Price of progress, I suppose.
168
169
170 ;__-r__ : This option adds an extra line to the memory info showing 'real' free memory, just as free(1) does.
171
172
173 ;__-h__ : Print a brief help message.
174
175
176 ;__-v__ : Print version info.
177
178
179
180 !!INTERACTIVE COMMANDS
181 When running __procinfo__ fullscreen, you can change its behaviour by pressing ''n,'' ''d,'' ''D,'' ''S,'' ''i,'' ''m,'' ''a,'' ''r'' and ''b,'' which have the same effect as the corresponding command line options. In addition you can press ''q'' which quits the program; ''s'' which switches back to the main screen after pressing ''m'' or ''a;'' ''t'' which switches back to displaying totals after pressing ''d'' or ''D;'' ''<space>'' which freezes the screen untill you press another key again; ''C'' and ''R'' which sets and releases a checkpoint in totals mode; and finally ''Ctrl-L'' which refreshes the screen.
182
183
184
185 !!FILES
186
187 ;__/proc__ : The proc file system.
188
189
190
191 !!BUGS
192 What, me worry?
193
194
195
196 !!SEE ALSO
197 free(1), uptime(1), w(1), init(8), proc(5).
198
199
200
201 !!AUTHOR
202 Sander van Malssen <svm''@''kozmix.cistron.nl>
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.