FRM(1L)
NAME
frm,nfrm - list from and subject of selected messages in
mailbox or folder
SYNOPSIS
frm [-hnQqStv] [-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.
-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
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