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
INCM(1) General Commands Manual INCM(1)NAME
incm - Incorporating new mails for Mew
SYNOPSIS
incm [options]
DESCRIPTION
The incm utility incoporates new mails from the mbox or the maildir to Mew's inbox folder.
The options are as follows:
-a Retrieve all mails from maildir/{cur,new} for maildir.
-b Backup mails. mbox: No truncate mbox file. maildir: To maildir/cur directory.
-c Use the Content-Length: field, instead of the "From " line, as a mail separator for mbox.
-d path Path to mbox/maildir. If path is a file, mbox is assumed. If path is a directory, maildir is assumed.
-m path The same as the -d option.
-s Read one mail from stdin instead of mbox/maildir.
-i inboxdir
A path to the inbox directory.
-h Display this help message.
-v Display the version.
mbox
For mbox, the mail separator is "From " in the beginning of lines. The incm utility does not convert ">From " to "From " in the beginning
of lines in the body. On Solaris, Content-Length: should be used with the -c option to tell the end of mail.
To lock mbox, both a lock file("user.lock") and flock() (or lockf(), or open(LOCK_EX) are used.
maildir
For maildir, no lock and no separator are necessary.
Consider the following situation:
cur/{1,2}
new/{3,4}
Executing incm without the options results in:
cur/{1,2}
new/{}
to inbox: {3,4}
Executing incm with the -a option results in:
cur/{}
new/{}
to inbox: {1,2,3,4}
Executing incm with the -b option results in:
cur/{1,2,3,4}
new/{}
to inbox: {3,4}
Executing incm with the -a option and the -b otpion results in:
cur/{1,2,3,4}
new/{}
to inbox: {1,2,3,4}
So, if both options are specified, messages are retrieved multiple times.
December 25, 2001 INCM(1)