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 gen‐
       erate 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
       2020-08-13.  (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)