summaryrefslogtreecommitdiff
path: root/man1
diff options
context:
space:
mode:
Diffstat (limited to 'man1')
-rw-r--r--man1/opentracker.143
1 files changed, 30 insertions, 13 deletions
diff --git a/man1/opentracker.1 b/man1/opentracker.1
index 45d71cb..85ded7b 100644
--- a/man1/opentracker.1
+++ b/man1/opentracker.1
@@ -1,6 +1,6 @@
1.Dd 15/4/2024 1.Dd 15/4/2024
2.Dt opentracker 1 2.Dt opentracker 1
3.Os posix 3.Os Unix
4.Sh opentracker 4.Sh opentracker
5.Nm opentracker 5.Nm opentracker
6.Nd a free and open bittorrent tracker 6.Nd a free and open bittorrent tracker
@@ -18,14 +18,14 @@
18.Sh DESCRIPTION 18.Sh DESCRIPTION
19.Nm 19.Nm
20is a bittorrent tracker that implements announce and scrape actions over the 20is a bittorrent tracker that implements announce and scrape actions over the
21udp and the plain http protocol, aiming for minimal resource usage. 21UDP and the plain http protocol, aiming for minimal resource usage.
22.Pp 22.Pp
23 23
24When invoked with parameters, it binds to tcp and udp port 6969 on all 24When invoked with parameters, it binds to TCP and UDP port 6969 on all
25interfaces. The recommended way to configure opentracker is by providing a 25interfaces. The recommended way to configure opentracker is by providing a
26config file using the 26config file using the
27.Op Fl f Ar config 27.Op Fl f Ar config
28option. See 28option. See
29.Xr opentracker.conf 4 29.Xr opentracker.conf 4
30for details. 30for details.
31.Pp 31.Pp
@@ -52,12 +52,12 @@ or
52.Op Fl P 52.Op Fl P
53commands will limit opentracker to only bind to this address. 53commands will limit opentracker to only bind to this address.
54.It Fl p Ar port-bind-tcp 54.It Fl p Ar port-bind-tcp
55Bind to the tcp port on the last preceding ip address set with the 55Bind to the TCP port on the last preceding ip address set with the
56.Op Fl i ip-select 56.Op Fl i ip-select
57option or to all available addresses if none has been set. Can be given multiple 57option or to all available addresses if none has been set. Can be given multiple
58times. 58times.
59.It Fl p Ar port-bind-udp 59.It Fl P Ar port-bind-udp
60Bind to the udp port on the last preceding ip address set with the 60Bind to the UDP port on the last preceding ip address set with the
61.Op Fl i ip-select 61.Op Fl i ip-select
62option or to all available addresses if none has been set. Can be given multiple 62option or to all available addresses if none has been set. Can be given multiple
63times. 63times.
@@ -95,16 +95,17 @@ options, this option sets the location of the accesslist.
95 95
96Start 96Start
97.Nm 97.Nm
98bound on udp and tcp ports 6969 on IPv6 localhost. 98bound on UDP and TCP ports 6969 on IPv6 localhost.
99 99
100.Dl # ./opentracker -i ::1 -p 6969 -P 6969 100.Dl # ./opentracker -i ::1 -p 6969 -P 6969
101 101
102.Pp 102.Pp
103Start 103Start
104.Nm 104.Nm
105bound on port udp and tcp port 6868 on IPv4 localhost and allow 105bound on UDP port 6868 and TCP port 6868 on IPv4 localhost and allow
106privileged access from the nnetwork 192.168/16 while redirecting 106privileged access from the network 192.168/16 while redirecting
107HTTP clients accessing / to https://my-trackersite.com/. 107HTTP clients accessing the root directory, which is not covered by the
108bittorrent tracker protocol, to https://my-trackersite.com/.
108 109
109.Dl # ./opentracker -i 192.168.0.4 -p 6868 -P 6969 -A 192.168/16 -r https://my-trackersite.com/ 110.Dl # ./opentracker -i 192.168.0.4 -p 6868 -P 6969 -A 192.168/16 -r https://my-trackersite.com/
110 111
@@ -112,14 +113,30 @@ The announce URLs are http://192.168.0.4:6868/announce and
112udp://192.168.0.4:6868/announce respectively. 113udp://192.168.0.4:6868/announce respectively.
113 114
114.Sh FILES 115.Sh FILES
115.Bl -tag -width -compact 116.Bl -tag -width indent
116.It Pa opentracker.conf 117.It Pa opentracker.conf
118The
119.Nm
117config file. 120config file.
118.El 121.El
119.Sh SEE ALSO 122.Sh SEE ALSO
120.Xr opentracker.conf 4 123.Xr opentracker.conf 4
124.Pp
125opentracker documentation
126.Lk https://erdgeist.org/arts/software/opentracker
127.Pp
128Bittorrent tracker protocol
129.Lk http://www.bittorrent.org/beps/bep_0015.html
121.Sh 130.Sh
122.Sh AUTHOR 131.Sh AUTHOR
123.An Dirk Engling 132.An Dirk Engling
124.Aq erdgeist@erdgeist.org . 133.Aq Mt erdgeist@erdgeist.org .
134.Sh LICENSE
135This software is released under the Beerware License:
136
137Permission is hereby granted, free of charge, to any person obtaining a copy of this software
138and associated documentation files (the "Software"), to deal in the Software with the following
139terms and conditions:
125 140
141If you meet the author(s) someday, and you think this software is worth it, you can buy them
142a beer in return.