XOSVIEW(1)

๐Ÿ“ฆ
version 1.25 ยท 4 versions
, in fedora 43, fedora 44, nixpkgs unstable, ubuntu resolute, ubuntu stonking

๐ŸŒธ XOSVIEW(1) โ€” General Commands Manual ๐ŸŒธ

okay bestie, welcome to xosview, the system monitor that literally watches your machine breathe. this is the manual page, Gen Z edition, and yes โ€” every single detail is still here, i promise on my life ๐Ÿ’–


โœจ NAME โœจ

xosview โ€” an X based system monitor ๐Ÿ‘‘


โœจ SYNOPSIS โœจ

xosview [options]

โœจ DESCRIPTION โœจ

so xosview is a monitor that shows you the status of a bunch of system parameters. we're talking CPU usage, load average, memory, swap space, network usage, and honestly more than that. every resource gets its own horizontal bar, and that bar is split into color coded regions so you can see exactly how much of the resource is being used for which particular thing. it's giving data visualization but make it cute ๐Ÿ“Š

xosview runs on several platforms: Linux, NetBSD, FreeBSD, OpenBSD, DragonflyBSD, some Solaris systems, IRIX 6.5, HPUX and GNU. but listen โ€” not all of the meters described below are supported on all platforms ๐Ÿ˜ญ. some meters may even look different depending on which platform xosview is running on. also, heads up: *BSD is used as an abbreviation for all the supported BSD operating systems (NetBSD, FreeBSD, OpenBSD, DragonflyBSD). iykyk.


๐ŸŒˆ Load: Kernel reported load average

  • all platforms โ€” load
  • Linux โ€” load | CPU frequency
  • *BSD โ€” load | CPU frequency
  • SunOS5 โ€” load | CPU frequency

๐Ÿ”ฅ CPU Usage

  • Linux โ€” user | nice | system | soft-interrupt | interrupt | io-wait | guest | niced guest | stolen | idle
  • *BSD โ€” user | nice | system | interrupt | idle
  • SunOS5 โ€” user | system | wait | idle
  • IRIX โ€” user | system | interrupt | wait | idle
  • HPUX โ€” user | nice | system | interrupt | idle

๐Ÿง  Memory Usage

  • Linux โ€” used | buffers | slab | map | cache | free
  • FreeBSD โ€” active | inactive | wired | cache | free
  • DFBSD โ€” active | inactive | wired | cache | free
  • OpenBSD โ€” active | inactive | wired | free
  • NetBSD โ€” active | inactive | wired | free
  • SunOS5 โ€” kernel | zfs | other | free
  • IRIX โ€” kernel | fs | user | free
  • HPUX โ€” text | used | other | free
  • GNU โ€” active | inactive | wired | free

๐Ÿ’พ Swap Usage

  • Linux โ€” used | free
  • *BSD โ€” used | free
  • SunOS5 โ€” used | free
  • HPUX โ€” used | free
  • GNU โ€” used | free

๐Ÿ’ฟ Disk Usage: Throughput to/from local disk, per second

  • Linux โ€” in | out | idle
  • *BSD โ€” in | out | idle
  • SunOS5 โ€” in | out | idle

๐Ÿฆ‹ Page Swapping: Pages to/from swap, per second

  • Linux โ€” in | out | idle
  • *BSD โ€” in | out | idle
  • SunOS5 โ€” in | out | idle
  • HPUX โ€” in | out | idle
  • GNU โ€” in | out | idle

๐ŸŒ Network Usage

  • Linux โ€” in | out | idle
  • *BSD โ€” in | out | idle
  • SunOS5 โ€” in | out | idle

๐ŸŽ€ GFX Usage: Framebuffer exchanges, per second

  • IRIX โ€” swapbuffers

  • Linux โ€” IRQs
  • *BSD โ€” IRQs

๐Ÿ’ฅ Interrupt Rate: Per second

  • Linux โ€” interrupts | free
  • *BSD โ€” interrupts | free
  • SunOS5 โ€” interrupts | free

๐Ÿ”Œ Serial Port Status: "leds" which show the serial port parameters

  • Linux โ€” LSR and MSR

๐Ÿ”‹ Battery Level: charge and status of batteries

  • Linux โ€” available | used
  • *BSD โ€” available | used

๐Ÿ—„๏ธ RAID: State of disks in a software RAID array

  • Linux โ€” disk0 disk1 disk2 ... diskN | rebuild

  • Linux โ€” quality

๐ŸŒก๏ธ Sensors: Readings from sensors

  • Linux โ€” I2C/hwmon sensors (lmstemp)
    • Intel Core/AMD K8+/VIA C7 temperature (coretemp)
    • ACPI thermal zones (acpitemp)
  • *BSD โ€” I2C sensors (bsdsensor)
    • Intel Core/AMD K8+ temperature (coretemp)

๐Ÿ’… pro tip bestie: typing a q in the window will terminate xosview. periodt.

โœจ more parts incoming, don't go anywhere โœจ


โœจ OPTIONS โœจ

okay bestie so most of these command line options are literally just a โœจconvenientโœจ way to set one or more of xosview's resources. wanna know what a resource even does? scroll down to the RESOURCES section, it's all there ๐Ÿ’–


  • -v โ€” shows u the version number, that's it, that's the whole vibe ๐Ÿ’…
  • -name name โ€” sets the Resource name xosview is gonna use (same energy as the -name option on ur typical X apps like xterm). when it does resource lookups, xosview looks under name first, then under xosview. example time, straight from README.netbsd:
