XMAILBOX++(1) XMAILBOX++(1) NNAAMMEE xmailbox - mailbox checker for X using XPM icons SSYYNNOOPPSSIISS xxmmaaiillbbooxx [-_t_o_o_l_k_i_t_o_p_t_i_o_n ...] [-option ...] DDEESSCCRRIIPPTTIIOONN The _x_m_a_i_l_b_o_x program displays (by default) an image of a mailbox. When there is no mail, the image shown is that of a mailbox with its flag down. When mail arrives, the image changes to that of a mailbox with the flag up, its door open and a letter visible inside. It can also optionally play a sound through the SUN workstation's internal speaker. The NCD audio server, the rplay sound package, and the standard SUN audio driver are supported. By default, pressing any mouse button in the image forces _x_m_a_i_l_b_o_x to remember the current size of the mail file as being the ``empty'' size and to change its image accord- ingly. In addition, the user can optionally invoke his/her favourite mail retrieving program. This program is nothing more than a wrapper around the _M_a_i_l_b_o_x_+_+ widget included with the program's source dis- tribution. OOPPTTIIOONNSS _x_m_a_i_l_b_o_x accepts all of the standard X Toolkit command line options along with the additional options listed below: --hheellpp This option indicates that a brief summary of the allowed options should be printed on the standard error. --uuppddaattee _s_e_c_o_n_d_s This option specifies the frequency in seconds at which _x_m_a_i_l_b_o_x should update its display. If the mailbox is obscured and then exposed, it will be updated immediately. The default is 30 seconds. --ffiillee _f_i_l_e_n_a_m_e This option specifies the name of the file which should be monitored. By default, it watches /usr/spool/mail/_u_s_e_r_n_a_m_e, where _u_s_e_r_n_a_m_e is your login name. --vvoolluummee _p_e_r_c_e_n_t_a_g_e This option specifies how loud the bell should be rung when new mail comes in, or, if the sound option is used, how high the playing volume should be. The default is 33 percent. The following standard X Toolkit command line arguments are commonly used with _x_m_a_i_l_b_o_x_: X Version 11 Release 5 1 XMAILBOX++(1) XMAILBOX++(1) --ddiissppllaayy _d_i_s_p_l_a_y This option specifies the X server to contact. --xxrrmm _r_e_s_o_u_r_c_e_s_t_r_i_n_g This option specifies a resource string to be used. This is especially useful for setting resources that do not have separate command line options. XX DDEEFFAAUULLTTSS The application class name is XMailbox. This program uses the _M_a_i_l_b_o_x_+_+ widget. It understands all of the core resource names and classes as well as: cchheecckkCCoommmmaanndd ((class CChheecckkCCoommmmaanndd)) Specifies a shell command to be executed to check for new mail rather than examining the size of ffiillee. The specified string value is used as the argument to a _s_y_s_t_e_m(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 indi- cates that the mail has been cleared. By default, no shell command is provided. ffiillee ((class FFiillee)) Specifies the name of the file to monitor. The default is to watch /usr/spool/mail/_u_s_e_r_n_a_m_e, where _u_s_e_r_n_a_m_e is your login name. oonncceeOOnnllyy ((class BBoooolleeaann)) 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. uuppddaattee ((class IInntteerrvvaall)) Specifies the frequency in seconds at which the mail should be checked. The default is 30. vvoolluummee ((class VVoolluummee)) Specifies how loud the bell should be rung, or, if the sound option is used, how high the playing volume should be. The default is 33 percent. mmaaiillXXppmmFFiillee ((class MMaaiillXXppmmFFiillee)) Specifies the XPM file used when mail exists in the mailbox. nnoommaaiillXXppmmFFiillee ((class NNoommaaiillXXppmmFFiillee)) Specifies the XPM file used when there is no mail X Version 11 Release 5 2 XMAILBOX++(1) XMAILBOX++(1) (or no new mail) in the mailbox. mmaaiillSSnnddFFiillee ((class MMaaiillSSnnddFFiillee)) Specifies the sound file used when mail exists in the mailbox. If no file is specified, the standard X Window beep sound is used. mmaaiillaapppp ((class MMaaiillAApppp)) Specifies the mail retrieving application to run when the user clicks on the mailbox image. The specified string value is used as the argument to a _s_y_s_t_e_m(3) call. AACCTTIIOONNSS The _M_a_i_l_b_o_x_+_+ widget provides the following actions for use in event translations: cchheecckk(()) This action causes the widget to check for new mail and display the flag appropriately. uunnsseett(()) This action causes the widget to lower the flag until new mail comes in. sseett(()) This action causes the widget to raise the flag until the user resets it. The default translation is : unset() EENNVVIIRROONNMMEENNTT DDIISSPPLLAAYY to get the default host and display number. XXEENNVVIIRROONNMMEENNTT to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property. SSEEEE AALLSSOO X(1), xrdb(1), stat(2) AAUUTTHHOORRSS Dimitrios P. Bouras The first version of xmailbox was a hack based on the X11R5 XBiff written by Jim Fulton, MIT X Consortium, and Ralph Swick, DEC/MIT Project Athena. William K. W. Cheung Added optional sound output using the standard SUN audio driver, the rplay sound package, or the NCD audio server, as well as optional mail application execution upon click- ing on the mail icon. X Version 11 Release 5 3 XMAILBOX++(1) XMAILBOX++(1) CCOOPPYYRRIIGGHHTT Xbiff is Copyright 1988, Massachusetts Institute of Tech- nology. See _X_(_1_) for a full statement of rights and per- missions. X Version 11 Release 5 4