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 specified mailboxes each _i_n_t_e_r_v_a_l seconds and will
       list  any  new  mail  that has arrived in any of the mail-
       boxes, indicating the sender name, and the subject of  the
       message.

       Each  entry displayed can be in a number of different for-
       mats 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 send-
       ing 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  interested  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  direc-
       tory (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'', pre-
       fixing all messages with  the  string  ``Mary'',  and  the
       folder  in  the  users _m_a_i_l_d_i_r directory called ``postmas-
       ter'', prefixing all of those messages with ``POBOX''.

       You can also have more complex monitoring too,  for  exam-
       ple:

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

       will check every 30 seconds for the users mailbox, a mail-
       box 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)
