TRACKERD(8)             FreeBSD System Manager's Manual            TRACKERD(8)

NAME
     trackerd -- Wired tracker

SYNOPSIS
     trackerd [-46Dllhtuv] [-d server_root] [-f config_file] [-i log_lines]
              [-L log_file] [-s syslog_facility]

DESCRIPTION
     trackerd is the Wired tracker program, implementing the Wired Tracker
     protocol. It is designed to run as a standalone server. On startup,
     trackerd will read the specified configuration file, bind to the speci-
     fied ports and listen for connections. It is recommended that
     trackerdctl(1) is used to control the starting and stopping of trackerd.

     The options are as follows:

     -4      Listen on IPv4 addresses only.

     -6      Listen on IPv6 addresses only.

     -D      Do not daemonize.  trackerd will run in the foreground and log to
             stderr.

     -d server_root
             Sets the server root path.  trackerd will attempt to locate its
             required files under this directory, and chroot(2) to it unless
             -u is specified. The default value is set to the path trackerd
             was originally installed as, so it will most often not need to be
             set.

     -f config_file
             Sets the path of the configuration file, relative to server_root.
             The default is etc/trackerd.conf.

     -h      Displays a brief help message and exits.

     -i log_lines
             When logging to a file using -L, limit the number of lines the
             log may occupy to log_lines.

     -L log_file
             Sets the path of the file that trackerd will log to. If it is not
             set, trackerd will instead log via syslog(3).

     -l      Increases the log level. Without it, logging is limited to con-
             nects and disconnects. Used once, server registrations are also
             logged. Used three times, logs full debug information.

     -s syslog_facility
             Sets the syslog(3) facility to use for logging. See
             syslog.conf(5) for information on possible values. The default
             value is daemon.

     -t      Runs a configuration syntax test and exits.

     -u      By default trackerd will chroot(2) to the server_root path. This
             flag disables this behaviour. As a result of the default secure
             behaviour, trackerd cannot access any files outside server_root.

     -v      Displays version information and exits.

CONFIGURATION FILE
     trackerd reads configuration data from config_file.  The file format and
     configuration options are described in trackerd.conf(5).

FILES
     The locations of these files can be configured in config_file, this list
     describes the default locations. All files are contained within the
     server_root path.

     banlist
             A newline separated list of banned IPs. Subnet notation
             (192.168.0.0/16 or 192.168.0.0/255.255.0.0) and wildcards
             (192.168.*.*) are recognized.

     categories
             A file containing a newline separated list of tracker categories.
             Categories work like file system paths, and can be configured in
             a directory-like structure:

                   category
                   category/subcategory 1
                   category/subcategory 2

     etc/certificate.pem
             The OpenSSL certificate as described in req(1).

     servers
             A file containing a list of all currently registered servers. Its
             format is private. Do not write to this file, the tracker will
             maintain it. If it exists at startup, the tracker will enter all
             the servers in it in its initial server list.

     etc/trackerd.conf
             Configuration data for trackerd.  The file format and configura-
             tion options are described in trackerd.conf(5).

     trackerd.status
             The status for the daemon. It is used by trackerdctl(8) and oth-
             ers to display some statistics. The file is a series of space
             separated numbers with the following meanings:

                   time of startup
                   number of online server
                   total number of clients
                   number of online users
                   number of online files
                   size of online files

AUTHORS
     trackerd and the Wired Tracker protocol were developed by Axel Andersson,
     Zanka Software.

SEE ALSO
     trackerdctl(1), trackerd.conf(5)

FreeBSD 6.2                      Mar 23, 2006                      FreeBSD 6.2