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 mailbox or folder.  If you want just a sum-
              mary 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.  `status' is one of "new", "unread",  "old"
              (same  as  "unread"), or "read".  The --ss 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.

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

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)
