MAN page from Other asmem-1.4-1.i386.rpm

asmem

Section: User Commands (1)
Updated: 09 September 1999
Index

NAME

asmem - the AfterStep memory utilization monitor

SYNOPSIS

asmem[-h] [-H] [-V]
        [-iconic] [-withdrawn] [-standout]
        [-used] [-asis] [-free] [-mb]
        [-position [+|-]x[+|-]y]
        [-u update rate]
        [-dev device]
        [-display display]
        [-bg color]
        [-fg color]
        [-memory color]
        [-buffer color]
        [-cache color]
        [-swap color]

DESCRIPTION

The asmem is a X11 application that acts asa memory utilization monitor. It shows the currentamount of memory and swap space, the free amountsof those, and the bars representing graphically thedifferent types of memory.

The display consists of two areas. The one above shows utilizationof the memory, the one below - the utilization of the swapspace. Each area contains a graphical bar that represents thepercentage of the occupied space. For the memory utilizationthere are three bars: user/system memory used, buffer memoryand cache memory. For the swap space only one bar showing theused space. Above each bar is the total amount of space, belowthe bar - the available space in kbytes and percents. If thememory amount is above 999999 kbytes the displays switchesto Mbytes instead of kbytes.

It is possible to force the display into Mbytes. You can alsoask asmem to display the occupied memory amounts and percentagesrather than those still available.

CONFIGURATION OPTIONS

-h or -H

: Prints a short description and usage message.

-V

: Version control. Prints out the version of the program.

-position [+|-]x[+|-]y

: Displays the window at the specified locationon the screen. This works like the standard X Windowsgeometry option. (See XParseGeometry (3x)).

-iconic

: Starts the asmem application in the iconized mode.The icon has the same appearance with the mainwindow.When this option is given, the -position refers tothe position of the icon window as well as the main window.

-withdrawn

: Starts the asmem application in the withdrawn mode.This option is necessary to be able to dock theasmem in the WindowMaker dock.When this option is given, the -position refers tothe position of the icon window as well as the main window.asmem ignores the -iconic option when startedin withdrawn mode.

-standout

: This changes the appearance of the asmem display from"pushed-in" to "popped-out". The first is the default look.The "popped-out" applets look much better in WindowMaker's dockaccording to some opinions. Give it a try in any case.

-used

: By default asmem displays the amount of memory or swapspace still left unused. This switch tells asmem todisplay the amounts of memory and swap space already in use.This switch affects the percentages displayed in accordance.

-asis

: Uses an alternative number for the display of the free memory.Or, rather, by default an alternative amount is used. When thisswitch is specified, the applet displays the amount of memoryfree as reported by the /proc/meminfo. Sometimes this is notreally helpful since the occupied memory includes the file systemcache and the buffers space. When this switch is not specifiedasmem will add the cache space and the buffer space to theamount of the actual free memory since both of those may bediscarded by the OS to free up some memory for the programs.

-free

: Exactly the same as -asis. Provided for backwardcompatibility. Obsolete. Do not use. Use -asis instead.

-mb

: Force the display in MBytes instead of kilobytes even ifthe numbers would fit into the window.

-u <update rate>

: Changes the polling rate for updating the memory utilization information.The update rate is specified in seconds. The valueof 1 is the minimum. Default value is 1 second.

-dev <device>

: The device that should be polled for the memory utilizationinformation. On Linux, this defaults to /proc/meminfo

-display <name>

: The name of the display to start the window in.It works just as X Windows display option.

-bg <color>

: Changes the color of the background of the applet.Default colour is #303030.

-fg <color>

: Changes the color of the foreground of the applet.Default colour is #20b2aa.

-memory <color>

: Changes the color of the bar that represents the usedmemory amount.Default colour is #4141d7.

-buffer <color>

: Changes the color of the bar that represents the memoryused for buffers.Default colour is #aa80aa.

-cache <color>

: Changes the color of the bar that represents the memoryused for caching.Default colour is #bebebe.

-swap <color>

: Changes the color of the bar that represents the swapspace utilization level.Default colour is #ffa649.

INVOCATION

asmem can be called in different ways. The most common invocation is the command line:

        userAATThost[1]% asmem -bg blue -fg white &

Another way to call asmem is from the window manager:

        *Wharf "asmem" nil Swallow "asmem" asmem &

This line, when placed in the wharf file in the user's Afterstepconfiguration directory will cause asmem to be abutton on the Wharf (1) button bar under the afterstep (1)window manager.

If you run WindowMaker then you should use the "-withdrawn"option:

        userAATThost[1]% asmem -withdrawn -standout &

and then drag the icon to the dock.

BUGS

My programs do not have bugs, they just develop randomfeatures ;-)

Well, there are limitations. All the strings for thecolor names, display name, and the geometry have thelength limit of 50 characters (terminating zero included). The string copying routine cuts the names that are longer.

COPYRIGHTS

Distributed under GNU General Public License v2 ; see LICENSE file for more informations.

AUTHORS

Albert "Tigr" Dorofeev <albertAATTmail.dma.be>

See the README file for credits.

This document was created byman2html,using the manual pages.