|-h||prints a short description and usage message.|
|-V||Version control. Prints out the version of the program.|
|-v||Verbose mode. In this mode, asmail will print the information about mailboxes onto the controlling terminal. The information includes: number of updates requested, per mailbox: thread PID, [R]unning or idle, any errors are signalled with leters (see above) and the number of e-mails in the format new/old. This mode is useful for debugging or could be used to monitor mailboxes without X Windows interface (give the -nox option).|
|-f resource file||Specifies the alternative location for the resource file. The default location is ~/.asmailrc If the alternative file is specified, the default location is ignored.|
|-geometry X geometry specification||
Specifies the size and position of the application
on the screen in the standard X11 format (see
XParseGeometry (3x) for details):
|-noconfig||Forces asmail to ignore the resource file even if one is present. asmail will run with all default settings and check the Unix mailbox specified by the $MAIL environment variable.|
Starts the asmail application in the terminal-only
mode. The X Windows interface is not started. The configuration
file is still parsed as usual though.
This option implies -v option.
Usually, asmail will check that the resource file
has the 600 mode, that is there are no access rights
for "group" and "others". If such access rights are granted,
asmail will complain and exit. This is done to make
you remember the passwords you put into the resource file.
If there are no passwords stored in the file (e.g. you are
using UNIX mailbox on the local machine) the check is not
This option forces asmail to continue operation even if the resource file has insecure permissions and passwords are stored in that file.
|-iconic||This option will cause asmail to start up as an icon rather than as a normal window. The application can still be de-iconized and iconized as usual.|
|-withdrawn||This option will cause asmail to start up in a so-called "withdrawn" mode. This mode is used by WindowMaker window manager to dock the application into their version of the Wharf.|
The syntax of the resource file is described in a separate man page under asmailrc (5).
asmail can be called in different ways. The most common invocation is the command line:Another way to call asmail is from the window manager:
user@host% asmail &
This line, when placed in the wharf file in the users Afterstep configuration directory will cause asmail to become a button on the Wharf (1) button bar under the afterstep (1) window manager.
*Wharf "asmail" nil Swallow "asmail" /usr/local/bin/asmail &
My programs do not have bugs, they just develop random features ;-)
Well, there are limitations. All the strings for the color names, file names, and other strings have the length limit of 256 characters (terminating zero included). The program will complain about very long names in the configuration file.
The number of mailboxes is not limited by the space on the icon but the stats will be chopped (not shown) if you have too many and they do not fit into the icon. Make sure you pick up a tall icon if you have many mailboxes and want to see info on each of them because they are shown from the top down and there is no way to change this.
The information about mailboxes will not appear when you use "shaped" windows with transparency if it is printed in the transparent area.
asmail may interfere with your mail client program when you use the POP3 server. There is no way to login to the POP3 server twice (from the mail client and asmail), so there is an inherent race condition between the two. The one that tries to log in second, will fail. asmail logs out immediately after checking so your mail client will have a much higher chance of precluding asmail from logging in than the other way around.
If the program is not satisfied with the specification of one of the mailboxes, it will print an error message, set the status for that mailbox to F (Failed) and exit the thread (only the thread that is responsible for handling that particular mailbox). Other mailboxes will be checked normally. Check the standard output of the tool to see what the problem is.
Copyright (c) 2002-2007 Albert 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 2.1||ASMAIL (1)||09 Apr 2007|