mirror of git://erdgeist.org/opentracker
Add first draft of a man page
Dirk Engling
7 months ago
parent
33bd2c9094
commit
dcc47f9612
@ -0,0 +1,125 @@
|
|||||||
|
.Dd 15/4/2024
|
||||||
|
.Dt opentracker 1
|
||||||
|
.Os posix
|
||||||
|
.Sh opentracker
|
||||||
|
.Nm opentracker
|
||||||
|
.Nd a free and open bittorrent tracker
|
||||||
|
.Sh SYNOPSIS
|
||||||
|
.Nm
|
||||||
|
.Op Fl f Ar config
|
||||||
|
.Op Fl i Ar ip-select
|
||||||
|
.Op Fl p Ar port-bind-tcp
|
||||||
|
.Op Fl P Ar port-bind-udp
|
||||||
|
.Op Fl A Ar blessed-ip
|
||||||
|
.Op Fl r Ar redirect-url
|
||||||
|
.Op Fl d Ar chdir
|
||||||
|
.Op Fl u Ar user
|
||||||
|
.Op Fl w| Fl b accesslist
|
||||||
|
.Sh DESCRIPTION
|
||||||
|
.Nm
|
||||||
|
is a bittorrent tracker that implements announce and scrape actions over the
|
||||||
|
udp and the plain http protocol, aiming for minimal resource usage.
|
||||||
|
.Pp
|
||||||
|
|
||||||
|
When invoked with parameters, it binds to tcp and udp port 6969 on all
|
||||||
|
interfaces. The recommended way to configure opentracker is by providing a
|
||||||
|
config file using the
|
||||||
|
.Op Fl f Ar config
|
||||||
|
option. See
|
||||||
|
.Xr opentracker.conf 4
|
||||||
|
for details.
|
||||||
|
.Pp
|
||||||
|
|
||||||
|
.Sh OPTIONS
|
||||||
|
The following options are available:
|
||||||
|
|
||||||
|
.Bl -tag -width -indent=8
|
||||||
|
.It Fl f Ar config
|
||||||
|
Parse a config file with a list of options. Consecutive command options
|
||||||
|
will override options from the config file. See
|
||||||
|
.Xr opentracker.conf 4
|
||||||
|
for details.
|
||||||
|
|
||||||
|
.It Fl i Ar ip-select
|
||||||
|
Select an ip address that will be used with the next
|
||||||
|
.Op Fl p
|
||||||
|
or
|
||||||
|
.Op Fl P
|
||||||
|
command to actually bind to this address. Setting this option without any bind
|
||||||
|
options in the config file or
|
||||||
|
.Op Fl p
|
||||||
|
or
|
||||||
|
.Op Fl P
|
||||||
|
commands will limit opentracker to only bind to this address.
|
||||||
|
.It Fl p Ar port-bind-tcp
|
||||||
|
Bind to the tcp port on the last preceding ip address set with the
|
||||||
|
.Op Fl i ip-select
|
||||||
|
option or to all available addresses if none has been set. Can be given multiple
|
||||||
|
times.
|
||||||
|
.It Fl p Ar port-bind-udp
|
||||||
|
Bind to the udp port on the last preceding ip address set with the
|
||||||
|
.Op Fl i ip-select
|
||||||
|
option or to all available addresses if none has been set. Can be given multiple
|
||||||
|
times.
|
||||||
|
.It Fl A Ar blessed-ip
|
||||||
|
Set an ip address in IPv4 or IPv6 or a net in CIDR notation to bless the network
|
||||||
|
for access to restricted resources.
|
||||||
|
.It Fl r Ar redirect-url
|
||||||
|
Set the URL that
|
||||||
|
.Nm
|
||||||
|
will redirect users to when the / address is requested via HTTP.
|
||||||
|
.It Fl d Ar chdir
|
||||||
|
Sets the directory
|
||||||
|
.Nm
|
||||||
|
will
|
||||||
|
.Xr chroot 2
|
||||||
|
to if ran as root or
|
||||||
|
.Xr chdir 2
|
||||||
|
to if ran as unprivileged user. Note that any accesslist files need to be
|
||||||
|
relative to and within that directory.
|
||||||
|
.It Fl u Ar user
|
||||||
|
User to run
|
||||||
|
.Nm
|
||||||
|
under after all operations that need privileges have finished.
|
||||||
|
.It Fl w Ar accesslist | Fl b Ar accesslist
|
||||||
|
If
|
||||||
|
.Nm
|
||||||
|
has been compiled with the
|
||||||
|
.B WANT_ACCESSLIST_BLACK
|
||||||
|
or
|
||||||
|
.Br WANT_ACCESSLIST_WHITE
|
||||||
|
options, this option sets the location of the accesslist.
|
||||||
|
.El
|
||||||
|
|
||||||
|
.Sh EXAMPLES
|
||||||
|
|
||||||
|
Start
|
||||||
|
.Nm
|
||||||
|
bound on udp and tcp ports 6969 on IPv6 localhost.
|
||||||
|
|
||||||
|
.Dl # ./opentracker -i ::1 -p 6969 -P 6969
|
||||||
|
|
||||||
|
.Pp
|
||||||
|
Start
|
||||||
|
.Nm
|
||||||
|
bound on port udp and tcp port 6868 on IPv4 localhost and allow
|
||||||
|
privileged access from the nnetwork 192.168/16 while redirecting
|
||||||
|
HTTP clients accessing / to https://my-trackersite.com/.
|
||||||
|
|
||||||
|
.Dl # ./opentracker -i 192.168.0.4 -p 6868 -P 6969 -A 192.168/16 -r https://my-trackersite.com/
|
||||||
|
|
||||||
|
The announce URLs are http://192.168.0.4:6868/announce and
|
||||||
|
udp://192.168.0.4:6868/announce respectively.
|
||||||
|
|
||||||
|
.Sh FILES
|
||||||
|
.Bl -tag -width -compact
|
||||||
|
.It Pa opentracker.conf
|
||||||
|
config file.
|
||||||
|
.El
|
||||||
|
.Sh SEE ALSO
|
||||||
|
.Xr opentracker.conf 4
|
||||||
|
.Sh
|
||||||
|
.Sh AUTHOR
|
||||||
|
.An Dirk Engling
|
||||||
|
.Aq erdgeist@erdgeist.org .
|
||||||
|
|
||||||
Loading…
Reference in New Issue