


FRM(1L)           MISC. REFERENCE MANUAL PAGES            FRM(1L)



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

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

DESCRIPTION
     _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 user-
     name 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 Elm mailer (e.g., =folder).

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

OPTIONS
     The _f_r_m program has the following options:

     -h   Print a brief help message summarizing the options.

     -n   Number the messages using  the  same  numbering  scheme
          that, for example, _r_e_a_d_m_s_g 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 _s_t_a_t_u_s
          Only display  headers  from  messages  with  the  given
          status.   `status'  is  one  of  "new", "unread", "old"



USENET Community TrustLast change: Elm Version 2.4                 1






FRM(1L)           MISC. REFERENCE MANUAL PAGES            FRM(1L)



          (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 _f_r_o_m 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  list-
          ing the contents of each mailbox or folder.

EXIT STATUS
     _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.

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 mes-
     sages 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, _f_r_m 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 exam-
     ple, ``You have 2 new messages, 3 unread messages,  23  read
     messages.''




USENET Community TrustLast change: Elm Version 2.4                 2






FRM(1L)           MISC. REFERENCE MANUAL PAGES            FRM(1L)



AUTHOR
     Elm Development Group

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

BUG REPORTS TO
     Syd Weinstein  elm@DSI.COM    (dsinc!elm)

COPYRIGHTS
     Copyright 1988-1992 by The USENET Community Trust
     Derived from Elm 2.0,  Copyright 1986, 1987 by Dave Taylor











































USENET Community TrustLast change: Elm Version 2.4                 3



