pkgtorrent-service(8) — Linux manual page

NAME | SYNOPSIS | USAGE | EXAMPLE | INPUT FILES | OUTPUT FILES | BUGS | AUTHOR | SEE ALSO | COLOPHON

pkgtorrent-service(8)    System Manager's Manual   pkgtorrent-service(8)

NAME         top

       pkgtorrent-service(8) Is a python WSGI web application that can
       generate BitTorrent files for binary files available from the web
       server.

SYNOPSIS         top

       The program should installed on a site local yum mirror and must
       be configured before use. See pkgtorrent-service.conf(5) for more
       information.

USAGE         top

       The primary use case for this service is implemented in
       yum-torrent(1).

       There is a secondary interface to assist with simple file
       downloads involving a single path.

EXAMPLE         top

              $ curl http://example.com/path/to/large/file > file

       can be converted to using BitTorrent with:

              $ curl http://example.com/path/torrent_service/single/path/to/large/file > file.torrent
              $ btclient file.torrent

       Note the repetition of path before the service name, and the
       addition of torrent_service/single to pass control to the single
       path mode.  Simple file mode supports simple globbing, so you can
       specify .../directory/*.foo.  If the path resolves to only one
       file, the multi-file support in the .torrent file is skipped,
       making the downloaded file easier to handle.

INPUT FILES         top

       /var/lib/torrent_service/trackers
              The service needs to include one or more BitTorrent
              tracker servers.  The format is one "announce" URL per
              line. Example: http://example.com:6969/announce This text
              file is scanned each minute for updates.

OUTPUT FILES         top

       The service makes extensive use of cache files. The files are
       relatively small. It is recommended you periodically clean these
       caches for files not used in the past month or so.

       /var/cache/torrent_service/info/input_digest
              This directory caches info_hashes for the previously
              requested path digests.  These are used with the current
              list of trackers to generate .torrent files in constant
              time.

       /var/cache/torrent_service/pieces/path/to/file/blocksize
              Every file within a torrent is represented by a list of
              SHA1 digests, one for each blocksize of the file.  The
              SHA1 list is expensive to generate.  The same binaries may
              be downloaded in different permutations by different
              clients.  The cache is invalidated if the original file
              has a different mtime or is a different size.

BUGS         top

       Single file mode should be called simple.

AUTHOR         top

       Matthew Almond <malmond@fb.com>

SEE ALSO         top

       pkgtorrent-service.conf(5)

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 man-pages@man7.org.  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 man-pages@man7.org

                              09 MARCH 2016        pkgtorrent-service(8)

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