X-Git-Url: http://www.privoxy.org/gitweb/?p=privoxy.git;a=blobdiff_plain;f=junkbuster.1;h=e9c4b51f53a0504dbfce7b732cf6de8648905a78;hp=48b54251e57ee57068d5a249db5c97b19997f8fc;hb=338493a4d2247ce0021acbd073fe6baef97a97b1;hpb=315866111867d02883a8ddc514b57ebdb4ff6ec5

diff --git a/junkbuster.1 b/junkbuster.1
index 48b54251..e9c4b51f 100644
--- a/junkbuster.1
+++ b/junkbuster.1
@@ -2,7 +2,7 @@
 .\" Hal Burgiss <hal@foobox.net> 
 .\" for Junkbuster developers: ijbswa-developers@lists.sourceforge.net
 .\"
-.TH JUNKBUSTER 1 "v2.9.10 (beta) Date: 2002/01/09"
+.TH JUNKBUSTER 1 "v2.9.11 (beta) Date: 2002/02/24"
 
 .SH NAME
 \fBjunkbuster\fP
@@ -12,18 +12,42 @@ Proxy
 \s-2(TM)\s+2
 .SH SYNOPSIS
 \fBjunkbuster\fP
-\fI\&[config_file]\fP
+[--help] [--version] [--no-daemon] [--pidfile \fIpidfile\fP] 
+\fI\&[config_file]\fP (Unix)
 .br
 \fBjunkbstr.exe\fP
 \fI\&[config_file]\fP
 (Windows)
 .br
-.P
-If the configuration file is not specified on the command line,
-\fBJunkbuster\fP will look for a file named \fIconfig\fP in the 
-current directory (except on Amiga where it will look for 
-\fIAmiTCP:db/junkbuster/config\fP and Win32 where it will try 
-\fIconfig.txt\fP).
+
+.SH OPTIONS
+\fBJunkbuster\fP may be invoked with the following command-line options:
+.TP
+.BR --version " (unix only)"
+Print version info and exit.
+.TP
+.BR --help " (unix only)"
+Print a short usage info and exit.
+.TP
+.BR --no-daemon " (unix only)"
+Don't become a daemon, i.e. don't fork and become process group
+leader, don't detach from controlling tty.
+.TP
+\fB --pidfile\fP \fIpidfile\fP (unix only)
+On startup, write the process ID to \fIpidfile\fP. Delete the
+\fIpidfile\fP on exit. Failiure to create or delete the
+\fIpidfile\fP is non-fatal. If no \fB--pidfile\fP option
+is given, no PID file will be used.
+.TP
+\fB --user\fP \fIuser\fP (unix only)
+After (optionally) writing the PID file, assume the user ID
+of \fIuser\fP. Exit if the privileges are not sufficient to
+do so.
+
+.PP
+If the \fIconfig file\fP is not specified on the command line,
+\fBJunkbuster\fP will look for a file named \fBconfig\fP in the 
+current directory (except on Win32 where it will try \fBconfig.txt\fP).
 
 
 .SH DESCRIPTION
@@ -41,7 +65,7 @@ fancy.
 Browsers must be configured to use 
 \fBJunkbuster\fP
 (the default is localhost, 
-port 8000).
+port 8118).
 To set the 
 \s-2HTTP\s0
 proxy in Netscape and Mozilla,
@@ -60,7 +84,7 @@ go through:
 \fB\&Connections\fP;
 \fB\&LAN Settings\fP.
 .P
-Set the HTTP proxy location for localhost, port 8000.
+Set the HTTP proxy location for localhost, port 8118.
 The
 Secure (SSL) Proxy\" ijbfaq.html#security
 should also be set to the same values,
@@ -69,14 +93,14 @@ otherwise
 \s-2URL\s0s
 won't be proxied.
 .P
-For other browser, check the documentation.
+For other browsers, check the documentation.
 
 .SH CONFIGURATION
 All \fBJunkbuster\fP configuration is done via the various configuration 
 files. The default configuration files are: \fIconfig\fP, 
 \fIijb.action\fP, and \fIre_filterfile\fP. These are well commented. 
 On Unix and Unix-like systems, these are located in \fI/etc/junkbuster/\fP 
-by default. On Windows and OS/2, these files are in the same directory 
+by default. On Windows, OS/2 and AmigaOS, these files are in the same directory 
 as the \fBJunkbuster\fP executable. 
 .P
 The name and number of configuration files has changed from previous versions,
@@ -85,7 +109,7 @@ itself is changed and much more sophisticated. See the user-manual for a brief
 explanation of all configuration options.
 .P
 \fBJunkbuster's\fP configuration parameters can be viewed at
-\fIhttp://i.j.b/\fP. This is an internal page. In
+\fIhttp://ijbswa.sourceforge.net/config\fP. This is an internal page. In
 addition, the \fIijb.action\fP file can be edited here, and \fBJunkbuster\fP can
 be toggled on/off.
 
@@ -201,6 +225,8 @@ options.
 .br
 \fI/etc/junkbuster/trust\fP
 .br
+\fI/etc/junkbuster/templates/*\fP
+.br
 \fI/var/log/junkbuster/logfile\fP
 
 .P
@@ -209,27 +235,25 @@ and build configuration. More documentation should be included in the local
 documentation directory, though is not complete at this time.
 
 .SH SIGNALS
-\fBJunkbuster\fP use the signal \fISIGHUP\fP (see kill -l) to reload all configuration
-files (see CONFIGURATION). This includes the re-open of the logfiles
-(logfile and jarfile) eg. used
-after rotation of the logfiles by logrotate.
-The \fISIGHUP\fP behavior is only for UNIX like OS'.
-.br
-However the configfile will be re-read if \fBJunkbuster\fP detects a changed
-modification time and then behaves like a re-start of \fBJunkbuster\fP 
-in context of all the pertinent files.
+\fBJunkbuster\fP teriminates on the \fBSIGINT\fP, \fBSIGTERM\fP and \fBSIGABRT\fP
+signals. Log rotation scripts may cause a re-opening of the logfile by sending
+a \fBSIGHUP\fP to \fBJunkbuster\fP. Note that unlike other daemons, \fBJunkbuster\fP
+does not need to be made aware of config file changes by \fBSIGHUP\fP -- it will
+detect them automatically.
  
 .SH NOTES
-This is a development version of \fBJunkbuster\fP. Not all features are  
+This is a \fBBETA\fP version of \fBJunkbuster\fP. Not all features are  
 complete.
+.br
+Please see the user-maual on how to contact the developers for 
+feature requests, reporting problems, and other questions.
 
 .SH BUGS
-Yes. HTTP/1.1 support is only partially implemented. See the user-manual for 
-how and where to report bugs.
+Probably. Please see the user-manual for how and where to report bugs.
 
 .SH SEE ALSO
 .br
-http://i.j.b/
+http://ijbswa.sourceforge.net/config
 .br
 http://ijbswa.sourceforge.net/
 .br
@@ -261,7 +285,7 @@ http://linuxalpha.ch/packages/
 .br
  Haroon Rafique
 .br
- Jorg Strohmayer
+ Joerg Strohmayer
 .br
  Shamim Mohamed
 .br