.\" Hal Burgiss <hal@foobox.net> \r
.\" for Junkbuster developers: ijbswa-developers@lists.sourceforge.net\r
.\"\r
-.TH JUNKBUSTER 1 "v2.9.11 (beta) Date: 2002/02/24"\r
+.TH JUNKBUSTER 1 "v2.9.11 (beta) Date: 2002/03/06"\r
\r
.SH NAME\r
\fBjunkbuster\fP\r
\s-2(TM)\s+2\r
.SH SYNOPSIS\r
\fBjunkbuster\fP\r
-\fI\&[config_file]\fP\r
-.br\r
+[--help] [--version] [--no-daemon] [--pidfile \fIPID_FILE\fP] [--user USER] \r
+\fI\&[config_file]\fP (Unix)\r
+.TP\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 usage 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, and do all logging\r
+there.\r
+.TP\r
+\fB --pidfile\fP \fIPID_FILE\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
+.TP\r
+\fB --user\fP \fIUSER\fP (unix only)\r
+After (optionally) writing the PID file, assume the user ID\r
+of \fIuser\fP. Exit if the privileges are not sufficient to\r
+do so.\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
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
\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
\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
+\fBJunkbuster\fP can be configured with the various configuration \r
files. The default configuration files are: \fIconfig\fP, \r
\fIijb.action\fP, and \fIre_filterfile\fP. These are well commented. \r
On Unix and Unix-like systems, these are located in \fI/etc/junkbuster/\fP \r
itself is changed and much more sophisticated. See the user-manual for a brief\r
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
-addition, the \fIijb.action\fP file can be edited here, and \fBJunkbuster\fP can\r
-be toggled on/off.\r
+The actions list (ad blocks, etc) can also be configured with your \r
+web browser at \fIhttp://ijbswa.sourceforge.net/config\fP.\r
+\fBJunkbuster's\fP configuration parameters can also be viewed \r
+at the same page. In addition, \fBJunkbuster\fP can be toggled on/off.\r
+This is an internal page. \r
\r
.SH "SAMPLE CONFIGURATION"\r
.PP\r
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
feature requests, reporting problems, and other questions.\r
\r
.SH BUGS\r
-Probably. Please the user-manual for how and where to report bugs.\r
+Probably. Please see the user-manual for how and where to report bugs.\r
\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
John Venvertloh\r
.br\r
Hal Burgiss\r
+.br\r
+ Rodrigo Barbosa\r
\r
.SH COPYRIGHT AND LICENSE\r
Orginally written by, and copyrighted by, the Anonymous Coders and Junkbusters\r