1XOSVIEW(1.8.3) XOSVIEW(1.8.3)
2
6 xosview - X based system monitor
7
9 xosview [options]
10
15 xosview is a monitor which displays the status of several system based
16 parameters. These include CPU usage, load average, memory usage, swap
17 space usage, network usage, interrupts, and serial port status. Each
18 of these is displayed as a horizontal bar which is separated into color
19 coded regions. Each region represents a percentage of the resource
20 which is being put to a particular use. Typing a 'q' in the window
21 will terminate xosview.
22 At the moment xosview runs on eight platforms (Linux, NetBSD, FreeBSD,
24 OpenBSD, some Solaris systems, IRIX 6.5, HPUX and GNU). Not all of the
25 meters described below are supported on all platforms. Some of the
26 meters may appear different depending upon the platform xosview is run‐
27 ning on. Note that *BSD is used as an abbreviation for all three of
28 the free BSD operating systems (NetBSD, FreeBSD, OpenBSD).
29 Load
31 all platforms : load
32 CPU Usage
34 Linux : user | nice | system | idle
35 *BSD : user | nice | system | interrupt | idle
36 IRIX : user | system | interrupt | wait | idle
37 HPUX : user | nice | system | interrupt | idle
38 Memory Usage
40 Linux : used | shared | buffers | free
41 NetBSD : active | inactive | wired | free
42 FreeBSD: active | inactive | wired | buffer | free
43 OpenBSD: active | inactive | wired | free
44 IRIX : kernel | fs | user | free
45 HPUX : text | used | other | free
46 GNU : active | inactive | wired | free
47 Swap Usage
49 all platforms except IRIX: used | free
50 Disk Usage (bytes/sec)
52 Linux : in | out | idle
53 *BSD : transferred | idle
54 HPUX : < Not Supported >
55 Page Swapping from/to disk
57 all platforms except IRIX : in | out | idle
58 NET Usage
60 bytes/sec
61 Linux : in | out | idle
62 *BSD : in | out | idle
63 HPUX : < Not Supported >
64 GFX Usage
66 swapbuffers/sec
67 IRIX : number of swapbuffers
68 Interrupts
70 "leds" which blink when an interrupt occurs.
71 Linux : IRQs 0 - 15
72 *BSD : IRQs 0 - 15 (or fewer, depending on architecture)
73 HPUX : < Not Supported >
74 Interrupt rate
76 interrupts per second
77 Linux : < Not Supported >
78 *BSD : interrupts | free
79 HPUX : < Not Supported >
80 Serial Port Status
82 "leds" which show the serial port parameters.
83 Linux : Both the Line Status Register
84 (LSR) and Modem Status Register
85 (MSR) are displayed.
86 *BSD : < Not Supported >
87 HPUX : < Not Supported >
88 Battery Level
90 Shows the current condition of the
91 battery (for laptops).
92 Linux : %left | %used
93 NetBSD : %left | %used
94 FreeBSD: < Not Supported >
95 OpenBSD: %left | %used
96 HPUX : < Not Supported >
97 RAID status
99 Shows the state of disks contained in your (software)
100 RAID1/4/5 array(s) and the rebuild state of the
101 array(s).
102 Linux : Disk0 Disk1 Disk2 .. DiskN | Rebuild Progress
103
106 Most of these command line options are just a convenient way to set one
107 or more of xosview's resources. Please see the RESOURCES section for
108 more details on what the resource is for.
109 -v
111 Displays the version number.
112 -name name
114 Sets the Resource name xosview will use (same as the -name
115 option for typical X applications like xterm). When performing
116 resource lookups, xosview will look under name, and then under
117 ``xosview''. For an example, perform the following (as docu‐
118 mented in README.netbsd):
119 xrdb -merge Xdefaults.stipple
120 xosview -name xosvstipple &
121 xosview -name xosvstipplebw &
122 -display display
125 Sets the X display to display. This option overrides the
126 xosview*display resource.
127 -font font
129 Specifies the font xosview will use for labels. This option
130 overrides the xosview*font resource.
131 -title title
133 This option sets the name xosview will tell the window manager
134 to use for the X window and icon. This option overrides the
135 xosview*title resource.
136 -geometry geometry_string
138 Sets the X geometry to geometry_string. This option overrides
139 the xosview*geometry resource.
140 -captions
142 This option overrides the xosview*captions resource. It is
143 equivalent to setting xosview*captions to "False".
144 +captions
145 This option overrides the xosview*captions resource. It is
146 equivalent to setting xosview*captions to "True".
147 -labels
149 This option overrides the xosview*labels resource. It is equiv‐
150 alent to setting xosview*labels to "False".
151 +labels
152 This option overrides the xosview*labels resource. It is equiv‐
153 alent to setting xosview*labels to "True".
154 -usedlabels
156 This option overrides the xosview*usedlabels resource. It is
157 equivalent to setting xosview*usedlabels to "False".
158 +usedlabels
160 This option overrides the xosview*usedlabels resource. It is
161 equivalent to setting xosview*usedlabels to "True".
162 -cpu
164 This option overrides the xosview*cpu resource. It is equiva‐
165 lent to setting xosview*cpu to "False".
166 +cpu
167 This option overrides the xosview*cpu resource. It is equiva‐
168 lent to setting xosview*cpu to "True".
169 -load
171 This option overrides the xosview*load resource. It is equiva‐
172 lent to setting xosview*load to "False".
173 +load
174 This option overrides the xosview*load resource. It is equiva‐
175 lent to setting xosview*load to "True".
176 -mem
178 This option overrides the xosview*mem resource. It is equiva‐
179 lent to setting xosview*mem to "False".
180 +mem
181 This option overrides the xosview*mem resource. It is equiva‐
182 lent to setting xosview*mem to "True".
183 -swap
185 This option overrides the xosview*swap resource. It is equiva‐
186 lent to setting xosview*swap to "False".
187 +swap
188 This option overrides the xosview*swap resource. It is equiva‐
189 lent to setting xosview*swap to "True".
190 -battery
192 This option overrides the xosview*battery resource. It is
193 equivalent to setting xosview*battery to "False".
194 +battery
195 This option overrides the xosview*battery resource. It is
196 equivalent to setting xosview*battery to "True".
197 -gfx
199 This option overrides the xosview*gfx resource. It is equiva‐
200 lent to setting xosview*gfx to "False".
201 +gfx
202 This option overrides the xosview*gfx resource. It is equiva‐
203 lent to setting xosview*gfx to "True".
204 -net
206 This option overrides the xosview*net resource. It is equiva‐
207 lent to setting xosview*net to "False".
208 +net
209 This option overrides the xosview*net resource. It is equiva‐
210 lent to setting xosview*net to "True".
211 -network maxbandwidth
213 -networkBW maxbandwidth
214 -networkBandwidth maxbandwidth
215 These options override the xosview*netBandwidth resource. They
216 cause xosview to display a meter that will shows network usage,
217 with a maximum bandwidth of maxbandwidth. Notice that setting
218 the bandwidth to 0 no longer disables the meter -- use the
219 ``-net'' option instead.
220 -page
222 This option overrides the xosview*page resource. It is equiva‐
223 lent to setting xosview*page to "False".
224 +page
225 This option overrides the xosview*page resource. It is equiva‐
226 lent to setting xosview*page to "True".
227 -pagespeed val
229 This option overrides the xosview*pageBandWidth resource. The
230 resource xosview*pageBandWidth will be set to val.
231 -disk
233 This option overrides the xosview*disk resource. It is equiva‐
234 lent to setting xosview*disk to "False".
235 +disk
236 This option overrides the xosview*disk resource. It is equiva‐
237 lent to setting xosview*disk to "True".
238 -int
240 This option overrides the xosview*int resource. It is equiva‐
241 lent to setting xosview*int to "False".
242 +int
243 This option overrides the xosview*int resource. It is equiva‐
244 lent to setting xosview*int to "True".
245 -ints +ints
247 -interrupts +interrupts
248 Equivalent to -int and +int.
249 -irqrate
251 This option overrides the xosview*irqrate resource. It is
252 equivalent to setting xosview*irqrate to "False".
253 +irqrate
254 This option overrides the xosview*irqrate resource. It is
255 equivalent to setting xosview*irqrate to "True".
256 -intrate +intrate
258 Equivalent to -irqrate and +irqrate.
259 -lmstemp
261 This option overrides the xosview*lmstemp resource. It is
262 equivalent to setting xosview*lmstemp to "False".
263 +lmstemp
264 This option overrides the xosview*lmstemp resource. It is
265 equivalent to setting xosview*lmstemp to "True".
266 -xrm resource_string
268 This switch allows any of xosview's resources to be set on the
269 command line. An example of how the xosview*memFreeColor could
270 be set using this option is shown below (Note the use of " to
271 prevent the shell from expanding ´*´ or from creating two sepa‐
272 rate arguments, ´xosview*memfreeColor:´ and ´purple´):
273 -xrm "xosview*memFreeColor: purple"
274
277 The following is a list of X resources supported by xosview. Each has
278 a default value assigned to it. These values can be found in the file
279 Xdefaults which can be obtained in the source distribution of xosview.
280 They can be overridden in the usual places (/usr/lib/X11/app-
281 defaults/XOsview, $HOME/.Xdefaults, etc.).
282 It should be noted that it is OK to have a resource defined for a port
284 of xosview that does not support the feature the resource configures.
285 Xosview will simply ignore the resources that are set for it but not
286 supported on a given platform.
287 General Resources
290 xosview*title: name
293 The string that xosview will use for the X window title. Nor‐
294 mally xosview will use 'xosview@machine_name' for a title. This
295 resource overrides the default behavior.
296 xosview*geometry: geometry_string
298 This is a standard X geometry string that defines the size and
299 location of the X window used by xosview.
300 xosview*display: name
302 The name of the display where xosview will contact the X server
303 for drawing its window.
304 xosview*pixmapName: name
306 The filename of an X pixmap (xpm) file for use as a background
307 image.
308 xosview*captions: (True or False)
310 If True then xosview will display meter captions.
311 xosview*labels: (True or False)
313 If True then xosview will display meter labels.
314 xosview*meterLabelColor: color
316 The color to use for the meter labels.
317 xosview*usedlabels: (True or False)
319 If True then xosview will display labels that show the percent‐
320 age of the resource (or absolute amount, depending on the meter)
321 being used. This option requires that the labels option also be
322 set to True.
323 xosview*usedLabelColor: color
325 The color to use for "used" labels.
326 xosview*borderwidth: width
328 The width of the border for the xosview window.
329 xosview*font: font
331 This is the font that xosview will use.
332 xosview*background: color
334 This is the color that will be used for the background.
335 xosview*foreground: color
337 This is the color that will be used for the foreground.
338 xosview*enableStipple: (True or False)
340 Change to true to try stipple support. This is primarily for
341 users stuck with 1-bit monitors/display cards. Try setting
342 enableStipple true. Please give us feedback on this, if you use
343 it. It needs some more work, but no one has given us any feed‐
344 back so far.
345 xosview*graphNumCols: number
347 This defines the number of sample bars drawn when a meter is in
348 scrolling graph mode. This also has the side-effect of defining
349 the width of the graph columns. This is only used by meters
350 which have graph mode enabled.
351 Load Meter Resources
354 xosview*load: (True or False)
357 If True then xosview will display a load meter.
358 xosview*loadWarnColor: color
360 This is the color that the load meter will use once the load
361 average is greater than 1.
362 xosview*loadProcColor: color
364 This is the color that the load meter will use to display the
365 load average when it is less than or equal to 1.
366 xosview*loadIdleColor: color
368 The load meter will use this color to display the idle field.
369 xosview*loadPriority: priority
371 This number (which must be an integer >= 1) sets the number of
372 tenths of a second that the load meter waits between updates. A
373 value of 1 has xosview update the meter 10 times per second (the
374 fastest). A value of 600 would cause xosview to update the
375 meter once a minute.
376 xosview*loadWarnThreshold: int
378 This number (which must be an integer >= 1) sets the value at
379 which the loadmeter changes its status and color from "normal"
380 to "alarm". The default value is 2.
381 xosview*loadDecay: (True or False)
383 You should probably leave this at the default value (False).
384 The load is already a time-averaged value!
385 xosview*loadGraph: (True or False)
387 If this is set to True then the load meter will be drawn as a
388 horizontally scrolling bargraph showing the state value verses
389 time.
390 xosview*loadUsedFormat: (float, percent or autoscale)
392 This resource tells xosview how to display "used" labels. The
393 formats work as follows:
394 float:
396 Display the value as a floating point number.
397 percent:
398 Display the value as a percentage of the total.
399 autoscale:
400 Display the absolute value and automatically print the
401 units (K, M, or G) as appropriate.
402 xosview*loadCpuSpeed: (True or False)
404 Display the current CPU speed in the load meter.
405 CPU Meter Resources
407 xosview*cpu: (True or False)
410 If True then xosview will display a cpu meter. On linux SMP
411 machines this will cause a seperate meter to be displayed for
412 each cpu if Jerome Forissier's kernel patch has been applied.
413 See the 'README.linux' file for more details. On IRIX 6.5, the
414 resource cpuFormat decides which meters are created for multiple
415 CPUs.
416 xosview*cpuUserColor: color
418 The cpu meter will use this color to display the cpu user time
419 field.
420 xosview*cpuNiceColor: color
421 The cpu meter will use this color to display the cpu nice time
422 field.
423 xosview*cpuSystemColor: color
424 The cpu meter will use this color to display the cpu system time
425 field.
426 xosview*cpuInterruptColor: color
427 The cpu meter will use this color to display the cpu interrupt
428 time field.
429 xosview*cpuFreeColor: color
430 The cpu meter will use this color to display the cpu idle time
431 field.
432 xosview*cpuPriority: priority
434 This number (which must be an integer >= 1) sets the number of
435 tenths of a second that the cpu meter waits between updates. A
436 value of 1 has xosview update the meter 10 times per second (the
437 fastest). A value of 600 would cause xosview to update the
438 meter once a minute.
439 xosview*cpuDecay: (True or False)
440 If True then the cpu meter will be split vertically in two. The
441 top half will show the instantaneous state, while the bottom
442 half will display a decaying average of the state.
443 xosview*cpuGraph: (True or False)
444 If this is set to True then the cpu meter will be drawn as a
445 horizontally scrolling bargraph showing the state value verses
446 time.
447 xosview*cpuUsedFormat: (float, percent or autoscale)
448 This resource tells xosview how to display "used" labels. The
449 formats work as follows:
450 float:
452 Display the value as a floating point number.
453 percent:
454 Display the value as a percentage of the total.
455 autoscale:
456 Display the absolute value and automatically print the
457 units (K, M, or G) as appropriate.
458 xosview*cpuFormat: (single, all, both or auto)
460 IRIX only.
461 If single, only a cumulative meter for all CPU is created. All
462 creates a meter for each CPU, but no cumulative meter. Both cre‐
463 ates one cumulative meter and one per cpu. auto behaves like
464 single on uniprocessor system, and like both on multiprocessor
465 systems.
466 Memory Meter Resources
470 xosview*mem: (True or False)
473 If True then xosview will display a mem meter.
474 xosview*memUsedColor: color
476 The mem meter will use this color to display the used memory
477 field.
478 xosview*memSharedColor: color
479 The mem meter will use this color to display the shared memory
480 field.
481 xosview*memBufferColor: color
482 The mem meter will use this color to display the buffer memory
483 field.
484 xosview*memCacheColor: color
485 The mem meter will use this color to display the cache memory
486 field.
487 xosview*memFreeColor: color
488 The mem meter will use this color to display the free memory
489 field.
490 xosview*memSharedColor: color
491 The mem meter will use this color to display the shared memory
492 field.
493 xosview*memTextColor: color
494 The mem meter will use this color to display the HP text memory
495 field.
496 xosview*memOtherColor: color
497 The mem meter will use this color to display the HP ``other''
498 memory field.
499 xosview*memActiveColor: color
500 The mem meter will use this color to display the NetBSD active
501 memory field.
502 xosview*memInactiveColor: color
503 The mem meter will use this color to display the NetBSD inactive
504 memory field.
505 xosview*memPriority: priority
507 This number (which must be an integer >= 1) sets the number of
508 tenths of a second that the mem meter waits between updates. A
509 value of 1 has xosview update the meter 10 times per second (the
510 fastest). A value of 600 would cause xosview to update the
511 meter once a minute.
512 xosview*memDecay: (True or False)
513 If True then the mem meter will be split vertically in two. The
514 top half will show the instantaneous state, while the bottom
515 half will display a decaying average of the state.
516 xosview*memGraph: (True or False)
517 If this is set to True then the mem meter will be drawn as a
518 horizontally scrolling bargraph showing the state value verses
519 time.
520 xosview*memUsedFormat: (float, percent or autoscale)
521 This resource tells xosview how to display "used" labels. The
522 formats work as follows:
523 float:
525 Display the value as a floating point number.
526 percent:
527 Display the value as a percentage of the total.
528 autoscale:
529 Display the absolute value and automatically print the
530 units (K, M, or G) as appropriate.
531 Swap Meter Resources
534 xosview*swap: (True or False)
536 If True then xosview will display a swap meter.
537 xosview*swapUsedColor: color
539 The swap meter will use this color to display the used swap
540 field.
541 xosview*swapFreeColor: color
542 The swap meter will use this color to display the free swap
543 field.
544 xosview*swapPriority: priority
546 This number (which must be an integer >= 1) sets the number of
547 tenths of a second that the swap meter waits between updates. A
548 value of 1 has xosview update the meter 10 times per second (the
549 fastest). A value of 600 would cause xosview to update the
550 meter once a minute.
551 xosview*swapDecay: (True or False)
552 If True then the swap meter will be split vertically in two.
553 The top half will show the instantaneous state, while the bottom
554 half will display a decaying average of the state.
555 xosview*swapGraph: (True or False)
556 If this is set to True then the swap meter will be drawn as a
557 horizontally scrolling bargraph showing the state value verses
558 time.
559 xosview*swapUsedFormat: (float, percent or autoscale)
560 This resource tells xosview how to display "used" labels. The
561 formats work as follows:
562 float:
564 Display the value as a floating point number.
565 percent:
566 Display the value as a percentage of the total.
567 autoscale:
568 Display the absolute value and automatically print the
569 units (K, M, or G) as appropriate.
570 Page Swapping Meter Resources
573 xosview*page: (True or False)
575 If True then xosview will display a page meter.
576 xosview*pageBandWidth: maxEvents
578 This number is used to specify the expected maximum bandwidth
579 (in events / sec) for the page meter. When the expected maximum
580 bandwidth (maxEvents) is exceeded then the page meter will dis‐
581 play the relative percentage of page swapping (25% in, 75% out).
582 xosview*pageInColor: color
584 The page meter will use this color to display the page-in field.
585 xosview*pageOutColor: color
586 The page meter will use this color to display the page-out
587 field.
588 xosview*pageIdleColor: color
589 The page meter will use this color to display the idle field.
590 xosview*pagePriority: priority
592 This number (which must be an integer >= 1) sets the number of
593 tenths of a second that the page meter waits between updates. A
594 value of 1 has xosview update the meter 10 times per second (the
595 fastest). A value of 600 would cause xosview to update the
596 meter once a minute.
597 xosview*pageDecay: (True or False)
598 If True then the page meter will be split vertically in two.
599 The top half will show the instantaneous state, while the bottom
600 half will display a decaying average of the state.
601 xosview*pageGraph: (True or False)
602 If this is set to True then the page meter will be drawn as a
603 horizontally scrolling bargraph showing the state value verses
604 time.
605 xosview*pageUsedFormat: (float, percent or autoscale)
606 This resource tells xosview how to display "used" labels. The
607 formats work as follows:
608 float:
610 Display the value as a floating point number.
611 percent:
612 Display the value as a percentage of the total.
613 autoscale:
614 Display the absolute value and automatically print the
615 units (K, M, or G) as appropriate.
616 Gfx Meter Resources
619 xosview*gfx: (True or False)
622 If True xosview will display the GfxMeter. The value is sampled
623 once per second, due to the usage of sadc to sample data.
624 xosview*gfxWarnColor: color
626 This is the color that the gfx meter will use once the warn
627 state is reached.
628 xosview*gfxAlarmColor: color
630 This is the color that the gfx meter will use once the alarm
631 state is reached.
632 xosview*gfxSwapColor: color
634 This is the color that the gfx meter will use in normal state
635 xosview*gfxIdleColor: color
637 The gfx meter will use this color to display the idle field.
638 xosview*gfxPriority: priority
640 This number (which must be an integer >= 1) sets the number of
641 tenths of a second that the gfx meter waits between updates. A
642 value of 1 has xosview update the meter 10 times per second (the
643 fastest). A value of 600 would cause xosview to update the
644 meter once a minute.
645 xosview*gfxWarnThreshold: int
647 This number (which must be an integer >= 1) of swapbuffers per
648 second and pipe at which the gfxmeter changes its status and
649 color from "normal" to "warn". The default value is 60.
650 xosview*gfxAlarmThreshold: int
652 This number (which must be an integer >= gfxWarnThreshold) of
653 swapbuffers per second and pipe at which the gfxmeter changes
654 its status and color from "warn" to "alarm". The default value
655 is 120.
656 xosview*gfxDecay: (True or False)
658 You should probably leave this at the default value (False).
659 The gfx does not work in decay mode.
660 xosview*gfxGraph: (True or False)
662 If this is set to True then the gfx meter will be drawn as a
663 horizontally scrolling bargraph showing the state value verses
664 time.
665 xosview*gfxUsedFormat: (float, percent or autoscale)
667 This resource tells xosview how to display "used" labels. The
668 formats work as follows:
669 float:
671 Display the value as a floating point number.
672 percent:
673 Display the value as a percentage of the total.
674 autoscale:
675 Display the absolute value and automatically print the
676 units (K, M, or G) as appropriate.
677 Network Meter Resources
680 xosview*net: (True or False)
683 If True xosview will display the NetMeter. Linux users will
684 have to configure their kernels and setup some ip accounting
685 rules to make this work. See the file README.linux which comes
686 with the xosview distribution for details.
687 xosview*netBandwidth: maxBytes
689 This number is used to specify the expected maximum bandwidth
690 (in bytes / sec) for the meter. When the expected maximum band‐
691 width (maxBytes) is exceeded then the network meter will display
692 the relative percentage of network usage (25% incomming, 75%
693 outgoing).
694 xosview*netIface: interface
696 If False, xosview will display the data received/transmitted by
697 any of the network interfaces. Otherwise, xosview will only dis‐
698 play the data received/transmitted by the specified network
699 interface.
700 xosview*netInColor: color
702 The net meter will use this color to display the incoming
703 field.
704 xosview*netOutColor: color
705 The net meter will use this color to display the outgoing
706 field.
707 xosview*netBackground: color
709 This is the color that the network meter will use for the
710 "idle" field.
711 xosview*netPriority: priority
713 This number (which must be an integer >= 1) sets the num‐
714 ber of tenths of a second that the net meter waits
715 between updates. A value of 1 has xosview update the
716 meter 10 times per second (the fastest). A value of 600
717 would cause xosview to update the meter once a minute.
718 xosview*netDecay: (True or False)
719 If True then the net meter will be split vertically in
720 two. The top half will show the instantaneous state,
721 while the bottom half will display a decaying average of
722 the state.
723 xosview*netGraph: (True or False)
724 If this is set to True then the net meter will be drawn
725 as a horizontally scrolling bargraph showing the state
726 value verses time.
727 xosview*netUsedFormat: (float, percent or autoscale)
728 This resource tells xosview how to display "used" labels.
729 The formats work as follows:
730 float:
732 Display the value as a floating point number.
733 percent:
734 Display the value as a percentage of the total.
735 autoscale:
736 Display the absolute value and automatically print
737 the units (K, M, or G) as appropriate.
738 NFSStats (Client) Resources
740 xosview*NFSStats: (True or False)
743 If True then xosview will display a meter to monitor NFS
744 client stats.
745 xosview*NFSStatReTransColor: color
747 The color to be used for retransmit stats.
748 xosview*NFSStatAuthRefrshColor: color
750 The color to be used for auth refresh stats.
751 xosview*NFSStatCallsColor: color
753 The color to be used for call stats.
754 xosview*NFSStatIdleColor: color
756 The color to be used for idle stats.
757 NFSDStats (Server) Resources
760 xosview*NFSDStats: (True or False)
762 If True xosview will display a meter for NFS server/dae‐
763 mon stats.
764 xosview*NFSDStatCallsColor: color
766 The color to be used for call stats.
767 xosview*NFSDStatBadCallsColor: color
769 The color to be used for bad stats.
770 xosview*NFSDStatUDPColor: color
772 The color to be used for UDP stats.
773 xosview*NFSDStatTCPColor: color
775 The color to be used for TCP stats.
776 xosview*NFSDStatIdleColor: color
778 The color to be used for idle stats.
779 Serial Meter Resources
782 xosview*serial(0-9): (True, False, or portBase)
785 If True then xosview will display a serial meter for
786 ttySx. The portbase will be autodetected. Because
787 autodetection can fail, (if the port is locked by
788 ppp/slip for example) you can specify the portbase
789 instead of "True". If a portBase is used then xosview
790 will use it instead of trying to autodetect.
791 For this to work on Linux xosview needs to be suid root
793 in order to have access to the ports. See the file
794 README.linux which comes with the xosview distribution
795 for more details.
796 xosview*serialOnColor: color
798 This is the color the serial meter will use for bits that
799 are set.
800 xosview*serialOffColor: color
802 This is the color the serial meter will use for bits that
803 are not set.
804 xosview*serialPriority: priority
806 This number (which must be an integer >= 1) sets the num‐
807 ber of tenths of a second that the serial meter waits
808 between updates. A value of 1 has xosview update the
809 meter 10 times per second (the fastest). A value of 600
810 would cause xosview to update the meter once a minute.
811 Interrupt Meter Resources
814 xosview*interrupts: (True or False)
817 If True then xosview will display an interrupt meter.
818 xosview*intOnColor: color
820 This is the color that will be used to show "active"
821 interrupts.
822 xosview*intOffColor: color
824 This is the color that will be used to show "inactive"
825 interrupts.
826 xosview*intPriority: priority
828 This number (which must be an integer >= 1) sets the num‐
829 ber of tenths of a second that the int meter waits
830 between updates. A value of 1 has xosview update the
831 meter 10 times per second (the fastest). A value of 600
832 would cause xosview to update the meter once a minute.
833 Lm Sensors Temperature Resources
836 xosview*lmstemp: (True or False)
838 If True then xosview will display a lmstemp meter.
839 xosview*lmstempHighest: 100
841 Highest temp value displayed, default 100.
842 xosview*lmstempActColor: color
844 Color of actual temperature.
845 xosview*lmstempHighColor: color
847 Color above alarm temperature, also used to indicate
848 alarm.
849 xosview*lmstempIdleColor: color
851 Color between actual and alarm temperatures.
852 xosview*lmstempN: filename
854 Name of temperature file from /proc/sys/dev/sensors/*/*,
855 N=1..
856 Note if more files with same name exists, only the first
857 is found. There is currently no possiblity to configure
858 equal named files on different busses (which would be
859 rarely necessary, I hope).
860 eg.
861 xosview*lmstemp1: temp xosview*lmstemp2: remote_temp
862 xosview*lmstempLabelN: Labelstring
864 N-th label for above temperatures, default is TMP.
865 xosview*lmstempPriority: priority
867 This number (which must be an integer >= 1) sets the num‐
868 ber of tenths of a second that the lmstemp meter waits
869 between updates. A value of 1 has xosview update the
870 meter 10 times per second (the fastest). A value of 600
871 would cause xosview to update the meter once a minute.
872 xosview*lmstempUsedFormat: (float, percent or autoscale)
873 This resource tells xosview how to display "used" labels.
874 The formats work as follows:
875 float:
877 Display the value as a floating point number.
878 percent:
879 Display the value as a percentage of the total.
880 autoscale:
881 Display the absolute value and automatically print
882 the units (K, M, or G) as appropriate.
883 Battery Meter Resources
885 xosview*battery: (True or False)
887 If True then xosview will display a battery meter. Linux
888 users will need to have APM or ACPI support in their ker‐
889 nels for this to work. For both, APM and ACPI xosview
890 shows the status/sum of all batteries. Additionally -
891 the legend text gets changed/adjusted to reflect the cur‐
892 rent state (charging/low/critical/etc.) of the bat‐
893 tery/batteries.
894 xosview*batteryLeftColor: color
896 This is the color that will be used to show the amount of
897 battery power left.
898 xosview*batteryUsedColor: color
900 This is the color that will be used to show the amount of
901 battery power used.
902 xosview*batteryChargeColor: color
904 This is the color that will be used as 'left' - if the
905 batteries get charged.
906 xosview*batteryFullColor: color
908 This is the color that will be used as 'left' - if the
909 batteries are fully charged. APM and ACPI does provide
910 this info, but not all machines actually do so.
911 xosview*batteryLowColor: color
913 APM only - the 'left' color that will indicate a low bat‐
914 tery. Depends on the machine - e.g. below 25% remaining
915 capacity.
916 xosview*batteryCritColor: color
918 APM case: the 'left' color if APM indicates 'critical'
919 state. (less than 5%)
920 ACPI case: the 'left' color if the remaining capacity is
922 below the alarm value. (which can be set by the user in
923 /proc/acpi/battery/BAT[01]/alarm )
924 xosview*batteryNoneColor: color
926 If no battery is present - or all batteries get removed
927 (while on AC).
928 xosview*batteryPriority: priority
931 This number (which must be an integer >= 1) sets the num‐
932 ber of tenths of a second that the battery meter waits
933 between updates. A value of 1 has xosview update the
934 meter 10 times per second (the fastest). A value of 600
935 would cause xosview to update the meter once a minute.
936 xosview*batteryUsedFormat: (float, percent or autoscale)
937 This resource tells xosview how to display "used" labels.
938 The formats work as follows:
939 float:
941 Display the value as a floating point number.
942 percent:
943 Display the value as a percentage of the total.
944 autoscale:
945 Display the absolute value and automatically print
946 the units (K, M, or G) as appropriate.
947 Disk Meter Resources
949 xosview*disk: (True or False)
951 If True then xosview will display a disk meter.
952 xosview*diskUsedColor: color
954 The disk meter will use this color to display the bytes
955 transferred (in or out) field.
956 xosview*diskIdleColor: color
957 The disk meter will use this color to display the idle
958 field.
959 xosview*diskBandwidth: bandwidth
961 This number is used to specify the expected maximum band‐
962 width in bytes per second for the disk meter.
963 xosview*diskWriteColor: color
965 This color will be used for the linux meter to show
966 writes.
967 xosview*diskReadColor: color
969 This color will be used for the linux meter to show
970 reads.
971 xosview*diskPriority: priority
973 This number (which must be an integer >= 1) sets the num‐
974 ber of tenths of a second that the disk meter waits
975 between updates. A value of 1 has xosview update the
976 meter 10 times per second (the fastest). A value of 600
977 would cause xosview to update the meter once a minute.
978 xosview*diskDecay: (True or False)
979 If True then the disk meter will be split vertically in
980 two. The top half will show the instantaneous state,
981 while the bottom half will display a decaying average of
982 the state.
983 xosview*diskGraph: (True or False)
984 If this is set to True then the disk meter will be drawn
985 as a horizontally scrolling bargraph showing the state
986 value verses time.
987 xosview*diskUsedFormat: (float, percent or autoscale)
988 This resource tells xosview how to display "used" labels.
989 The formats work as follows:
990 float:
992 Display the value as a floating point number.
993 percent:
994 Display the value as a percentage of the total.
995 autoscale:
996 Display the absolute value and automatically print
997 the units (K, M, or G) as appropriate.
998 RAID Meter Resources
1000 xosview*RAID: (True or False)
1002 If True then xosview will display a RAID meter.
1003 xosview*RAIDdevicecount: int
1005 Please enter your RAID device count (n) here or 0 if you
1006 don't have any supported RAID devices. xosview then will
1007 display n RAID state displays.
1008 xosview*RAIDdiskOnlineColor: color
1010 xosview*RAIDdiskFailureColor: color
1012 These colors will be used for indicating working/online
1013 or failed/offline disks. The order (from left to right)
1014 is the same as in /proc/mdstat.
1015 xosview*RAIDresyncdoneColor: color
1017 xosview*RAIDresynctodoColor: color
1019 xosview*RAIDresynccompleteColor: color
1021 If a resync/rebuild of the RAID array is in progress, the
1022 "done" and "todo" colors will be used. If no
1023 rebuild/resync is running, then the "complete" color will
1024 be shown.
1025 xosview*RAIDPriority: priority
1027 This number (which must be an integer >= 1) sets the num‐
1028 ber of tenths of a second that the RAID meter waits
1029 between updates. A value of 1 has xosview update the
1030 meter 10 times per second (the fastest). A value of 600
1031 would cause xosview to update the meter once a minute.
1032 xosview*RAIDUsedFormat: (float, percent or autoscale)
1034 This resource tells xosview how to display "used" labels.
1035 The formats work as follows:
1036 float:
1038 Display the value as a floating point number.
1039 percent:
1040 Display the value as a percentage of the total.
1041 autoscale:
1042 Display the absolute value and automatically print
1043 the units (K, M, or G) as appropriate.
1044
1047 Here is a list of known bugs. Reports of unknown bugs are appreciated
1048 and should be directed to:
1049 Mike Romberg (mike.romberg@noaa.gov)
1051 General xosview bugs and bugs related to the Linux and
1052 HPUX ports.
1053 Brian Grayson (bgrayson@netbsd.org)
1055 Bugs related to the NetBSD port. I am also a catch-all
1056 for bug reports for the other *BSDs and SunOS.
1057 Stefan Eilemann (eilemann@gmail.com)
1059 Bugs related to the IRIX port.
1060
1063 The most current version of xosview can be found at the following
1064 sites:
1065 http://xosview.sourceforge.net
1067 ftp://sunsite.unc.edu/pub/Linux/system/status/xstatus
1068 For *BSD users with the ports/package system, the sysutils/xosview tree
1070 ought to also have a version that is just as up-to-date.
1071
1074 Mike Romberg (mike.romberg@noaa.gov)
1075 Original author, Linux and HPUX ports.
1076 Brian Grayson (bgrayson@netbsd.org)
1078 NetBSD port and most of the nice enhancements for version 1.4,
1079 initial work on FreeBSD port.
1080 Scott McNab (jedi@tartarus.uwa.edu.au)
1082 Added the scrolling graph mode.
1083 Tom Pavel (pavel@slac.stanford.edu)
1085 Most of the FreeBSD support, more resource-handling improve‐
1086 ments.
1087 Greg Onufer (exodus@cheers.bungi.com)
1089 SunOS port.
1090 Stefan Eilemann (eilemann@gmail.com)
1092 IRIX 6.5 port.
1093 Sheldon Hearn (axl@iafrica.com)
1095 FreeBSD libdevstat-based diskmeter support.
1096 David W. Talmage (talmage@jefferson.cmf.nrl.navy.mil)
1098 Added battery-meter support to NetBSD.
1099 Oleg Safiullin (form@openbsd.org)
1101 OpenBSD interrupt-meter support.
1102 Werner Fink (werner@suse.de)
1104 Originator of the loadmeter.
1105 Massimiliano Ghilardi ( ghilardi@cibs.sns.it )
1107 Linux pagemeter.
1108 Carsten Schabacker (cschaba@spock.central.de)
1110 Made extensions to the serial-meter.
1111 Paal Beyer <pbeyer@online.no>
1113 Ported the linux memstat kernel module to linux-2.1
1114 Jerome Forissier <forissier@isia.cma.fr>
1116 Maintains the linux SMP kernel patch which xosview uses to dis‐
1117 play meters for each cpu. This patch can be found at the fol‐
1118 lowing URL:
1119 http://www-isia.cma.fr/~forissie/smp_kernel_patch/
1120 Tomer Klainer <mandor@cs.huji.ac.il>
1122 Initial port to BSDI.
1123 Arno Augustin (Arno.Augustin@3SOFT.de)
1125 Solaris disk and network meters.
1126 Alberto BARSELLA <ishark@lsh01.univ-lille1.fr>
1128 Fixes for linux diskmeter + ip_chains support
1129 Thomas Waldmann (ThomasWaldmann@gmx.de)
1131 Linux raid meter, bitfieldmeter. Many cosmetic fixes.
1132 Leopold Toetsch <lt@toetsch.at>
1134 Linux lms temp meter.
1135 David O'Brien (obrien@nuxi.com)
1137 FreeBSD 4.* updates, and a few other suggestions.
1138 Christos Zoulas (christos@netbsd.org)
1140 C++ standard compliance and other NetBSD fixes.
1141 And many others who have sent in small fixes and improvements.
11433rd Berkeley Distribution$Date: 2008/02/28 23:43:06 $ XOSVIEW(1.8.3)