.rn '' }`
''' $RCSfile$$Revision$$Date$
'''
''' $Log$
'''
.de Sh
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp
.if t .sp .5v
.if n .sp
..
.de Ip
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.de Vb
.ft CW
.nf
.ne \\$1
..
.de Ve
.ft R

.fi
..
'''
'''
'''     Set up \*(-- to give an unbreakable dash;
'''     string Tr holds user defined translation string.
'''     Bell System Logo is used as a dummy character.
'''
.tr \(*W-|\(bv\*(Tr
.ie n \{\
.ds -- \(*W-
.ds PI pi
.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
.ds L" ""
.ds R" ""
'''   \*(M", \*(S", \*(N" and \*(T" are the equivalent of
'''   \*(L" and \*(R", except that they are used on ".xx" lines,
'''   such as .IP and .SH, which do another additional levels of
'''   double-quote interpretation
.ds M" """
.ds S" """
.ds N" """""
.ds T" """""
.ds L' '
.ds R' '
.ds M' '
.ds S' '
.ds N' '
.ds T' '
'br\}
.el\{\
.ds -- \(em\|
.tr \*(Tr
.ds L" ``
.ds R" ''
.ds M" ``
.ds S" ''
.ds N" ``
.ds T" ''
.ds L' `
.ds R' '
.ds M' `
.ds S' '
.ds N' `
.ds T' '
.ds PI \(*p
'br\}
.\"	If the F register is turned on, we'll generate
.\"	index entries out stderr for the following things:
.\"		TH	Title 
.\"		SH	Header
.\"		Sh	Subsection 
.\"		Ip	Item
.\"		X<>	Xref  (embedded
.\"	Of course, you have to process the output yourself
.\"	in some meaninful fashion.
.if \nF \{
.de IX
.tm Index:\\$1\t\\n%\t"\\$2"
..
.nr % 0
.rr F
.\}
.TH LAVAPS 1 "lavaps-1.9" "27/Dec/1999" "Lavaps Documentation"
.UC
.if n .hy 0
.if n .na
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.de CQ          \" put $1 in typewriter font
.ft CW
'if n "\c
'if t \\&\\$1\c
'if n \\&\\$1\c
'if n \&"
\\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
'.ft R
..
.\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
.	\" AM - accent mark definitions
.bd B 3
.	\" fudge factors for nroff and troff
.if n \{\
.	ds #H 0
.	ds #V .8m
.	ds #F .3m
.	ds #[ \f1
.	ds #] \fP
.\}
.if t \{\
.	ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.	ds #V .6m
.	ds #F 0
.	ds #[ \&
.	ds #] \&
.\}
.	\" simple accents for nroff and troff
.if n \{\
.	ds ' \&
.	ds ` \&
.	ds ^ \&
.	ds , \&
.	ds ~ ~
.	ds ? ?
.	ds ! !
.	ds /
.	ds q
.\}
.if t \{\
.	ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.	ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.	ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.	ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.	ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.	ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
.	ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
.	ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.	ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
.\}
.	\" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
.ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
.ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
.ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.ds oe o\h'-(\w'o'u*4/10)'e
.ds Oe O\h'-(\w'O'u*4/10)'E
.	\" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.	\" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.	ds : e
.	ds 8 ss
.	ds v \h'-1'\o'\(aa\(ga'
.	ds _ \h'-1'^
.	ds . \h'-1'.
.	ds 3 3
.	ds o a
.	ds d- d\h'-1'\(ga
.	ds D- D\h'-1'\(hy
.	ds th \o'bp'
.	ds Th \o'LP'
.	ds ae ae
.	ds Ae AE
.	ds oe oe
.	ds Oe OE
.\}
.rm #[ #] #H #V #F C
.SH "NAME"
lavaps -- a lava lamp of currently running processes
.SH "SYNOPSIS"
\fBlavaps\fR
.SH "DESCRIPTION"
Lavaps is an interactive process-tracking program like ``top'\*(R', 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.
.PP
Lavaps was inspired by Mark Weiser's idea of calm computing in this paper:
.Ip "\& ``The Coming Age of Calm Technology'\*(T' by Mark Weiser and John Seely Brown. A revised version of Weiser & Brown. ``Designing Calm Technology'\*(T', PowerGrid Journal, v 1.01, \fIhttp://powergrid.electriciti.com/1.01\fR (July 1996). October, 1996.  \fIhttp://www.ubiq.com/hypertext/weiser/acmfuture2endnote.htm\fR." 4
.PP
(This program dedicated to the memory of M.W.--I hope you would have
thought it a good hack.)
.SH "AVAILABILITY"
The latest version of lavaps should always be available from
\fIhttp://www.isi.edu/~johnh/SOFTWARE/LAVAPS/\fR.
.PP
Mailing lists for lavaps are
.PP
.Vb 2
\&        lavaps-announce@heidemann.la.ca.us and
\&        lavaps-talk@heidemann.la.ca.us
.Ve
To subscribe to either, send mail with \*(L"subscribe\*(R" in
the \fIBODY\fR of the message to:
.PP
.Vb 2
\&        lavaps-announce-request@heidemann.la.ca.us
\&        or lavaps-talk-request@heidemann.la.ca.us.
.Ve
.SH "CONTROLLING LAVAPS"
Basic lavaps is quite simple.
Blobs live and grow corresponding to processes in the system
(see the section on \fIBLOBS\fR).
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 the section on \fIMENUS\fR).
.SH "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).
.PP
Blob shows 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.
.PP
Please don't ask me about the chemical composition of
the virtual lava.
.SH "MENUS"
The right mouse button pops up menus which control lavaps, including:
.PP
\fBWho\fR: track processes by \fIme\fR or by \fIeveryone\fR (including root, httpd, etc.).
.PP
\fBWhat\fR: 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.
.PP
\fBHow\fR: 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 \fIautosizing\fR 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 \fIGrow\fR and \fIShrink\fR options.
.PP
\fBHelp\fR: you'll have to figure this one out on your own.
.PP
\fBQuit\fR: this one's even harder than Help.
.SH "RESOURCES"
Lavaps can configured from X resources (only if they're loaded with xrdb)
or with the file \fI$HOME/.lavapsrc\fR.
In both cases, the format is like:
.PP
.Vb 1
\&        lavaps.autosize: false
.Ve
setting whatever resource you want (in this case autosize)
to some value (false).
In the \fI.lavapsrc\fR file, the ``lavaps'\*(R' before the period can be omitted.
.PP
The following resources are supported:
.Ip "geometry (default none). Specifies the initial window location and size in X\-style (see the \fIX(1)\fR manpage)." 4
.Ip "who (default me). Whose processes should we be watching, anyway? My processes (set to ``me'') or everyones (set to... ``everyone''). Can also be the process id of a single process if you're very single-minded." 4
.Ip "what (default both). What kind of memory should blob size correspond to, either both, physical, or virtual." 4
.Ip "autosize (default true). Keep the blobs at a reasonable size?" 4
.Ip "debug (default false).  Enable debugging messages." 4
.Ip "checkInterval (default 2000).  How frequently (in milliseconds) should we check to see who's run?  Defaults to 2 seconds which seems ``reasonable'\*(T' on my computer; shorten the interval if you want more frequent updates and have a faster computer (or are more tolerant than I am :\-)." 4
.Ip "clicklessInfo (default false). If set, process information pops up without clicking. (Not yet fully working.)" 4
.SH "TO DOS"
.Ip "\(bu known bug:  leaks memory under Debian Linux \fIhttp://www.debian.org/Bugs/db/49/49828.html\fR" 4
.Ip "\(bu window shrinks to zero on startup with tkstep installed" 4
.Ip "\(bu possible license problems with tcl2cc <http://www.debian.org/Bugs/db/49/49787.html>" 4
.Ip "\(bu settable default scaling of blob size" 4
.Ip "\(bu handle command-line options for geometry, resources, etc." 4
.Ip "\(bu should have an option to label things with the hostname" 4
.Ip "\(bu should verify that blobs can occupy the whole, whole screen." 4
.Ip "\(bu flag to force directionality" 4
.Ip "\(bu Show all processes but those by these uids (root, http, etc.). Also some way to exclude the (large) mfs image under FreeBSD." 4
.Ip "\(bu When things are resizing they should probably maintain some relationship between visual space and memory that is not affected by odd horizontal:vertical ratios." 4
.Ip "\(bu pop-up sliders to adjust scaling." 4
.Ip "\(bu lavaps steals lots of colors on a pseudocolor display. I hoped that Tcl would do reasonable color mapping for me, but apparently not." 4
.Ip "\(bu A --root option to run in the root." 4
.Ip "\(bu The info window should be pinnable (like in OpenLook), and then auto-update. <http://www.debian.org/Bugs/db/49/49884.html>" 4
.PP
\&
.SH "COPYRIGHT"
Lavaps is Copyright (C) 1998-1999 by John Heidemann.
.PP
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.
.PP
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.
.PP
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.
.SH "AUTHOR"
John Heidemann,
\f(CWjohnh@isi.edu\fR.
.PP
Thanks to two enthusiastic early users (Ted Faber and Mark Yarvis)
for encouragement, suggestions, and bits of code.
.PP
Lavaps includes a small amount of code from xscreensaver
by M. Dobie, Patrick J. Naughton, and Jamie Zawinski.
Building lavaps uses tcl2cc by Ron Frederick, from tclcl
(see \fIhttp://www-mash.cs.berkeley.edu/ns/\fR).

.rn }` ''
.IX Title "LAVAPS 1"
.IX Name "lavaps - a lava lamp of currently running processes"

.IX Header "NAME"

.IX Header "SYNOPSIS"

.IX Header "DESCRIPTION"

.IX Item "\& ``The Coming Age of Calm Technology'\*(T' by Mark Weiser and John Seely Brown. A revised version of Weiser & Brown. ``Designing Calm Technology'\*(T', PowerGrid Journal, v 1.01, \fIhttp://powergrid.electriciti.com/1.01\fR (July 1996). October, 1996.  \fIhttp://www.ubiq.com/hypertext/weiser/acmfuture2endnote.htm\fR."

.IX Header "AVAILABILITY"

.IX Header "CONTROLLING LAVAPS"

.IX Header "BLOBS"

.IX Header "MENUS"

.IX Header "RESOURCES"

.IX Item "geometry (default none). Specifies the initial window location and size in X\-style (see the \fIX(1)\fR manpage)."

.IX Item "who (default me). Whose processes should we be watching, anyway? My processes (set to ``me'') or everyones (set to... ``everyone''). Can also be the process id of a single process if you're very single-minded."

.IX Item "what (default both). What kind of memory should blob size correspond to, either both, physical, or virtual."

.IX Item "autosize (default true). Keep the blobs at a reasonable size?"

.IX Item "debug (default false).  Enable debugging messages."

.IX Item "checkInterval (default 2000).  How frequently (in milliseconds) should we check to see who's run?  Defaults to 2 seconds which seems ``reasonable'\*(T' on my computer; shorten the interval if you want more frequent updates and have a faster computer (or are more tolerant than I am :\-)."

.IX Item "clicklessInfo (default false). If set, process information pops up without clicking. (Not yet fully working.)"

.IX Header "TO DOS"

.IX Item "\(bu known bug:  leaks memory under Debian Linux \fIhttp://www.debian.org/Bugs/db/49/49828.html\fR"

.IX Item "\(bu window shrinks to zero on startup with tkstep installed"

.IX Item "\(bu possible license problems with tcl2cc <http://www.debian.org/Bugs/db/49/49787.html>"

.IX Item "\(bu settable default scaling of blob size"

.IX Item "\(bu handle command-line options for geometry, resources, etc."

.IX Item "\(bu should have an option to label things with the hostname"

.IX Item "\(bu should verify that blobs can occupy the whole, whole screen."

.IX Item "\(bu flag to force directionality"

.IX Item "\(bu Show all processes but those by these uids (root, http, etc.). Also some way to exclude the (large) mfs image under FreeBSD."

.IX Item "\(bu When things are resizing they should probably maintain some relationship between visual space and memory that is not affected by odd horizontal:vertical ratios."

.IX Item "\(bu pop-up sliders to adjust scaling."

.IX Item "\(bu lavaps steals lots of colors on a pseudocolor display. I hoped that Tcl would do reasonable color mapping for me, but apparently not."

.IX Item "\(bu A --root option to run in the root."

.IX Item "\(bu The info window should be pinnable (like in OpenLook), and then auto-update. <http://www.debian.org/Bugs/db/49/49884.html>"

.IX Header "COPYRIGHT"

.IX Header "AUTHOR"