newmail(1)                          CLIX                          newmail(1)



  NAME

    newmail - Notifies user when new mail arrives

  SYNOPSIS

    newmail [-d] [-i interval] [-w] [file[=prefix] ... ]

  FLAGS

    -d            Turns on the debugging, verbose output mode.  This flag
                  should not be used unless newmail is being debugged.

    -i interval   Changes the frequency that newmail checks the folders to
                  interval seconds.  The default interval is 60 seconds.  If
                  the interval is changed to less than 10 seconds, newmail
                  displays a warning message.

    -w            Runs newmail in a window by itself.  Normally, when newmail
                  is run, the system prompt reappears after the command is
                  entered and newmail runs in the background.  With the -w
                  flag, the prompt does not reappear.  Thus, this flag is
                  meant to be used with newmail running in a window by itself.
                  With the -w flag, newmail will beep when new mail arrives.

    -b            Beeps whenever new mail arrives.

  DESCRIPTION

    The newmail command monitors mailboxes and notifies the user when new mail
    arrives.  The newmail command checks the list of specified mailboxes and
    folders at each specified time period and displays the sender's name and
    the message subject of any new mail.

    The file can specify a pathname, the name of the user whose mailbox should
    be monitored, or use the standard elm prefix metacharacters to specify the
    folder directory (+, =, or %).

    Folders that cannot be opened because of permission mismatches will cause
    the command to abort immediately.  However, files that do not exist will
    continue to be checked every interval seconds.

    The default folder to monitor is the incoming mailbox.

    Each entry displayed can have various formats, depending on the mode of
    newmail, to display the number of folders being monitored and the status
    of the mail message.  If newmail is started using the -w flag, the output
    is formatted as follows:

    sender_name -- subject
    Priority sender_name -- subject



  2/94 - Intergraph Corporation                                              1

  newmail(1)                          CLIX                          newmail(1)



    The sender_name is either the name of the person sending the message or
    some other brief indication of origin.  If no subject is specified, the
    message (No Subject Specified) displays.

    Folders are indicated by the folder name appearing first on the output
    line as in the following:

    folder : sender_name -- subject

    If newmail is started without the -w flag, the output is more suitable for
    displaying on an otherwise active screen and is formatted as follows:

    >> Mail from sender_name - subject
    >> Priority mail from sender_name - subject

    The command will run until the user logs out or explicitly kills it, and
    can internally reset itself if any of the folders shrink and then grow
    again.

  EXAMPLES

    1.  To check the incoming mailbox every 60 seconds:

        newmail


    2.  To monitor the incoming mailboxes for joe and root, checking every 15
        seconds for mail:

        newmail -i 15 joe root


    3.  This example will monitor the incoming mailbox for user mary,
        prefixing all messages with the string Mary, and will monitor the
        folder in the user's maildir directory called postmaster, prefixing
        all of those messages with POBOX. (Prefixing works only when two or
        more file specifications are given.)

        newmail "mary=Mary" +postmaster=POBOX


    4.  Complex monitoring is also possible, as in the following example:

        newmail -i 30 $LOGNAME=me ${LOGNAME}su=myroot /tmp/mbox

        This example will check every 30 seconds for mail in three places:
        the user's mailbox, a mailbox that is the user's login name with su
        appended (joe becomes joesu), and the file /tmp/mbox.  The newmail
        command will prefix new mail for each with me, myroot, and mbox,
        respectively.




  2                                              Intergraph Corporation - 2/94

  newmail(1)                          CLIX                          newmail(1)



  FILES

    /usr/mail/username   The user's default mailbox.

    /usr/spool/mail/username
                         The user's default mailbox with the Sun Elm product.

  NOTES

    Prefixing works only when two or more file specifications are given.

  DIAGNOSTICS

    If the user sets the time interval to check folders to less than ten
    seconds, this message is displayed: ``Warning: interval set to number
    seconds.  I hope you know what you are doing.'' If the permissions on a
    mailbox are not set so that the user may monitor the mailbox, this message
    is displayed: ``Permission to monitor mailbox denied!''

  EXIT VALUES

    The exit values are not valid.

  RELATED INFORMATION

    Commands: sh(1), csh(1), wnewmail(1), elm(1)




























  2/94 - Intergraph Corporation                                              3