.\" Copyright (c) 1983, 1991 The Regents of the University of California.
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" 1. Redistributions of source code must retain the above copyright
.\" notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\" must display the following acknowledgement:
.\" This product includes software developed by the University of
.\" California, Berkeley and its contributors.
.\" 4. Neither the name of the University nor the names of its contributors
.\" may be used to endorse or promote products derived from this software
.\" without specific prior written permission.
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" @(#)bugfiler.8 6.11 (Berkeley) 3/16/91
.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