Reference

btt_infohash(8)

Edit infohash data in a mod_bt tracker database

NAME

btt_infohash - Edit infohash data in a mod_bt tracker database

SYNOPSIS

  btt_infohash [--help] [--master] homedir [--verbose]
    [--delete [--force]| --create]
    [--metainfo file.torrent] [--register 0|1] [--name=name]
    [--size=size] infohash

DESCRIPTION

btt_infohash updates infohash records in a mod_bt tracker database. Infohash details may be specified on the commandline, or the information can be taken from a metainfo (.torrent) file.

USAGE

btt_infohash can be run in one of two ways:

* Infohash information specified on the commandline

When running in this mode, you should specify the tracker's home directory, the infohash string (a 40-byte hexadecimal string, eg; "042c1a867907b88f351d1112f4ceb900d5afcb3e"), and the torrent's name and/or size ("--name" and "--size" options).

* Infohash information read from a metainfo file

When running in this mode, you should specify the tracker's home directory, and a "--metainfo" option specifying the path to the metainfo (.torrent) file you wish to obtain the infohash, filename, and file size from.

Either way, there are several other useful command-line options:

--master

Connect to the tracker database as it's master. You should only use this option if there is not a mod_bt tracker running.

--verbose

Display the infohash's details after updating them.

--delete

Instead of updating an infohash, delete it from the tracker's database.

--force

This option should only be used with "--delete". It forces the infohash to be removed from the database even if there are still peers attached to it.

--register [0|1]

This option specifies that the infohash should be registered ("--register 1") or unregistered ("--register 0") in the tracker database.

BUGS

Occasionally, btt_infohash has been seen causing a database deadlock. When this happens, the tracker is frozen and unable to handle requests until the deadlock clears. If this happens, kill the frozen btt_infohash process, shut down and restart your tracker, and try again. (<http://bts.yi.org/cgi/bugreport.cgi?bug=18>)

LICENSE

Copyright 2006 Tyler "Crackerjack" MacDonald <[email protected]> This is free software; you may use it under the terms of the Apache License 2.0, included with the mod_bt distribution.