.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
.\" %sccs.include.redist.man%
.\" @(#)bugfiler.8 8.2 (Berkeley) %G%
.Nd file bug reports in folders automatically
is a program to automatically intercept, acknowledge,
redistribute and store bug reports.
by the mail delivery program with a line similar to the following in
.Bd -literal -offset indent
It should be noted that the login
must exist for the bugfiler
to run. Unless otherwise noted all paths used by
relative to the home directory of this login.
expects all of its files and directories to be owned by
Do not send automatic mail acknowledgement to the bug report filer.
(The default is to send the acknowledgement with the file
.Pa ~bugs/version/bug:ack
provided within the bug report itself.
For the bug report to be correctly filed, it must contain a line
.Bd -filled -offset indent -compact
.It Index: Ta Em folder Ta Ar version
.Pa ~bugs/ Ns Ar version/ Ns Em folder
attempts to store the bug report. Bug
reports will be stored in files named by the concatenation of
and sequential numbers, i.e. if
the first bug report will be placed in
contains more than one component only
the first one will be used, e.g. if
it will be treated as if it were simply
flag is not supplied, redistribution of the bug reports
is done as specified in the file
.Pa ~bugs/version/bug:redist .
file, including comments and
entries requiring multiple lines, with the single exception that the
line replaces the name to alias.
receives a redistribution of all bug reports
.Bd -literal -offset indent -compact
# bigbug gets a copy of everything
# ucb folder redistribution list
ucb: karels, kjd@coke.berkeley.edu
will send copies of all bug reports with
to bigbug, karels, kjd, and ra.
Reports that cannot be filed, due to an invalid
some other error, are placed in the directory
maintainer should correct these bug reports and then
with the corrected report as its standard input,
as bug reports with errors are neither acknowledged or redistributed.
Valid bugs are also logged in the file
.Pa ~bugs/version/summary.
This file has an entry for each bug report for
.Bd -literal -offset indent -compact
is the date as reported by the system
lines contained in the bug
fields are intended to provide a
rudimentary method of tracking the status of bug reports.
is the focus of all locking for
If you wish to manipulate any of the log or error files, rename or remove
will treat all bug reports that it receives as if
they were incorrectly formatted, i.e. it will place them in the directory
for later recovery by the
Obviously, this file must be created when you first install
All errors that occur before
is found are logged into the system
.Bl -tag -width /usr/share/misc/bugformatxx -compact
the acknowledgement message
.It Pa ~bugs/errors/BUG_??????
bug reports with format errors
.It Pa ~bugs/folder/summary
.It Pa /usr/sbin/sendmail
the mail delivery program
.It Pa /usr/share/misc/bugformat
a sample bug report format
Since mail can be forwarded in a number of different ways,
does not recognize forwarded mail and will acknowledge to the forwarder
instead of the original sender unless there is a
is not compatible with the version
in that it doesn't complain to the sender about
incorrectly formatted bug reports.
Frankly, we got tired of the profanity, not to mention the extended