1XOSVIEW(1)                  General Commands Manual                 XOSVIEW(1)
2
3
4

NAME

6       xosview - X based system monitor
7

SYNOPSIS

9       xosview [options]
10
11
12
13

DESCRIPTION

15       xosview is a monitor which displays the status of several system param‐
16       eters.  These include CPU usage, load average, memory, swap space, net‐
17       work  usage  and  more.  Each resource is displayed as a horizontal bar
18       which is separated into color coded regions showing how much of the re‐
19       source is being put to a particular use.
20
21       xosview  runs  on  several  platforms (Linux, NetBSD, FreeBSD, OpenBSD,
22       DragonflyBSD, some Solaris systems, IRIX 6.5, HPUX and GNU).   Not  all
23       of  the meters described below are supported on all platforms.  Some of
24       the meters may appear different depending upon the platform xosview  is
25       running on.  Note that *BSD is used as an abbreviation for all the sup‐
26       ported BSD operating systems (NetBSD, FreeBSD, OpenBSD, DragonflyBSD).
27
28       Load: Kernel reported load average
29          all platforms  :  load
30          Linux          :  load | CPU frequency
31          *BSD           :  load | CPU frequency
32          SunOS5         :  load | CPU frequency
33
34       CPU Usage
35          Linux  : user | nice | system | soft-interrupt | interrupt | io-wait
36       |
37                   guest | niced guest | stolen | idle
38          *BSD   : user | nice | system | interrupt | idle
39          SunOS5 : user | system | wait | idle
40          IRIX   : user | system | interrupt | wait | idle
41          HPUX   : user | nice | system | interrupt | idle
42
43       Memory Usage
44          Linux  : used | buffers | slab | map | cache | free
45          FreeBSD: active | inactive | wired | cache | free
46          DFBSD  : active | inactive | wired | cache | free
47          OpenBSD: active | inactive | wired | free
48          NetBSD : active | inactive | wired | free
49          SunOS5 : kernel | zfs | other | free
50          IRIX   : kernel | fs | user | free
51          HPUX   : text | used | other | free
52          GNU    : active | inactive | wired | free
53
54       Swap Usage
55          Linux  : used | free
56          *BSD   : used | free
57          SunOS5 : used | free
58          HPUX   : used | free
59          GNU    : used | free
60
61       Disk Usage: Throughput to/from local disk, per second
62          Linux  : in | out | idle
63          *BSD   : in | out | idle
64          SunOS5 : in | out | idle
65
66       Page Swapping: Pages to/from swap, per second
67          Linux  : in | out | idle
68          *BSD   : in | out | idle
69          SunOS5 : in | out | idle
70          HPUX   : in | out | idle
71          GNU    : in | out | idle
72
73       Network Usage
74          Linux  : in | out | idle
75          *BSD   : in | out | idle
76          SunOS5 : in | out | idle
77
78       GFX Usage: Framebuffer exchanges, per second
79          IRIX   : swapbuffers
80
81       Interrupts: "leds" which blink when an interrupt occurs
82          Linux  : IRQs
83          *BSD   : IRQs
84
85       Interrupt Rate: Per second
86          Linux  : interrupts | free
87          *BSD   : interrupts | free
88          SunOS5 : interrupts | free
89
90       Serial Port Status: "leds" which show the serial port parameters
91          Linux  : LSR and MSR
92
93       Battery Level: charge and status of batteries
94          Linux  : available | used
95          *BSD   : available | used
96
97       RAID: State of disks in a software RAID array
98          Linux  : disk0 disk1 disk2 ... diskN | rebuild
99
100       Wireless Link
101          Linux  : quality
102
103       Sensors: Readings from sensors
104          Linux  : I2C/hwmon sensors (lmstemp)
105                   Intel Core/AMD K8+/VIA C7 temperature (coretemp)
106                   ACPI thermal zones (acpitemp)
107          *BSD   : I2C sensors (bsdsensor)
108                   Intel Core/AMD K8+ temperature (coretemp)
109
110       Typing a 'q' in the window will terminate xosview.
111
112

OPTIONS