xrdb -merge Xdefaults.stipple
xosview -name xosvstipple &
xosview -name xosvstipplebw &
  • -display display โ€” sets the X display to display. this one overrides the xosview*display resource, no cap.
  • -font font โ€” picks the font xosview uses for labels. overrides the xosview*font resource ๐ŸŽ€
  • -title title โ€” tells the window manager what name to use for the X window AND the icon. overrides the xosview*title resource.
  • -geometry geometry_string โ€” sets the X geometry to geometry_string. overrides the xosview*geometry resource โœจ
  • -captions โ€” overrides the xosview*captions resource. literally equivalent to setting xosview*captions to "False".
  • +captions โ€” overrides the xosview*captions resource. literally equivalent to setting xosview*captions to "True".
  • -labels โ€” overrides the xosview*labels resource. equivalent to setting xosview*labels to "False".
  • +labels โ€” overrides the xosview*labels resource. equivalent to setting xosview*labels to "True".
  • -usedlabels โ€” overrides the xosview*usedlabels resource. equivalent to setting xosview*usedlabels to "False".
  • +usedlabels โ€” overrides the xosview*usedlabels resource. equivalent to setting xosview*usedlabels to "True".
  • -cpu โ€” overrides the xosview*cpu resource. equivalent to setting xosview*cpu to "False".
  • +cpu โ€” overrides the xosview*cpu resource. equivalent to setting xosview*cpu to "True".
  • -cpus โ€” forces the display of a single meter for ALL the CPUs in the system. equivalent to setting xosview*cpuFormat to "single". one meter, all the cores, minimalism slay ๐Ÿฆ‹
  • +cpus โ€” forces the display of all CPUs in the system. equivalent to setting xosview*cpuFormat to "all". every core gets its moment ๐Ÿ‘‘
  • -load โ€” overrides the xosview*load resource. equivalent to setting xosview*load to "False".
  • +load โ€” overrides the xosview*load resource. equivalent to setting xosview*load to "True".
  • -mem โ€” overrides the xosview*mem resource. equivalent to setting xosview*mem to "False".
  • +mem โ€” overrides the xosview*mem resource. equivalent to setting xosview*mem to "True".
  • -swap โ€” overrides the xosview*swap resource. equivalent to setting xosview*swap to "False".
  • +swap โ€” overrides the xosview*swap resource. equivalent to setting xosview*swap to "True".
  • -battery โ€” overrides the xosview*battery resource. equivalent to setting xosview*battery to "False".
  • +battery โ€” overrides the xosview*battery resource. equivalent to setting xosview*battery to "True".
  • -gfx โ€” overrides the xosview*gfx resource. equivalent to setting xosview*gfx to "False".
  • +gfx โ€” overrides the xosview*gfx resource. equivalent to setting xosview*gfx to "True".
  • -wireless โ€” overrides the xosview*wireless resource. equivalent to setting xosview*wireless to "False".
  • +wireless โ€” overrides the xosview*wireless resource. equivalent to setting xosview*wireless to "True".
  • -net โ€” overrides the xosview*net resource. equivalent to setting xosview*net to "False".
  • +net โ€” overrides the xosview*net resource. equivalent to setting xosview*net to "True".
  • -network maxbandwidth, -networkBW maxbandwidth, -networkBandwidth maxbandwidth โ€” these override the xosview*netBandwidth resource. they make xosview display a meter that shows network usage with a max bandwidth of maxbandwidth. โš ๏ธ heads up bestie: setting the bandwidth to 0 does NOT disable the meter anymore โ€” use the -net option for that instead, fr fr.
  • -page โ€” overrides the xosview*page resource. equivalent to setting xosview*page to "False".
  • +page โ€” overrides the xosview*page resource. equivalent to setting xosview*page to "True".
  • -pagespeed val โ€” overrides the xosview*pageBandWidth resource. the resource xosview*pageBandWidth gets set to val. simple as ๐Ÿ“
  • -disk โ€” overrides the xosview*disk resource. equivalent to setting xosview*disk to "False".
  • +disk โ€” overrides the xosview*disk resource. equivalent to setting xosview*disk to "True".
  • -int โ€” overrides the xosview*int resource. equivalent to setting xosview*int to "False".
  • +int โ€” overrides the xosview*int resource. equivalent to setting xosview*int to "True".
  • -ints, +ints, -interrupts, +interrupts โ€” equivalent to -int and +int. same thing, different name, iykyk ๐Ÿ’…
  • -irqrate โ€” overrides the xosview*irqrate resource. equivalent to setting xosview*irqrate to "False".
  • +irqrate โ€” overrides the xosview*irqrate resource. equivalent to setting xosview*irqrate to "True".
  • -intrate, +intrate โ€” equivalent to -irqrate and +irqrate.
  • -lmstemp โ€” overrides the xosview*lmstemp resource. equivalent to setting xosview*lmstemp to "False".
  • +lmstemp โ€” overrides the xosview*lmstemp resource. equivalent to setting xosview*lmstemp to "True".
  • -coretemp โ€” overrides the xosview*coretemp resource. equivalent to setting xosview*coretemp to "False".
  • +coretemp โ€” overrides the xosview*coretemp resource. equivalent to setting xosview*coretemp to "True".
  • -acpitemp โ€” overrides the xosview*acpitemp resource. equivalent to setting xosview*acpitemp to "False".
  • +acpitemp โ€” overrides the xosview*acpitemp resource. equivalent to setting xosview*acpitemp to "True".
  • -bsdsensor โ€” overrides the xosview*bsdsensor resource. equivalent to setting xosview*bsdsensor to "False".
  • +bsdsensor โ€” overrides the xosview*bsdsensor resource. equivalent to setting xosview*bsdsensor to "True".
  • -xrm resource_string โ€” this one is iconic: it lets u set ANY of xosview's resources right on the command line. here's how u'd set xosview*memFreeColor with it. notice the quoting โ€” it stops the shell from expanding * or from splitting this into two separate arguments, xosview*memfreeColor: and purple:
-xrm "xosview*memFreeColor: purple"

๐ŸŒˆ X RESOURCES ๐ŸŒˆ

here's the full list of X resources xosview supports ๐Ÿซถ each one has a default value already assigned to it. u can find those defaults in the file Xdefaults, which u can get from the source distribution of xosview. wanna override them? do it in all the usual places (/usr/lib/X11/app-defaults/XOsview, $HOME/.Xdefaults, etc.) โœจ

also quick PSA: it's totally OK to have a resource defined for a port of xosview that doesn't even support the feature that resource configures. xosview just ignores resources that are set for it but not supported on a given platform. no drama ๐Ÿ’…

๐Ÿ’– General Resources ๐Ÿ’–

  • xosview*title: name โ€” the string xosview uses for the X window title. normally it uses 'xosview@machine_name' as the title, and this resource overrides that default behavior.
  • xosview*geometry: geometry_string โ€” a standard X geometry string that defines the size and location of the X window xosview uses.
  • xosview*display: name โ€” the name of the display where xosview contacts the X server to draw its window.
  • xosview*pixmapName: name โ€” the filename of an X pixmap (xpm) file to use as a background image ๐ŸŽ€
  • xosview*captions: (True or False) โ€” if True, xosview displays meter captions.
  • xosview*labels: (True or False) โ€” if True, xosview displays meter labels.
  • xosview*meterLabelColor: color โ€” the color used for the meter labels.
  • xosview*usedlabels: (True or False) โ€” if True, xosview displays labels showing the percentage of the resource being used (or the absolute amount, depending on the meter). โš ๏ธ this one needs the labels option to ALSO be set to True, they're a package deal.
  • xosview*usedLabelColor: color โ€” the color used for "used" labels.
  • xosview*borderwidth: width โ€” the width of the border for the xosview window.
  • xosview*font: font โ€” the font xosview uses. it's a bitmap font rendered at the X server. wanna see what's available? use xlsfonts(1) to list the fonts, and rehash the list with xset(1).
  • xosview*background: color โ€” the color used for the background.
  • xosview*foreground: color โ€” the color used for the foreground.
  • xosview*enableStipple: (True or False) โ€” set it to true to try stipple support. this is mainly for the girlies stuck on 1-bit monitors/display cards ๐Ÿ˜ญ try setting enableStipple true. and pls give us feedback on this if u use it โ€” it needs some more work, but literally no one has given us any feedback so far ๐Ÿ™ˆ
  • xosview*graphNumCols: number โ€” defines the number of sample bars drawn when a meter is in scrolling graph mode. side effect alert: it also defines the width of the graph columns. this is only used by meters that have graph mode enabled.

๐Ÿ’พ Load Meter Resources ๐Ÿ’พ

