BUGFILER(8,C) AIX Commands Reference BUGFILER(8,C)
-------------------------------------------------------------------------------
bugfiler
PURPOSE
Intercepts, summarizes and stores bug reports.
SYNTAX
/usr/lib/bugfiler --- maildirectory ---|
Note: This command does not have MBCS support.
DESCRIPTION
The bugfiler command 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 with a line such
as the following in /usr/lib/aliases:
bugs:"|/usr/lib/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 indicating 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 must 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
Processed November 8, 1990 BUGFILER(8,C) 1
BUGFILER(8,C) AIX Commands Reference BUGFILER(8,C)
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/lib/sendmail Mail delivery program.
/usr/lib/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.
Processed November 8, 1990 BUGFILER(8,C) 2