1.\" Copyright (c) 1983, 1991, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" %sccs.include.redist.man% 5.\" 6.\" @(#)bugfiler.8 8.2 (Berkeley) 12/11/93 7.\" 8.Dd 9.Dt BUGFILER 8 10.Os BSD 4.2 11.Sh NAME 12.Nm bugfiler 13.Nd file bug reports in folders automatically 14.Sh SYNOPSIS 15.Nm bugfiler 16.Op Fl ar 17.Op Fl v Ar version 18.Sh DESCRIPTION 19.Nm Bugfiler 20is a program to automatically intercept, acknowledge, 21redistribute and store bug reports. 22.Nm Bugfiler 23is normally invoked 24by the mail delivery program with a line similar to the following in 25.Pa /etc/aliases . 26.Bd -literal -offset indent 27bugs: "|bugfiler" 28.Ed 29.Pp 30It should be noted that the login 31.Dq bugs 32must exist for the bugfiler 33to run. Unless otherwise noted all paths used by 34.Nm bugfiler 35are 36relative to the home directory of this login. 37.Nm Bugfiler 38also 39expects all of its files and directories to be owned by 40.Dq bugs . 41.Pp 42Available options. 43.Bl -tag -width Ds 44.It Fl a 45Do not send automatic mail acknowledgement to the bug report filer. 46(The default is to send the acknowledgement with the file 47.Pa ~bugs/version/bug:ack 48appended). 49.It Fl r 50Do not redistribute. 51.It Fl v Ar version 52Override the 53.Ar version 54provided within the bug report itself. 55.El 56.Pp 57For the bug report to be correctly filed, it must contain a line 58in the following format: 59.Pp 60.Bd -filled -offset indent -compact 61.Bl -column Index folder 62.It Index: Ta Em folder Ta Ar version 63.El 64.Ed 65.Pp 66The directories 67.Pa ~bugs/ Ns Ar version 68and 69.Pa ~bugs/ Ns Ar version/ Ns Em folder 70must exist before 71.Nm bugfiler 72attempts to store the bug report. Bug 73reports will be stored in files named by the concatenation of 74.Ar version , 75.Em folder , 76and sequential numbers, i.e. if 77.Ar version 78is 79.Dq 4.3 Tn BSD 80and 81.Em folder 82is 83.Dq ucb 84the first bug report will be placed in 85.Pa ~bugs/4.3BSD/ucb/1 . 86If 87.Em folder 88contains more than one component only 89the first one will be used, e.g. if 90.Em folder 91is 92.Dq bin/from.c 93or 94.Dq bin/adb/con.c 95it will be treated as if it were simply 96.Dq bin . 97.Pp 98.Pp 99If the 100.Fl r 101flag is not supplied, redistribution of the bug reports 102is done as specified in the file 103.Pa ~bugs/version/bug:redist . 104This file 105is in the format of the 106.Xr aliases 5 107file, including comments and 108entries requiring multiple lines, with the single exception that the 109.Em folder 110component of the 111.Dq Index: 112line replaces the name to alias. 113The special folder 114.Dq all: 115receives a redistribution of all bug reports 116sent to this 117.Ar version . 118For example, the 119.Pa bug:redist 120file 121.Pp 122.Bd -literal -offset indent -compact 123# bigbug gets a copy of everything 124all: bigbug 125# ucb folder redistribution list 126ucb: karels, kjd@coke.berkeley.edu 127 ra@beno.css.gov 128.Ed 129.Pp 130will send copies of all bug reports with 131.Dq ucb 132as the 133.Em folder 134to bigbug, karels, kjd, and ra. 135.Pp 136Reports that cannot be filed, due to an invalid 137.Dq Index: 138line or 139some other error, are placed in the directory 140.Pa ~bugs/errors . 141The 142.Nm bugfiler 143maintainer should correct these bug reports and then 144run 145.Nm bugfiler , 146with the corrected report as its standard input, 147as bug reports with errors are neither acknowledged or redistributed. 148All reports that 149.Nm bugfiler 150handles are logged in 151.Pa ~bugs/log. 152.Pp 153Valid bugs are also logged in the file 154.Pa ~bugs/version/summary. 155This file has an entry for each bug report for 156.Ar version 157in the 158format: 159.Pp 160.Bd -literal -offset indent -compact 161Filename Date 162 Subject: 163 Index: 164 Owner: Bugs Bunny 165 Status: Received 166.Ed 167.Pp 168.Li Filename 169is the concatenation of 170.Ar version , 171.Em folder , 172and a number 173as described above. 174.Xr Date 175is the date as reported by the system 176clock, using 177.Xr ctime 3 . 178The 179.Li Subject: 180and 181.Li Index: 182lines are 183copies of the 184.Dq Subject: 185and 186.Dq index: 187lines contained in the bug 188report. The 189.Li Owner 190and 191.Li Status 192fields are intended to provide a 193rudimentary method of tracking the status of bug reports. 194.Pp 195The file 196.Pa ~bugs/bug:lock 197is the focus of all locking for 198.Nm bugfiler . 199If you wish to manipulate any of the log or error files, rename or remove 200it and 201.Nm bugfiler 202will treat all bug reports that it receives as if 203they were incorrectly formatted, i.e. it will place them in the directory 204.Pa ~bugs/errors , 205for later recovery by the 206.Nm bugfiler 207maintainer. 208Obviously, this file must be created when you first install 209.Nm bugfiler . 210.Pp 211All errors that occur before 212.Pa ~bugs/log 213is found are logged into the system 214log file, using 215.Xr syslog 8 . 216.Sh FILES 217.Bl -tag -width /usr/share/misc/bugformatxx -compact 218.It Pa ~bugs/bug:ack 219the acknowledgement message 220.It Pa ~bugs/bug:redist 221the redistribution list 222.It Pa ~bugs/bug:lock 223the locking file 224.It Pa ~bugs/errors/BUG_?????? 225bug reports with format errors 226.It Pa ~bugs/log 227the log file 228.It Pa ~bugs/folder/summary 229the summary files 230.It Pa /usr/sbin/sendmail 231the mail delivery program 232.It Pa /usr/share/misc/bugformat 233a sample bug report format 234.El 235.Sh SEE ALSO 236.Xr sendbug 1 , 237.Xr aliases 5 , 238.Xr syslog 8 239.Sh BUGS 240Since mail can be forwarded in a number of different ways, 241.Nm bugfiler 242does not recognize forwarded mail and will acknowledge to the forwarder 243instead of the original sender unless there is a 244.Dq Reply-To 245field in the 246header. 247.Pp 248This version of 249.Nm bugfiler 250is not compatible with the version 251released with 252.Bx 4.3 253in that it doesn't complain to the sender about 254incorrectly formatted bug reports. 255Frankly, we got tired of the profanity, not to mention the extended 256conversations 257.Nm bugfiler 258was holding with 259.Xr vacation 1 . 260.Sh HISTORY 261The 262.Nm 263command appeared in 264.Bx 4.2 . 265