btt_infohash(8)

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 hexadec

imal 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 run

ning.

--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 reg

istered ("--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 hap

pens, kill the frozen btt_infohash process, shut down and restart

your tracker, and try again. (<http://bts.yi.org/cgi/bugre

port.cgi?bug=18>)

LICENSE

Copyright 2006 Tyler "Crackerjack" MacDonald

<tyler@yi.org> This is free software; you may use it under the

terms of the Apache License 2.0, included with the mod_bt distri

bution.

mod_bt/0.0.19 2006-05-26

BTT_INFOHASH(8)