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 sum-
              mary 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  infor-
              mation  from, for example, only new and unread mes-
              sages.  It is sufficient to specify only the  first
              letter of the status.

       -t     Tidy mode. If the from field is long enough to dis-
              place the subject field from its natural start col-
              umn, 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 match-
       ing `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                        1