---
name: "btt_xml2db"
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_xml2db"
---

# btt\_xml2db(8)

Import infohash records from an XML document into a tracker database

## NAME

btt\_xml2db - Import infohash records from an XML document into a tracker database

## SYNOPSIS

```
    btt_xml2db [--master] [--verbose] backup.xml /path/to/tracker
```

## DESCRIPTION

btt\_xml2db reads the XML document specified on the commandline and imports any `"Infohash"` records found into a mod\_bt database. If any of the specified infohashes already exist in the tracker database, they will be replaced. The XML document should be one that was generated with btt\_db2xml.

The "Peers", "Seeds", and "Shields" counts from the XML document are discarded; these fields are instead set to the counts of who is actually connected to the tracker, or "0" if this is a new infohash.

btt\_xml2db can be used to create a new tracker database, like so:

```
    mkdir /tmp/new_database
    btt_xml2db --master --verbose backup.xml /tmp/new_database
```

## SWITCHES

- \--master

  Connect to the database as it's master; you should use this option only if no other processes are connected to the database.

- \--verbose

  Print the infohash string and filename of each infohash as it's being inserted into the database.

- \--help

  Displays brief usage instructions.

## BUGS

The path to the tracker must be an **absolute** path, relative paths are not permitted. This is a limitation of Berkeley DB that will be addressed in a future version.

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

## SEE ALSO

btt\_db2xml