X Version 11 (Release 6.1)

xbiff(X1)

xbiff -- mailbox flag for X

Synopsis

xbiff [-toolkitoption . . .] [-option . . .]

Description

The xbiff program displays an icon showing a two-tiered mailbox. When there is no mail, the box is empty. When there is mail, the box is full. 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 display the empty icon.

Options

Xbiff accepts all of the standard X Toolkit command line options along with the additional options listed below:

-help: This option indicates that a brief summary of the allowed options should be printed on the standard error.
-update seconds: 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 60 seconds.
-file filename: 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. You must set this flag if user mailboxes are stored elsewhere on the system.
-volume percentage: This option specifies how loud the bell should be rung when new mail comes in.
-shape: 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:

-display display: This option specifies the X server to contact.
-geometry geometry: 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.
-bg color: This option specifies the color to use for the background of the window. The default is ``white.''
-bd color: This option specifies the color to use for the border of the window. The default is ``black.'' -bw number" This option specifies the width in pixels of the border surrounding the window.
-fg color: This option specifies the color to use for the foreground of the window. The default is ``black.''
-rv: This option indicates that reverse video should be simulated by swapping the foreground and background colors.
-xrm resourcestring: This option specifies a resource string to be used. This is especially 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 understands all of the core resource names and classes as well as:

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. 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.
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 will continue to indicate the presence of new mail until it has been retrieved.
width (class Width): Specifies the width of the mailbox. You must also set height if you use this resource.
height (class Height): Specifies the height of the mailbox. You must also set width if you use this resource.
update (class Interval): Specifies the frequency in seconds at which the mail should be checked.
volume (class Volume): Specifies how loud the bell should be rung. 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.
flip (class Flip): Specifies whether or not the image that is shown when mail has arrived should be inverted. The default is ``true.''
fullPixmap (class Pixmap): Specifies a bitmap to be shown when new mail has arrived.
emptyPixmap (class Pixmap): Specifies a bitmap to be shown when no new mail is present.
shapeWindow (class ShapeWindow): Specifies whether or not the mailbox window should be shaped to the given fullPixmapMask and emptyPixmapMask.
fullPixmapMask (class PixmapMask): Specifies a mask for the bitmap to be shown when new mail has arrived.
emptyPixmapMask (class PixmapMask): Specifies a mask for the bitmap to be shown when no new mail is present.

Actions

The Mailbox widget provides the following actions for use in event translations:

check(): This action causes the widget to check for new mail and display the flag appropriately.
unset(): This action causes the widget to lower the flag until new mail comes in.
set(): This action causes the widget to raise the flag until the user resets it.

The default translation is:

<ButtonPress>: unset()

Environment variables

DISPLAY: To get the default host and display number.
XENVIRONMENT: To get the name of a resource file that overrides the global resources that is stored in the RESOURCE_MANAGER property.

References

X(X1M), xrdb(X1)