NAME

lavaps -- a lava lamp of currently running processes


SYNOPSIS

lavaps


DESCRIPTION

LavaPS is an interactive process-tracking program like ``top'', but with a much different attitude. Rather than presenting lots of specific info in digital form, it tries to present certain important information in a graphical analog form. The idea is that you can run it in the background and get a rough idea of what's happening to your system without devoting much concentration to the task.

LavaPS was inspired by Mark Weiser's idea of calm computing in this paper:

(This program dedicated to the memory of M.W.--I hope you would have thought it a good hack.)


CONTROLLING LAVAPS

Basic LavaPS is quite simple. Blobs live and grow corresponding to processes in the system (see BLOBS). Clicking the left mouse button on a blob shows information about that process. Clicking the right mouse button pops up menus that let you control LavaPS (see MENUS). The ``base'' at the bottom of the lamp includes icons for the menus and resizing, and allows one to move the lamp around.


BLOBS

LavaPS is all about blobs of virtual, non-toxic lava. Blobs in LavaPS correspond to processes in the system. When a process is started, a new blob is created. When a process exits, the corresponding blob disappears. Blob size is proportional to the amount of memory the process uses. Blob movement is proportional to the amount of time the process runs (if the process never runs, the blob will never move).

Blobs show several things. First, the basic color (the hue) corresponds to the name of the program which is running. Emacs is always one color, Netscape another (on my system, blue and yellow). Second, blobs get darker when the process doesn't run. Over time, the process will become nearly black and only its border will remain colored. Finally, if both physical and virtual memory are shown, then the part of the process will be a slightly different color showing what percentage of the process is not in physical memory.