114       Most of these command line options are just a convenient way to set one
115       or more of xosview's resources.  Please see the RESOURCES  section  for
116       more details on what the resource is for.
117
118       -v
119              Displays the version number.
120
121       -name name
122              Sets  the  Resource name xosview will use (same as the -name op‐
123              tion for typical X applications like  xterm).   When  performing
124              resource  lookups,  xosview will look under name, and then under
125              ``xosview''.  For an example, perform the  following  (as  docu‐
126              mented in README.netbsd):
127                       xrdb -merge Xdefaults.stipple
128                       xosview -name xosvstipple &
129                       xosview -name xosvstipplebw &
130
131       -display display
132              Sets  the  X  display  to  display.   This  option overrides the
133              xosview*display resource.
134
135       -font font
136              Specifies the font xosview will use  for  labels.   This  option
137              overrides the xosview*font resource.
138
139       -title title
140              This  option  sets the name xosview will tell the window manager
141              to use for the X window and icon.   This  option  overrides  the
142              xosview*title resource.
143
144       -geometry geometry_string
145              Sets  the  X geometry to geometry_string.  This option overrides
146              the xosview*geometry resource.
147
148       -captions
149              This option overrides  the  xosview*captions  resource.   It  is
150              equivalent to setting xosview*captions to "False".
151
152       +captions
153              This  option  overrides  the  xosview*captions  resource.  It is
154              equivalent to setting xosview*captions to "True".
155       -labels
156              This option overrides the xosview*labels resource.  It is equiv‐
157              alent to setting xosview*labels to "False".
158
159       +labels
160              This option overrides the xosview*labels resource.  It is equiv‐
161              alent to setting xosview*labels to "True".
162       -usedlabels
163              This option overrides the xosview*usedlabels  resource.   It  is
164              equivalent to setting xosview*usedlabels to "False".
165
166       +usedlabels
167              This  option  overrides  the xosview*usedlabels resource.  It is
168              equivalent to setting xosview*usedlabels to "True".
169       -cpu
170              This option overrides the xosview*cpu resource.  It  is  equiva‐
171              lent to setting xosview*cpu to "False".
172
173       +cpu
174              This  option  overrides the xosview*cpu resource.  It is equiva‐
175              lent to setting xosview*cpu to "True".
176
177       -cpus
178              Force the display of a single meter for all CPUs in the  system.
179              This  option is equivalent to setting xosview*cpuFormat to "sin‐
180              gle".
181
182       +cpus
183              Force the display of all CPUs in  the  system.  This  option  is
184              equivalent to setting xosview*cpuFormat to "all".
185
186       -load
187              This  option overrides the xosview*load resource.  It is equiva‐
188              lent to setting xosview*load to "False".
189
190       +load
191              This option overrides the xosview*load resource.  It is  equiva‐
192              lent to setting xosview*load to "True".
193       -mem
194              This  option  overrides the xosview*mem resource.  It is equiva‐
195              lent to setting xosview*mem to "False".
196
197       +mem
198              This option overrides the xosview*mem resource.  It  is  equiva‐
199              lent to setting xosview*mem to "True".
200       -swap
201              This  option overrides the xosview*swap resource.  It is equiva‐
202              lent to setting xosview*swap to "False".
203
204       +swap
205              This option overrides the xosview*swap resource.  It is  equiva‐
206              lent to setting xosview*swap to "True".
207       -battery
208              This  option  overrides  the  xosview*battery  resource.   It is
209              equivalent to setting xosview*battery to "False".
210
211       +battery
212              This option  overrides  the  xosview*battery  resource.   It  is
213              equivalent to setting xosview*battery to "True".
214       -gfx
215              This  option  overrides the xosview*gfx resource.  It is equiva‐
216              lent to setting xosview*gfx to "False".
217
218       +gfx
219              This option overrides the xosview*gfx resource.  It  is  equiva‐
220              lent to setting xosview*gfx to "True".
221       -wireless
222              This  option  overrides  the  xosview*wireless  resource.  It is
223              equivalent to setting xosview*wireless to "False".
224
225       +wireless
226              This option overrides  the  xosview*wireless  resource.   It  is
227              equivalent to setting xosview*wireless to "True".
228       -net
229              This  option  overrides the xosview*net resource.  It is equiva‐
230              lent to setting xosview*net to "False".
231
232       +net
233              This option overrides the xosview*net resource.  It  is  equiva‐
234              lent to setting xosview*net to "True".
235
236       -network maxbandwidth
237       -networkBW maxbandwidth
238       -networkBandwidth maxbandwidth
239              These  options override the xosview*netBandwidth resource.  They
240              cause xosview to display a meter that will shows network  usage,
241              with  a  maximum bandwidth of maxbandwidth.  Notice that setting
242              the bandwidth to 0 no longer  disables  the  meter  --  use  the
243              ``-net'' option instead.
244
245       -page
246              This  option overrides the xosview*page resource.  It is equiva‐
247              lent to setting xosview*page to "False".
248
249       +page
250              This option overrides the xosview*page resource.  It is  equiva‐
251              lent to setting xosview*page to "True".
252
253       -pagespeed val
254              This  option  overrides the xosview*pageBandWidth resource.  The
255              resource xosview*pageBandWidth will be set to val.
256
257       -disk
258              This option overrides the xosview*disk resource.  It is  equiva‐
259              lent to setting xosview*disk to "False".
260
261       +disk
262              This  option overrides the xosview*disk resource.  It is equiva‐
263              lent to setting xosview*disk to "True".
264       -int
265              This option overrides the xosview*int resource.  It  is  equiva‐
266              lent to setting xosview*int to "False".
267
268       +int
269              This  option  overrides the xosview*int resource.  It is equiva‐
270              lent to setting xosview*int to "True".
271
272       -ints +ints
273       -interrupts +interrupts
274              Equivalent to -int and +int.
275
276       -irqrate
277              This option  overrides  the  xosview*irqrate  resource.   It  is
278              equivalent to setting xosview*irqrate to "False".
279
280       +irqrate
281              This  option  overrides  the  xosview*irqrate  resource.   It is
282              equivalent to setting xosview*irqrate to "True".
283
284       -intrate +intrate
285              Equivalent to -irqrate and +irqrate.
286
287       -lmstemp
288              This option  overrides  the  xosview*lmstemp  resource.   It  is
289              equivalent to setting xosview*lmstemp to "False".
290
291       +lmstemp
292              This  option  overrides  the  xosview*lmstemp  resource.   It is
293              equivalent to setting xosview*lmstemp to "True".
294       -coretemp
295              This option overrides  the  xosview*coretemp  resource.   It  is
296              equivalent to setting xosview*coretemp to "False".
297
298       +coretemp
299              This  option  overrides  the  xosview*coretemp  resource.  It is
300              equivalent to setting xosview*coretemp to "True".
301       -acpitemp
302              This option overrides  the  xosview*acpitemp  resource.   It  is
303              equivalent to setting xosview*acpitemp to "False".
304
305       +acpitemp
306              This  option  overrides  the  xosview*acpitemp  resource.  It is
307              equivalent to setting xosview*acpitemp to "True".
308       -bsdsensor
309              This option overrides the  xosview*bsdsensor  resource.   It  is
310              equivalent to setting xosview*bsdsensor to "False".
311
312       +bsdsensor
313              This  option  overrides  the  xosview*bsdsensor resource.  It is
314              equivalent to setting xosview*bsdsensor to "True".
315
316       -xrm resource_string
317              This switch allows any of xosview's resources to be set  on  the
318              command  line.  An example of how the xosview*memFreeColor could
319              be set using this option is shown below (Note the use  of  "  to
320              prevent  the shell from expanding ´*´ or from creating two sepa‐
321              rate arguments, ´xosview*memfreeColor:´ and ´purple´):
322                     -xrm "xosview*memFreeColor: purple"
323
324

X RESOURCES