Bestie, this is the load average meter and it is so important for vibe checks on your system. ๐Ÿซถ

  • xosview*load โ€” (True or False) Set this to True and xosview will show you a load meter, periodt.
  • xosview*loadProcColor โ€” color โ€” the color the load meter paints the load average with while it's still chillin' below the warning threshold. ๐ŸŸข
  • xosview*loadWarnColor โ€” color โ€” the color it switches to once the load average has climbed above the warning threshold but is still below the critical load threshold. Yellow-flag energy. ๐ŸŸก
  • xosview*loadCritColor โ€” color โ€” the color it rocks once the load average is above the critical load threshold. It's giving "girl, something is on fire". ๐Ÿ”ฅ
  • xosview*loadIdleColor โ€” color โ€” the load meter uses this one to paint the idle field. ๐Ÿ˜ด
  • xosview*loadPriority โ€” priority โ€” this number (and it must be an integer >= 1) sets how many tenths of a second the load meter waits between updates. A value of 1 has xosview update the meter 10 times per second (the fastest). A value of 600 would cause xosview to update the meter once a minute.
  • xosview*loadWarnThreshold โ€” int โ€” this number (again, must be an integer >= 1) sets the value at which the loadmeter flips its status and color from "normal" to "warning". The default value is the number of processors.
  • xosview*loadCritThreshold โ€” int โ€” this number (must be an integer >= 1) sets the value at which the loadmeter flips its status and color from "warning" to "critical". The default value is four times the warning threshold.
  • xosview*loadDecay โ€” (True or False) honestly? You should probably leave this at the default value (False). The load is already a time-averaged value! No notes. ๐Ÿ™ˆ
  • xosview*loadGraph โ€” (True or False) Set it to True and the load meter gets drawn as a horizontally scrolling bargraph, showing the state value verses time. ๐Ÿ“ˆ
  • xosview*loadUsedFormat โ€” (float, percent or autoscale) This resource tells xosview how to display "used" labels. The formats work as follows:
    • float: Display the value as a floating point number.
    • percent: Display the value as a percentage of the total.
    • autoscale: Display the absolute value and automatically print the units (K, M, or G) as appropriate.
  • xosview*loadCpuSpeed โ€” (True or False) Display the current CPU speed in the load meter. โœจ

๐Ÿง  CPU Meter Resources ๐Ÿง 

  • xosview*cpu โ€” (True or False) If True then xosview will display a cpu meter. On Linux, *BSD, Solaris and IRIX SMP machines, the resource cpuFormat defines how meters are created for multiple CPUs. (iykyk ๐Ÿ‘‘)
  • xosview*cpuUserColor โ€” color โ€” the cpu meter uses this color to display the cpu user time field.
  • xosview*cpuNiceColor โ€” color โ€” the cpu meter uses this color to display the cpu nice time field.
  • xosview*cpuSystemColor โ€” color โ€” the cpu meter uses this color to display the cpu system time field.
  • xosview*cpuInterruptColor โ€” color โ€” the cpu meter uses this color to display the cpu hard interrupt time field.
  • xosview*cpuSInterruptColor โ€” color โ€” the cpu meter uses this color to display the cpu soft interrupt time field.
  • xosview*cpuWaitColor โ€” color โ€” the cpu meter uses this color to display the cpu IO waiting time field.
  • xosview*cpuGuestColor โ€” color โ€” the cpu meter uses this color to display the cpu virtualization guest time field.
  • xosview*cpuNiceGuestColor โ€” color โ€” the cpu meter uses this color to display the cpu niced virtualization guest time field.
  • xosview*cpuStolenColor โ€” color โ€” the cpu meter uses this color to display the cpu involuntary wait time field.
  • xosview*cpuFreeColor โ€” color โ€” the cpu meter uses this color to display the cpu idle time field.
  • xosview*cpuPriority โ€” priority โ€” this number (must be an integer >= 1) sets the number of tenths of a second the cpu meter waits between updates. A value of 1 has xosview update the meter 10 times per second (the fastest). A value of 600 would cause xosview to update the meter once a minute.
  • xosview*cpuDecay โ€” (True or False) If True then the cpu meter gets split vertically in two. The top half shows the instantaneous state, while the bottom half displays a decaying average of the state. two moods fr. ๐Ÿฆ‹
  • xosview*cpuGraph โ€” (True or False) Set it to True and the cpu meter gets drawn as a horizontally scrolling bargraph showing the state value verses time.
  • xosview*cpuUsedFormat โ€” (float, percent or autoscale) This resource tells xosview how to display "used" labels. The formats work as follows:
    • float: Display the value as a floating point number.
    • percent: Display the value as a percentage of the total.
    • autoscale: Display the absolute value and automatically print the units (K, M, or G) as appropriate.
  • xosview*cpuFormat โ€” (single, all, both or auto) If single, only a cumulative meter for all CPU usage is created. all creates a meter for each CPU, but no cumulative meter. both creates one cumulative meter and one for each CPU. auto makes a choice based on the number of CPUs found. slay, options. ๐Ÿ’…
  • xosview*cpuFields โ€” USED/USR/NIC/SYS/INT/SI/HI/WIO/GST/NGS/STL/IDLE โ€” The set of fields to show in Linux CPU meter instead of the default. Possible fields are:
    • USED: Combine all used CPU time into one field. This is the sum of user, nice, system, soft and hard interrupts, guest, niced guest and stolen times. None of these, except stolen, may be defined together with USED.
    • IDLE: Time spent doing nothing. Includes I/O wait if it is not defined separately.
    • USR: Time spent in user mode processes. Includes nice, guest and niced guest if those are not defined separately.
    • NIC: Time spent in niced user mode processes. Includes niced guest if neither it nor guest is not defined separately.
    • SYS: Time spent in kernel code. Includes soft and hard interrupt as well as stolen time if those are not defined separately.
    • INT: Combines soft and hard interrupt handling times into one field.
    • SI: Time the kernel used to handle soft interrupts. Available on Linux kernel 2.6.0 and higher.
    • HI: Time the kernel used to handle hard interrupts. Available on Linux kernel 2.6.0 and higher.
    • WIO: Time spent waiting for I/O to complete. Available on Linux kernel 2.6.0 and higher.
    • GST: Time spent running guest OS in virtual machine. Includes niced guest if it is not defined separately. Available on Linux kernel 2.6.24 and higher.
    • NGS: Time spent running niced guest OS in virtual machine. Available on Linux kernel 2.6.32 and higher.
    • STL: Involuntary wait time when running as guest in virtual machine. Available on Linux kernel 2.6.11 and higher.

Most combinations are possible (see above for restrictions), but at least USED or USR and SYS need to be defined. IDLE field is added automatically.


