|-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 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 summary line, use this in conjunction with the -q option.|
|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 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 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 contents of each mailbox or folder.|
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 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.
Some example uses: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.
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
assuming you have the proper file permissions to read guests mail, will print out header information from all new and unread messages in guests incoming mailbox. If there are no messages, frm will print guest has no mail.
$ frm -s new -s unread guest
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.
$ frm -q -S
Elm Development Group
Bill Pemberton firstname.lastname@example.org
\(coCopyright 1988-1995 by The USENET Community Trust
Derived from Elm 2.0, \(co Copyright 1986, 1987 by Dave Taylor
|USENET Community Trust||FRM (1L)||Elm Version 2.5|