Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
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 de-
     fault 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  exam-
	    ple, 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	informa-
	    tion  from, for example, only new and unread messages.  It is suffi-
	    cient 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  con-
	    tents 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 re-
     turns 3 if an error occurred.  If multiple mailboxes or folders are  speci-
     fied,  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 mes-
     sages are in your incoming mailbox.  For example, ``You  have  2  new  mes-
     sages, 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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=frm&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help