๐Ÿ“ Memory Meter Resources ๐Ÿ“

  • xosview*mem โ€” (True or False) If True then xosview will display a mem meter.
  • xosview*memUsedColor โ€” color โ€” the mem meter uses this color to display the used memory field.
  • xosview*memSharedColor โ€” color โ€” the mem meter uses this color to display the shared memory field.
  • xosview*memBufferColor โ€” color โ€” the mem meter uses this color to display the buffer memory field.
  • xosview*memCacheColor โ€” color โ€” the mem meter uses this color to display the cache memory field.
  • xosview*memFreeColor โ€” color โ€” the mem meter uses this color to display the free memory field.
  • xosview*memKernelColor โ€” color โ€” the mem meter uses this color to display the kernel memory field.
  • xosview*memSharedColor โ€” color โ€” the mem meter uses this color to display the shared memory field. (yes bestie, it's listed again, and yes it's the exact same thing โ€” we keep it real ๐Ÿซถ)
  • xosview*memTextColor โ€” color โ€” the mem meter uses this color to display the HP text memory field.
  • xosview*memOtherColor โ€” color โ€” the mem meter uses this color to display the HP ``other'' memory field.
  • xosview*memActiveColor โ€” color โ€” the mem meter uses this color to display the *BSD active memory field.
  • xosview*memInactiveColor โ€” color โ€” the mem meter uses this color to display the *BSD inactive memory field.
  • xosview*memWiredColor โ€” color โ€” the mem meter uses this color to display the *BSD wired memory field.
  • xosview*memSlabColor โ€” color โ€” the mem meter uses this color to display the Linux in-kernel data structures field.
  • xosview*memMapColor โ€” color โ€” the mem meter uses this color to display the Linux memory mapped files field.
  • xosview*memPriority โ€” priority โ€” this number (must be an integer >= 1) sets the number of tenths of a second the mem meter waits between updates. A value of 1 has xosview update the meter 10 times per second (the fastest). A value of 600 would cause xosview to update the meter once a minute.
  • xosview*memDecay โ€” (True or False) If True then the mem meter gets split vertically in two. The top half shows the instantaneous state, while the bottom half displays a decaying average of the state.
  • xosview*memGraph โ€” (True or False) Set it to True and the mem meter gets drawn as a horizontally scrolling bargraph showing the state value verses time.
  • xosview*memUsedFormat โ€” (float, percent or autoscale) This resource tells xosview how to display "used" labels. The formats work as follows:
  • float โ€” shows the value as a floating point number, plain and simple ๐Ÿ’
  • percent โ€” shows it as a percentage of the total, so you get the vibe in context ๐Ÿ“Š
  • autoscale โ€” shows the absolute value and auto-prints the units (K, M, or G) as appropriate, bestie it literally picks the unit for you โœจ

