FRM(1L)                                                                FRM(1L)



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

SSYYNNOOPPSSIISS
       ffrrmm [--hhMMnnQQqqSSttvv] [--ss _s_t_a_t_u_s] [folder | username] ...
       nnffrrmm [--hhnnQQqqSSttvv] [--ss _s_t_a_t_u_s] [folder | username] ...

DDEESSCCRRIIPPTTIIOONN
       _F_r_m outputs one line per message of the form:

       _f_r_o_m _[_s_u_b_j_e_c_t_]

       where _f_r_o_m is the name of the person the message is from,  and  _s_u_b_j_e_c_t
       is the subject of the message, if present.  If the message is from you,
       the _f_r_o_m 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 _f_r_m 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
       EEllmm mailer (e.g., =folder).

       _F_r_m invoked as _n_f_r_m is identical to invoking ``frm -s new''.

OOPPTTIIOONNSS
       The _f_r_m program has the following options:

       --hh     Print a brief help message summarizing the options.

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

       --nn     Number the messages using the same numbering  scheme  that,  for
              example, _r_e_a_d_m_s_g will understand.

       --QQ     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.

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

       --SS     Summarize the number of messages by message status in each mail-
              box  or  folder.   If  you want just a summary line, use this in
              conjunction with the --qq option.

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

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

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

EEXXIITT SSTTAATTUUSS
       _F_r_m returns a zero status ("true") if messages  matching  `status'  are
       present.   _F_r_m  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.

EEXXAAMMPPLLEESS
       Some example uses:

            $ ffrrmm

       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.

            $ ffrrmm --ss nneeww

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

            $ ffrrmm --ss nneeww --ss uunnrreeaadd gguueesstt

       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, _f_r_m will print
       ``guest has no mail.''

            $ ffrrmm --qq --SS

       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.''

AAUUTTHHOORR
       Elm Development Group

SSEEEE AALLSSOO
       readmsg(1L), elm(1L), mail(1), mailx(1)

BBUUGG RREEPPOORRTTSS TTOO
       Bill Pemberton  flash@virginia.edu

CCOOPPYYRRIIGGHHTTSS
       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)
