|-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 location on the screen. This works like the standard X Windows geometry option. (See XParseGeometry (3x)).|
|-iconic||Starts the asmem application in the iconized mode. The icon has the same appearance with the main window. When this option is given, the -position refers to the 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 the asmem in the WindowMaker dock. When this option is given, the -position refers to the position of the icon window as well as the main window. asmem ignores the -iconic option when started in 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 WindowMakers dock according to some opinions. Give it a try in any case.|
|-used||By default asmem displays the amount of memory or swap space still left unused. This switch tells asmem to display 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 this switch is specified, the applet displays the amount of memory free as reported by the /proc/meminfo. Sometimes this is not really helpful since the occupied memory includes the file system cache and the buffers space. When this switch is not specified asmem will add the cache space and the buffer space to the amount of the actual free memory since both of those may be discarded by the OS to free up some memory for the programs.|
|-free||Exactly the same as -asis. Provided for backward compatibility. Obsolete. Do not use. Use -asis instead.|
|-mb||Force the display in MBytes instead of kilobytes even if the 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 value of 1 is the minimum. Default value is 1 second.|
|-dev <device>||The device that should be polled for the memory utilization information. 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 used memory amount. Default colour is #4141d7.|
|-buffer <color>||Changes the color of the bar that represents the memory used for buffers. Default colour is #aa80aa.|
|-cache <color>||Changes the color of the bar that represents the memory used for caching. Default colour is #bebebe.|
|-swap <color>||Changes the color of the bar that represents the swap space utilization level. Default colour is #ffa649.|
asmem can be called in different ways. The most common invocation is the command line:Another way to call asmem is from the window manager:
user@host% asmem -bg blue -fg white &
This line, when placed in the wharf file in the users Afterstep configuration directory will cause asmem to be a button on the Wharf (1) button bar under the afterstep (1) window manager.
*Wharf "asmem" nil Swallow "asmem" asmem &
If you run WindowMaker then you should use the "-withdrawn" option:and then drag the icon to the dock.
user@host% asmem -withdrawn -standout &
My programs do not have bugs, they just develop random features ;-)
Well, there are limitations. All the strings for the color names, display name, and the geometry have the length limit of 50 characters (terminating zero included). The string copying routine cuts the names that are longer.
Copyright (c) 1999-2007 Albert "Tigr" Dorofeev <firstname.lastname@example.org>
Distributed under GNU General Public License v2 ; see LICENSE file for more informations.
Albert "Tigr" Dorofeev <email@example.com>
See the README file for credits.
|Version 1.12||ASMEM (1)||12 April 2007|