xbiff(1X)xbiff(1X)NAMExbiff - mailbox flag for X
SYNOPSISxbiff [-toolkitoption...] [-option ...]
OPTIONSxbiff accepts all of the standard X Toolkit command line options along
with the additional options listed below: This option indicates that a
brief summary of the allowed options should be printed on the standard
error. This option specifies the frequency in seconds at which xbiff
should update its display. If the mailbox is obscured and then
exposed, it will be updated immediately. The default is 30 seconds.
This option specifies the name of the file which should be monitored.
By default, it watches /usr/spool/mail/username, where username is your
login name. This option specifies how loud the bell should be rung
when new mail comes in. This option indicates that the mailbox window
should be shaped if masks for the empty or full images are given.
The following standard X Toolkit command line arguments are commonly
used with xbiff: This option specifies the X server to contact. This
option specifies the preferred size and position of the mailbox window.
The mailbox is 48 pixels wide and 48 pixels high and will be centered
in the window. This option specifies the color to use for the back‐
ground of the window. This option specifies the color to use for the
border of the window. This option specifies the width in pixels of the
border surrounding the window. This option specifies the color to use
for the foreground of the window. This option indicates that reverse
video should be simulated by swapping the foreground and background
colors. This option specifies a resource string to be used. This is
especially useful for setting resources that do not have separate com‐
mand line options.
DESCRIPTION
The xbiff program displays a little image 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.
X DEFAULTS
The application class name is XBiff. This program uses the Mailbox wid‐
get. It understands all of the core resource names and classes as well
as: 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. An exit status of 0 indicates that new mail is waiting, 1
indicates that there has been no change in size, and 2 indicates that
the mail has been cleared. By default, no shell command is provided.
Specifies the name of the file to monitor. The default is to watch
/usr/spool/mail/username, where username is your login name. 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 will continue to indicate the presence of new mail until it
has been retrieved. The default is false. Specifies the width of the
mailbox. Specifies the height of the mailbox. Specifies the frequency
in seconds at which the mail should be checked. The default is 30.
Specifies how loud the bell should be rung. The default is 33 percent.
Specifies the color for the foreground. Specifies that the foreground
and background should be reversed. Specifies whether or not the image
that is shown when mail has arrived should be inverted. The default is
“true.” Specifies a bitmap to be shown when new mail has arrived. The
default is flagup. Specifies a bitmap to be shown when no new mail is
present. The default is flagdown. Specifies whether or not the mail‐
box window should be shaped to the given fullPixmapMask and emptyP‐
ixmapMask. The default is false. Specifies a mask for the bitmap to
be shown when new mail has arrived. The default is none. Specifies a
mask for the bitmap to be shown when no new mail is present. The
default is none.
ACTIONS
The Mailbox widget provides the following actions for use in event
translations: This action causes the widget to check for new mail and
display the flag appropriately. This action causes the widget to lower
the flag until new mail comes in. This action causes the widget to
raise the flag until the user resets it.
The default translation is
<ButtonPress>: unset()ENVIRONMENT
to get the default host and display number. to get the name of a
resource file that overrides the global resources stored in the
RESOURCE_MANAGER property.
BUGS
The mailbox bitmaps are ugly.
SEE ALSOX(1X), xrdb(1X), stat(2)AUTHOR
Jim Fulton, MIT X Consortium
Additional hacks by Ralph Swick, DEC/MIT Project Athena
xbiff(1X)