---
name: "btt_infohash"
section: "8"
platform: "linux"
package: "libbttracker-utils"
version: "0.0.19+p4.2296-1"
release: "Debian 4.0 (Etch)"
platforms: ["linux"]
url: "https://new.carta.tech/btt_infohash"
---

# 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 \<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 distribution.