yum-torrent.conf(5) — Linux manual page

NAME | SYNOPSIS | FILES | [main] OPTIONS | [timeouts] OPTIONS | AUTHOR | SEE ALSO | COLOPHON

YUM-TORRENT.CONF(5)           File Formats           YUM-TORRENT.CONF(5)

NAME         top

       yum-torrent.conf(5)

SYNOPSIS         top

       yum-torrent.conf(5) is the configuration file for yum-torrent(1)
       Yum plugin to download and seed packages via BitTorrent.  This
       configuration specifies which BitTorrent client to use, how to
       interact with it, and a number of timing parameters.  Of
       particular note is the {seed_time} substitution.  The benefit of
       using BitTorrent is partially attributable to clients contining
       to seed their torrents some time after they have completed their
       download.  yum-torrent(1) employs an exponential decay algorithm
       seeded from the hostname and torrent info_hash.  All clients will
       seed for at least seed_min After that, the number of seeders will
       decay as the probability of other hosts also needing the same set
       of packages will also decrease.

FILES         top

       /etc/yum/pluginconf.d/yum-torrent.conf

[main] OPTIONS         top

       service
              A specific relative path on the http repository where the
              pkgtorrent-service(8) is configured. See also
              pkgtorrent-service.conf(5) for more. Defaults to
              /yum/torrent_service

       client Fully qualified path to BitTorrent client that accepts a
              single positional torrent filename that will download into
              the current working directory.  Required.

       options
              Additional command line parameters passed to client on
              startup.  A substitution named {seed_time} is available.
              This is measured in seconds and can be used to instruct
              the BitTorrent client to seed for a variable time once the
              download is completed.

       complete
              The text to match anywhere from the logged stdout of the
              client signaling the package files have been downloaded.
              This allows the client to continue to run and seed the
              torrent file for others.

[timeouts] OPTIONS         top

       All the values in this section are positive integers measured in
       seconds.

       download
              The maximum time to wait for the message complete to
              appear in the log file.  If a download with the plugin
              fails for any reason yum will not find the downloaded rpm
              files in /var/cache/yum directory. It will fall back on
              the internal download mechanism.

       seed_min
              The minimum value for {seed_time}. Default 900 (15
              minutes).  It is recommended you set this to the same time
              as your configuration management interval.

       seed_max
              The maximum value for {seed_time}. Default 86400 (1 day).

       nullfile
              Delete the padding nullfiles after this time period.

       cache  At the end of each run, /var/cache/yum_torrent is
              examined. Any files not touched in this time period are
              deleted, and empty directories are removed.  Note: If yum
              is not run for an extended period, this garbage collection
              will not happen.

AUTHOR         top

       Matthew Almond <[email protected]>

SEE ALSO         top

       yum-torrent(1)

COLOPHON         top

       This page is part of the yum-utils (Yum Package Manager
       utilities) project.  Information about the project can be found
       at ⟨https://github.com/rpm-software-management/yum⟩.  It is not
       known how to report bugs for this man page; if you know, please
       send a mail to [email protected].  This page was obtained from
       the project's upstream Git repository
       ⟨https://github.com/rpm-software-management/yum-utils.git⟩ on
       2024-06-14.  (At that time, the date of the most recent commit
       that was found in the repository was 2020-03-11.)  If you
       discover any rendering problems in this HTML version of the page,
       or you believe there is a better or more up-to-date source for
       the page, or you have corrections or improvements to the
       information in this COLOPHON (which is not part of the original
       manual page), send a mail to [email protected]

                              09 MARCH 2016          YUM-TORRENT.CONF(5)

Pages that refer to this page: yum-torrent(1)yum-torrent.conf(5)