There are some more subtle aspects of blob physiology: initial placement is dependent on the process id (blobs appear roughly left to right) and user id (processes for the same user start at the same height, with root's processes at the top).

Blobs also move along the longer distance of the lamp: if you resize it they may change direction.

Please don't ask me about the chemical composition of the virtual lava.


MENUS

The right mouse button pops up menus which control LavaPS, including:

Proc: control the process under the menu: ``Nice'' it (make it take less CPU), unnice it (the reverse; only works if you're root), or send it a signal. Signals are terminate (the polite way to stop a process; ``terminate'' allows it to clean up after itself), kill (the forcefully way to stop something not listening to terminate), stop and continue (temporarily stop and resume the process), and hang-up (used to restart certain processes). Beware that these commands will be disabled if you don't have privileges to run them, and under some circumstances even ``kill'' won't stop a process.

Who: track processes by me or by everyone (including root, httpd, etc.).

What: track process physical or virtual memory or both. Most modern operating systems can keep all of a process in RAM (physical memory), or can let pages that aren't currently used float out to disk (virtual memory). Virtual memory is always a superset of physical memory. You can track either one, or both. When tracking both, virtual memory appears as a different colored strip down the middle of the process blob.

How: general lava lamp details: sizing, speed, and window manager interaction. Putting too little or too much lava in your lava lamp would make it boring or overflow. LavaPS therefore usually runs with patent-pending lava autosizing where blobs fill about a quarter of the lamp. This feature can be turned off (at your peril) with the How menu. You can also control the desired size of the blobs (when autosizing is enabled) or the absolute size of the blobs (when it's not) with the Grow and Shrink options.

Also under How, Jumpier and Smoother control the quality of lavaps animation. The smoother the animation, the higher the CPU overhead of lavaps (because of more frequent scans of the process table). Less smooth is more efficient.

Help: you'll have to figure this one out on your own.

Quit: this one's even harder than Help.


CONTROLLING LAVAPS (TCL/TK)

Basic LavaPS is quite simple. Blobs live and grow corresponding to processes in the system (see BLOBS). Clicking the left mouse button on a blob shows information about that process. Clicking the right mouse button pops up menus that let you control LavaPS (see MENUS).


MENUS (TCL/TK)

The right mouse button pops up menus which control LavaPS, including:

Proc: control the process under the menu: ``Nice'' it (make it take less CPU), unnice it (the reverse; only works if you're root), or send it a signal. Signals are terminate (the polite way to stop a process; ``terminate'' allows it to clean up after itself), kill (the forcefully way to stop something not listening to terminate), stop and continue (temporarily stop and resume the process), and hang-up (used to restart certain processes). Beware that these commands will be disabled if you don't have privileges to run them, and under some circumstances even ``kill'' won't stop a process.

Who: track processes by me or by everyone (including root, httpd, etc.).

What: track process physical or virtual memory or both. Most modern operating systems can keep all of a process in RAM (physical memory), or can let pages that aren't currently used float out to disk (virtual memory). Virtual memory is always a superset of physical memory. You can track either one, or both. When tracking both, virtual memory appears as a different colored strip down the middle of the process blob.

How: controls blob sizing. Putting too little or too much lava in your lava lamp would make it boring or overflow. LavaPS therefore usually runs with patent-pending lava autosizing where blobs fill about a quarter of the lamp. This feature can be turned off (at your peril) with the How menu. You can also control the desired size of the blobs (when autosizing is enabled) or the absolute size of the blobs (when it's not) with the Grow and Shrink options.

Help: you'll have to figure this one out on your own.

Quit: this one's even harder than Help.


RESOURCES (TCL/TK)

The Tcl/Tk version of LavaPS can configured from X resources (only if they're loaded with xrdb) or with the file $HOME/.lavapsrc. In both cases, the format is like:

        lavaps.autosize: false

setting whatever resource you want (in this case autosize) to some value (false). In the .lavapsrc file, the ``lavaps'' before the period can be omitted.

The following resources are supported:

geometry (default none). Specifies the initial window location and size in X-style (see X(1)).
who (default me). Whose processes should we be watching, anyway? My processes (set to ``me'') or everyone's (set to... ``everyone''). Can also be the process id of a single process if you're very single-minded.
what (default both). What kind of memory should blob size correspond to, either both, physical, or virtual.
autosize (default true). Keep the blobs at a reasonable size by dynamically changing scaling?
debug (default false). Enable debugging messages.
checkInterval (default 2000). How frequently (in milliseconds) should we check to see who's run? Defaults to 2 seconds which seems ``reasonable'' on my computer; shorten the interval if you want more frequent updates and have a faster computer (or are more tolerant than I am :-).
shaped (default true). Allow lozenge control (see next).
lozenge (default true). Make the lamp lava-lamp (lozenge) shaped using X11 shaped windows. Disabled if shaped is false.
clicklessInfo (default false). If set, process information pops up without clicking. (Not yet fully working.)


HOW DO I... (TCL/TK)

Q: The blobs are as jumpy as little rabbits, How do I make the animation smoother?

A: Set the checkInterval resource to a smaller value. Currently, Resources like checkInterval only work in the Tcl version.

Q: I'm running LavaPS on my Timex Sinclair and it consumes a lot of CPU, making my editor ed run slowly. How can I make LavaPS take less CPU?

A: Set the checkInterval resource to a larger value. Currently, Resources like checkInterval only work in the Tcl version.

Q: Lozenge-shaped LavaPS is so cool, but I keep loosing it on my 8000-pixel wide xinerama multi-screen display. How can I resize lozenge-shaped LavaPS since it doesn't have any title bar?

A: In the Tcl/Tk version: (1) Read your window manager documentation, most have ways to resize windows other than the title bar (sometimes using a menu). (2) Set the geometry explicitly with the -geometry command-line option or the geometry resource. (3) Put the title bar back (unfortunately loosing the lozenge shape) by setting the ``shaped'' resource to ``false''.

In the Gtk version: the base has controls to let you move and resize the lava lamp.


TO DOS


SEE ALSO

LavaPS was reviewed as app-of-the-week (see http://www.linuxcare.com/viewpoints/ap-of-the-wk/03-10-00.epl) by Brett Neely of Linuxcare.

ps(1)

Johan Walles's Bubbling Load Monitor http://www.student.nada.kth.se/~d92-jwa/code/ provides a similar service.


COPYRIGHT

LavaPS is Copyright (C) 1998-2003 by John Heidemann.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License, version 2, as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.


AUTHOR

John Heidemann, johnh@isi.edu.

The idea of doing a lava lamp arose in discussions with David Taylor at USC. Although he didn't end up taking it on as directed research, the idea of a top-like lava lamp seemed too good not to follow-up on.

Thanks to two enthusiastic early users (Ted Faber and Mark Yarvis) for encouragement, suggestions, and bits of code.

LavaPS includes a small amount of code from xscreensaver by M. Dobie, Patrick J. Naughton, and Jamie Zawinski. On Linux it uses Chuck Blake's /proc scanning library. Building LavaPS uses tcl2cc by Ron Frederick, from tclcl (see http://www.isi.edu/nsnam/tclcl/ for details). Thanks to these authors for releasing their code to LavaPS.

Johann Visagie, johann@egenetics.com, is the current maintainer of the FreeBSD port.

Hubert Feyrer hubert.feyrer@informatik.fh-regensburg.de, is the current maintainer of the NetBSD port.

Ashley T. Howes debiandev@ashleyhowes.com is the current maintainer of the Debian Linux package.

Thanks to all the port contributors (listed above).