man wmmount () - the WindowMaker universal mount point

NAME

wmmount - the WindowMaker universal mount point

SYNOPSIS

wmmount [ -- [-h|-help|--help] [-s] [-w] [-a] [-display <display>] [-position <position>] [-b <color>] ]

DESCRIPTION

wmmount mounts and umounts filesystems using a simple interface on a 64x64 miniwindow and a configuration file. It can also launch commands on the mount points, for example Midnight Commander, mc(1).

wmmount is configured using a configuration file, ~/.wmmount (or /etc/system.wmmountrc). Its format is documented on the "Configuration" section below.

To mount a file system, click the left most button on the bottom strip. To move between mounts, click the right arrow button (goes "forward") and left arrow button (goes "back"). To launch the configured command, click the icon you defined.

OPTIONS

You need to put "--" in front of every argument that relates to dockapp settings.

-h, -help, --help
displays a brief help message
-s
start up without groundplate
-w
start up withdrawn (for Window Maker)
-a
use an smaller window (for AfterStep's Wharf)
-display <display>
selects target display
-position <position>
specifies the start up position in +x+y format
-b <color>
specifies the back color

CONFIGURATION

The configuration file has a semi rigid format, and is case sensitive. A # starts a comment, and lines consisting entirely of whitespace are ignored. There are some key-value pairs that control the behaviour and appearance of wmmount, namely:

mountcmd=<command>
specifies the command used to mount a file system. If ommited mount %m & will be used.
umountcmd=<command>
specifies the command used to unmount a file system. If ommited umount %m & will be used.
opencmd=<command>
specifies the command to run when the mount icon is clicked. If ommited xterm -e mc %m will be used.
namecolor=<color>
specifies the color used for the mount name text. If ommited, black is used.
namefont=<font>
specifies the font used for the mount name text. This is an X Font specification. See xlsfonts(1). If ommited, helvetica, bold, 11 pt is used.
usagecolor=<color>
specifies the color used for the capacity readout. If ommited, gray90 is used.
usagefont=<font>
specifies the font used for the capacity readout. This is an X Font specification. See xlsfonts(1). If ommited, helvetica, medium, oblique, 11 pt is used.
ledcolor=<color>
specifies the color used for the led. If ommited, green is used.

As you may have guessed by now, %m on the commands, is substituted with the corresponding mount point. Icons are specified like this:

icon <icon file>

At least one icon has to be specified, there's a maximum of 20 icons. The details of the mountpoint(s) are specified like this (ordering and indentation is important, there are no blank lines between keys):

mountpoint <mountpoint>

name=<name>

iconnumber=<number>

usagedisplay=<0|1|2|3>

mountpoint
is the actual mountpoint. This value is substituted wherever %m appears on the commands described above.
name
is the name displayed on for that particular mount.
number
is the icon number used. The first icon is number 0, and the same icon can be used multiple times.
usagedisplay
this key specifies that kind of capacity information will be displayed. Value of usagedisplay can be 0 (none), 1 (available), 2 (used) or 3 (percentage used). The quantities, with values 1 or 2, are in bytes (kB, MB or GB).

FILES

~/.wmmount
user configuration file.
/etc/system.wmmount
system-wide configuration file.
/etc/fstab
static information about the filesystems.
/usr/share/wmmount
directory which contains several icons that can be used with wmmount.

A maximum of 20 mountnames can be specified.

BUGS

Does not read symlinks properly when testing for mounted filesystems. So, if it incorrectly reports devices as mounted, make sure the mountpoint specified in the config file does not include symlinks. Version 1.0-beta1 of wmmount had different configuration file syntax and different way of argument handling. You may experience segfaults if trying to use old style configuration files with newer versions (>= 1.0-beta2). You can use the gen-wmmountrc script to generate a new wmmount config file from your /etc/fstab file contents.

SEE ALSO

AUTHORS

wmmount was written by Sam Hawker <shawkie@geocities.com>. This manual page was written by Marcelo Magallon <mmagallo@debian.org>, and is GNU Copyright 1998 Marcelo Magallon. Later updated by Josip Rodin.