rcvtty



RCVTTY(1)                                                            RCVTTY(1)




NAME

       rcvtty  - report new mail


SYNOPSIS

       /usr/lib/nmh/rcvtty [command]
            [-form formatfile] [-format string] [-width columns]
            [-bell] [-nobell] [-newline] [-nonewline] [-biff]
            [-version] [-help]


DESCRIPTION

       The  rcvtty  can  be  used to report new mail.  It is used primarily in
       conjunction with mail filtering agents such as slocal or procmail.

       The rcvtty program executes the named command with the message  as  its
       standard input, and writes the resulting output on your terminal.

       Alternately, if no command is specified (or is bogus), then rcvtty will
       instead write a one-line scan listing.  The default  output  format  of
       this  scan listing may be overridden by using either the `-form format-
       file' or `-format string' option, similar to the equivalent options for
       scan and inc.  See mh-format(5) for details.

       A newline is output before the message output, and the terminal bell is
       rung after the output.  The `-nonewline'  and  `-nobell'  options  will
       inhibit these functions.

       The  switch  `-width columns'  may be given to specify the width of the
       scan line.  The default is to use the width of the terminal.

       In addition to the standard format escapes described  in  mh-format(5),
       rcvtty also recognizes the following additional component escapes:

       Escape    Returns  Description
       body      string   the (compressed) first part of the body
       dtimenow  date     the current date
       folder    string   the name of the current folder

       By  default, rcvtty will send its output to every terminal on the local
       machine that is owned by current user, and that has given write permis-
       sion  as  granted  by  the  command mesg (1).  If the option `-biff' is
       given, then rcvtty will obey the notification status set by the command
       biff (1) instead.


FILES

       /etc/nmh/mts.conf                    nmh mts configuration file
       $HOME/.maildelivery                  The file controlling local delivery
       /etc/nmh/maildelivery                Rather than the standard file


DEFAULTS

       `-width' defaults to the width of the terminal
       `-newline'
       `-bell'


SEE ALSO

       rcvdist(1), rcvpack(1), rcvstore(1), mh-format(5), slocal(1)


BUGS

       Only two return codes are meaningful, others should be.



[nmh-1.0.4]                         MH.6.8                           RCVTTY(1)

Man(1) output converted with man2html