XBIFF(1) XBIFF(1)
NAME
xbiff - mailbox flag for X
SYNOPSIS
xbiff [-toolkitoption ...] [-option ...]
DESCRIPTION
The xbiff program displays a small of a mailbox. When
there is no mail, the flag on the mailbox is down.
When mail arrives, the flag goes up and the mailbox
beeps. By default, pressing any mouse button in the
image forces xbiff to remember the current size of the
mail file as being the empty size and to lower the
flag.
This program is nothing more than a wrapper around the
Athena Mailbox widget.
OPTIONS
xbiff accepts all of the standard X Toolkit command
line options in addition to the following options
listed:
-help
indicates that a brief summary of the allowed
options should be printed on the standard error.
-update seconds
specifies the frequency in seconds at which xbiff
should update its display. If the mailbox is
obscured and then exposed, it is updated
immediately. The default is 60 seconds.
-file filename
specifies the name of the file that should be
monitored. By default, it watches
/usr/mail/username, where username is your login
name.
-volume percentage
specifies how loud to ring the bell when new mail
comes in.
The following standard X Toolkit command line arguments
are commonly used with xbiff:
-display display
specifies the X server to contact.
-geometry geometry
specifies the preferred size and position of the
mailbox window. The mailbox is 48 pixels wide and
- 1 -
XBIFF(1) XBIFF(1)
48 pixels high and is centered in the window.
-bg color
specifies the color to use for the background of
the window. The default is white.
-bd color
specifies the color to use for the border of the
window. The default is black.
-bw number
specifies the width in pixels of the border
surrounding the window.
-fg color
specifies the color to use for the foreground of
the window. The default is black.
-rv
indicates that reverse video should be simulated by
swapping the foreground and background colors.
-xrm resourcestring
specifies a resource string to be used. This is
useful for setting resources that do not have
separate command line options.
X DEFAULTS
This program uses the Mailbox widget in the X Toolkit.
It also understands all the core resource names and
classes:
checkCommand (class CheckCommand)
specifies a shell command to be executed to check
for new mail rather than examining the size of
file. The specified string value is used as the
argument to a system(3) call and may therefore
contain I/O redirection. A successful (zero) exit
status should indicate that new mail is waiting.
file (class File)
specifies the name of the file to monitor. The
default is to watch /usr/spool/mail/username, where
username is your login name.
onceOnly (class Boolean)
specifies that the bell is only rung the first time
new mail is found and is not rung again until at
least one interval has passed with no mail waiting.
The window continues to indicate the presence of
new mail until it has been retrieved.
- 2 -
XBIFF(1) XBIFF(1)
width (class Width)
specifies the width of the mailbox.
height (class Height)
specifies the height of the mailbox.
update (class Interval)
specifies the frequency in seconds at which the
mail should be checked.
volume (class Volume)
specifies how loud to ring the bell. The default
is 33 percent.
foreground (class Foreground)
specifies the color for the foreground. The
default is black since the core default for
background is white.
reverseVideo (class ReverseVideo)
specifies that the foreground and background should
be reversed.
ACTIONS
The Mailbox widget provides the following actions for
use in event translations:
check()
causes the widget to check for new mail and display
the flag appropriately.
unset()
causes the widget to lower the flag until new mail
comes in.
set()
causes the widget to raise the flag until the user
resets it.
The default translation is
<ButtonPress>: unset()
ENVIRONMENT
DISPLAY
To get the default host and display number.
XENVIRONMENT
To get the name of a resource file that overrides the
global resources stored in the RESOURCE_MANAGER
property.
- 3 -
XBIFF(1) XBIFF(1)
SEE ALSO
xrdb(1), stat(2)
BUGS
The mailbox bitmaps are not attractive.
AUTHOR
Jim Fulton, MIT X Consortium
Additional modifications by Ralph Swick, DEC/MIT
Project Athena
- 4 -