๐Ÿ’พ Swap Meter Resources ๐Ÿ’พ

  • xosview*swap โ€” (True or False) set it True and xosview will display a swap meter. periodt ๐Ÿ’…
  • xosview*swapUsedColor โ€” color. the swap meter uses this one for the used swap field.
  • xosview*swapFreeColor โ€” color. and this one for the free swap field. balance ๐Ÿซถ
  • xosview*swapPriority โ€” priority. this number (must be an integer >= 1, no negotiating) sets how many tenths of a second the swap meter waits between updates. a value of 1 has xosview update the meter 10 times per second (the fastest, she's zoomin ๐Ÿ”ฅ). a value of 600 would cause xosview to update the meter once a minute. choose your own adventure.
  • xosview*swapDecay โ€” (True or False) if True the swap meter gets split vertically in two. top half shows the instantaneous state, bottom half shows a decaying average of the state. it's giving duality ๐ŸŒ—
  • xosview*swapGraph โ€” (True or False) set it True and the swap meter is drawn as a horizontally scrolling bargraph showing the state value verses time. so cinematic ๐Ÿ“ˆ
  • xosview*swapUsedFormat โ€” (float, percent or autoscale). this resource tells xosview how to display the "used" labels. the formats work like this:
    • float โ€” display the value as a floating point number.
    • percent โ€” display the value as a percentage of the total.
    • autoscale โ€” display the absolute value and automatically print the units (K, M, or G) as appropriate.

๐Ÿ“„ Page Swapping Meter Resources ๐Ÿ“„

  • xosview*page โ€” (True or False) if True then xosview will display a page meter. let her cook ๐Ÿณ
  • xosview*pageBandWidth โ€” maxEvents. this number specifies the expected maximum bandwidth (in events / sec) for the page meter. when the expected maximum bandwidth (maxEvents) is exceeded, the page meter will display the relative percentage of page swapping (25% in, 75% out). lowkey informative.
  • xosview*pageInColor โ€” color. the page meter uses this for the page-in field.
  • xosview*pageOutColor โ€” color. and this for the page-out field.
  • xosview*pageIdleColor โ€” color. and this for the idle field. the chill one ๐Ÿ˜ด
  • xosview*pagePriority โ€” priority. this number (must be an integer >= 1) sets the number of tenths of a second the page meter waits between updates. a value of 1 has xosview update the meter 10 times per second (the fastest). a value of 600 would cause xosview to update the meter once a minute.
  • xosview*pageDecay โ€” (True or False) if True the page meter will be split vertically in two. the top half shows the instantaneous state, the bottom half displays a decaying average of the state. same energy as the swap one ๐Ÿ’ซ
  • xosview*pageGraph โ€” (True or False) set this True and the page meter is drawn as a horizontally scrolling bargraph showing the state value verses time.
  • xosview*pageUsedFormat โ€” (float, percent or autoscale). this resource tells xosview how to display "used" labels. the formats work as follows:
    • float โ€” display the value as a floating point number.
    • percent โ€” display the value as a percentage of the total.
    • autoscale โ€” display the absolute value and automatically print the units (K, M, or G) as appropriate.

๐ŸŽฎ Gfx Meter Resources ๐ŸŽฎ

  • xosview*gfx โ€” (True or False) if True xosview will display the GfxMeter. the value is sampled once per second, due to the usage of sadc to sample data. yes, only once a second, that's the deal bestie ๐Ÿข
  • xosview*gfxWarnColor โ€” color. this is the color the gfx meter uses once the warn state is reached. โš ๏ธ vibes
  • xosview*gfxAlarmColor โ€” color. this is the color it uses once the alarm state is reached. ๐Ÿšจ
  • xosview*gfxSwapColor โ€” color. this is the color the gfx meter uses in normal state. (yes, it's spelled SwapColor, no I did not make that up, keep it exactly like that ๐Ÿ’€)
  • xosview*gfxIdleColor โ€” color. the gfx meter uses this to display the idle field.
  • xosview*gfxPriority โ€” priority. this number (must be an integer >= 1) sets the number of tenths of a second the gfx meter waits between updates. a value of 1 has xosview update the meter 10 times per second (the fastest). a value of 600 would cause xosview to update the meter once a minute.
  • xosview*gfxWarnThreshold โ€” int. this number (must be an integer >= 1) of swapbuffers per second and pipe at which the gfxmeter changes its status and color from "normal" to "warn". the default value is 60.
  • xosview*gfxAlarmThreshold โ€” int. this number (must be an integer >= gfxWarnThreshold) of swapbuffers per second and pipe at which the gfxmeter changes its status and color from "warn" to "alarm". the default value is 120.
  • xosview*gfxDecay โ€” (True or False) you should probably leave this at the default value (False). the gfx does not work in decay mode. so like. don't. ๐Ÿ™ˆ
  • xosview*gfxGraph โ€” (True or False) set this True and the gfx meter is drawn as a horizontally scrolling bargraph showing the state value verses time.
  • xosview*gfxUsedFormat โ€” (float, percent or autoscale). this resource tells xosview how to display "used" labels. the formats work as follows:
    • float โ€” display the value as a floating point number.
    • percent โ€” display the value as a percentage of the total.
    • autoscale โ€” display the absolute value and automatically print the units (K, M, or G) as appropriate.

๐ŸŒ Network Meter Resources ๐ŸŒ

  • xosview*net โ€” (True or False) if True xosview will display the NetMeter. Linux users will have to configure their kernels and setup some ip accounting rules to make this work. see the file README.linux which comes with the xosview distribution for details. yeah it's a whole side quest ๐Ÿ˜ญ
  • xosview*netBandwidth โ€” maxBytes. this number specifies the expected maximum bandwidth (in bytes / sec) for the meter. when the expected maximum bandwidth (maxBytes) is exceeded, the network meter will display the relative percentage of network usage (25% incoming, 75% outgoing).
  • xosview*netIface โ€” interface. if False, xosview will display the data received/transmitted by any of the network interfaces. otherwise, xosview will only display the data received/transmitted by the specified network interface. if the name is prepended with a - sign, the data in that interface is ignored. pick your faves, exclude your opps ๐Ÿ’…
  • xosview*netInColor โ€” color. the net meter uses this for the incoming field.
  • xosview*netOutColor โ€” color. and this for the outgoing field.
  • xosview*netBackground โ€” color. this is the color the network meter uses for the "idle" field.
  • xosview*netPriority โ€” priority. this number (must be an integer >= 1) sets the number of tenths of a second the net meter waits between updates. a value of 1 has xosview update the meter 10 times per second (the fastest). a value of 600 would cause xosview to update the meter once a minute.
  • xosview*netDecay โ€” (True or False) if True the net meter will be split vertically in two. top half = instantaneous state, bottom half = decaying average of the state. the classic combo ๐Ÿฆ‹
  • xosview*netGraph โ€” (True or False) set this True and the net meter is drawn as a horizontally scrolling bargraph showing the state value verses time.
  • xosview*netUsedFormat โ€” (float, percent or autoscale). this resource tells xosview how to display "used" labels. the formats work as follows:
    • float โ€” display the value as a floating point number.
    • percent โ€” display the value as a percentage of the total.
    • autoscale โ€” display the absolute value and automatically print the units (K, M, or G) as appropriate.

๐Ÿ—‚๏ธ NFSStats (Client) Resources ๐Ÿ—‚๏ธ

  • xosview*NFSStats โ€” (True or False) if True xosview will display a meter to monitor NFS client stats.
  • xosview*NFSStatReTransColor โ€” color. the color to be used for retransmit stats.
  • xosview*NFSStatAuthRefrshColor โ€” color. the color to be used for auth refresh stats. (yep, that spelling โ€” Refrsh โ€” is exactly what it says, do not "fix" it, she's iconic as-is ๐Ÿ‘‘)
  • xosview*NFSStatCallsColor โ€” color. the color to be used for call stats.
  • xosview*NFSStatIdleColor โ€” color. the color to be used for idle stats.

๐Ÿ–ฅ๏ธ NFSDStats (Server) Resources ๐Ÿ–ฅ๏ธ

  • xosview*NFSDStats โ€” (True or False) if True xosview will display a meter for NFS server/daemon stats.
  • xosview*NFSDStatCallsColor โ€” color. the color to be used for call stats.
  • xosview*NFSDStatBadCallsColor โ€” color. the color to be used for bad stats.
  • xosview*NFSDStatUDPColor โ€” color. the color to be used for UDP stats.
  • xosview*NFSDStatTCPColor โ€” color. the color to be used for TCP stats.
  • xosview*NFSDStatIdleColor โ€” color. the color to be used for idle stats.

๐Ÿ”Œ Serial Meter Resources ๐Ÿ”Œ

  • xosview*serial(0-9) โ€” (True, False, or portBase). if True then xosview will display a serial meter for ttySx. the portbase will be autodetected. because autodetection can fail (if the port is locked by ppp/slip for example) you can specify the portbase instead of "True". if a portBase is used then xosview will use it instead of trying to autodetect. lowkey autodetect is just guessing with confidence ๐Ÿ™ˆ

for this to work on Linux xosview needs to be suid root in order to have access to the ports. see the file README.linux which comes with the xosview distribution for more details.

okay bestie real talk: that's suid root. it's the price of admission for touching the ports. don't skip the README. ๐Ÿซถ
  • xosview*serialOnColor โ€” color. this is the color the serial meter uses for bits that are set.
  • xosview*serialOffColor โ€” color. and this is the color the serial meter uses for bits that are not set.
  • xosview*serialPriority: priority โ€” bestie this number (and it has to be an integer >= 1, no decimals, no zero, no negativity) sets how many tenths of a second the serial meter sits around between updates. So 1 = the meter refreshes 10 times a second (that's the fastest it goes ๐Ÿƒโ€โ™€๏ธ๐Ÿ’จ). And 600 = it refreshes literally once a minute. Chill meter energy. ๐Ÿง˜

๐Ÿ’ฅ Interrupt Meter Resources ๐Ÿ’ฅ

  • xosview*interrupts: (True or False) โ€” set it True and boom, xosview shows you an interrupt meter. โœจ
  • xosview*intSeparate: (True of False) โ€” True means you get one interrupt meter per CPU on SMP machines (so many meters, so much drama ๐Ÿ‘‘). False means just one single meter, no crowd. Default: True.
  • xosview*intOnColor: color โ€” the color used to show interrupts that are active. ๐Ÿ”ฅ
  • xosview*intOffColor: color โ€” the color used to show interrupts that are inactive. ๐Ÿ’ค
  • xosview*intPriority: priority โ€” same deal as always, and yes it must be an integer >= 1: this is how many tenths of a second the int meter waits between updates. 1 = 10 updates per second (fastest). 600 = one update per minute. Pick your vibe. ๐ŸŽ€

๐Ÿ“Š Interrupt Rate Meter Resources ๐Ÿ“Š

  • xosview*irqrate: (True or False) โ€” True and xosview will show an interrupt rate meter. Slay. ๐Ÿ’…
  • xosview*irqrateUsedColor: color โ€” the color used to show the interrupt rate itself.
  • xosview*irqrateIdleColor: color โ€” the irqrate meter uses this color to display the idle field. ๐Ÿ˜ด
  • xosview*irqratePriority: priority โ€” you already know the drill: integer >= 1, number of tenths of a second the irqrate meter waits between updates. 1 = 10 times a second (the fastest). 600 = once a minute. โฑ๏ธ
  • xosview*irqrateDecay: (True or False) โ€” True means the irqrate meter gets split vertically in two, like a lil sandwich ๐Ÿฅช. The top half shows the instantaneous state, and the bottom half shows a decaying average of the state. Iconic.
  • xosview*irqrateGraph: (True or False) โ€” True here and the irqrate meter gets drawn as a horizontally scrolling bargraph, showing the state value vs. time. It's giving history lesson ๐Ÿ“ˆ.
  • xosview*irqrateUsedFormat: (float, percent or autoscale) โ€” this one tells xosview how to display those "used" labels. The formats go like this:
    • float: display the value as a floating point number.
    • percent: display the value as a percentage of the total.
    • autoscale: display the absolute value and automatically print the units (K, M, or G) as appropriate. โœจ

๐ŸŒก๏ธ Lm Sensors Resources ๐ŸŒก๏ธ

  • xosview*lmstemp: (True or False) โ€” True = xosview shows an lmstemp meter. Temperature check, but make it a graph ๐Ÿซถ.
  • xosview*lmstempHighest: number โ€” the highest value displayed. If you don't give it, or the number you give is too small, the meter will adjust itself to fit the actual and alarm values (it's flexible like that ๐Ÿ’โ€โ™€๏ธ). You can also override it for any single meter with lmstempHighestN.
  • xosview*lmstempActColor: color โ€” color of the actual value.
  • xosview*lmstempHighColor: color โ€” color above the high alarm value, and it's also used to indicate the alarm. ๐Ÿšจ
  • xosview*lmstempLowColor: color โ€” color of the actual value when it's below the low alarm value.
  • xosview*lmstempIdleColor: color โ€” color of the zone between the actual and high alarm values.
  • xosview*lmstempN: filename โ€” the name of the input file from /proc/sys/dev/sensors/*/* or /sys/class/hwmon/*/{,device}/, where N=1,2,3,.... It can also be an absolute path. For example:
xosview*lmstemp1: temp1
xosview*lmstemp2: temp2_input
Note: lots of sensors keep the value and the alarm threshold in files named *_input and *_max/*_min respectively. In that case, just specifying the base name like "temp1" right here is enough โ€” xosview will use both files for you. ๐Ÿ’–
Note: if the same file name as lmstempN, lmshighN or lmslowN exists in other sensor directories, then lmsnameN needs to be specified, or an absolute path used, so xosview finds the correct one. No mixing up sensors, okay? ๐Ÿ™ˆ
  • xosview*lmshighN: filename or number โ€” an optional high alarm value, or the name of a file from /sys/class/hwmon/*/{,device}/, with N=1,2,3,.... Can also be an absolute path. If you don't give it, lmstempHighest is used as both the maximum and the high alarm. For example:
xosview*lmshigh1: 70
xosview*lmshigh2: temp1_crit_hyst
  • xosview*lmslowN: filename or number โ€” an optional low alarm value, or the name of a file from /sys/class/hwmon/*/{,device}/, with N=1,2,3,.... Can also be an absolute path. Default is 0. For example:
xosview*lmslow1: 1.5
xosview*lmslow2: fan1_min
  • xosview*lmsnameN: name โ€” optional name of the sensor device to use when xosview is hunting down the filename(s) you gave in lmstempN, lmshighN and lmslowN. Peep /sys/class/hwmon/*/{,device}/name for the names of your sensors. Heads up: this has no effect on files given as absolute paths. For example:
xosview*lmsname1: nct6779
xosview*lmsname2: radeon
  • xosview*lmstempLabelN: string โ€” the N-th label for the values above. Default is TMP.
  • xosview*lmstempHighestN: number โ€” overrides the default lmstempHighest for meter N. ๐ŸŽฏ
  • xosview*lmstempUsedFormatN: (float, percent or autoscale) โ€” overrides the default lmstempUsedFormat for meter N.
  • xosview*lmstempPriority: priority โ€” okay so it's the same rule every time: integer >= 1, the number of tenths of a second the lmstemp meter waits between updates. 1 = 10 updates per second (fastest). 600 = once a minute. โฐ
  • xosview*lmstempUsedFormat: (float, percent or autoscale) โ€” how xosview displays the "used" labels. The formats, once again:
    • float: display the value as a floating point number.
    • percent: display the value as a percentage of the total.
    • autoscale: display the absolute value and automatically print the units (K, M, or G) as appropriate. ๐ŸŒˆ

๐Ÿ”ฅ ACPI Temperature Resources ๐Ÿ”ฅ

  • xosview*acpitemp: (True or False) โ€” True and xosview displays an acpitemp meter. ๐ŸŒก๏ธ
  • xosview*acpitempHighest: 100 โ€” highest temp value displayed, default 100. But if acpihighN is given, the value gets read from there instead. Sneaky swap ๐Ÿ‘€.
  • xosview*acpitempActColor: color โ€” color of the actual temperature.
  • xosview*acpitempHighColor: color โ€” color above the alarm temperature, also used to indicate the alarm. ๐Ÿšจ
  • xosview*acpitempIdleColor: color โ€” color of the space between actual and alarm temperatures.
  • xosview*acpitempN: filename โ€” name of the temperature file from /proc/acpi/thermal_zone or /sys/devices/virtual/thermal. Careful bestie: the last directory part must be given, like TZ0/temperature. An absolute path can also be used. ๐Ÿ’…
  • xosview*acpihighN: filename โ€” name of the high value / trip point file from /proc/acpi/thermal_zone or /sys/devices/virtual/thermal, or an absolute path to one.
  • xosview*acpitempLabelN: Labelstring โ€” the N-th label for the temperatures above. Default is TMP.
  • xosview*acpitempPriority: priority โ€” you know it, you love it: an integer >= 1 setting how many tenths of a second the acpitemp meter waits between updates. 1 = 10 per second (the fastest). 600 = once a minute. ๐Ÿ•
  • xosview*acpitempUsedFormat: (float, percent or autoscale) โ€” how to display the "used" labels. Here's the rundown:
    • float: display the value as a floating point number.
    • percent: display the value as a percentage of the total.
    • autoscale: display the absolute value and automatically print the units (K, M, or G) as appropriate. โœจ

๐ŸงŠ Intel Core / AMD K8+ / VIA C7 Temperature Sensor Resources ๐ŸงŠ

  • xosview*coretemp: (True or False) โ€” True = xosview shows a coretemp meter. ๐ŸŒก๏ธ๐Ÿ’–
  • xosview*coretempHighest: 100 โ€” highest temp value displayed, default 100. But if the CPU throttling temperature (tjMax) is supplied by the operating system, that gets used instead. The OS said what it said ๐Ÿ‘‘.
  • xosview*coretempHigh: number โ€” the value to use as the alarm temperature, default is coretempHighest. If a usable value is supplied by the operating system โ€” like the temperature for which maximum cooling is required โ€” then that's used instead. โ„๏ธ
  • xosview*coretempActColor: color โ€” color of the actual temperature.
  • xosview*coretempHighColor: color โ€” color above the alarm temperature, also used to indicate the alarm.
  • xosview*coretempIdleColor: color โ€” color of the zone between actual and alarm temperatures.
  • xosview*coretempDisplayType: (separate, average or maximum) โ€” tells xosview how to display the CPU temperature. The formats work like this:
    • separate: display one meter for each CPU core of a multi-core CPU. This is the default.
    • average: display the average of core temperatures of a multi-core CPU. On multi-socket machines, one meter per physical CPU is displayed.
    • maximum: display the highest core temperature of a multi-core CPU. On multi-socket machines, one meter per physical CPU is displayed. ๐Ÿ†
  • xosview*coretempPriority: priority โ€” yes, again, integer >= 1: how many tenths of a second the coretemp meter waits between updates. 1 = 10 updates per second (the fastest). 600 = once a minute. โณ
  • xosview*coretempUsedFormat: (float, percent or autoscale) โ€” how to display the "used" labels. As follows:
    • float: display the value as a floating point number.
    • percent: display the value as a percentage of the total.
    • autoscale: display the absolute value and automatically print the units (K, M, or G) as appropriate. ๐ŸŒธ

๐Ÿก *BSD Sensor Resources ๐Ÿก

  • xosview*bsdsensor: (True or False) โ€” True and xosview will display a bsdsensor meter. ๐Ÿฆ‹
  • xosview*bsdsensorHighest: number โ€” the biggest value the meter is ever gonna show. If you don't give it, or you give it something too smol, the meter just adjusts itself to fit the actual and alarm values. And yes bestie, you can override it per-meter with bsdsensorHighestN. ๐Ÿ’…
  • xosview*bsdsensorActColor: color โ€” the color of the actual value. The real one. The moment. โœจ
  • xosview*bsdsensorHighColor: color โ€” color for anything above the high alarm value, and it's also what flags the alarm. She's serving double duty. ๐Ÿšจ
  • xosview*bsdsensorLowColor: color โ€” the color of the actual value when it dips below the low alarm value. ๐Ÿฅถ
  • xosview*bsdsensorIdleColor: color โ€” the color for the zone between the actual and high alarm values. Chill zone energy. ๐Ÿ˜Œ
  • xosview*bsdsensorN: name.type
  • xosview*bsdsensorHighN: name.type
  • xosview*bsdsensorLowN: name.type

okay so THESE three are the plug โ€” they define where the actual value, the high alarm value and the low alarm value for meter N=1,2,3,... get read from. The name is the sensor driver, and type is the value you want. Both alarm values are optional, and they can also just be handed to you as static numerical values. no cap.

On OpenBSD and DragonFly BSD you can find the correct pair with the systat command, like:

xosview*bsdsensor1:     it0.temp1
xosview*bsdsensorHigh1: 100

On NetBSD, you find the driver name with the envstat command. The value name for the actual reading is typically 'cur-value', for the high alarm it's 'critical-max' and for the low alarm it's 'critical-min', like:

xosview*bsdsensor2:     coretemp0.cur-value
xosview*bsdsensorHigh2: coretemp0.critical-max

For literally all possible NetBSD value names, go read the envstat source code. iykyk. ๐Ÿ“–

FreeBSD has no usable sensor drivers as of version 9.0. ๐Ÿ™ˆ However, ACPI thermal zones can be used by defining the sysctl node below hw.acpi.thermal, like:

xosview*bsdsensor1:     tz0.temperature
xosview*bsdsensorHigh1: tz0._CRT

ACPI thermal zones can be used like this on DragonFly BSD as well. ๐Ÿ‰

  • xosview*bsdsensorLabelN: string โ€” the N-th label for the meters above, and the default is SENN. ๐Ÿท๏ธ
  • xosview*bsdsensorHighestN: number โ€” overrides the default bsdsensorHighest for meter N. ๐Ÿ’…
  • xosview*bsdsensorUsedFormatN: (float, percent or autoscale) โ€” overrides the default bsdsensorUsedFormat for meter N.
  • xosview*bsdsensorPriority: priority โ€” this number (and it must be an integer >= 1, don't try it) sets how many tenths of a second the bsdsensor meter waits between updates. A value of 1 has xosview updating the meter 10 times per second (that's the fastest). A value of 600 would make xosview update the meter once a minute. ๐Ÿข
  • xosview*bsdsensorUsedFormat: (float, percent or autoscale) โ€” this resource tells xosview how to display "used" labels. The formats work like this:
    • float: Display the value as a floating point number.
    • percent: Display the value as a percentage of the total.
    • autoscale: Display the absolute value and automatically print the units (K, M, or G) as appropriate.

๐Ÿ”‹ Battery Meter Resources ๐Ÿ”‹

  • xosview*battery: (True or False) โ€” if True then xosview will display a battery meter. Linux girlies will need APM or ACPI support in their kernels for this to work, periodt. For both APM and ACPI, xosview shows the status/sum of all the batteries. Plus โ€” the legend text gets changed/adjusted to reflect the current state (charging/low/critical/etc.) of the battery/batteries. ๐Ÿ’–
  • xosview*batteryLeftColor: color โ€” the color used to show how much battery power is left. ๐Ÿ”‹
  • xosview*batteryUsedColor: color โ€” the color used to show how much battery power got used.
  • xosview*batteryChargeColor: color โ€” used as 'left' when the batteries are getting charged. โšก
  • xosview*batteryFullColor: color โ€” used as 'left' when the batteries are fully charged. APM and ACPI do provide this info, but not all machines actually do. ๐Ÿ˜ญ
  • xosview*batteryLowColor: color โ€” APM only โ€” the 'left' color that indicates a low battery. Depends on the machine โ€” e.g. below 25% remaining capacity.
  • xosview*batteryCritColor: color โ€” APM case: the 'left' color if APM indicates a 'critical' state (less than 5%). ACPI case: the 'left' color if the remaining capacity is below the alarm value (which you can set yourself in /proc/acpi/battery/BAT[01]/alarm). ๐Ÿšจ
  • xosview*batteryNoneColor: color โ€” for when no battery is present, or all the batteries get removed (while on AC). ๐Ÿ’€
  • xosview*batteryPriority: priority โ€” this number (which must be an integer >= 1) sets how many tenths of a second the battery meter waits between updates. A value of 1 has xosview update the meter 10 times per second (the fastest). A value of 600 would cause xosview to update the meter once a minute.
  • xosview*batteryUsedFormat: (float, percent or autoscale) โ€” this resource tells xosview how to display "used" labels. The formats work like this:
    • float: Display the value as a floating point number.
    • percent: Display the value as a percentage of the total.
    • autoscale: Display the absolute value and automatically print the units (K, M, or G) as appropriate.

๐Ÿ“ถ Wireless Meter Resources ๐Ÿ“ถ

  • xosview*wireless: (True or False) โ€” if True then xosview will display the link quality of each wireless connection. Note that the graph will *never* show up if you don't have any wireless devices, or no wireless extensions in the kernel (/proc/net/wireless). Default is true. ๐ŸŒˆ
  • xosview*PoorQualityColor: color โ€” the color for the quality field when it's between 0 and 6. ๐Ÿ˜ฌ
  • xosview*FairQualityColor: color โ€” the color for the quality field when it's between 7 and 14.
  • xosview*GoodQualityColor: color โ€” the color for the quality field when it's higher than 14. slay. โœจ
  • xosview*wirelessUsedColor: color โ€” this one's the background color.
  • xosview*wirelessPriority: priority โ€” this number (which must be an integer >= 1) sets how many tenths of a second the wireless meter waits between updates. A value of 1 has xosview update the meter 10 times per second (the fastest). A value of 600 would cause xosview to update the meter once a minute.
  • xosview*wirelessDecay: (True or False) โ€” if True then the wireless meter gets split vertically in two. The top half shows the instantaneous state, while the bottom half displays a decaying average of the state. she's giving duality. ๐Ÿฆ‹
  • xosview*wirelessUsedFormat: (float, percent or autoscale) โ€” this resource tells xosview how to display "used" labels. The formats work like this:
    • float: Display the value as a floating point number.
    • percent: Display the value as a percentage of the total.
    • autoscale: Display the absolute value and automatically print the units (K, M, or G) as appropriate.

๐Ÿ’พ Disk Meter Resources ๐Ÿ’พ

  • xosview*disk: (True or False) โ€” if True then xosview will display a disk meter.
  • xosview*diskInColor: color โ€” the disk meter uses this color to display the reads field.
  • xosview*diskOutColor: color โ€” the disk meter uses this color to display the writes field.
  • xosview*diskIdleColor: color โ€” the disk meter uses this color to display the idle field.
  • xosview*diskBandwidth: bandwidth โ€” this number specifies the expected maximum bandwidth in bytes per second for the disk meter.
  • xosview*diskWriteColor: color โ€” this color gets used for the linux meter to show writes.
  • xosview*diskReadColor: color โ€” this color gets used for the linux meter to show reads.
  • xosview*diskPriority: priority โ€” this number (which must be an integer >= 1) sets how many tenths of a second the disk meter waits between updates. A value of 1 has xosview update the meter 10 times per second (the fastest). A value of 600 would cause xosview to update the meter once a minute.
  • xosview*diskDecay: (True or False) โ€” if True then the disk meter gets split vertically in two. The top half shows the instantaneous state, while the bottom half displays a decaying average of the state.
  • xosview*diskGraph: (True or False) โ€” if this is set to True then the disk meter gets drawn as a horizontally scrolling bargraph showing the state value verses time. ๐Ÿ“ˆ
  • xosview*diskUsedFormat: (float, percent or autoscale) โ€” this resource tells xosview how to display "used" labels. The formats work like this:
    • float: Display the value as a floating point number.
    • percent: Display the value as a percentage of the total.
    • autoscale: Display the absolute value and automatically print the units (K, M, or G) as appropriate.

๐Ÿ‘‘ RAID Meter Resources ๐Ÿ‘‘

  • xosview*RAID: (True or False) โ€” if True then xosview will display a RAID meter.
  • xosview*RAIDdevicecount: int โ€” please drop your RAID device count (n) here, or 0 if you don't have any supported RAID devices. xosview will then display n RAID state displays. ๐Ÿซถ
  • xosview*RAIDdiskOnlineColor: color
  • xosview*RAIDdiskFailureColor: color

These colors get used for indicating working/online or failed/offline disks. The order (from left to right) is the same as in /proc/mdstat. ๐Ÿ’…

  • xosview*RAIDresyncdoneColor: color
  • xosview*RAIDresynctodoColor: color
  • xosview*RAIDresynccompleteColor: color

If a resync/rebuild of the RAID array is in progress, the "done" and "todo" colors get used. If no rebuild/resync is running, then the "complete" color will be shown. โœจ

  • xosview*RAIDPriority: priority โ€” this number (which must be an integer >= 1) sets how many tenths of a second the RAID meter waits between updates. A value of 1 has xosview update the meter 10 times per second (the fastest). A value of 600 would cause xosview to update the meter once a minute.
  • xosview*RAIDUsedFormat: (float, percent or autoscale) โ€” this resource tells xosview how to display "used" labels. The formats work like this:
  • float โ€” shows the value as a floating point number. decimals, bestie, live a little ๐Ÿ’…
  • percent โ€” shows the value as a percentage of the total. very "what portion of the whole is this" of it โœจ
  • autoscale โ€” shows the absolute value and auto-prints the units (K, M, or G) as appropriate. it just knows. iconic behavior honestly ๐ŸŽ€

๐Ÿ” OBTAINING ๐Ÿ”

so if you're like "okay bestie where do I even get this" โ€” this version of xosview is distributed from the following site:

http://www.pogo.org.uk/~mark/xosview/

go get it, she's waiting ๐Ÿ’–


๐Ÿ‘‘ AUTHORS ๐Ÿ‘‘

okay this is the part where we give everybody their flowers because this is a group project and it ate ๐ŸŒธ every single one of these people put in work, no cap:

  • Mike Romberg <mike.romberg@noaa.gov> โ€” original author, plus the Linux and HPUX ports. the founding mother of the group chat ๐Ÿ‘‘
  • Brian Grayson <bgrayson@netbsd.org> โ€” NetBSD port and most of the nice enhancements for version 1.4, plus initial work on the FreeBSD port. carrying the 1.4 era fr fr
  • Scott McNab <jedi@tartarus.uwa.edu.au> โ€” added the scrolling graph mode. the scrolling graph?? obsessed ๐Ÿ”ฅ
  • Tom Pavel <pavel@slac.stanford.edu> โ€” most of the FreeBSD support, and more resource-handling improvements
  • Greg Onufer <exodus@cheers.bungi.com> โ€” SunOS port
  • Stefan Eilemann <eilemann@gmail.com> โ€” IRIX 6.5 port
  • Sheldon Hearn <axl@iafrica.com> โ€” FreeBSD libdevstat-based diskmeter support
  • David W. Talmage <talmage@jefferson.cmf.nrl.navy.mil> โ€” added battery-meter support to NetBSD ๐Ÿ”‹
  • Oleg Safiullin <form@openbsd.org> โ€” OpenBSD interrupt-meter support
  • Werner Fink <werner@suse.de> โ€” originator of the loadmeter
  • Massimiliano Ghilardi <ghilardi@cibs.sns.it> โ€” Linux pagemeter
  • Carsten Schabacker <cschaba@spock.central.de> โ€” made extensions to the serial-meter
  • Paal Beyer <pbeyer@online.no> โ€” ported the linux memstat kernel module to linux-2.1
  • Jerome Forissier <forissier@isia.cma.fr> โ€” author of the Linux SMP kernel patch which xosview uses to display meters for each CPU. one meter per CPU? main character energy ๐Ÿซถ
  • Tomer Klainer <mandor@cs.huji.ac.il> โ€” initial port to BSDI
  • Arno Augustin <Arno.Augustin@3SOFT.de> โ€” Solaris disk and network meters
  • Alberto BARSELLA <ishark@lsh01.univ-lille1.fr> โ€” fixes for linux diskmeter + ip_chains support
  • Thomas Waldmann <ThomasWaldmann@gmx.de> โ€” Linux raid meter, bitfieldmeter. many cosmetic fixes โœจ
  • Leopold Toetsch <lt@toetsch.at> โ€” Linux lms temp meter ๐ŸŒก๏ธ
  • David O'Brien <obrien@nuxi.com> โ€” FreeBSD 4.* updates, and a few other suggestions
  • Christos Zoulas <christos@netbsd.org> โ€” C++ standard compliance and other NetBSD fixes
  • Tim Ehlers <tehlers@gwdg.de> โ€” wireless Link-Meter for Linux ๐Ÿ“ถ
  • Mark Hills <mark@pogo.org.uk> โ€” bug fixes and general caretaking. the caretaker!! ๐Ÿงš
  • Tomi Tapper <tomi.o.tapper@student.jyu.fi> โ€” temperature sensor, and FreeBSD updates
  • Raymond S Brand (rsbx@acm.org) โ€” misc fixes
  • And many others who have sent in small fixes and improvements. โ€” not me getting emotional over the unnamed contributors ๐Ÿ˜ญ every single one of y'all matters, lowkey legends

and that's the whole page bestie!! you read it all, that's genuinely so slay of you ๐Ÿ’œ

so real talk โ€” this one comes to you from the 3rd Berkeley Distribution, it's XOSVIEW(1), and that's a wrap fr fr. go check your meters, hydrate, and remember: it's giving system monitor, it's giving iconic, periodt ๐Ÿฆ‹๐ŸŒˆโญ๐Ÿ’–

๐Ÿ“ฆ where this page comes from