Program Options and Command

UDPT Command line options

The program use boost-program-options for command line and configuration parsing.

UDPT command is as follows:

    $ ./udpt [options]

Options:

• --help, -h: Produces a help message.
• --all-help: Displays all configuration options.
• --test, -t: Test the configuration file syntax.
• --config, -c: Sets the configuration file path. default is /etc/udpt.conf.
• --interactive, -i: (not for Windows) Doesn't start as a daemon.

UDPT Configuration

Configuration files are ini style files. Every section has key/value pairs.

[db] section

• driver: The DB section sets the database adapter that will be used. sqlite3 is currently the only supported one, and it's set by default.
• param: Parameter to pass to the database adapter. For sqlite3 this is the file the database should be stored in. You can set :memory: for in-memory database. default path is /var/lib/udpt.db.

[tracker] section

• is_dynamic: Sets if the tracker should run in dynamic mode. default is 1.
• port: UDP port the tracker should listen on. default is 6969.
• threads: Worker threads to run. default is 5.
• allow_remotes: If set to true, clients can report IPs other than the ones they are behind. default is 1.
• allow_iana_ips: Allows IANA reserved addresses to connect (192.168.0.0/16 for example). This value is good for testing/debugging, default is 0.
• announce_interval: Number of seconds to tell clients to wait before sending another announce request. default is 1800.
• cleanup_interval: Sets the interval (in seconds) to clean up the database. default is 120.

[apiserver] section

• enable: If this value is set to true, the tracker will run a HTTP RESTful server for controlling tracked torrents. default is 0.
• threads: HTTP server threads, default is 1.
• port: TCP port to listen on, default is 6969.

[logging] section

• filename: Path to log file.
• level: Log level to record; values can be debug, warning, info or error. default is warning.

[daemon] section (not for Windows)

• chdir: The working directory to set when running as a daemon.