.\" Copyright (c) 1983, 1991, 1993.\"	The Regents of the University of California.  All rights reserved..\".\" Redistribution and use in source and binary forms, with or without.\" modification, are permitted provided that the following conditions.\" are met:.\" 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.\" SUCH DAMAGE..\".\"     @(#)bugfiler.8	8.2 (Berkeley) 12/11/93.\".Dd December 11, 1993.Dt BUGFILER 8.Os BSD 4.2.Sh NAME.Nm bugfiler.Nd file bug reports in folders automatically.Sh SYNOPSIS.Nm bugfiler.Op Fl ar.Op Fl v Ar version.Sh DESCRIPTION.Nm Bugfileris a program to automatically intercept, acknowledge,redistribute and store bug reports..Nm Bugfileris normally invokedby the mail delivery program with a line similar to the following in.Pa /etc/aliases ..Bd -literal -offset indentbugs:	"|bugfiler".Ed.PpIt should be noted that the login.Dq bugsmust exist for the bugfilerto run.  Unless otherwise noted all paths used by.Nm bugfilerarerelative to the home directory of this login..Nm Bugfileralsoexpects all of its files and directories to be owned by.Dq bugs ..PpAvailable options..Bl -tag -width Ds.It Fl aDo not send automatic mail acknowledgement to the bug report filer.(The default is to send the acknowledgement with the file.Pa ~bugs/version/bug:ackappended)..It Fl rDo not redistribute..It Fl v Ar versionOverride the.Ar versionprovided within the bug report itself..El.PpFor the bug report to be correctly filed, it must contain a linein the following format:.Pp.Bd -filled -offset indent -compact.Bl -column Index folder.It Index: Ta Em folder Ta Ar version.El.Ed.PpThe directories.Pa ~bugs/ Ns Ar versionand.Pa ~bugs/ Ns Ar version/ Ns Em foldermust exist before.Nm bugfilerattempts to store the bug report.  Bugreports will be stored in files named by the concatenation of.Ar version ,.Em folder ,and sequential numbers, i.e. if.Ar versionis.Dq 4.3 Tn BSDand.Em folderis.Dq ucbthe first bug report will be placed in.Pa ~bugs/4.3BSD/ucb/1 .If.Em foldercontains more than one component onlythe first one will be used, e.g. if.Em folderis.Dq bin/from.cor.Dq bin/adb/con.cit will be treated as if it were simply.Dq bin ..Pp.PpIf the.Fl rflag is not supplied, redistribution of the bug reportsis done as specified in the file.Pa ~bugs/version/bug:redist .This fileis in the format of the.Xr aliases 5file, including comments andentries requiring multiple lines, with the single exception that the.Em foldercomponent of the.Dq Index:line replaces the name to alias.The special folder.Dq all:receives a redistribution of all bug reportssent to this.Ar version .For example, the.Pa bug:redistfile.Pp.Bd -literal -offset indent -compact#	bigbug gets a copy of everythingall:	bigbug#	ucb folder redistribution listucb:	karels, kjd@coke.berkeley.edu	ra@beno.css.gov.Ed.Ppwill send copies of all bug reports with.Dq ucbas the.Em folderto bigbug, karels, kjd, and ra..PpReports that cannot be filed, due to an invalid.Dq Index:line orsome other error, are placed in the directory.Pa ~bugs/errors .The.Nm bugfilermaintainer should correct these bug reports and thenrun.Nm bugfiler ,with the corrected report as its standard input,as bug reports with errors are neither acknowledged or redistributed.All reports that.Nm bugfilerhandles are logged in.Pa ~bugs/log..PpValid bugs are also logged in the file.Pa ~bugs/version/summary.This file has an entry for each bug report for.Ar versionin theformat:.Pp.Bd -literal -offset indent -compactFilename	Date     Subject:     Index:     Owner:	Bugs Bunny     Status:	Received.Ed.Pp.Li Filenameis the concatenation of.Ar version ,.Em folder ,and a numberas described above..Xr Dateis the date as reported by the systemclock, using.Xr ctime 3 .The.Li Subject:and.Li Index:lines arecopies of the.Dq Subject:and.Dq index:lines contained in the bugreport.  The.Li Ownerand.Li Statusfields are intended to provide arudimentary method of tracking the status of bug reports..PpThe file.Pa ~bugs/bug:lockis the focus of all locking for.Nm bugfiler .If you wish to manipulate any of the log or error files, rename or removeit and.Nm bugfilerwill treat all bug reports that it receives as ifthey were incorrectly formatted, i.e. it will place them in the directory.Pa ~bugs/errors ,for later recovery by the.Nm bugfilermaintainer.Obviously, this file must be created when you first install.Nm bugfiler ..PpAll errors that occur before.Pa ~bugs/logis found are logged into the systemlog file, using.Xr syslog 8 ..Sh FILES.Bl -tag -width /usr/share/misc/bugformatxx -compact.It Pa ~bugs/bug:ackthe acknowledgement message.It Pa ~bugs/bug:redistthe redistribution list.It Pa ~bugs/bug:lockthe locking file.It Pa ~bugs/errors/BUG_??????bug reports with format errors.It Pa ~bugs/logthe log file.It Pa ~bugs/folder/summarythe summary files.It Pa /usr/sbin/sendmailthe mail delivery program.It Pa /usr/share/misc/bugformata sample bug report format.El.Sh SEE ALSO.Xr sendbug 1 ,.Xr aliases 5 ,.Xr syslog 8.Sh BUGSSince mail can be forwarded in a number of different ways,.Nm bugfilerdoes not recognize forwarded mail and will acknowledge to the forwarderinstead of the original sender unless there is a.Dq Reply-Tofield in theheader..PpThis version of.Nm bugfileris not compatible with the versionreleased with.Bx 4.3in that it doesn't complain to the sender aboutincorrectly formatted bug reports.Frankly, we got tired of the profanity, not to mention the extendedconversations.Nm bugfilerwas holding with.Xr vacation 1 ..Sh HISTORYThe.Nmcommand appeared in.Bx 4.2 .