RCVTTY(1)

NAME
rcvtty - report new mail

SYNOPSIS
/usr/local/libexec/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 overriden by using either the `-form formatfile' 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 permission 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. ^/usr/local/lib/nmh/mts.conf~^nmh mts configuration file ^$HOME/.maildelivery~^The file controlling local delivery ^/usr/local/lib/nmh/maildelivery~^Rather than the standard file `-width' defaults to the width of the terminal `-newline' `-bell' rcvdist(1), rcvpack(1), rcvstore(1), mh-format(5), slocal(1) Only two return codes are meaningful, others should be.