From 6407f8ccbadb071fa5a69986b3ec549f2aec682e Mon Sep 17 00:00:00 2001 From: Tynan Ford Date: Fri, 9 Jan 2026 16:57:34 -0800 Subject: [PATCH] update recceiver docs to remove passing poll reactor --- server/README.md | 31 +++++++++++++++++-------------- 1 file changed, 17 insertions(+), 14 deletions(-) diff --git a/server/README.md b/server/README.md index 239c3e0a..1fd90eaf 100644 --- a/server/README.md +++ b/server/README.md @@ -38,34 +38,37 @@ Setup sqlite3 test.db -init recceiver.sqlite3 .exit ``` -Run (for twistd <= 16.0.3) +Run (for twistd >= 16.0.4) ```bash -twistd -n recceiver -f demo.conf +PYTHONPATH=$PWD twistd --nodaemon recceiver -f demo.conf ``` -or (see below for discussion) +At some point 'twistd' stopped implicitly searching the working directory. + +May need to uncomment `addrlist = 127.255.255.255:5049` in demo.conf +when doing local testing on a computer w/ a firewall. + +### Older Recceiver/Twistd Versions + +For recceiver <= 1.6, passing the poll reactor was required. See [here](https://github.com/ChannelFinder/recsync/issues/132) for more discussion. ```bash -twistd -r poll -n recceiver -f demo.conf +PYTHONPATH=$PWD twistd -r poll --nodaemon recceiver -f demo.conf ``` - -Run (for twistd >= 16.0.4) +For older versions of twistd (<= 16.0.3), run ```bash -PYTHONPATH=$PWD twistd -r poll -n recceiver -f demo.conf +twistd --nodaemon recceiver -f demo.conf ``` -At some point 'twistd' stopped implicitly searching the working directory. +or (see below for discussion) -May need to uncomment `addrlist = 127.255.255.255:5049` in demo.conf -when doing local testing on a computer w/ a firewall. +```bash +twistd -r poll --nodaemon recceiver -f demo.conf +``` Twisted 14.0.2 seems to have a problem with the epoll() reactor which raises 'IOError: [Errno 2] No such file or directory' during startup. Try with the poll() reactor. - -```bash -twistd -r poll -n recceiver -f demo.conf -```