- Added OPTIONS section
[privoxy.git] / junkbuster.1
index be7e971..ed158c4 100644 (file)
@@ -12,16 +12,37 @@ Proxy
 \s-2(TM)\s+2\r
 .SH SYNOPSIS\r
 \fBjunkbuster\fP\r
-\fI\&[config_file]\fP\r
+[--help] [--version] [--no-daemon] [--pidfile \fIpidfile\fP] \r
+\fI\&[config_file]\fP (Unix)\r
 .br\r
 \fBjunkbstr.exe\fP\r
 \fI\&[config_file]\fP\r
 (Windows)\r
 .br\r
-.P\r
-If the configuration file is not specified on the command line,\r
-\fBJunkbuster\fP will look for a file named \fIconfig\fP in the \r
-current directory (except on Win32 where it will try \fIconfig.txt\fP).\r
+\r
+.SH OPTIONS\r
+\fBJunkbuster\fP may be invoked with the following command-line options:\r
+.TP\r
+.BR --version " (unix only)"\r
+Print version info and exit.\r
+.TP\r
+.BR --help " (unix only)"\r
+Print a short usae info and exit.\r
+.TP\r
+.BR --no-daemon " (unix only)"\r
+Don't become a daemon, i.e. don't fork and become process group\r
+leader, don't detach from controlling tty.\r
+.TP\r
+\fB --pidfile\fP \fIpidfile\fP (unix only)\r
+On startup, write the process ID to \fIpidfile\fP. Delete the\r
+\fIpidfile\fP on exit. Failiure to create or delete the\r
+\fIpidfile\fP is non-fatal. If no \fB--pidfile\fP option\r
+is given, no PID file will be used.\r
+\r
+.PP\r
+If the \fIconfig file\fP is not specified on the command line,\r
+\fBJunkbuster\fP will look for a file named \fBconfig\fP in the \r
+current directory (except on Win32 where it will try \fBconfig.txt\fP).\r
 \r
 \r
 .SH DESCRIPTION\r
@@ -39,7 +60,7 @@ fancy.
 Browsers must be configured to use \r
 \fBJunkbuster\fP\r
 (the default is localhost, \r
-port 8000).\r
+port 8118).\r
 To set the \r
 \s-2HTTP\s0\r
 proxy in Netscape and Mozilla,\r
@@ -58,7 +79,7 @@ go through:
 \fB\&Connections\fP;\r
 \fB\&LAN Settings\fP.\r
 .P\r
-Set the HTTP proxy location for localhost, port 8000.\r
+Set the HTTP proxy location for localhost, port 8118.\r
 The\r
 Secure (SSL) Proxy\" ijbfaq.html#security\r
 should also be set to the same values,\r
@@ -67,7 +88,7 @@ otherwise
 \s-2URL\s0s\r
 won't be proxied.\r
 .P\r
-For other browser, check the documentation.\r
+For other browsers, check the documentation.\r
 \r
 .SH CONFIGURATION\r
 All \fBJunkbuster\fP configuration is done via the various configuration \r
@@ -83,7 +104,7 @@ itself is changed and much more sophisticated. See the user-manual for a brief
 explanation of all configuration options.\r
 .P\r
 \fBJunkbuster's\fP configuration parameters can be viewed at\r
-\fIhttp://i.j.b/\fP. This is an internal page. In\r
+\fIhttp://ijbswa.sourceforge.net/config\fP. This is an internal page. In\r
 addition, the \fIijb.action\fP file can be edited here, and \fBJunkbuster\fP can\r
 be toggled on/off.\r
 \r
@@ -209,18 +230,14 @@ and build configuration. More documentation should be included in the local
 documentation directory, though is not complete at this time.\r
 \r
 .SH SIGNALS\r
-\fBJunkbuster\fP use the signal \fISIGHUP\fP (see kill -l) to reload all configuration\r
-files (see CONFIGURATION). This includes the re-open of the logfiles\r
-(logfile and jarfile) eg. used\r
-after rotation of the logfiles by logrotate.\r
-The \fISIGHUP\fP behavior is only for UNIX like OS'.\r
-.br\r
-However the configfile will be re-read if \fBJunkbuster\fP detects a changed\r
-modification time and then behaves like a re-start of \fBJunkbuster\fP \r
-in context of all the pertinent files.\r
+\fBJunkbuster\fP teriminates on the \fBSIGINT\fP, \fBSIGTERM\fP and \fBSIGABRT\fP\r
+signals. Log rotation scripts may cause a re-opening of the logfile by sending\r
+a \fBSIGHUP\fP to \fBJunkbuster\fP. Note that unlike other daemons, \fBJunkbuster\fP\r
+does not need to be made aware of config file changes by \fBSIGHUP\fP -- it will\r
+detect them automatically.\r
  \r
 .SH NOTES\r
-This is a BETA version of \fBJunkbuster\fP. Not all features are  \r
+This is a \fBBETA\fP version of \fBJunkbuster\fP. Not all features are  \r
 complete.\r
 .br\r
 Please see the user-maual on how to contact the developers for \r
@@ -231,7 +248,7 @@ Probably. Please the user-manual for how and where to report bugs.
 \r
 .SH SEE ALSO\r
 .br\r
-http://i.j.b/\r
+http://ijbswa.sourceforge.net/config\r
 .br\r
 http://ijbswa.sourceforge.net/\r
 .br\r