| 1 |
.\"
|
| 2 |
.\" Copyright (C) 2000 Ross Combs (ross@bnetd.org)
|
| 3 |
.\"
|
| 4 |
.\" This is free documentation; you can redistribute it and/or
|
| 5 |
.\" modify it under the terms of the GNU General Public License as
|
| 6 |
.\" published by the Free Software Foundation; either version 2 of
|
| 7 |
.\" the License, or (at your option) any later version.
|
| 8 |
.\"
|
| 9 |
.\" The GNU General Public License's references to "object code"
|
| 10 |
.\" and "executables" are to be interpreted as the output of any
|
| 11 |
.\" document formatting or typesetting system, including
|
| 12 |
.\" intermediate and printed output.
|
| 13 |
.\"
|
| 14 |
.\" This manual is distributed in the hope that it will be useful,
|
| 15 |
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
|
| 16 |
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
| 17 |
.\" GNU General Public License for more details.
|
| 18 |
.\"
|
| 19 |
.\" You should have received a copy of the GNU General Public
|
| 20 |
.\" License along with this manual; if not, write to the Free
|
| 21 |
.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,
|
| 22 |
.\" USA.
|
| 23 |
.\"
|
| 24 |
.TH BNPROXY 1 "12 September, 2000" "BNETD" "BNETD User's Manual"
|
| 25 |
.SH NAME
|
| 26 |
bnproxy \- bnetd tracking daemon
|
| 27 |
.SH SYNOPSIS
|
| 28 |
.B bntrackd
|
| 29 |
[\fIoptions\fP]
|
| 30 |
.BR
|
| 31 |
.SH DESCRIPTION
|
| 32 |
.B bntrackd
|
| 33 |
is a simple daemon which will listen for UDP announcement packets sent by
|
| 34 |
.BR bnetd (1)
|
| 35 |
servers. The list of servers and their statistics is written to a text
|
| 36 |
file an optionally processed by an external program. A
|
| 37 |
.BR perl (1)
|
| 38 |
script is
|
| 39 |
provided which processes this information to produce an HTML document
|
| 40 |
suitable for display on the web.
|
| 41 |
.LP
|
| 42 |
.BR bnetd (1)
|
| 43 |
servers must be configured to report to tracking servers. The
|
| 44 |
.BR bnetd.conf (5)
|
| 45 |
file allows for multiple tracking servers to be listed separated by commas.
|
| 46 |
The master server is track.bnetd.org. Please consider including that server
|
| 47 |
in your configuration.
|
| 48 |
.SH OPTIONS
|
| 49 |
.TP
|
| 50 |
.B \-c --command
|
| 51 |
Run the specified command after writing server information to \fIoutfile\fP.
|
| 52 |
If this option is not specified, the command "scripts/process.pl" is executed
|
| 53 |
from the directory that
|
| 54 |
.B bntrackd
|
| 55 |
was started. If an empty string is provided for \fIcommand\fP, no command
|
| 56 |
will be executed.
|
| 57 |
.TP
|
| 58 |
.B \-e --expire
|
| 59 |
Set the period of time in seconds to keep server information without receiving
|
| 60 |
new updates. If this option is not specified, 600 seconds is used.
|
| 61 |
.TP
|
| 62 |
.B \-d --debug
|
| 63 |
Place additional informational messages in the event log.
|
| 64 |
.TP
|
| 65 |
.B \-h --help --usage
|
| 66 |
Print usage information and exit.
|
| 67 |
.TP
|
| 68 |
.B \-l --logfile
|
| 69 |
Put the event log messages into the specified file. If this option is not
|
| 70 |
specified, the file "logs/bntrackd.log" will be written from the directory
|
| 71 |
that
|
| 72 |
.B bntrackd
|
| 73 |
was started. If an empty string is provided for \fIlogfile\fP, no event
|
| 74 |
messages will be written.
|
| 75 |
.TP
|
| 76 |
.TP
|
| 77 |
.B \-o --outfile
|
| 78 |
Put the server information into the specified file \fIoutfile\fP..
|
| 79 |
.TP
|
| 80 |
.B \-p --port
|
| 81 |
Listen for announcements on the specified UDP port number. If this option
|
| 82 |
is not specified, the port number defaults to 6114.
|
| 83 |
.TP
|
| 84 |
.B \-P --pidfile
|
| 85 |
Record the process ID of the tracking daemon in the specified file. If this
|
| 86 |
option is not specified, this information is not written to any file.
|
| 87 |
.TP
|
| 88 |
.B \-u --update
|
| 89 |
Set the period of time in seconds between updates of the \fIoutfile\fP. If
|
| 90 |
this option is not specified, 150 seconds is used.
|
| 91 |
.TP
|
| 92 |
.B \-v --version
|
| 93 |
Causes
|
| 94 |
.B bntrackd
|
| 95 |
to print its version number and exit.
|
| 96 |
.SH NOTES
|
| 97 |
.TP
|
| 98 |
The current version is available at:
|
| 99 |
.LP
|
| 100 |
.RS
|
| 101 |
.I http://www.bnetd.org/
|
| 102 |
.RE
|
| 103 |
.SH "SEE ALSO"
|
| 104 |
.BR bnetd (1),
|
| 105 |
.BR perl (1)
|
| 106 |
.SH AUTHOR
|
| 107 |
Ross Combs (\fIross@bnetd.org\fP)
|