Unix/Linux Go Back    


BSD 2.11 - man page for bugfiler (bsd section 8)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


BUGFILER(8)									      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  indicating  the  proper  format.   Valid
       reports are then summarized and filed in the appropriate folder; improperly formatted mes-
       sages 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 ``Descrip-
       tion:'' followed by zero or more lines describing the problem in detail and a line  begin-
       ning with ``Repeat-By:'' followed by zero or more lines describing how to repeat the prob-
       lem.  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 mul-
       tiple 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 forwarder 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)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 06:10 AM.