NEWMAIL(1L)                                                        NEWMAIL(1L)



NNAAMMEE
       newmail,wnewmail - programs to asynchronously notify of new mail

SSYYNNOOPPSSIISS
       nneewwmmaaiill [[--dd]] [[--ii _i_n_t_e_r_v_a_l]] [[--ww]] _f_i_l_e_-_s_p_e_c {_f_i_l_e_-_s_p_e_c...}
       wwnneewwmmaaiill [[--dd]] [[--ii _i_n_t_e_r_v_a_l]] [[--ww]] _f_i_l_e_-_s_p_e_c {_f_i_l_e_-_s_p_e_c...}


DDEESSCCRRIIPPTTIIOONN
       _N_e_w_m_a_i_l is a program to allow monitoring of mailboxes in an intelligent
       fashion.  It is based loosely on _b_i_f_f_(_1_) and  the  version  of  _n_e_w_m_a_i_l
       that was distributed with EEllmm 11..77.

       The  basic  operation is that the program will check the list of speci-
       fied mailboxes each _i_n_t_e_r_v_a_l seconds and will list any  new  mail  that
       has  arrived  in  any of the mailboxes, indicating the sender name, and
       the subject of the message.

       Each entry displayed can be in a number of different formats  depending
       on  the mode of the program, the number of folders being monitored, and
       the status of the message.  If you're running  it  as  a  _w_i_n_d_o_w  (e.g.
       ``-w'' or invoked as _w_n_e_w_m_a_i_l) then the output will be similar to:

          _s_e_n_d_e_r _n_a_m_e - _s_u_b_j_e_c_t _o_f _m_e_s_s_a_g_e
          Priority: _s_e_n_d_e_r _n_a_m_e - _s_u_b_j_e_c_t _o_f _m_e_s_s_a_g_e

       where  <sender  name>  is  either the name of the person sending it, if
       available (the ARPA 'From:' line) or some  other  brief  indication  of
       origin.    If you are the sender, <sender name> will be replaced by "to
       <recipient name>".  If there is no subject, the message "<no  subject>"
       will appear on the screen.

       Folders  are  indicated  by  having the folder name appear first on the
       output line, as in:

          _f_o_l_d_e_r: _s_e_n_d_e_r _n_a_m_e - _s_u_b_j_e_c_t _o_f _m_e_s_s_a_g_e

       If you're running _n_e_w_m_a_i_l without the windows option, then  the  output
       is more suitable for popping up on an otherwise active screen, and will
       be formatted:

          >> New mail from _s_e_n_d_e_r _n_a_m_e - _s_u_b_j_e_c_t _o_f _m_e_s_s_a_g_e
          >> Priority mail from _s_e_n_d_e_r _n_a_m_e - _s_u_b_j_e_c_t _o_f _m_e_s_s_a_g_e

       Again, with folder names indicated as a prefix.

       The flags available are:

       --dd        This will turn on the debugging, verbose output mode.  It  is
                 not recommended that you use this option unless you're inter-
                 ested in actually debugging the program.

       --ii _i_n_t_e_r_v_a_l
                 This will change the frequency that the  program  checks  the
                 folders  to  the interval specified, in seconds.  The default
                 interval for the program is 60 seconds.  _N_o_t_e_: _i_f _y_o_u  _c_h_a_n_g_e
                 _t_h_e  _i_n_t_e_r_v_a_l  _t_o _l_e_s_s _t_h_a_n _1_0 _s_e_c_o_n_d_s_, _t_h_e _p_r_o_g_r_a_m _w_i_l_l _w_a_r_n
                 _y_o_u _t_h_a_t _i_t _i_s_n_'_t _r_e_c_o_m_m_e_n_d_e_d_.

       --ww        Use of the ``-w'' flag will simulate having the  program  run
                 from  within  a window (e.g. the more succinct output format,
                 and so on).  Most likely, rather than using this  option  you
                 should be simply invoking _w_n_e_w_m_a_i_l instead.

       _F_i_l_e  _s_p_e_c_s are made up of two components, the _f_o_l_d_e_r _n_a_m_e and the _p_r_e_-
       _f_i_x _s_t_r_i_n_g, the latter of which can always be omitted.  The  format  is
       _f_o_l_d_e_r_n_a_m_e_=_p_r_e_f_i_x_s_t_r_i_n_g,  and  you can specify folders by full name, by
       simply the name of the user whose mailbox should be  monitored,  or  by
       the  standard EEllmm metacharacters to specify your folder directory (e.g.
       ``+'', ``='', or ``%'').

       Folders that cannot be opened due to permission mismatches  will  cause
       the program to immediately abort.  On the other hand, files that do not
       exist will continue to be checked every _i_n_t_e_r_v_a_l seconds, so some  care
       should be exercised when invoking the program.

       The  program  will run until you log out or explicitly kill it, and can
       internally reset itself if any of the folders shrink in size  and  then
       grow again.

       The default folder to monitor is always your incoming mailbox.

EEXXAAMMPPLLEESS
       Some example invocations:

            $ nneewwmmaaiill

       will check your incoming mailbox every 60 seconds.

            $ nneewwmmaaiill  --ii  1155  jjooee  rroooott

       will  monitor the incoming mailboxes for ``joe'' and ``root'', checking
       every 15 seconds for new mail.

            $ nneewwmmaaiill  ""mmaarryy==MMaarryy""  ++ppoossttmmaasstteerr==PPOOBBOOXX

       will monitor the incoming mailbox for user ``mary'', prefixing all mes-
       sages  with  the  string  ``Mary'', and the folder in the users _m_a_i_l_d_i_r
       directory called ``postmaster'', prefixing all of those  messages  with
       ``POBOX''.

       You can also have more complex monitoring too, for example:

            $ nneewwmmaaiill  --ii  3300  $$LLOOGGNNAAMMEE==mmee  $${{LLOOGGNNAAMMEE}}ssuu==mmyyrroooott   //ttmmpp//mmbbooxx

       will  check  every  30 seconds for the users mailbox, a mailbox that is
       the users login-name with ``su'' appended (e.g.  ``joe''  would  become
       ``joesu'')  and  the  file  /tmp/mbox, prefixing new mail for each with
       ``me'', ``myroot'' and ``mbox'' respectively.

AAUUTTHHOORR
       Elm Development Group

SSEEEE AALLSSOO
       notify in sh(1) or csh(1)

BBUUGG RREEPPOORRTTSS TTOO
       Bill Pemberton  flash@virginia.edu

CCOOPPYYRRIIGGHHTTSS
       Copyright 1988-1995 by The USENET Community Trust
       Derived from Elm 2.0,  Copyright 1986, 1987 by Dave Taylor



USENET Community Trust          Elm Version 2.5                    NEWMAIL(1L)
