btpd
1.0.0
Демон протокола BitTorrent
btpd — утилита для обмена файлами по сетевому протоколу BitTorrent. Он работает в режиме демона, поэтому не требует управляющего терминала или графического интерфейса. Вместо этого демон управляется btcli, его утилитой командной строки или другими программами, способными отправлять команды и запросы в управляющий сокет.
btpd состоит из следующих программ:
btpd — BitTorrent-клиент.btcli — интерфейс командной строки для btpd.btinfo — Показывает информацию из торрент-файла. Все программы принимают опцию --help .
Утилита btcli имеет несколько различных режимов работы. При запуске btcli необходимо указать одну из следующих команд:
add — Добавить торренты в btpd.del - Удалить торренты из btpd.kill - Выключить btpd.list - Список торрентов.rate — установите глобальную скорость загрузки и скачивания в КБ/с.start - Активировать торренты.stat - Отображение статистики активных торрентов.stop - отключить торренты. Чтобы начать делиться торрентом с помощью btpd, его необходимо добавить в btpd. Это делается с помощью btcli add . При добавлении торрента btpd автоматически (если вы не указали иное) начинает расшаривать торрент и докачивать недостающие данные. Каталог содержимого, который вы указываете при добавлении торрента, не обязательно должен существовать; он будет создан btpd.
Вы можете увидеть, какие торренты были добавлены в btpd, с помощью btcli list . Команда list также отображает номер каждого добавленного торрента. Это число можно использовать для указания целевого торрента для команд btcli, поэтому вам не нужно сохранять торрент-файл после его добавления.
За ходом загрузки и загрузки можно следить с помощью команды btcli stat . Команды list и stat используют следующие индикаторы для отображения состояния торрента:
+ - торрент запускается. Это может занять некоторое время, если btpd необходимо проверить содержимое этого торрента или торрента, запущенного до него.- - Торрент останавливается.I - торрент неактивен.S - btpd раздает торрент.L - btpd качает торрент. Вы можете остановить активный торрент с помощью btcli stop и, конечно же, запустить неактивный торрент с помощью btcli start .
Команду btcli del следует использовать только тогда, когда вы полностью завершили общий доступ к торренту. Команда удалит торрент и связанные с ним данные из btpd. Особенно плохая идея удалять не до конца скачанный торрент, а затем добавлять его заново, так как btpd потерял информацию о не до конца скачанных кусках и ему придется скачивать данные заново.
Чтобы завершить работу btpd, используйте btcli kill . Не забудьте прочитать справку по каждой команде btcli.
ПРИМЕЧАНИЕ. Вам понадобится только один экземпляр btpd, независимо от того, сколько торрентов вы хотите разделить.
Чтобы запустить btpd с настройками по умолчанию, вам нужно всего лишь запустить его. Однако есть много полезных опций, которые вы можете использовать. Чтобы просмотреть полный список, запустите btpd --help . Если вы не указали иное, btpd запускается с тем же набором активных торрентов, что и в последний раз, когда он был выключен.
btdp будет хранить информацию и записывать свой журнал в $HOME/.btpd . Поэтому необходимо иметь возможность писать туда во время выполнения. Вы можете указать другой каталог с помощью опции -d или переменной $BTPD_HOME .
Рекомендую указать максимальное количество загрузок. Bittorrent использует алгоритм «око за око», поэтому загрузка с хорошей скоростью позволяет скачивать. Постарайтесь найти баланс между загрузкой/исходящей пропускной способностью и количеством активных торрентов.
Запустите btpd со значениями по умолчанию для всех параметров.
# btpd
Запустите btpd и заставьте его прослушивать порт 12345, ограничьте исходящую пропускную способность до 200 КБ/с, ограничьте количество пиров до 40 и не запускайте торренты, которые были активны при последнем выключении btpd.
# btpd -p 12345 --bw-out 200 --max-peers 40 --empty-start
Отобразить список торрентов btpd, их количество, размер, статус и т. д.
# btcli list
То же, что и выше, но только для торрент 12 и my.little.torrent.
# btcli list 12 my.little.torrent
То же, что и выше, но только для активных торрентов.
# btcli list -a
То же, что и выше, но печать в пользовательском формате.
# btcli list -a -f "btcli list -f "%nt%#t%p%st%rn"
Добавьте foo.torrent с содержимым foo.torrent.d и запустите его.
# btcli add -d foo.torrent.d foo.torrent
То же, что и выше, без запуска.
# btcli add --no-start -d foo.torrent.d foo.torrent
Запустите bar.torrent и торрент №7.
# btcli start bar.torrent 7
Остановите торрент номер 7.
# btcli stop 7
Остановите все активные торренты.
# btcli stop -a
Удалите bar.torrent и связанную с ним информацию из btpd.
# btcli del bar.torrent
Отображение сводной статистики загрузки/загрузки для активных торрентов.
# btcli stat
Отображайте сводку каждые пять секунд.
# btcli stat -w 5
То же, что и выше, но также отображает индивидуальную статистику для каждого активного торрента.
# btcli stat -w 5 -i
Установите глобальную скорость загрузки на 20 КБ/с и скорость загрузки на 1 МБ/с.
# btcli rate 20K 1M
Выключите btpd.
# btcli kill
Если btpd отключился по какой-то неизвестной причине, проверьте файл журнала на предмет возможных подсказок.
У вас должна быть BSD, Linux или достаточно подобная система.
Убедитесь, что у вас установлены последние версии следующего программного обеспечения:
Вам также понадобится компилятор c99. Не старинный GCC подойдет.
Чтобы открыть руководство, расположенное в doc вам необходимо установить man-pages .
# ./configure
# make
# make install
См ./configure --help , чтобы узнать о доступных параметрах сборки, если вышеуказанное не помогло.
Расположение каталога торрентов в каталоге btpd изменилось с версии btpd 0.11. Пожалуйста, удалите каталог торрентов перед запуском более поздних версий.
Если btpd необходимо отправить трекерам стоп-сообщения перед выключением, он перейдет в режим предварительного выхода. Процесс btpd в этом режиме можно безопасно игнорировать, и он не будет мешать любому новому btpd, запущенному в том же каталоге.
К сожалению, включение IPv6 и IPv4 в btpd менее полезно, чем должно быть. Проблема в том, что на некоторых сайтах есть трекеры для обеих версий, и вполне вероятно, что версия IPv6, у которой, вероятно, меньше пиров, будет использоваться в пользу версии IPv4.
Чтобы решить эту проблему, в какой-нибудь будущей версии btpd параметры версии IP следует изменить на каждый торрент.
Если вы хотите связаться с нами, чтобы получить помощь, внести свой вклад или просто поздороваться, без колебаний заходите на наш IRC-канал #btpd на freenode.