326       The following is a list of X resources supported by xosview.  Each  has
327       a  default value assigned to it.  These values can be found in the file
328       Xdefaults which can be obtained in the source distribution of  xosview.
329       They  can  be  overridden  in  the  usual  places (/usr/lib/X11/app-de‐
330       faults/XOsview, $HOME/.Xdefaults, etc.).
331
332       It should be noted that it is OK to have a resource defined for a  port
333       of  xosview  that does not support the feature the resource configures.
334       Xosview will simply ignore the resources that are set for  it  but  not
335       supported on a given platform.
336
337
338       General Resources
339
340       xosview*title: name
341              The  string  that xosview will use for the X window title.  Nor‐
342              mally xosview will use 'xosview@machine_name' for a title.  This
343              resource overrides the default behavior.
344
345       xosview*geometry: geometry_string
346              This  is  a standard X geometry string that defines the size and
347              location of the X window used by xosview.
348
349       xosview*display: name
350              The name of the display where xosview will contact the X  server
351              for drawing its window.
352
353       xosview*pixmapName: name
354              The  filename  of an X pixmap (xpm) file for use as a background
355              image.
356
357       xosview*captions: (True or False)
358              If True then xosview will display meter captions.
359
360       xosview*labels: (True or False)
361              If True then xosview will display meter labels.
362
363       xosview*meterLabelColor: color
364              The color to use for the meter labels.
365
366       xosview*usedlabels: (True or False)
367              If True then xosview will display labels that show the  percent‐
368              age of the resource (or absolute amount, depending on the meter)
369              being used.  This option requires that the labels option also be
370              set to True.
371
372       xosview*usedLabelColor: color
373              The color to use for "used" labels.
374
375       xosview*borderwidth: width
376              The width of the border for the xosview window.
377
378       xosview*font: font
379              This  is  the  font that xosview will use. This is a bitmap font
380              rendered at the X server. To list the available fonts, use  xls‐
381              fonts(1), and rehash the list with xset(1).
382
383       xosview*background: color
384              This is the color that will be used for the background.
385
386       xosview*foreground: color
387              This is the color that will be used for the foreground.
388
389       xosview*enableStipple: (True or False)
390              Change  to  true  to try stipple support.  This is primarily for
391              users stuck with 1-bit monitors/display cards.  Try setting  en‐
392              ableStipple  true.   Please give us feedback on this, if you use
393              it.  It needs some more work, but no one has given us any  feed‐
394              back so far.
395
396       xosview*graphNumCols: number
397              This  defines the number of sample bars drawn when a meter is in
398              scrolling graph mode. This also has the side-effect of  defining
399              the  width  of  the  graph  columns. This is only used by meters
400              which have graph mode enabled.
401
402
403       Load Meter Resources
404
405       xosview*load: (True or False)
406              If True then xosview will display a load meter.
407
408       xosview*loadProcColor: color
409              This is the color that the load meter will use  to  display  the
410              load average when it is below the warning threshold.
411
412       xosview*loadWarnColor: color
413              This is the color that the load meter will use once the load av‐
414              erage is above the warning but below the critical  load  thresh‐
415              old.
416
417       xosview*loadCritColor: color
418              This is the color that the load meter will use once the load av‐
419              erage is above critical load threshold.
420
421       xosview*loadIdleColor: color
422              The load meter will use this color to display the idle field.
423
424       xosview*loadPriority: priority
425              This number (which must be an integer >= 1) sets the  number  of
426              tenths of a second that the load meter waits between updates.  A
427              value of 1 has xosview update the meter 10 times per second (the
428              fastest).   A value of 600 would cause xosview to update the me‐
429              ter once a minute.
430
431       xosview*loadWarnThreshold: int
432              This number (which must be an integer >= 1) sets  the  value  at
433              which  the  loadmeter changes its status and color from "normal"
434              to "warning".  The default value is the number of processors.
435
436       xosview*loadCritThreshold: int
437              This number (which must be an integer >= 1) sets  the  value  at
438              which  the loadmeter changes its status and color from "warning"
439              to "critical".  The default value  is  four  times  the  warning
440              threshold.
441
442       xosview*loadDecay: (True or False)
443              You  should  probably  leave  this at the default value (False).
444              The load is already a time-averaged value!
445
446       xosview*loadGraph: (True or False)
447              If this is set to True then the load meter will be  drawn  as  a
448              horizontally  scrolling  bargraph showing the state value verses
449              time.
450
451       xosview*loadUsedFormat: (float, percent or autoscale)
452              This resource tells xosview how to display "used"  labels.   The
453              formats work as follows:
454
455              float:
456                     Display the value as a floating point number.
457              percent:
458                     Display the value as a percentage of the total.
459              autoscale:
460                     Display  the  absolute  value and automatically print the
461                     units (K, M, or G) as appropriate.
462
463       xosview*loadCpuSpeed: (True or False)
464              Display the current CPU speed in the load meter.
465
466
467       CPU Meter Resources
468
469       xosview*cpu: (True or False)
470              If True then xosview will display a cpu meter. On  Linux,  *BSD,
471              Solaris  and  IRIX  SMP machines, the resource cpuFormat defines
472              how meters are created for multiple CPUs.
473
474       xosview*cpuUserColor: color
475              The cpu meter will use this color to display the cpu  user  time
476              field.
477
478       xosview*cpuNiceColor: color
479              The  cpu  meter will use this color to display the cpu nice time
480              field.
481
482       xosview*cpuSystemColor: color
483              The cpu meter will use this color to display the cpu system time
484              field.
485
486       xosview*cpuInterruptColor: color
487              The cpu meter will use this color to display the cpu hard inter‐
488              rupt time field.
489
490       xosview*cpuSInterruptColor: color
491              The cpu meter will use this color to display the cpu soft inter‐
492              rupt time field.
493
494       xosview*cpuWaitColor: color
495              The  cpu meter will use this color to display the cpu IO waiting
496              time field.
497
498       xosview*cpuGuestColor: color
499              The cpu meter will use this color to display the cpu virtualiza‐
500              tion guest time field.
501
502       xosview*cpuNiceGuestColor: color
503              The  cpu meter will use this color to display the cpu niced vir‐
504              tualization guest time field.
505
506       xosview*cpuStolenColor: color
507              The cpu meter will use this color to display the cpu involuntary
508              wait time field.
509
510       xosview*cpuFreeColor: color
511              The  cpu  meter will use this color to display the cpu idle time
512              field.
513
514       xosview*cpuPriority: priority
515              This number (which must be an integer >= 1) sets the  number  of
516              tenths  of a second that the cpu meter waits between updates.  A
517              value of 1 has xosview update the meter 10 times per second (the
518              fastest).   A value of 600 would cause xosview to update the me‐
519              ter once a minute.
520
521       xosview*cpuDecay: (True or False)
522              If True then the cpu meter will be split vertically in two.  The
523              top  half  will  show  the instantaneous state, while the bottom
524              half will display a decaying average of the state.
525
526       xosview*cpuGraph: (True or False)
527              If this is set to True then the cpu meter will  be  drawn  as  a
528              horizontally  scrolling  bargraph showing the state value verses
529              time.
530
531       xosview*cpuUsedFormat: (float, percent or autoscale)
532              This resource tells xosview how to display "used"  labels.   The
533              formats work as follows:
534
535              float:
536                     Display the value as a floating point number.
537              percent:
538                     Display the value as a percentage of the total.
539              autoscale:
540                     Display  the  absolute  value and automatically print the
541                     units (K, M, or G) as appropriate.
542
543       xosview*cpuFormat: (single, all, both or auto)
544              If `single', only a cumulative meter for all CPU usage  is  cre‐
545              ated.  `all' creates a meter for each CPU, but no cumulative me‐
546              ter. `both' creates one cumulative meter and one for  each  CPU.
547              `auto' makes a choice based on the number of CPUs found.
548
549       xosview*cpuFields: USED/USR/NIC/SYS/INT/SI/HI/WIO/GST/NGS/STL/IDLE
550              The  set of fields to show in Linux CPU meter instead of the de‐
551              fault. Possible fields are:
552
553              USED:
554                     Combine all used CPU time into one field. This is the sum
555                     of  user,  nice, system, soft and hard interrupts, guest,
556                     niced guest and stolen  times.   None  of  these,  except
557                     stolen, may be defined together with `USED'.
558              IDLE:
559                     Time  spent doing nothing. Includes I/O wait if it is not
560                     defined separately.
561              USR:
562                     Time spent in user mode processes. Includes  nice,  guest
563                     and niced guest if those are not defined separately.
564              NIC:
565                     Time  spent  in niced user mode processes. Includes niced
566                     guest if neither it nor guest is not defined separately.
567              SYS:
568                     Time spent in kernel code. Includes soft and hard  inter‐
569                     rupt as well as stolen time if those are not defined sep‐
570                     arately.
571              INT:
572                     Combines soft and hard interrupt handling times into  one
573                     field.
574              SI:
575                     Time the kernel used to handle soft interrupts. Available
576                     on Linux kernel 2.6.0 and higher.
577              HI:
578                     Time the kernel used to handle hard interrupts. Available
579                     on Linux kernel 2.6.0 and higher.
580              WIO:
581                     Time  spent  waiting  for  I/O  to complete. Available on
582                     Linux kernel 2.6.0 and higher.
583              GST:
584                     Time spent running guest OS in virtual machine.  Includes
585                     niced guest if it is not defined separately. Available on
586                     Linux kernel 2.6.24 and higher.
587              NGS:
588                     Time spent running niced guest  OS  in  virtual  machine.
589                     Available on Linux kernel 2.6.32 and higher.
590              STL:
591                     Involuntary  wait  time  when running as guest in virtual
592                     machine. Available on Linux kernel 2.6.11 and higher.
593
594              Most combinations are possible (see above for restrictions), but
595              at  least  `USED'  or `USR' and `SYS' need to be defined. `IDLE'
596              field is added automatically.
597
598
599       Memory Meter Resources
600
601       xosview*mem: (True or False)
602              If True then xosview will display a mem meter.
603
604       xosview*memUsedColor: color
605              The mem meter will use this color to  display  the  used  memory
606              field.
607
608       xosview*memSharedColor: color
609              The  mem  meter will use this color to display the shared memory
610              field.
611
612       xosview*memBufferColor: color
613              The mem meter will use this color to display the  buffer  memory
614              field.
615
616       xosview*memCacheColor: color
617              The  mem  meter  will use this color to display the cache memory
618              field.
619
620       xosview*memFreeColor: color
621              The mem meter will use this color to  display  the  free  memory
622              field.
623
624       xosview*memKernelColor: color
625              The  mem  meter will use this color to display the kernel memory
626              field.
627
628       xosview*memSharedColor: color
629              The mem meter will use this color to display the  shared  memory
630              field.
631
632       xosview*memTextColor: color
633              The  mem meter will use this color to display the HP text memory
634              field.
635
636       xosview*memOtherColor: color
637              The mem meter will use this color to display  the  HP  ``other''
638              memory field.
639
640       xosview*memActiveColor: color
641              The  mem  meter  will  use this color to display the *BSD active
642              memory field.
643
644       xosview*memInactiveColor: color
645              The mem meter will use this color to display the  *BSD  inactive
646              memory field.
647
648       xosview*memWiredColor: color
649              The mem meter will use this color to display the *BSD wired mem‐
650              ory field.
651
652       xosview*memSlabColor: color
653              The mem meter will use this color to display the Linux in-kernel
654              data structures field.
655
656       xosview*memMapColor: color
657              The  mem  meter  will use this color to display the Linux memory
658              mapped files field.
659
660       xosview*memPriority: priority
661              This number (which must be an integer >= 1) sets the  number  of
662              tenths  of a second that the mem meter waits between updates.  A
663              value of 1 has xosview update the meter 10 times per second (the
664              fastest).   A value of 600 would cause xosview to update the me‐
665              ter once a minute.
666
667       xosview*memDecay: (True or False)
668              If True then the mem meter will be split vertically in two.  The
669              top  half  will  show  the instantaneous state, while the bottom
670              half will display a decaying average of the state.
671
672       xosview*memGraph: (True or False)
673              If this is set to True then the mem meter will  be  drawn  as  a
674              horizontally  scrolling  bargraph showing the state value verses
675              time.
676
677       xosview*memUsedFormat: (float, percent or autoscale)
678              This resource tells xosview how to display "used"  labels.   The
679              formats work as follows:
680
681              float:
682                     Display the value as a floating point number.
683              percent:
684                     Display the value as a percentage of the total.
685              autoscale:
686                     Display  the  absolute  value and automatically print the
687                     units (K, M, or G) as appropriate.
688
689
690       Swap Meter Resources
691
692       xosview*swap: (True or False)
693              If True then xosview will display a swap meter.
694
695       xosview*swapUsedColor: color
696              The swap meter will use this color  to  display  the  used  swap
697              field.
698
699       xosview*swapFreeColor: color
700              The  swap  meter  will  use  this color to display the free swap
701              field.
702
703       xosview*swapPriority: priority
704              This number (which must be an integer >= 1) sets the  number  of
705              tenths of a second that the swap meter waits between updates.  A
706              value of 1 has xosview update the meter 10 times per second (the
707              fastest).   A value of 600 would cause xosview to update the me‐
708              ter once a minute.
709
710       xosview*swapDecay: (True or False)
711              If True then the swap meter will be  split  vertically  in  two.
712              The top half will show the instantaneous state, while the bottom
713              half will display a decaying average of the state.
714
715       xosview*swapGraph: (True or False)
716              If this is set to True then the swap meter will be  drawn  as  a
717              horizontally  scrolling  bargraph showing the state value verses
718              time.
719
720       xosview*swapUsedFormat: (float, percent or autoscale)
721              This resource tells xosview how to display "used"  labels.   The
722              formats work as follows:
723
724              float:
725                     Display the value as a floating point number.
726              percent:
727                     Display the value as a percentage of the total.
728              autoscale:
729                     Display  the  absolute  value and automatically print the
730                     units (K, M, or G) as appropriate.
731
732
733       Page Swapping Meter Resources
734
735       xosview*page: (True or False)
736              If True then xosview will display a page meter.
737
738       xosview*pageBandWidth: maxEvents
739              This number is used to specify the  expected  maximum  bandwidth
740              (in events / sec) for the page meter.  When the expected maximum
741              bandwidth (maxEvents) is exceeded then the page meter will  dis‐
742              play the relative percentage of page swapping (25% in, 75% out).
743
744       xosview*pageInColor: color
745              The page meter will use this color to display the page-in field.
746
747       xosview*pageOutColor: color
748              The  page  meter  will  use  this  color to display the page-out
749              field.
750
751       xosview*pageIdleColor: color
752              The page meter will use this color to display the idle field.
753
754       xosview*pagePriority: priority
755              This number (which must be an integer >= 1) sets the  number  of
756              tenths of a second that the page meter waits between updates.  A
757              value of 1 has xosview update the meter 10 times per second (the
758              fastest).   A value of 600 would cause xosview to update the me‐
759              ter once a minute.
760
761       xosview*pageDecay: (True or False)
762              If True then the page meter will be  split  vertically  in  two.
763              The top half will show the instantaneous state, while the bottom
764              half will display a decaying average of the state.
765
766       xosview*pageGraph: (True or False)
767              If this is set to True then the page meter will be  drawn  as  a
768              horizontally  scrolling  bargraph showing the state value verses
769              time.
770
771       xosview*pageUsedFormat: (float, percent or autoscale)
772              This resource tells xosview how to display "used"  labels.   The
773              formats work as follows:
774
775              float:
776                     Display the value as a floating point number.
777              percent:
778                     Display the value as a percentage of the total.
779              autoscale:
780                     Display  the  absolute  value and automatically print the
781                     units (K, M, or G) as appropriate.
782
783
784       Gfx Meter Resources
785
786       xosview*gfx:   (True or False)
787              If True xosview will display the GfxMeter. The value is  sampled
788              once per second, due to the usage of sadc to sample data.
789
790       xosview*gfxWarnColor: color
791              This  is  the  color  that  the gfx meter will use once the warn
792              state is reached.
793
794       xosview*gfxAlarmColor: color
795              This is the color that the gfx meter will  use  once  the  alarm
796              state is reached.
797
798       xosview*gfxSwapColor: color
799              This is the color that the gfx meter will use in normal state
800
801       xosview*gfxIdleColor: color
802              The gfx meter will use this color to display the idle field.
803
804       xosview*gfxPriority: priority
805              This  number  (which must be an integer >= 1) sets the number of
806              tenths of a second that the gfx meter waits between updates.   A
807              value of 1 has xosview update the meter 10 times per second (the
808              fastest).  A value of 600 would cause xosview to update the  me‐
809              ter once a minute.
810
811       xosview*gfxWarnThreshold: int
812              This  number  (which must be an integer >= 1) of swapbuffers per
813              second and pipe at which the gfxmeter  changes  its  status  and
814              color from "normal" to "warn". The default value is 60.
815
816       xosview*gfxAlarmThreshold: int
817              This  number  (which  must be an integer >= gfxWarnThreshold) of
818              swapbuffers per second and pipe at which  the  gfxmeter  changes
819              its  status  and color from "warn" to "alarm". The default value
820              is 120.
821
822       xosview*gfxDecay: (True or False)
823              You should probably leave this at  the  default  value  (False).
824              The gfx does not work in decay mode.
825
826       xosview*gfxGraph: (True or False)
827              If  this  is  set  to True then the gfx meter will be drawn as a
828              horizontally scrolling bargraph showing the state  value  verses
829              time.
830
831       xosview*gfxUsedFormat: (float, percent or autoscale)
832              This  resource  tells xosview how to display "used" labels.  The
833              formats work as follows:
834
835              float:
836                     Display the value as a floating point number.
837              percent:
838                     Display the value as a percentage of the total.
839              autoscale:
840                     Display the absolute value and  automatically  print  the
841                     units (K, M, or G) as appropriate.
842
843
844       Network Meter Resources
845
846       xosview*net: (True or False)
847              If  True  xosview  will  display the NetMeter.  Linux users will
848              have to configure their kernels and  setup  some  ip  accounting
849              rules  to make this work.  See the file README.linux which comes
850              with the xosview distribution for details.
851
852       xosview*netBandwidth: maxBytes
853              This number is used to specify the  expected  maximum  bandwidth
854              (in bytes / sec) for the meter.  When the expected maximum band‐
855              width (maxBytes) is exceeded then the network meter will display
856              the relative percentage of network usage (25% incoming, 75% out‐
857              going).
858
859       xosview*netIface: interface
860              If False, xosview will display the data received/transmitted  by
861              any of the network interfaces. Otherwise, xosview will only dis‐
862              play the data received/transmitted by the specified network  in‐
863              terface.  If  the  name  is prepended with '-' sign, the data in
864              that interface is ignored.
865
866       xosview*netInColor: color
867              The net meter will use this color to display the incoming field.
868
869       xosview*netOutColor: color
870              The net meter will use this color to display the outgoing field.
871
872       xosview*netBackground: color
873              This is the color that the network meter will use for the "idle"
874              field.
875
876       xosview*netPriority: priority
877              This  number  (which must be an integer >= 1) sets the number of
878              tenths of a second that the net meter waits between updates.   A
879              value of 1 has xosview update the meter 10 times per second (the
880              fastest).  A value of 600 would cause xosview to update the  me‐
881              ter once a minute.
882
883       xosview*netDecay: (True or False)
884              If True then the net meter will be split vertically in two.  The
885              top half will show the instantaneous  state,  while  the  bottom
886              half will display a decaying average of the state.
887
888       xosview*netGraph: (True or False)
889              If  this  is  set  to True then the net meter will be drawn as a
890              horizontally scrolling bargraph showing the state  value  verses
891              time.
892
893       xosview*netUsedFormat: (float, percent or autoscale)
894              This  resource  tells xosview how to display "used" labels.  The
895              formats work as follows:
896
897              float:
898                     Display the value as a floating point number.
899              percent:
900                     Display the value as a percentage of the total.
901              autoscale:
902                     Display the absolute value and  automatically  print  the
903                     units (K, M, or G) as appropriate.
904
905
906       NFSStats (Client) Resources
907
908       xosview*NFSStats: (True or False)
909              If  True then xosview will display a meter to monitor NFS client
910              stats.
911
912       xosview*NFSStatReTransColor: color
913              The color to be used for retransmit stats.
914
915       xosview*NFSStatAuthRefrshColor:    color
916              The color to be used for auth refresh stats.
917
918       xosview*NFSStatCallsColor: color
919              The color to be used for call stats.
920
921       xosview*NFSStatIdleColor: color
922              The color to be used for idle stats.
923
924
925       NFSDStats (Server) Resources
926
927       xosview*NFSDStats: (True or False)
928              If True xosview will  display  a  meter  for  NFS  server/daemon
929              stats.
930
931       xosview*NFSDStatCallsColor: color
932              The color to be used for call stats.
933
934       xosview*NFSDStatBadCallsColor: color
935              The color to be used for bad stats.
936
937       xosview*NFSDStatUDPColor: color
938              The color to be used for UDP stats.
939
940       xosview*NFSDStatTCPColor: color
941              The color to be used for TCP stats.
942
943       xosview*NFSDStatIdleColor: color
944              The color to be used for idle stats.
945
946
947       Serial Meter Resources
948
949       xosview*serial(0-9): (True, False, or portBase)
950              If True then xosview will display a serial meter for ttySx.  The
951              portbase will be autodetected.  Because autodetection can  fail,
952              (if  the port is locked by ppp/slip for example) you can specify
953              the portbase instead of "True".  If  a  portBase  is  used  then
954              xosview will use it instead of trying to autodetect.
955
956              For this to work on Linux xosview needs to be suid root in order
957              to have access to the ports.  See the  file  README.linux  which
958              comes with the xosview distribution for more details.
959
960       xosview*serialOnColor: color
961              This  is  the  color the serial meter will use for bits that are
962              set.
963
964       xosview*serialOffColor: color
965              This is the color the serial meter will use for  bits  that  are
966              not set.
967
968       xosview*serialPriority: priority
969              This  number  (which must be an integer >= 1) sets the number of
970              tenths of a second that the serial meter waits between  updates.
971              A  value  of  1 has xosview update the meter 10 times per second
972              (the fastest).  A value of 600 would cause xosview to update the
973              meter once a minute.
974
975
976       Interrupt Meter Resources
977
978       xosview*interrupts: (True or False)
979              If True then xosview will display an interrupt meter.
980
981       xosview*intSeparate: (True of False)
982              If True then xosview will display one interrupt meter per CPU on
983              SMP machines. If False only one  meter  is  displayed.  Default:
984              True.
985
986       xosview*intOnColor: color
987              This is the color that will be used to show "active" interrupts.
988
989       xosview*intOffColor: color
990              This  is  the  color that will be used to show "inactive" inter‐
991              rupts.
992
993       xosview*intPriority: priority
994              This number (which must be an integer >= 1) sets the  number  of
995              tenths  of a second that the int meter waits between updates.  A
996              value of 1 has xosview update the meter 10 times per second (the
997              fastest).   A value of 600 would cause xosview to update the me‐
998              ter once a minute.
999
1000
1001       Interrupt Rate Meter Resources
1002
1003       xosview*irqrate: (True or False)
1004              If True then xosview will display an interrupt rate meter.
1005
1006       xosview*irqrateUsedColor: color
1007              This is the color that will be used to show the interrupt rate.
1008
1009       xosview*irqrateIdleColor: color
1010              The irqrate meter will use this color to display the idle field.
1011
1012       xosview*irqratePriority: priority
1013              This number (which must be an integer >= 1) sets the  number  of
1014              tenths of a second that the irqrate meter waits between updates.
1015              A value of 1 has xosview update the meter 10  times  per  second
1016              (the fastest).  A value of 600 would cause xosview to update the
1017              meter once a minute.
1018
1019       xosview*irqrateDecay: (True or False)
1020              If True then the irqrate meter will be split vertically in  two.
1021              The top half will show the instantaneous state, while the bottom
1022              half will display a decaying average of the state.
1023
1024       xosview*irqrateGraph: (True or False)
1025              If this is set to True then the irqrate meter will be drawn as a
1026              horizontally  scrolling  bargraph showing the state value verses
1027              time.
1028
1029       xosview*irqrateUsedFormat: (float, percent or autoscale)
1030              This resource tells xosview how to display "used"  labels.   The
1031              formats work as follows:
1032
1033              float:
1034                     Display the value as a floating point number.
1035              percent:
1036                     Display the value as a percentage of the total.
1037              autoscale:
1038                     Display  the  absolute  value and automatically print the
1039                     units (K, M, or G) as appropriate.
1040
1041
1042       Lm Sensors Resources
1043
1044       xosview*lmstemp: (True or False)
1045              If True then xosview will display a lmstemp meter.
1046
1047       xosview*lmstempHighest: number
1048              Highest value displayed. If not given, or too small,  the  meter
1049              will  adjust  to  fit actual and alarm values. Can be overridden
1050              for any meter with lmstempHighestN.
1051
1052       xosview*lmstempActColor: color
1053              Color of actual value.
1054
1055       xosview*lmstempHighColor: color
1056              Color above high alarm value, also used to indicate alarm.
1057
1058       xosview*lmstempLowColor: color
1059              Color of actual value, when it is below low alarm value.
1060
1061       xosview*lmstempIdleColor: color
1062              Color between actual and high alarm values.
1063
1064       xosview*lmstempN: filename
1065              Name   of   input   file   from   /proc/sys/dev/sensors/*/*   or
1066              /sys/class/hwmon/*/{,device}/,  N=1,2,3,... Can also be absolute
1067              path.  For example,
1068              xosview*lmstemp1: temp1
1069              xosview*lmstemp2: temp2_input
1070
1071              Note: Many sensors have the value and alarm threshold  in  files
1072              named "*_input" and "*_max"/"*_min", respectively. In such case,
1073              specifying the base name such as "temp1" here will be enough for
1074              having both files used.
1075
1076              Note: If the same file name as lmstempN, lmshighN or lmslowN ex‐
1077              ists in other sensor directories,  then  lmsnameN  needs  to  be
1078              specified, or absolute path used, to find the correct one.
1079
1080       xosview*lmshighN: filename or number
1081              Optional  high  alarm  value or name of file from /sys/class/hw‐
1082              mon/*/{,device}/, N=1,2,3,... Can also be absolute path. If  not
1083              given,  lmstempHighest  is  used as both maximum and high alarm.
1084              For example,
1085              xosview*lmshigh1: 70
1086              xosview*lmshigh2: temp1_crit_hyst
1087
1088       xosview*lmslowN: filename or number
1089              Optional low alarm value or name  of  file  from  /sys/class/hw‐
1090              mon/*/{,device}/, N=1,2,3,... Can also be absolute path. Default
1091              is 0. For example,
1092              xosview*lmslow1: 1.5
1093              xosview*lmslow2: fan1_min
1094
1095       xosview*lmsnameN: name
1096              Optional name of the sensor device to use when finding the file‐
1097              name(s)   given   in   lmstempN,   lmshighN   and  lmslowN.  See
1098              /sys/class/hwmon/*/{,device}/name for the names of your sensors.
1099              This  has  no effect to files given as absolute paths. For exam‐
1100              ple,
1101              xosview*lmsname1: nct6779
1102              xosview*lmsname2: radeon
1103
1104       xosview*lmstempLabelN: string
1105              N-th label for above values, default is TMP.
1106
1107       xosview*lmstempHighestN: number
1108              Override default lmstempHighest for meter N.
1109
1110       xosview*lmstempUsedFormatN: (float, percent or autoscale)
1111              Override default lmstempUsedFormat for meter N.
1112
1113       xosview*lmstempPriority: priority
1114              This number (which must be an integer >= 1) sets the  number  of
1115              tenths of a second that the lmstemp meter waits between updates.
1116              A value of 1 has xosview update the meter 10  times  per  second
1117              (the fastest).  A value of 600 would cause xosview to update the
1118              meter once a minute.
1119
1120       xosview*lmstempUsedFormat: (float, percent or autoscale)
1121              This resource tells xosview how to display "used"  labels.   The
1122              formats work as follows:
1123
1124              float:
1125                     Display the value as a floating point number.
1126              percent:
1127                     Display the value as a percentage of the total.
1128              autoscale:
1129                     Display  the  absolute  value and automatically print the
1130                     units (K, M, or G) as appropriate.
1131
1132
1133       ACPI Temperature Resources
1134
1135       xosview*acpitemp: (True or False)
1136              If True then xosview will display a acpitemp meter.
1137
1138       xosview*acpitempHighest: 100
1139              Highest temp value  displayed,  default  100.  If  acpihighN  is
1140              given, the value is read from there instead.
1141
1142       xosview*acpitempActColor:  color
1143              Color of actual temperature.
1144
1145       xosview*acpitempHighColor:  color
1146              Color above alarm temperature, also used to indicate alarm.
1147
1148       xosview*acpitempIdleColor:   color
1149              Color between actual and alarm temperatures.
1150
1151       xosview*acpitempN: filename
1152              Name   of   temperature  file  from  /proc/acpi/thermal_zone  or
1153              /sys/devices/virtual/thermal. Note that the last directory  part
1154              must  be  given, e.g. TZ0/temperature. Absolute path can also be
1155              used.
1156
1157       xosview*acpihighN:    filename
1158              Name of high value/trip point file from  /proc/acpi/thermal_zone
1159              or /sys/devices/virtual/thermal, or an absolute path to one.
1160
1161       xosview*acpitempLabelN:  Labelstring
1162              N-th label for above temperatures, default is TMP.
1163
1164       xosview*acpitempPriority: priority
1165              This  number  (which must be an integer >= 1) sets the number of
1166              tenths of a second that the acpitemp  meter  waits  between  up‐
1167              dates.   A  value of 1 has xosview update the meter 10 times per
1168              second (the fastest).  A value of 600 would cause xosview to up‐
1169              date the meter once a minute.
1170
1171       xosview*acpitempUsedFormat: (float, percent or autoscale)
1172              This  resource  tells xosview how to display "used" labels.  The
1173              formats work as follows:
1174
1175              float:
1176                     Display the value as a floating point number.
1177              percent:
1178                     Display the value as a percentage of the total.
1179              autoscale:
1180                     Display the absolute value and  automatically  print  the
1181                     units (K, M, or G) as appropriate.
1182
1183
1184       Intel Core / AMD K8+ / VIA C7 Temperature Sensor Resources
1185
1186       xosview*coretemp: (True or False)
1187              If True then xosview will display a coretemp meter.
1188
1189       xosview*coretempHighest: 100
1190              Highest  temp  value  displayed,  default 100. If CPU throttling
1191              temperature (tjMax) is supplied by the operating system,  it  is
1192              used instead.
1193
1194       xosview*coretempHigh: number
1195              Value  to  use as alarm temperature, default is coretempHighest.
1196              If a usable value, such as the  temperature  for  which  maximum
1197              cooling  is required, is supplied by the operating system, it is
1198              used instead.
1199
1200       xosview*coretempActColor:  color
1201              Color of actual temperature.
1202
1203       xosview*coretempHighColor:  color
1204              Color above alarm temperature, also used to indicate alarm.
1205
1206       xosview*coretempIdleColor:   color
1207              Color between actual and alarm temperatures.
1208
1209       xosview*coretempDisplayType: (separate, average or maximum)
1210              This resource tells xosview how to display the CPU  temperature.
1211              The formats work as follows:
1212
1213              separate:
1214                     Display  one meter for each CPU core of a multi-core CPU.
1215                     This is the default.
1216              average:
1217                     Display the average of core temperatures of a  multi-core
1218                     CPU. On multi-socket machines, one meter per physical CPU
1219                     is displayed.
1220              maximum:
1221                     Display the highest core temperature of a multi-core CPU.
1222                     On  multi-socket  machines, one meter per physical CPU is
1223                     displayed.
1224
1225       xosview*coretempPriority: priority
1226              This number (which must be an integer >= 1) sets the  number  of
1227              tenths  of  a  second  that the coretemp meter waits between up‐
1228              dates.  A value of 1 has xosview update the meter 10  times  per
1229              second (the fastest).  A value of 600 would cause xosview to up‐
1230              date the meter once a minute.
1231
1232       xosview*coretempUsedFormat: (float, percent or autoscale)
1233              This resource tells xosview how to display "used"  labels.   The
1234              formats work as follows:
1235
1236              float:
1237                     Display the value as a floating point number.
1238              percent:
1239                     Display the value as a percentage of the total.
1240              autoscale:
1241                     Display  the  absolute  value and automatically print the
1242                     units (K, M, or G) as appropriate.
1243
1244
1245       *BSD Sensor Resources
1246
1247       xosview*bsdsensor: (True or False)
1248              If True then xosview will display a bsdsensor meter.
1249
1250       xosview*bsdsensorHighest: number
1251              Highest value displayed. If not given, or too small,  the  meter
1252              will  adjust  to  fit actual and alarm values. Can be overridden
1253              for any meter with bsdsensorHighestN.
1254
1255       xosview*bsdsensorActColor: color
1256              Color of actual value.
1257
1258       xosview*bsdsensorHighColor: color
1259              Color above high alarm value, also used to indicate alarm.
1260
1261       xosview*bsdsensorLowColor: color
1262              Color of actual value, when it is below low alarm value.
1263
1264       xosview*bsdsensorIdleColor: color
1265              Color between actual and high alarm values.
1266
1267       xosview*bsdsensorN:     name.type
1268       xosview*bsdsensorHighN: name.type
1269       xosview*bsdsensorLowN:  name.type
1270              These define where the actual value, high alarm  value  and  low
1271              alarm value for meter N=1,2,3,... will be read from. The name is
1272              the sensor driver, and type is the wanted value. Both alarm val‐
1273              ues are optional, and can also be given as static numerical val‐
1274              ues.
1275
1276              You can find the correct pair for OpenBSD and DragonFly BSD with
1277              systat command, e.g.
1278              xosview*bsdsensor1:     it0.temp1
1279              xosview*bsdsensorHigh1: 100
1280
1281              On  NetBSD,  you  can find the driver name with envstat command.
1282              Value name for the actual reading is typically  'cur-value'  and
1283              for  high alarm 'critical-max' and for low alarm 'critical-min',
1284              e.g.
1285              xosview*bsdsensor2:     coretemp0.cur-value
1286              xosview*bsdsensorHigh2: coretemp0.critical-max
1287
1288              For all possible NetBSD value names,  refer  to  envstat  source
1289              code.
1290
1291              FreeBSD has no usable sensor drivers as of version 9.0. However,
1292              ACPI thermal zones can be used by defining the sysctl node below
1293              hw.acpi.thermal, e.g.
1294              xosview*bsdsensor1:     tz0.temperature
1295              xosview*bsdsensorHigh1: tz0._CRT
1296
1297              ACPI  thermal  zones  can  be used like this on DragonFly BSD as
1298              well.
1299
1300       xosview*bsdsensorLabelN: string
1301              N-th label for above meters, default is SENN.
1302
1303       xosview*bsdsensorHighestN: number
1304              Override default bsdsensorHighest for meter N.
1305
1306       xosview*bsdsensorUsedFormatN: (float, percent or autoscale)
1307              Override default bsdsensorUsedFormat for meter N.
1308
1309       xosview*bsdsensorPriority: priority
1310              This number (which must be an integer >= 1) sets the  number  of
1311              tenths  of  a  second that the bsdsensor meter waits between up‐
1312              dates.  A value of 1 has xosview update the meter 10  times  per
1313              second (the fastest).  A value of 600 would cause xosview to up‐
1314              date the meter once a minute.
1315
1316       xosview*bsdsensorUsedFormat: (float, percent or autoscale)
1317              This resource tells xosview how to display "used"  labels.   The
1318              formats work as follows:
1319
1320              float:
1321                     Display the value as a floating point number.
1322              percent:
1323                     Display the value as a percentage of the total.
1324              autoscale:
1325                     Display  the  absolute  value and automatically print the
1326                     units (K, M, or G) as appropriate.
1327
1328
1329       Battery Meter Resources
1330
1331       xosview*battery: (True or False)
1332              If True then xosview will display a battery meter.  Linux  users
1333              will  need to have APM or ACPI support in their kernels for this
1334              to work.  For both APM and ACPI, xosview shows the status/sum of
1335              all  batteries.  Additionally - the legend text gets changed/ad‐
1336              justed to reflect the current state (charging/low/critical/etc.)
1337              of the battery/batteries.
1338
1339       xosview*batteryLeftColor: color
1340              This  is  the color that will be used to show the amount of bat‐
1341              tery power left.
1342
1343       xosview*batteryUsedColor: color
1344              This is the color that will be used to show the amount  of  bat‐
1345              tery power used.
1346
1347       xosview*batteryChargeColor: color
1348              This is the color that will be used as 'left' - if the batteries
1349              get charged.
1350
1351       xosview*batteryFullColor: color
1352              This is the color that will be used as 'left' - if the batteries
1353              are fully charged.  APM and ACPI does provide this info, but not
1354              all machines actually do so.
1355
1356       xosview*batteryLowColor: color
1357              APM only - the 'left' color that will indicate  a  low  battery.
1358              Depends on the machine - e.g. below 25% remaining capacity.
1359
1360       xosview*batteryCritColor: color
1361              APM  case:  the  'left' color if APM indicates 'critical' state.
1362              (less than 5%) ACPI case: the 'left' color if the remaining  ca‐
1363              pacity  is below the alarm value.  (which can be set by the user
1364              in /proc/acpi/battery/BAT[01]/alarm )
1365
1366       xosview*batteryNoneColor: color
1367              If no battery is present - or all batteries get  removed  (while
1368              on AC).
1369
1370       xosview*batteryPriority: priority
1371              This  number  (which must be an integer >= 1) sets the number of
1372              tenths of a second that the battery meter waits between updates.
1373              A  value  of  1 has xosview update the meter 10 times per second
1374              (the fastest).  A value of 600 would cause xosview to update the
1375              meter once a minute.
1376
1377       xosview*batteryUsedFormat: (float, percent or autoscale)
1378              This  resource  tells xosview how to display "used" labels.  The
1379              formats work as follows:
1380
1381              float:
1382                     Display the value as a floating point number.
1383              percent:
1384                     Display the value as a percentage of the total.
1385              autoscale:
1386                     Display the absolute value and  automatically  print  the
1387                     units (K, M, or G) as appropriate.
1388
1389
1390       Wireless Meter Resources
1391
1392       xosview*wireless: (True or False)
1393              If True then xosview will display the link quality of each wire‐
1394              less connection.  Note that the graph will *never* show  up,  if
1395              you  don't  have any wireless devices, or no wireless extensions
1396              in the kernel (/proc/net/wireless).  Default is true.
1397
1398       xosview*PoorQualityColor: color
1399              This is the color for the quality field when between 0 and 6.
1400
1401       xosview*FairQualityColor: color
1402              This is the color for the quality field when between 7 and 14.
1403
1404       xosview*GoodQualityColor: color
1405              This is the color for the quality field when higher than 14.
1406
1407       xosview*wirelessUsedColor: color
1408              This is the background color.
1409
1410       xosview*wirelessPriority: priority
1411              This number (which must be an integer >= 1) sets the  number  of
1412              tenths  of  a  second  that the wireless meter waits between up‐
1413              dates.  A value of 1 has xosview update the meter 10  times  per
1414              second (the fastest).  A value of 600 would cause xosview to up‐
1415              date the meter once a minute.
1416
1417       xosview*wirelessDecay: (True or False)
1418              If True then the wireless meter will be split vertically in two.
1419              The top half will show the instantaneous state, while the bottom
1420              half will display a decaying average of the state.
1421
1422       xosview*wirelessUsedFormat: (float, percent or autoscale)
1423              This resource tells xosview how to display "used"  labels.   The
1424              formats work as follows:
1425
1426              float:
1427                     Display the value as a floating point number.
1428              percent:
1429                     Display the value as a percentage of the total.
1430              autoscale:
1431                     Display  the  absolute  value and automatically print the
1432                     units (K, M, or G) as appropriate.
1433
1434
1435       Disk Meter Resources
1436
1437       xosview*disk: (True or False)
1438              If True then xosview will display a disk meter.
1439
1440       xosview*diskInColor: color
1441              The disk meter will use this color to display the reads field.
1442
1443       xosview*diskOutColor: color
1444              The disk meter will use this color to display the writes field.
1445
1446       xosview*diskIdleColor: color
1447              The disk meter will use this color to display the idle field.
1448
1449       xosview*diskBandwidth: bandwidth
1450              This number is used to specify the expected maximum bandwidth in
1451              bytes per second for the disk meter.
1452
1453       xosview*diskWriteColor: color
1454              This color will be used for the linux meter to show writes.
1455
1456       xosview*diskReadColor: color
1457              This color will be used for the linux meter to show reads.
1458
1459       xosview*diskPriority: priority
1460              This  number  (which must be an integer >= 1) sets the number of
1461              tenths of a second that the disk meter waits between updates.  A
1462              value of 1 has xosview update the meter 10 times per second (the
1463              fastest).  A value of 600 would cause xosview to update the  me‐
1464              ter once a minute.
1465
1466       xosview*diskDecay: (True or False)
1467              If  True  then  the  disk meter will be split vertically in two.
1468              The top half will show the instantaneous state, while the bottom
1469              half will display a decaying average of the state.
1470
1471       xosview*diskGraph: (True or False)
1472              If  this  is  set to True then the disk meter will be drawn as a
1473              horizontally scrolling bargraph showing the state  value  verses
1474              time.
1475
1476       xosview*diskUsedFormat: (float, percent or autoscale)
1477              This  resource  tells xosview how to display "used" labels.  The
1478              formats work as follows:
1479
1480              float:
1481                     Display the value as a floating point number.
1482              percent:
1483                     Display the value as a percentage of the total.
1484              autoscale:
1485                     Display the absolute value and  automatically  print  the
1486                     units (K, M, or G) as appropriate.
1487
1488
1489       RAID Meter Resources
1490
1491       xosview*RAID: (True or False)
1492              If True then xosview will display a RAID meter.
1493
1494       xosview*RAIDdevicecount: int
1495              Please  enter  your RAID device count (n) here or 0 if you don't
1496              have any supported RAID devices. xosview  then  will  display  n
1497              RAID state displays.
1498
1499       xosview*RAIDdiskOnlineColor: color
1500
1501       xosview*RAIDdiskFailureColor: color
1502              These  colors  will  be  used  for  indicating working/online or
1503              failed/offline disks. The order (from left to right) is the same
1504              as in /proc/mdstat.
1505
1506       xosview*RAIDresyncdoneColor: color
1507
1508       xosview*RAIDresynctodoColor: color
1509
1510       xosview*RAIDresynccompleteColor: color
1511              If a resync/rebuild of the RAID array is in progress, the "done"
1512              and "todo" colors will be used. If no rebuild/resync is running,
1513              then the "complete" color will be shown.
1514
1515       xosview*RAIDPriority: priority
1516              This  number  (which must be an integer >= 1) sets the number of
1517              tenths of a second that the RAID meter waits between updates.  A
1518              value of 1 has xosview update the meter 10 times per second (the
1519              fastest).  A value of 600 would cause xosview to update the  me‐
1520              ter once a minute.
1521
1522       xosview*RAIDUsedFormat: (float, percent or autoscale)
1523              This  resource  tells xosview how to display "used" labels.  The
1524              formats work as follows:
1525
1526              float:
1527                     Display the value as a floating point number.
1528              percent:
1529                     Display the value as a percentage of the total.
1530              autoscale:
1531                     Display the absolute value and  automatically  print  the
1532                     units (K, M, or G) as appropriate.
1533
1534

OBTAINING

1536       This version of xosview is distributed from the following site:
1537
1538              http://www.pogo.org.uk/~mark/xosview/
1539
1540

AUTHORS

1542       Mike Romberg  <mike.romberg@noaa.gov>
1543              Original author, Linux and HPUX ports.
1544
1545       Brian Grayson <bgrayson@netbsd.org>
1546              NetBSD  port  and most of the nice enhancements for version 1.4,
1547              initial work on FreeBSD port.
1548
1549       Scott McNab <jedi@tartarus.uwa.edu.au>
1550              Added the scrolling graph mode.
1551
1552       Tom Pavel <pavel@slac.stanford.edu>
1553              Most of the FreeBSD  support,  more  resource-handling  improve‐
1554              ments.
1555
1556       Greg Onufer <exodus@cheers.bungi.com>
1557              SunOS port.
1558
1559       Stefan Eilemann <eilemann@gmail.com>
1560              IRIX 6.5 port.
1561
1562       Sheldon Hearn <axl@iafrica.com>
1563              FreeBSD libdevstat-based diskmeter support.
1564
1565       David W. Talmage <talmage@jefferson.cmf.nrl.navy.mil>
1566              Added battery-meter support to NetBSD.
1567
1568       Oleg Safiullin <form@openbsd.org>
1569              OpenBSD interrupt-meter support.
1570
1571       Werner Fink <werner@suse.de>
1572              Originator of the loadmeter.
1573
1574       Massimiliano Ghilardi <ghilardi@cibs.sns.it>
1575              Linux pagemeter.
1576
1577       Carsten Schabacker <cschaba@spock.central.de>
1578              Made extensions to the serial-meter.
1579
1580       Paal Beyer <pbeyer@online.no>
1581              Ported the linux memstat kernel module to linux-2.1
1582
1583       Jerome Forissier <forissier@isia.cma.fr>
1584              Author  of the Linux SMP kernel patch which xosview uses to dis‐
1585              play meters for each CPU.
1586
1587       Tomer Klainer <mandor@cs.huji.ac.il>
1588              Initial port to BSDI.
1589
1590       Arno Augustin <Arno.Augustin@3SOFT.de>
1591              Solaris disk and network meters.
1592
1593       Alberto BARSELLA <ishark@lsh01.univ-lille1.fr>
1594              Fixes for linux diskmeter + ip_chains support
1595
1596       Thomas Waldmann <ThomasWaldmann@gmx.de>
1597              Linux raid meter, bitfieldmeter.  Many cosmetic fixes.
1598
1599       Leopold Toetsch <lt@toetsch.at>
1600              Linux lms temp meter.
1601
1602       David O'Brien <obrien@nuxi.com>
1603              FreeBSD 4.* updates, and a few other suggestions.
1604
1605       Christos Zoulas <christos@netbsd.org>
1606              C++ standard compliance and other NetBSD fixes.
1607
1608       Tim Ehlers <tehlers@gwdg.de>
1609              Wireless Link-Meter for Linux.
1610
1611       Mark Hills <mark@pogo.org.uk>
1612              Bug fixes and general caretaking.
1613
1614       Tomi Tapper <tomi.o.tapper@student.jyu.fi>
1615              Temperature sensor, and FreeBSD updates.
1616
1617       Raymond S Brand (rsbx@acm.org)
1618              Misc fixes.
1619
1620       And many others who have sent in small fixes and improvements.
1621
1622
1623
16243rd Berkeley Distribution                                           XOSVIEW(1)
Impressum