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

OBTAINING

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

AUTHORS

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