BUGFILER(8) System Manager's Manual BUGFILER(8)NAME
bugfiler - file bug reports in folders automatically
SYNOPSIS
bugfiler [ mail directory ]
DESCRIPTION
Bugfiler is a program to automatically intercept bug reports, summarize them and store them in the appropriate sub directories of the mail
directory specified on the command line or the (system dependent) default. It is designed to be compatible with the Rand MH mail system.
Bugfiler is normally invoked by the mail delivery program through aliases(5) with a line such as the following in /etc/aliases.
bugs:"|bugfiler /usr/bugs/mail"
It reads the message from the standard input or the named file, checks the format and returns mail acknowledging receipt or a message indi-
cating the proper format. Valid reports are then summarized and filed in the appropriate folder; improperly formatted messages are filed
in a folder named ``errors.'' Program maintainers can then log onto the system and check the summary file for bugs that pertain to them.
Bug reports should be submitted in RFC822 format and aremust contain the following header lines to be properly indexed:
Date: <date the report is received>
From: <valid return address>
Subject: <short summary of the problem>
Index: <source directory>/<source file> <version> [Fix]
In addition, the body of the message must contain a line which begins with ``Description:'' followed by zero or more lines describing the
problem in detail and a line beginning with ``Repeat-By:'' followed by zero or more lines describing how to repeat the problem. If the
keyword `Fix' is specified in the `Index' line, then there must also be a line beginning with ``Fix:'' followed by a diff of the old and
new source files or a description of what was done to fix the problem.
The `Index' line is the key to the filing mechanism. The source directory name must match one of the folder names in the mail directory.
The message is then filed in this folder and a line appended to the summary file in the following format:
<folder name>/<message number> <Index info>
<Subject info>
The bug report may also be redistributed according to the index. If the file maildir/.redist exists, it is examined for a line beginning
with the index name followed with a tab. The remainder of this line contains a comma-separated list of mail addresses which should receive
copies of bugs with this index. The list may be continued onto multiple lines by ending each but the last with a backslash (`').
FILES
/usr/sbin/sendmail mail delivery program
/usr/libexec/unixtomh converts unix mail format to mh format
maildir/.ack the message sent in acknowledgement
maildir/.format the message sent when format errors are detected
maildir/.redist the redistribution list
maildir/summary the summary file
maildir/Bf?????? temporary copy of the input message
maildir/Rp?????? temporary file for the reply message.
SEE ALSO mh(1), newaliases(1), aliases(5)BUGS
Since mail can be forwarded in a number of different ways, bugfiler does not recognize forwarded mail and will reply/complain to the for-
warder instead of the original sender unless there is a `Reply-To' field in the header.
Duplicate messages should be discarded or recognized and put somewhere else.
4.2 Berkeley Distribution October 23, 1996 BUGFILER(8)
Check Out this Related Man Page
mailfrom(1) General Commands Manual mailfrom(1)NAME
mailfrom - summarize mail folders by subject and sender
SYNOPSIS
status] [folder|username]...
DESCRIPTION
The command reads one or more mail folders and outputs one line per message in 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 determines that the
message is from you, the from portion will read where user is the user the message was sent to. This happens when you receive a copy of a
letter you sent.
The default folder is your incoming mailbox, See the Operands subsection below.
Options
recognizes the following options:
Print a brief help message summarizing the options.
Number the messages using the same numbering scheme used by
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.
Quiet mode. Output only a one-line summary for each mailbox or folder.
Add a summary of the number of messages by message status in each
mailbox or folder. To get the summary only, use this with the option. The summary has the form:
If an item count, n, r, or u is zero, the line is omitted.
Only display headers from messages with the given status.
status can be one of or and are equivalent. The option can be repeated to print header information from more than
one category, for example, only new and unread messages. The values can be abbreviated to their first letters. The
default is all messages.
Tidy mode. If the from field is long enough to displace the subject field from its normal start column, move the subject down
onto the next line.
Verbose mode. Print a descriptive header before listing the contents of each mailbox or folder.
Operands
recognizes the following optional operands:
folder|username
A file name or the name of a mail user on your system. You can use the format to specify a folder in your mail
directory, defined by the string variable in your configuration file.
searches for the value as a file name relative to your current directory. Then, if the file name is not an absolute
path, it searches for the value relative to the incoming mailbox directory, The first file found is selected. You
must have read access to the file.
RETURN VALUE
returns the following values:
Messages matching
status are present.
No messages matching
status are present, but there are some messages.
There are no messages at all.
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
Display header information from all the messages in your mailbox.
Display header information from all new messages in your mailbox.
Assuming you have the proper file permissions to read mail, print out header information from all new and unread messages in incoming mail-
box.
Print only a summary of how many new, unread, and read messages are in your incoming mailbox.
AUTHOR
was developed by HP.
FILES
Your configuration file.
Directory of incoming mailboxes.
SEE ALSO elm(1), mail(1), mailx(1), readmail(1).
mailfrom(1)