# phpman > man > rcvtty(1)

[RCVTTY(1mh)](https://www.chedong.com/phpMan.php/man/RCVTTY/1mh/markdown)                                                                              [RCVTTY(1mh)](https://www.chedong.com/phpMan.php/man/RCVTTY/1mh/markdown)



## NAME
       rcvtty - report new mail with nmh

## SYNOPSIS
       **/usr/lib/mh/rcvtty** [**-help**] [**-version**] [_command_] [**-form** _formatfile_] [**-format** _string_] [**-width**
            _columns_] [**-bell** | **-nobell**] [**-newline** | **-nonewline**] [**-biff**]

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

       **rcvtty**  executes the named command with the message as its standard input, and writes the re‐
       sulting output on your terminal.

       Alternatively, if no command is specified (or the command is bogus), then **rcvtty** will instead
       write  a  one-line scan listing.  The default output format of this scan listing may be over‐
       ridden by using either the **-form** _formatfile_ or **-format** _string_ option, similar to the  equiva‐
       lent options for **scan** and **inc**.  See [_mh-format_(5)](https://www.chedong.com/phpMan.php/man/mh-format/5/markdown) for details.

       A  newline  is output before the message output, and the terminal bell is rung after the out‐
       put.  The **-nonewline** and **-nobell** switches 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)](https://www.chedong.com/phpMan.php/man/mh-format/5/markdown), **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)](https://www.chedong.com/phpMan.php/man/mesg/1/markdown).  If
       the option **-biff** is given, then **rcvtty** will obey the notification status set by  the  command
       [_biff_(1)](https://www.chedong.com/phpMan.php/man/biff/1/markdown) 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

## CONTEXT
       None

## DEFAULTS
       `**-width**' defaults to the width of the terminal
       `**-newline**'
       `**-bell**'

## SEE ALSO
       [_mh-format_(5)](https://www.chedong.com/phpMan.php/man/mh-format/5/markdown), [_rcvdist_(1)](https://www.chedong.com/phpMan.php/man/rcvdist/1/markdown), [_rcvpack_(1)](https://www.chedong.com/phpMan.php/man/rcvpack/1/markdown), [_rcvstore_(1)](https://www.chedong.com/phpMan.php/man/rcvstore/1/markdown), [_slocal_(1)](https://www.chedong.com/phpMan.php/man/slocal/1/markdown)

## BUGS
       Only two return codes are meaningful, others should be.



nmh-1.7.1                                    1999-04-30                                  [RCVTTY(1mh)](https://www.chedong.com/phpMan.php/man/RCVTTY/1mh/markdown)