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 omitted, mount %m & will be used.
- umountcmd=<command>
- specifies the command used to unmount a file system. If omitted, umount %m & will be used.
- opencmd=<command>
- specifies the command to run when the mount icon is clicked. If omitted, x-terminal-emulator -e mc %m will be used.
- namecolor=<color>
- specifies the color used for the mount name text. If omitted, black is used.
- namefont=<font>
- specifies the font used for the mount name text. This is an X Font specification. See xlsfonts(1x). If omitted, helvetica, bold, 11 pt is used.
- usagecolor=<color>
- specifies the color used for the capacity readout. If omitted, gray90 is used.
- usagefont=<font>
- specifies the font used for the capacity readout. This is an X Font specification. See xlsfonts(1x). If omitted, helvetica, medium, oblique, 11 pt is used.
- ledcolor=<color>
- specifies the color used for the led. If omitted, green is used.
As you may have guessed by now, the special string %m in command specification is substituted with the corresponding mount point. Likewise, %n will be replaced with the name of the mountpoint. The string %% will be replaced with '%'.
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.
AUTHORS
wmmount was written by Sam Hawker <[email protected]>.This manual page was written by Marcelo Magallon <[email protected]>, and is GNU Copyright 1998 Marcelo Magallon. Later updated by Josip Rodin.