DragonFly On-Line Manual Pages

FRM(1L)                                                                FRM(1L)

NAME
       frm,nfrm - list from and subject of selected messages in mailbox or
       folder

SYNOPSIS
       frm [-hMnQqStv] [-s status] [folder | username] ...
       nfrm [-hnQqStv] [-s status] [folder | username] ...

DESCRIPTION
       Frm outputs one line per message of the form:

       from [subject]

       where from is the name of the person the message is from, and subject
       is the subject of the message, if present.  If the message is from you,
       the from portion will read ``To user'', where `user' is the user the
       message was sent to.  This happens when you receive a copy of a letter
       you sent.

       If a folder is specified, the program reads that folder rather than the
       default mailbox.  If the argument is a username then frm looks in that
       user's mailbox, provided you have permission to read it.

       A folder can be specified with the same notation as when invoking the
       Elm mailer (e.g., =folder).

       Frm invoked as nfrm is identical to invoking ``frm -s new''.

OPTIONS
       The frm program has the following options:

       -h     Print a brief help message summarizing the options.

       -M     Magic mode - treat all folders as if they were the spool folder
              (lock, update Status: headers, etc.).

       -n     Number the messages using the same numbering scheme that, for
              example, readmsg will understand.

       -Q     Very quiet mode.  Only error messages are produced.  This option
              is useful in shell scripts, where only the success or failure of
              the program is important, and output is not desired.

       -q     Quiet mode.  Output only a one-line summary for each mailbox or
              folder specified.

       -S     Summarize the number of messages by message status in each
              mailbox or folder.  If you want just a summary line, use this in
              conjunction with the -q option.

       -s status
              Only display headers from messages with the given status.
              `status' is one of "new", "unread", "old" (same as "unread"), or
              "read".  The -s option can be specified multiple times to print
              header information from, for example, only new and unread
              messages.  It is sufficient to specify only the first letter of
              the status.

       -t     Tidy mode. If the from field is long enough to displace the
              subject field from its natural start column, move the subject
              down onto the next line.

       -v     Verbose mode.  Print a descriptive header before listing the
              contents of each mailbox or folder.

EXIT STATUS
       Frm returns a zero status ("true") if messages matching `status' are
       present.  Frm returns 1 if no messages matching `status' are present,
       but there are some messages, returns 2 if there are no messages at all,
       or returns 3 if an error occurred.  If multiple mailboxes or folders
       are specified, the exit status only applies to the last one examined.
       This can be used in scripts to determine what kind of mail a user has.

EXAMPLES
       Some example uses:

            $ frm

       will display header information from all the messages in your mailbox,
       or ``You have no mail.'' if there are no messages in your incoming
       mailbox.

            $ frm -s new

       will display header information from all new messages in your mailbox,
       or ``You have no new mail.''  Note the slightly different diagnostic.

            $ frm -s new -s unread guest

       assuming you have the proper file permissions to read guest's mail,
       will print out header information from all new and unread messages in
       guest's incoming mailbox.  If there are no messages, frm will print
       ``guest has no mail.''

            $ frm -q -S

       will print only a one line summary of how many read, unread, and read
       messages are in your incoming mailbox.  For example, ``You have 2 new
       messages, 3 unread messages, 23 read messages.''

AUTHOR
       Elm Development Group

SEE ALSO
       readmsg(1L), elm(1L), mail(1), mailx(1)

BUG REPORTS TO
       Bill Pemberton  flash@virginia.edu

COPYRIGHTS
       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                        FRM(1L)