camenduru commited on Nov 3, 2023

Commit

51101ce

1 Parent(s): 0f82f07

thanks to aria2 ❤

Browse files

This view is limited to 50 files because it contains too many changes. See raw diff

Files changed (50) hide show

.gitattributes +1 -0
bin/aria2c +3 -0
share/doc/aria2/README +1 -0
share/doc/aria2/README.html +904 -0
share/doc/aria2/README.rst +565 -0
share/doc/aria2/bash_completion/README.txt +11 -0
share/doc/aria2/bash_completion/aria2c +90 -0
share/doc/aria2/xmlrpc/README.txt +3 -0
share/doc/aria2/xmlrpc/aria2mon +157 -0
share/doc/aria2/xmlrpc/aria2rpc +427 -0
share/locale/ar/LC_MESSAGES/aria2.mo +0 -0
share/locale/bg/LC_MESSAGES/aria2.mo +0 -0
share/locale/bn/LC_MESSAGES/aria2.mo +0 -0
share/locale/ca/LC_MESSAGES/aria2.mo +0 -0
share/locale/da/LC_MESSAGES/aria2.mo +0 -0
share/locale/de/LC_MESSAGES/aria2.mo +0 -0
share/locale/el/LC_MESSAGES/aria2.mo +0 -0
share/locale/en@boldquot/LC_MESSAGES/aria2.mo +0 -0
share/locale/en@quot/LC_MESSAGES/aria2.mo +0 -0
share/locale/es/LC_MESSAGES/aria2.mo +0 -0
share/locale/fa/LC_MESSAGES/aria2.mo +0 -0
share/locale/fi/LC_MESSAGES/aria2.mo +0 -0
share/locale/fil/LC_MESSAGES/aria2.mo +0 -0
share/locale/fr/LC_MESSAGES/aria2.mo +0 -0
share/locale/he/LC_MESSAGES/aria2.mo +0 -0
share/locale/hr/LC_MESSAGES/aria2.mo +0 -0
share/locale/hu/LC_MESSAGES/aria2.mo +0 -0
share/locale/id/LC_MESSAGES/aria2.mo +0 -0
share/locale/it/LC_MESSAGES/aria2.mo +0 -0
share/locale/ja/LC_MESSAGES/aria2.mo +0 -0
share/locale/kk/LC_MESSAGES/aria2.mo +0 -0
share/locale/ko/LC_MESSAGES/aria2.mo +0 -0
share/locale/ms/LC_MESSAGES/aria2.mo +0 -0
share/locale/nb/LC_MESSAGES/aria2.mo +0 -0
share/locale/nl/LC_MESSAGES/aria2.mo +0 -0
share/locale/nn/LC_MESSAGES/aria2.mo +0 -0
share/locale/oc/LC_MESSAGES/aria2.mo +0 -0
share/locale/pl/LC_MESSAGES/aria2.mo +0 -0
share/locale/pt/LC_MESSAGES/aria2.mo +0 -0
share/locale/pt_BR/LC_MESSAGES/aria2.mo +0 -0
share/locale/ro/LC_MESSAGES/aria2.mo +0 -0
share/locale/ru/LC_MESSAGES/aria2.mo +0 -0
share/locale/sk/LC_MESSAGES/aria2.mo +0 -0
share/locale/sr/LC_MESSAGES/aria2.mo +0 -0
share/locale/sv/LC_MESSAGES/aria2.mo +0 -0
share/locale/th/LC_MESSAGES/aria2.mo +0 -0
share/locale/tr/LC_MESSAGES/aria2.mo +0 -0
share/locale/uk/LC_MESSAGES/aria2.mo +0 -0
share/locale/vi/LC_MESSAGES/aria2.mo +0 -0
share/locale/zh_CN/LC_MESSAGES/aria2.mo +0 -0

.gitattributes CHANGED Viewed

@@ -33,3 +33,4 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text

 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+bin/aria2c filter=lfs diff=lfs merge=lfs -text

bin/aria2c ADDED Viewed

	@@ -0,0 +1,3 @@

+version https://git-lfs.github.com/spec/v1
+oid sha256:4ff1c2ec1b4be76ebf602969a4416b7b6e6ae30955ef9d2bfea579330421d55a
+size 82219952

share/doc/aria2/README ADDED Viewed

	@@ -0,0 +1 @@


1	+ See README.rst

share/doc/aria2/README.html ADDED Viewed

	@@ -0,0 +1,904 @@

+<?xml version="1.0" encoding="utf-8" ?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+<meta name="generator" content="Docutils 0.16: http://docutils.sourceforge.net/" />
+<title>aria2 - The ultra fast download utility</title>
+<style type="text/css">
+/*
+:Author: David Goodger (goodger@python.org)
+:Id: $Id: html4css1.css 7952 2016-07-26 18:15:59Z milde $
+:Copyright: This stylesheet has been placed in the public domain.
+Default cascading style sheet for the HTML output of Docutils.
+See http://docutils.sf.net/docs/howto/html-stylesheets.html for how to
+customize this style sheet.
+*/
+/* used to remove borders from tables and images */
+.borderless, table.borderless td, table.borderless th {
+  border: 0 }
+table.borderless td, table.borderless th {
+  /* Override padding for "table.docutils td" with "! important".
+     The right padding separates the table cells. */
+  padding: 0 0.5em 0 0 ! important }
+.first {
+  /* Override more specific margin styles with "! important". */
+  margin-top: 0 ! important }
+.last, .with-subtitle {
+  margin-bottom: 0 ! important }
+.hidden {
+  display: none }
+.subscript {
+  vertical-align: sub;
+  font-size: smaller }
+.superscript {
+  vertical-align: super;
+  font-size: smaller }
+a.toc-backref {
+  text-decoration: none ;
+  color: black }
+blockquote.epigraph {
+  margin: 2em 5em ; }
+dl.docutils dd {
+  margin-bottom: 0.5em }
+object[type="image/svg+xml"], object[type="application/x-shockwave-flash"] {
+  overflow: hidden;
+}
+/* Uncomment (and remove this text!) to get bold-faced definition list terms
+dl.docutils dt {
+  font-weight: bold }
+*/
+div.abstract {
+  margin: 2em 5em }
+div.abstract p.topic-title {
+  font-weight: bold ;
+  text-align: center }
+div.admonition, div.attention, div.caution, div.danger, div.error,
+div.hint, div.important, div.note, div.tip, div.warning {
+  margin: 2em ;
+  border: medium outset ;
+  padding: 1em }
+div.admonition p.admonition-title, div.hint p.admonition-title,
+div.important p.admonition-title, div.note p.admonition-title,
+div.tip p.admonition-title {
+  font-weight: bold ;
+  font-family: sans-serif }
+div.attention p.admonition-title, div.caution p.admonition-title,
+div.danger p.admonition-title, div.error p.admonition-title,
+div.warning p.admonition-title, .code .error {
+  color: red ;
+  font-weight: bold ;
+  font-family: sans-serif }
+/* Uncomment (and remove this text!) to get reduced vertical space in
+   compound paragraphs.
+div.compound .compound-first, div.compound .compound-middle {
+  margin-bottom: 0.5em }
+div.compound .compound-last, div.compound .compound-middle {
+  margin-top: 0.5em }
+*/
+div.dedication {
+  margin: 2em 5em ;
+  text-align: center ;
+  font-style: italic }
+div.dedication p.topic-title {
+  font-weight: bold ;
+  font-style: normal }
+div.figure {
+  margin-left: 2em ;
+  margin-right: 2em }
+div.footer, div.header {
+  clear: both;
+  font-size: smaller }
+div.line-block {
+  display: block ;
+  margin-top: 1em ;
+  margin-bottom: 1em }
+div.line-block div.line-block {
+  margin-top: 0 ;
+  margin-bottom: 0 ;
+  margin-left: 1.5em }
+div.sidebar {
+  margin: 0 0 0.5em 1em ;
+  border: medium outset ;
+  padding: 1em ;
+  background-color: #ffffee ;
+  width: 40% ;
+  float: right ;
+  clear: right }
+div.sidebar p.rubric {
+  font-family: sans-serif ;
+  font-size: medium }
+div.system-messages {
+  margin: 5em }
+div.system-messages h1 {
+  color: red }
+div.system-message {
+  border: medium outset ;
+  padding: 1em }
+div.system-message p.system-message-title {
+  color: red ;
+  font-weight: bold }
+div.topic {
+  margin: 2em }
+h1.section-subtitle, h2.section-subtitle, h3.section-subtitle,
+h4.section-subtitle, h5.section-subtitle, h6.section-subtitle {
+  margin-top: 0.4em }
+h1.title {
+  text-align: center }
+h2.subtitle {
+  text-align: center }
+hr.docutils {
+  width: 75% }
+img.align-left, .figure.align-left, object.align-left, table.align-left {
+  clear: left ;
+  float: left ;
+  margin-right: 1em }
+img.align-right, .figure.align-right, object.align-right, table.align-right {
+  clear: right ;
+  float: right ;
+  margin-left: 1em }
+img.align-center, .figure.align-center, object.align-center {
+  display: block;
+  margin-left: auto;
+  margin-right: auto;
+}
+table.align-center {
+  margin-left: auto;
+  margin-right: auto;
+}
+.align-left {
+  text-align: left }
+.align-center {
+  clear: both ;
+  text-align: center }
+.align-right {
+  text-align: right }
+/* reset inner alignment in figures */
+div.align-right {
+  text-align: inherit }
+/* div.align-center * { */
+/*   text-align: left } */
+.align-top    {
+  vertical-align: top }
+.align-middle {
+  vertical-align: middle }
+.align-bottom {
+  vertical-align: bottom }
+ol.simple, ul.simple {
+  margin-bottom: 1em }
+ol.arabic {
+  list-style: decimal }
+ol.loweralpha {
+  list-style: lower-alpha }
+ol.upperalpha {
+  list-style: upper-alpha }
+ol.lowerroman {
+  list-style: lower-roman }
+ol.upperroman {
+  list-style: upper-roman }
+p.attribution {
+  text-align: right ;
+  margin-left: 50% }
+p.caption {
+  font-style: italic }
+p.credits {
+  font-style: italic ;
+  font-size: smaller }
+p.label {
+  white-space: nowrap }
+p.rubric {
+  font-weight: bold ;
+  font-size: larger ;
+  color: maroon ;
+  text-align: center }
+p.sidebar-title {
+  font-family: sans-serif ;
+  font-weight: bold ;
+  font-size: larger }
+p.sidebar-subtitle {
+  font-family: sans-serif ;
+  font-weight: bold }
+p.topic-title {
+  font-weight: bold }
+pre.address {
+  margin-bottom: 0 ;
+  margin-top: 0 ;
+  font: inherit }
+pre.literal-block, pre.doctest-block, pre.math, pre.code {
+  margin-left: 2em ;
+  margin-right: 2em }
+pre.code .ln { color: grey; } /* line numbers */
+pre.code, code { background-color: #eeeeee }
+pre.code .comment, code .comment { color: #5C6576 }
+pre.code .keyword, code .keyword { color: #3B0D06; font-weight: bold }
+pre.code .literal.string, code .literal.string { color: #0C5404 }
+pre.code .name.builtin, code .name.builtin { color: #352B84 }
+pre.code .deleted, code .deleted { background-color: #DEB0A1}
+pre.code .inserted, code .inserted { background-color: #A3D289}
+span.classifier {
+  font-family: sans-serif ;
+  font-style: oblique }
+span.classifier-delimiter {
+  font-family: sans-serif ;
+  font-weight: bold }
+span.interpreted {
+  font-family: sans-serif }
+span.option {
+  white-space: nowrap }
+span.pre {
+  white-space: pre }
+span.problematic {
+  color: red }
+span.section-subtitle {
+  /* font-size relative to parent (h1..h6 element) */
+  font-size: 80% }
+table.citation {
+  border-left: solid 1px gray;
+  margin-left: 1px }
+table.docinfo {
+  margin: 2em 4em }
+table.docutils {
+  margin-top: 0.5em ;
+  margin-bottom: 0.5em }
+table.footnote {
+  border-left: solid 1px black;
+  margin-left: 1px }
+table.docutils td, table.docutils th,
+table.docinfo td, table.docinfo th {
+  padding-left: 0.5em ;
+  padding-right: 0.5em ;
+  vertical-align: top }
+table.docutils th.field-name, table.docinfo th.docinfo-name {
+  font-weight: bold ;
+  text-align: left ;
+  white-space: nowrap ;
+  padding-left: 0 }
+/* "booktabs" style (no vertical lines) */
+table.docutils.booktabs {
+  border: 0px;
+  border-top: 2px solid;
+  border-bottom: 2px solid;
+  border-collapse: collapse;
+}
+table.docutils.booktabs * {
+  border: 0px;
+}
+table.docutils.booktabs th {
+  border-bottom: thin solid;
+  text-align: left;
+}
+h1 tt.docutils, h2 tt.docutils, h3 tt.docutils,
+h4 tt.docutils, h5 tt.docutils, h6 tt.docutils {
+  font-size: 100% }
+ul.auto-toc {
+  list-style-type: none }
+</style>
+</head>
+<body>
+<div class="document" id="aria2-the-ultra-fast-download-utility">
+<h1 class="title">aria2 - The ultra fast download utility</h1>
+<div class="section" id="disclaimer">
+<h1>Disclaimer</h1>
+<p>This program comes with no warranty.
+You must use this program at your own risk.</p>
+</div>
+<div class="section" id="introduction">
+<h1>Introduction</h1>
+<p>aria2 is a utility for downloading files. The supported protocols are
+HTTP(S), FTP, SFTP, BitTorrent, and Metalink. aria2 can download a
+file from multiple sources/protocols and tries to utilize your maximum
+download bandwidth. It supports downloading a file from
+HTTP(S)/FTP/SFTP and BitTorrent at the same time, while the data
+downloaded from HTTP(S)/FTP/SFTP is uploaded to the BitTorrent
+swarm. Using Metalink's chunk checksums, aria2 automatically validates
+chunks of data while downloading a file like BitTorrent.</p>
+<p>The project page is located at <a class="reference external" href="https://aria2.github.io/">https://aria2.github.io/</a>.</p>
+<p>See <a class="reference external" href="https://aria2.github.io/manual/en/html/">aria2 Online Manual</a> (<a class="reference external" href="https://aria2.github.io/manual/ru/html/">Russian translation</a>, <a class="reference external" href="https://aria2.github.io/manual/pt/html/">Portuguese
+translation</a>) to learn
+how to use aria2.</p>
+</div>
+<div class="section" id="features">
+<h1>Features</h1>
+<p>Here is a list of features:</p>
+<ul class="simple">
+<li>Command-line interface</li>
+<li>Download files through HTTP(S)/FTP/SFTP/BitTorrent</li>
+<li>Segmented downloading</li>
+<li>Metalink version 4 (RFC 5854) support(HTTP/FTP/SFTP/BitTorrent)</li>
+<li>Metalink version 3.0 support(HTTP/FTP/SFTP/BitTorrent)</li>
+<li>Metalink/HTTP (RFC 6249) support</li>
+<li>HTTP/1.1 implementation</li>
+<li>HTTP Proxy support</li>
+<li>HTTP BASIC authentication support</li>
+<li>HTTP Proxy authentication support</li>
+<li>Well-known environment variables for proxy: <tt class="docutils literal">http_proxy</tt>,
+<tt class="docutils literal">https_proxy</tt>, <tt class="docutils literal">ftp_proxy</tt>, <tt class="docutils literal">all_proxy</tt> and <tt class="docutils literal">no_proxy</tt></li>
+<li>HTTP gzip, deflate content encoding support</li>
+<li>Verify peer using given trusted CA certificate in HTTPS</li>
+<li>Client certificate authentication in HTTPS</li>
+<li>Chunked transfer encoding support</li>
+<li>Load Cookies from file using the Firefox3 format, Chromium/Google Chrome
+and the Mozilla/Firefox
+(1.x/2.x)/Netscape format.</li>
+<li>Save Cookies in the Mozilla/Firefox (1.x/2.x)/Netscape format.</li>
+<li>Custom HTTP Header support</li>
+<li>Persistent Connections support</li>
+<li>FTP/SFTP through HTTP Proxy</li>
+<li>Download/Upload speed throttling</li>
+<li>BitTorrent extensions: Fast extension, DHT, PEX, MSE/PSE,
+Multi-Tracker, UDP tracker</li>
+<li>BitTorrent <a class="reference external" href="http://getright.com/seedtorrent.html">WEB-Seeding</a>.
+aria2 requests chunks more than piece size to reduce the request
+overhead. It also supports pipelined requests with piece size.</li>
+<li>BitTorrent Local Peer Discovery</li>
+<li>Rename/change the directory structure of BitTorrent downloads
+completely</li>
+<li>JSON-RPC (over HTTP and WebSocket)/XML-RPC interface</li>
+<li>Run as a daemon process</li>
+<li>Selective download in multi-file torrent/Metalink</li>
+<li>Chunk checksum validation in Metalink</li>
+<li>Can disable segmented downloading in Metalink</li>
+<li>Netrc support</li>
+<li>Configuration file support</li>
+<li>Download URIs found in a text file or stdin and the destination
+directory and output file name can be specified optionally</li>
+<li>Parameterized URI support</li>
+<li>IPv6 support with Happy Eyeballs</li>
+<li>Disk cache to reduce disk activity</li>
+</ul>
+</div>
+<div class="section" id="versioning-and-release-schedule">
+<h1>Versioning and release schedule</h1>
+<p>We use 3 numbers for aria2 version: MAJOR.MINOR.PATCH.  We will ship
+MINOR update on 15th of every month.  We may skip a release if we have
+no changes since the last release.  The feature and documentation
+freeze happens 10 days before the release day (5th day of the month)
+for translation teams.  We will raise an issue about the upcoming
+release around that day.</p>
+<p>We may release PATCH releases between regular releases if we have
+security issues.</p>
+<p>MAJOR version will stay at 1 for the time being.</p>
+</div>
+<div class="section" id="how-to-get-source-code">
+<h1>How to get source code</h1>
+<p>We maintain the source code at Github:
+<a class="reference external" href="https://github.com/aria2/aria2">https://github.com/aria2/aria2</a></p>
+<p>To get the latest source code, run following command:</p>
+<pre class="literal-block">
+$ git clone https://github.com/aria2/aria2.git
+</pre>
+<p>This will create aria2 directory in your current directory and source
+files are stored there.</p>
+</div>
+<div class="section" id="dependency">
+<h1>Dependency</h1>
+<table border="1" class="docutils">
+<colgroup>
+<col width="35%" />
+<col width="65%" />
+</colgroup>
+<thead valign="bottom">
+<tr><th class="head">features</th>
+<th class="head">dependency</th>
+</tr>
+</thead>
+<tbody valign="top">
+<tr><td>HTTPS</td>
+<td>OSX or GnuTLS or OpenSSL or Windows</td>
+</tr>
+<tr><td>SFTP</td>
+<td>libssh2</td>
+</tr>
+<tr><td>BitTorrent</td>
+<td>None. Optional: libnettle+libgmp or libgcrypt
+or OpenSSL (see note)</td>
+</tr>
+<tr><td>Metalink</td>
+<td>libxml2 or Expat.</td>
+</tr>
+<tr><td>Checksum</td>
+<td>None. Optional: OSX or libnettle or libgcrypt
+or OpenSSL or Windows (see note)</td>
+</tr>
+<tr><td>gzip, deflate in HTTP</td>
+<td>zlib</td>
+</tr>
+<tr><td>Async DNS</td>
+<td>C-Ares</td>
+</tr>
+<tr><td>Firefox3/Chromium cookie</td>
+<td>libsqlite3</td>
+</tr>
+<tr><td>XML-RPC</td>
+<td>libxml2 or Expat.</td>
+</tr>
+<tr><td>JSON-RPC over WebSocket</td>
+<td>libnettle or libgcrypt or OpenSSL</td>
+</tr>
+</tbody>
+</table>
+<div class="admonition note">
+<p class="first admonition-title">Note</p>
+<p class="last">libxml2 has precedence over Expat if both libraries are installed.
+If you prefer Expat, run configure with <tt class="docutils literal"><span class="pre">--without-libxml2</span></tt>.</p>
+</div>
+<div class="admonition note">
+<p class="first admonition-title">Note</p>
+<p>On Apple OSX the OS-level SSL/TLS support will be preferred. Hence
+neither GnuTLS nor OpenSSL are required on that platform. If you'd
+like to disable this behavior, run configure with
+<tt class="docutils literal"><span class="pre">--without-appletls</span></tt>.</p>
+<p>GnuTLS has precedence over OpenSSL if both libraries are installed.
+If you prefer OpenSSL, run configure with <tt class="docutils literal"><span class="pre">--without-gnutls</span></tt>
+<tt class="docutils literal"><span class="pre">--with-openssl</span></tt>.</p>
+<p class="last">On Windows there is SSL implementation available that is based on
+the native Windows SSL capabilities (Schannel) and it will be
+preferred.  Hence neither GnuTLS nor OpenSSL are required on that
+platform.  If you'd like to disable this behavior, run configure
+with <tt class="docutils literal"><span class="pre">--without-wintls</span></tt>.</p>
+</div>
+<div class="admonition note">
+<p class="first admonition-title">Note</p>
+<p>On Apple OSX the OS-level checksum support will be preferred,
+unless aria2 is configured with <tt class="docutils literal"><span class="pre">--without-appletls</span></tt>.</p>
+<p>libnettle has precedence over libgcrypt if both libraries are
+installed.  If you prefer libgcrypt, run configure with
+<tt class="docutils literal"><span class="pre">--without-libnettle</span> <span class="pre">--with-libgcrypt</span></tt>. If OpenSSL is selected over
+GnuTLS, neither libnettle nor libgcrypt will be used.</p>
+<p>If none of the optional dependencies are installed, an internal
+implementation that only supports md5 and sha1 will be used.</p>
+<p class="last">On Windows there is SSL implementation available that is based on
+the native Windows capabilities and it will be preferred, unless
+aria2 is configured with <tt class="docutils literal"><span class="pre">--without-wintls</span></tt>.</p>
+</div>
+<p>A user can have one of the following configurations for SSL and crypto
+libraries:</p>
+<ul class="simple">
+<li>OpenSSL</li>
+<li>GnuTLS + libgcrypt</li>
+<li>GnuTLS + libnettle</li>
+<li>Apple TLS (OSX only)</li>
+<li>Windows TLS (Windows only)</li>
+</ul>
+<p>You can disable BitTorrent and Metalink support by providing
+<tt class="docutils literal"><span class="pre">--disable-bittorrent</span></tt> and <tt class="docutils literal"><span class="pre">--disable-metalink</span></tt> to the configure
+script respectively.</p>
+<p>In order to enable async DNS support, you need c-ares.</p>
+<ul class="simple">
+<li>c-ares: <a class="reference external" href="http://c-ares.haxx.se/">http://c-ares.haxx.se/</a></li>
+</ul>
+</div>
+<div class="section" id="how-to-build">
+<h1>How to build</h1>
+<p>aria2 is primarily written in C++. Initially it was written based on
+C++98/C++03 standard features. We are now migrating aria2 to C++11
+standard. The current source code requires C++11 aware compiler. For
+well-known compilers, such as g++ and clang, the <tt class="docutils literal"><span class="pre">-std=c++11</span></tt> or
+<tt class="docutils literal"><span class="pre">-std=c++0x</span></tt> flag must be supported.</p>
+<p>In order to build aria2 from the source package, you need following
+development packages (package name may vary depending on the
+distribution you use):</p>
+<ul class="simple">
+<li>libgnutls-dev    (Required for HTTPS, BitTorrent, Checksum support)</li>
+<li>nettle-dev       (Required for BitTorrent, Checksum support)</li>
+<li>libgmp-dev       (Required for BitTorrent)</li>
+<li>libssh2-1-dev    (Required for SFTP support)</li>
+<li>libc-ares-dev    (Required for async DNS support)</li>
+<li>libxml2-dev      (Required for Metalink support)</li>
+<li>zlib1g-dev       (Required for gzip, deflate decoding support in HTTP)</li>
+<li>libsqlite3-dev   (Required for Firefox3/Chromium cookie support)</li>
+<li>pkg-config       (Required to detect installed libraries)</li>
+</ul>
+<p>You can use libgcrypt-dev instead of nettle-dev and libgmp-dev:</p>
+<ul class="simple">
+<li>libgpg-error-dev (Required for BitTorrent, Checksum support)</li>
+<li>libgcrypt-dev    (Required for BitTorrent, Checksum support)</li>
+</ul>
+<p>You can use libssl-dev instead of
+libgnutls-dev, nettle-dev, libgmp-dev, libgpg-error-dev and libgcrypt-dev:</p>
+<ul class="simple">
+<li>libssl-dev       (Required for HTTPS, BitTorrent, Checksum support)</li>
+</ul>
+<p>You can use libexpat1-dev instead of libxml2-dev:</p>
+<ul class="simple">
+<li>libexpat1-dev    (Required for Metalink support)</li>
+</ul>
+<p>On Fedora you need the following packages: gcc, gcc-c++, kernel-devel,
+libgcrypt-devel, libxml2-devel, openssl-devel, gettext-devel, cppunit</p>
+<p>If you downloaded source code from git repository, you have to install
+following packages to get autoconf macros:</p>
+<ul class="simple">
+<li>libxml2-dev</li>
+<li>libcppunit-dev</li>
+<li>autoconf</li>
+<li>automake</li>
+<li>autotools-dev</li>
+<li>autopoint</li>
+<li>libtool</li>
+</ul>
+<p>And run following command to generate configure script and other files
+necessary to build the program:</p>
+<pre class="literal-block">
+$ autoreconf -i
+</pre>
+<p>Also you need <a class="reference external" href="http://sphinx-doc.org/">Sphinx</a> to build man page.</p>
+<p>If you are building aria2 for Mac OS X, take a look at
+the makerelease-osx.mk GNU Make makefile.</p>
+<p>The quickest way to build aria2 is first run configure script:</p>
+<pre class="literal-block">
+$ ./configure
+</pre>
+<p>To build statically linked aria2, use <tt class="docutils literal">ARIA2_STATIC=yes</tt>
+command-line option:</p>
+<pre class="literal-block">
+$ ./configure ARIA2_STATIC=yes
+</pre>
+<p>After configuration is done, run <tt class="docutils literal">make</tt> to compile the program:</p>
+<pre class="literal-block">
+$ make
+</pre>
+<p>See <a class="reference internal" href="#cross-compiling-windows-binary">Cross-compiling Windows binary</a> to create a Windows binary.
+See <a class="reference internal" href="#cross-compiling-android-binary">Cross-compiling Android binary</a> to create an Android binary.</p>
+<p>The configure script checks available libraries and enables as many
+features as possible except for experimental features not enabled by
+default.</p>
+<p>Since 1.1.0, aria2 checks the certificate of HTTPS servers by default.
+If you build with OpenSSL or the recent version of GnuTLS which has
+<tt class="docutils literal">gnutls_certificate_set_x509_system_trust()</tt> function and the
+library is properly configured to locate the system-wide CA
+certificates store, aria2 will automatically load those certificates
+at the startup. If it is not the case, I recommend to supply the path
+to the CA bundle file. For example, in Debian the path to CA bundle
+file is '/etc/ssl/certs/ca-certificates.crt' (in ca-certificates
+package). This may vary depending on your distribution. You can give
+it to configure script using <tt class="docutils literal"><span class="pre">--with-ca-bundle</span> option</tt>:</p>
+<pre class="literal-block">
+$ ./configure --with-ca-bundle='/etc/ssl/certs/ca-certificates.crt'
+$ make
+</pre>
+<p>Without <tt class="docutils literal"><span class="pre">--with-ca-bundle</span></tt> option, you will encounter the error when
+accessing HTTPS servers because the certificate cannot be verified
+without CA bundle. In such case, you can specify the CA bundle file
+using aria2's <tt class="docutils literal"><span class="pre">--ca-certificate</span></tt> option.  If you don't have CA bundle
+file installed, then the last resort is disable the certificate
+validation using <tt class="docutils literal"><span class="pre">--check-certificate=false</span></tt>.</p>
+<p>Using the native OSX (AppleTLS) and/or Windows (WinTLS) implementation
+will automatically use the system certificate store, so
+<tt class="docutils literal"><span class="pre">--with-ca-bundle</span></tt> is not necessary and will be ignored when using
+these implementations.</p>
+<p>By default, the bash_completion file named <tt class="docutils literal">aria2c</tt> is installed to
+the directory <tt class="docutils literal">$prefix/share/doc/aria2/bash_completion</tt>.  To change
+the install directory of the file, use <tt class="docutils literal"><span class="pre">--with-bashcompletiondir</span></tt>
+option.</p>
+<p>After a <tt class="docutils literal">make</tt> the executable is located at <tt class="docutils literal">src/aria2c</tt>.</p>
+<p>aria2 uses CppUnit for automated unit testing. To run the unit test:</p>
+<pre class="literal-block">
+$ make check
+</pre>
+</div>
+<div class="section" id="cross-compiling-windows-binary">
+<h1>Cross-compiling Windows binary</h1>
+<p>In this section, we describe how to build a Windows binary using a
+mingw-w64 (<a class="reference external" href="http://mingw-w64.org/doku.php">http://mingw-w64.org/doku.php</a>) cross-compiler on Debian
+Linux. The MinGW (<a class="reference external" href="http://www.mingw.org/">http://www.mingw.org/</a>) may not be able to build
+aria2.</p>
+<p>The easiest way to build Windows binary is use Dockerfile.mingw.  See
+Dockerfile.mingw how to build binary.  If you cannot use Dockerfile,
+then continue to read following paragraphs.</p>
+<p>Basically, after compiling and installing depended libraries, you can
+do cross-compile just passing appropriate <tt class="docutils literal"><span class="pre">--host</span></tt> option and
+specifying <tt class="docutils literal">CPPFLAGS</tt>, <tt class="docutils literal">LDFLAGS</tt> and <tt class="docutils literal">PKG_CONFIG_LIBDIR</tt>
+variables to configure. For convenience and lowering our own
+development cost, we provide easier way to configure the build
+settings.</p>
+<p><tt class="docutils literal"><span class="pre">mingw-config</span></tt> script is a configure script wrapper for mingw-w64.
+We use it to create official Windows build.  This script assumes
+following libraries have been built for cross-compile:</p>
+<ul class="simple">
+<li>c-ares</li>
+<li>expat</li>
+<li>sqlite3</li>
+<li>zlib</li>
+<li>libssh2</li>
+<li>cppunit</li>
+</ul>
+<p>Some environment variables can be adjusted to change build settings:</p>
+<dl class="docutils">
+<dt><tt class="docutils literal">HOST</tt></dt>
+<dd>cross-compile to build programs to run on <tt class="docutils literal">HOST</tt>. It defaults to
+<tt class="docutils literal"><span class="pre">i686-w64-mingw32</span></tt>. To build 64bit binary, specify
+<tt class="docutils literal"><span class="pre">x86_64-w64-mingw32</span></tt>.</dd>
+<dt><tt class="docutils literal">PREFIX</tt></dt>
+<dd>Prefix to the directory where dependent libraries are installed.  It
+defaults to <tt class="docutils literal"><span class="pre">/usr/local/$HOST</span></tt>. <tt class="docutils literal"><span class="pre">-I$PREFIX/include</span></tt> will be
+added to <tt class="docutils literal">CPPFLAGS</tt>. <tt class="docutils literal"><span class="pre">-L$PREFIX/lib</span></tt> will be added to
+<tt class="docutils literal">LDFLAGS</tt>. <tt class="docutils literal">$PREFIX/lib/pkgconfig</tt> will be set to
+<tt class="docutils literal">PKG_CONFIG_LIBDIR</tt>.</dd>
+</dl>
+<p>For example, to build 64bit binary do this:</p>
+<pre class="literal-block">
+$ HOST=x86_64-w64-mingw32 ./mingw-config
+</pre>
+<p>If you want libaria2 dll with <tt class="docutils literal"><span class="pre">--enable-libaria2</span></tt>, then don't use
+<tt class="docutils literal">ARIA2_STATIC=yes</tt> and prepare the DLL version of external
+libraries.</p>
+</div>
+<div class="section" id="cross-compiling-android-binary">
+<h1>Cross-compiling Android binary</h1>
+<p>In this section, we describe how to build Android binary using Android
+NDK cross-compiler on Debian Linux.</p>
+<p>At the time of this writing, Android NDK r21e should compile aria2
+without errors.</p>
+<p><tt class="docutils literal"><span class="pre">android-config</span></tt> script is a configure script wrapper for Android
+build.  We use it to create official Android build.  This script
+assumes the following libraries have been built for cross-compile:</p>
+<ul class="simple">
+<li>c-ares</li>
+<li>openssl</li>
+<li>expat</li>
+<li>zlib</li>
+<li>libssh2</li>
+</ul>
+<p>When building the above libraries, make sure that disable shared
+library and enable only static library. We are going to link those
+libraries statically.</p>
+<p><tt class="docutils literal"><span class="pre">android-config</span></tt> assumes that <tt class="docutils literal">$ANDROID_HOME</tt> and <tt class="docutils literal">$NDK</tt>
+environment variables are defined.</p>
+<p>We currently use Android NDK r21e.  <tt class="docutils literal">$NDK</tt> should point to the
+directory to Anroid NDK.  The build tools will be found under
+<tt class="docutils literal"><span class="pre">$NDK/toolchains/llvm/prebuilt/linux-x86_64/bin/</span></tt>.</p>
+<p>All the dependent libraries must be installed under
+<tt class="docutils literal">$ANDROID_HOME/usr/local</tt>.</p>
+<p>After <tt class="docutils literal"><span class="pre">android-config</span></tt>, run <tt class="docutils literal">make</tt> to compile sources.</p>
+</div>
+<div class="section" id="building-documentation">
+<h1>Building documentation</h1>
+<p><a class="reference external" href="http://sphinx-doc.org/">Sphinx</a> is used to build the
+documentation. aria2 man pages will be build when you run <tt class="docutils literal">make</tt> if
+they are not up-to-date.  You can also build HTML version of aria2 man
+page by <tt class="docutils literal">make html</tt>. The HTML version manual is also available at
+<a class="reference external" href="https://aria2.github.io/manual/en/html/">online</a> (<a class="reference external" href="https://aria2.github.io/manual/ru/html/">Russian
+translation</a>, <a class="reference external" href="https://aria2.github.io/manual/pt/html/">Portuguese
+translation</a>).</p>
+</div>
+<div class="section" id="bittorrent">
+<h1>BitTorrent</h1>
+<div class="section" id="about-file-names">
+<h2>About file names</h2>
+<p>The file name of the downloaded file is determined as follows:</p>
+<dl class="docutils">
+<dt>single-file mode</dt>
+<dd>If &quot;name&quot; key is present in .torrent file, file name is the value
+of &quot;name&quot; key. Otherwise, file name is the base name of .torrent
+file appended by &quot;.file&quot;. For example, .torrent file is
+&quot;test.torrent&quot;, then file name is &quot;test.torrent.file&quot;.  The
+directory to store the downloaded file can be specified by -d
+option.</dd>
+<dt>multi-file mode</dt>
+<dd>The complete directory/file structure mentioned in .torrent file
+is created.  The directory to store the top directory of
+downloaded files can be specified by -d option.</dd>
+</dl>
+<p>Before download starts, a complete directory structure is created if
+needed. By default, aria2 opens at most 100 files mentioned in
+.torrent file, and directly writes to and reads from these files.
+The number of files to open simultaneously can be controlled by
+<tt class="docutils literal"><span class="pre">--bt-max-open-files</span></tt> option.</p>
+</div>
+<div class="section" id="dht">
+<h2>DHT</h2>
+<p>aria2 supports mainline compatible DHT. By default, the routing table
+for IPv4 DHT is saved to <tt class="docutils literal">$XDG_CACHE_HOME/aria2/dht.dat</tt> and the
+routing table for IPv6 DHT is saved to
+<tt class="docutils literal">$XDG_CACHE_HOME/aria2/dht6.dat</tt> unless files exist at
+<tt class="docutils literal"><span class="pre">$HOME/.aria2/dht.dat</span></tt> or <tt class="docutils literal"><span class="pre">$HOME/.aria2/dht6.dat</span></tt>. aria2 uses same
+port number to listen on for both IPv4 and IPv6 DHT.</p>
+</div>
+<div class="section" id="udp-tracker">
+<h2>UDP tracker</h2>
+<p>UDP tracker support is enabled when IPv4 DHT is enabled.  The port
+number of UDP tracker is shared with DHT. Use <tt class="docutils literal"><span class="pre">--dht-listen-port</span></tt>
+option to change the port number.</p>
+</div>
+<div class="section" id="other-things-should-be-noted">
+<h2>Other things should be noted</h2>
+<ul class="simple">
+<li><tt class="docutils literal"><span class="pre">-o</span></tt> option is used to change the file name of .torrent file itself,
+not a file name of a file in .torrent file. For this purpose, use
+<tt class="docutils literal"><span class="pre">--index-out</span></tt> option instead.</li>
+<li>The port numbers that aria2 uses by default are 6881-6999 for TCP
+and UDP.</li>
+<li>aria2 doesn't configure port-forwarding automatically. Please
+configure your router or firewall manually.</li>
+<li>The maximum number of peers is 55. This limit may be exceeded when
+download rate is low. This download rate can be adjusted using
+<tt class="docutils literal"><span class="pre">--bt-request-peer-speed-limit</span></tt> option.</li>
+<li>As of release 0.10.0, aria2 stops sending request message after
+selective download completes.</li>
+</ul>
+</div>
+</div>
+<div class="section" id="metalink">
+<h1>Metalink</h1>
+<p>The current implementation supports HTTP(S)/FTP/SFTP/BitTorrent.  The
+other P2P protocols are ignored. Both Metalink4 (RFC 5854) and
+Metalink version 3.0 documents are supported.</p>
+<p>For checksum verification, md5, sha-1, sha-224, sha-256, sha-384 and
+sha-512 are supported. If multiple hash algorithms are provided, aria2
+uses stronger one. If whole file checksum verification fails, aria2
+doesn't retry the download and just exits with non-zero return code.</p>
+<p>The supported user preferences are version, language, location,
+protocol and os.</p>
+<p>If chunk checksums are provided in Metalink file, aria2 automatically
+validates chunks of data during download. This behavior can be turned
+off by a command-line option.</p>
+<p>If signature is included in a Metalink file, aria2 saves it as a file
+after the completion of the download.  The file name is download
+file name + &quot;.sig&quot;. If same file already exists, the signature file is
+not saved.</p>
+<p>In Metalink4, multi-file torrent could appear in metalink:metaurl
+element.  Since aria2 cannot download 2 same torrents at the same
+time, aria2 groups files in metalink:file element which has same
+BitTorrent metaurl and downloads them from a single BitTorrent swarm.
+This is basically multi-file torrent download with file selection, so
+the adjacent files which is not in Metalink document but shares same
+piece with selected file are also created.</p>
+<p>If relative URI is specified in metalink:url or metalink:metaurl
+element, aria2 uses the URI of Metalink file as base URI to resolve
+the relative URI. If relative URI is found in Metalink file which is
+read from local disk, aria2 uses the value of <tt class="docutils literal"><span class="pre">--metalink-base-uri</span></tt>
+option as base URI. If this option is not specified, the relative URI
+will be ignored.</p>
+</div>
+<div class="section" id="metalink-http">
+<h1>Metalink/HTTP</h1>
+<p>The current implementation only uses rel=duplicate links only.  aria2
+understands Digest header fields and check whether it matches the
+digest value from other sources. If it differs, drop connection.
+aria2 also uses this digest value to perform checksum verification
+after download finished. aria2 recognizes geo value. To tell aria2
+which location you prefer, you can use <tt class="docutils literal"><span class="pre">--metalink-location</span></tt> option.</p>
+</div>
+<div class="section" id="netrc">
+<h1>netrc</h1>
+<p>netrc support is enabled by default for HTTP(S)/FTP/SFTP.  To disable
+netrc support, specify -n command-line option.  Your .netrc file
+should have correct permissions(600).</p>
+</div>
+<div class="section" id="websocket">
+<h1>WebSocket</h1>
+<p>The WebSocket server embedded in aria2 implements the specification
+defined in RFC 6455. The supported protocol version is 13.</p>
+</div>
+<div class="section" id="libaria2">
+<h1>libaria2</h1>
+<p>The libaria2 is a C++ library which offers aria2 functionality to the
+client code. Currently, libaria2 is not built by default. To enable
+libaria2, use <tt class="docutils literal"><span class="pre">--enable-libaria2</span></tt> configure option.  By default,
+only the shared library is built. To build static library, use
+<tt class="docutils literal"><span class="pre">--enable-static</span></tt> configure option as well. See libaria2
+documentation to know how to use API.</p>
+</div>
+<div class="section" id="references">
+<h1>References</h1>
+<ul class="simple">
+<li><a class="reference external" href="https://aria2.github.io/manual/en/html/">aria2 Online Manual</a></li>
+<li><a class="reference external" href="https://aria2.github.io/">https://aria2.github.io/</a></li>
+<li><a class="reference external" href="http://tools.ietf.org/html/rfc959">RFC 959 FILE TRANSFER PROTOCOL (FTP)</a></li>
+<li><a class="reference external" href="http://tools.ietf.org/html/rfc1738">RFC 1738 Uniform Resource Locators (URL)</a></li>
+<li><a class="reference external" href="http://tools.ietf.org/html/rfc2428">RFC 2428 FTP Extensions for IPv6 and NATs</a></li>
+<li><a class="reference external" href="http://tools.ietf.org/html/rfc2616">RFC 2616 Hypertext Transfer Protocol -- HTTP/1.1</a></li>
+<li><a class="reference external" href="http://tools.ietf.org/html/rfc3659">RFC 3659 Extensions to FTP</a></li>
+<li><a class="reference external" href="http://tools.ietf.org/html/rfc3986">RFC 3986 Uniform Resource Identifier (URI): Generic Syntax</a></li>
+<li><a class="reference external" href="http://tools.ietf.org/html/rfc4038">RFC 4038 Application Aspects of IPv6 Transition</a></li>
+<li><a class="reference external" href="http://tools.ietf.org/html/rfc5854">RFC 5854 The Metalink Download Description Format</a></li>
+<li><a class="reference external" href="http://tools.ietf.org/html/rfc6249">RFC 6249 Metalink/HTTP: Mirrors and Hashes</a></li>
+<li><a class="reference external" href="http://tools.ietf.org/html/rfc6265">RFC 6265 HTTP State Management Mechanism</a></li>
+<li><a class="reference external" href="http://tools.ietf.org/html/rfc6266">RFC 6266 Use of the Content-Disposition Header Field in the Hypertext Transfer Protocol (HTTP)</a></li>
+<li><a class="reference external" href="http://tools.ietf.org/html/rfc6455">RFC 6455 The WebSocket Protocol</a></li>
+<li><a class="reference external" href="http://tools.ietf.org/html/rfc6555">RFC 6555 Happy Eyeballs: Success with Dual-Stack Hosts</a></li>
+<li><a class="reference external" href="http://www.bittorrent.org/beps/bep_0003.html">The BitTorrent Protocol Specification</a></li>
+<li><a class="reference external" href="http://www.bittorrent.org/beps/bep_0005.html">BitTorrent: DHT Protocol</a></li>
+<li><a class="reference external" href="http://www.bittorrent.org/beps/bep_0006.html">BitTorrent: Fast Extension</a></li>
+<li><a class="reference external" href="http://www.bittorrent.org/beps/bep_0007.html">BitTorrent: IPv6 Tracker Extension</a></li>
+<li><a class="reference external" href="http://www.bittorrent.org/beps/bep_0009.html">BitTorrent: Extension for Peers to Send Metadata Files</a></li>
+<li><a class="reference external" href="http://www.bittorrent.org/beps/bep_0010.html">BitTorrent: Extension Protocol</a></li>
+<li><a class="reference external" href="http://www.bittorrent.org/beps/bep_0012.html">BitTorrent: Multitracker Metadata Extension</a></li>
+<li><a class="reference external" href="http://www.bittorrent.org/beps/bep_0015.html">BitTorrent: UDP Tracker Protocol for BitTorrent</a>
+and <a class="reference external" href="http://www.rasterbar.com/products/libtorrent/udp_tracker_protocol.html">BitTorrent udp-tracker protocol specification</a>.</li>
+<li><a class="reference external" href="http://www.bittorrent.org/beps/bep_0019.html">BitTorrent: WebSeed - HTTP/FTP Seeding (GetRight style)</a></li>
+<li><a class="reference external" href="http://www.bittorrent.org/beps/bep_0027.html">BitTorrent: Private Torrents</a></li>
+<li><a class="reference external" href="http://www.bittorrent.org/beps/bep_0032.html">BitTorrent: BitTorrent DHT Extensions for IPv6</a></li>
+<li><a class="reference external" href="http://wiki.vuze.com/w/Message_Stream_Encryption">BitTorrent: Message Stream Encryption</a></li>
+<li><a class="reference external" href="https://pdos.csail.mit.edu/~petar/papers/maymounkov-kademlia-lncs.pdf">Kademlia: A Peer-to-peer Information System Based on the  XOR Metric</a></li>
+</ul>
+</div>
+</div>
+</body>
+</html>

share/doc/aria2/README.rst ADDED Viewed

	@@ -0,0 +1,565 @@

+aria2 - The ultra fast download utility
+=======================================
+Disclaimer
+----------
+This program comes with no warranty.
+You must use this program at your own risk.
+Introduction
+------------
+aria2 is a utility for downloading files. The supported protocols are
+HTTP(S), FTP, SFTP, BitTorrent, and Metalink. aria2 can download a
+file from multiple sources/protocols and tries to utilize your maximum
+download bandwidth. It supports downloading a file from
+HTTP(S)/FTP/SFTP and BitTorrent at the same time, while the data
+downloaded from HTTP(S)/FTP/SFTP is uploaded to the BitTorrent
+swarm. Using Metalink's chunk checksums, aria2 automatically validates
+chunks of data while downloading a file like BitTorrent.
+The project page is located at https://aria2.github.io/.
+See `aria2 Online Manual
+<https://aria2.github.io/manual/en/html/>`_ (`Russian translation
+<https://aria2.github.io/manual/ru/html/>`_, `Portuguese
+translation <https://aria2.github.io/manual/pt/html/>`_) to learn
+how to use aria2.
+Features
+--------
+Here is a list of features:
+* Command-line interface
+* Download files through HTTP(S)/FTP/SFTP/BitTorrent
+* Segmented downloading
+* Metalink version 4 (RFC 5854) support(HTTP/FTP/SFTP/BitTorrent)
+* Metalink version 3.0 support(HTTP/FTP/SFTP/BitTorrent)
+* Metalink/HTTP (RFC 6249) support
+* HTTP/1.1 implementation
+* HTTP Proxy support
+* HTTP BASIC authentication support
+* HTTP Proxy authentication support
+* Well-known environment variables for proxy: ``http_proxy``,
+  ``https_proxy``, ``ftp_proxy``, ``all_proxy`` and ``no_proxy``
+* HTTP gzip, deflate content encoding support
+* Verify peer using given trusted CA certificate in HTTPS
+* Client certificate authentication in HTTPS
+* Chunked transfer encoding support
+* Load Cookies from file using the Firefox3 format, Chromium/Google Chrome
+  and the Mozilla/Firefox
+  (1.x/2.x)/Netscape format.
+* Save Cookies in the Mozilla/Firefox (1.x/2.x)/Netscape format.
+* Custom HTTP Header support
+* Persistent Connections support
+* FTP/SFTP through HTTP Proxy
+* Download/Upload speed throttling
+* BitTorrent extensions: Fast extension, DHT, PEX, MSE/PSE,
+  Multi-Tracker, UDP tracker
+* BitTorrent `WEB-Seeding <http://getright.com/seedtorrent.html>`_.
+  aria2 requests chunks more than piece size to reduce the request
+  overhead. It also supports pipelined requests with piece size.
+* BitTorrent Local Peer Discovery
+* Rename/change the directory structure of BitTorrent downloads
+  completely
+* JSON-RPC (over HTTP and WebSocket)/XML-RPC interface
+* Run as a daemon process
+* Selective download in multi-file torrent/Metalink
+* Chunk checksum validation in Metalink
+* Can disable segmented downloading in Metalink
+* Netrc support
+* Configuration file support
+* Download URIs found in a text file or stdin and the destination
+  directory and output file name can be specified optionally
+* Parameterized URI support
+* IPv6 support with Happy Eyeballs
+* Disk cache to reduce disk activity
+Versioning and release schedule
+-------------------------------
+We use 3 numbers for aria2 version: MAJOR.MINOR.PATCH.  We will ship
+MINOR update on 15th of every month.  We may skip a release if we have
+no changes since the last release.  The feature and documentation
+freeze happens 10 days before the release day (5th day of the month)
+for translation teams.  We will raise an issue about the upcoming
+release around that day.
+We may release PATCH releases between regular releases if we have
+security issues.
+MAJOR version will stay at 1 for the time being.
+How to get source code
+----------------------
+We maintain the source code at Github:
+https://github.com/aria2/aria2
+To get the latest source code, run following command::
+    $ git clone https://github.com/aria2/aria2.git
+This will create aria2 directory in your current directory and source
+files are stored there.
+Dependency
+----------
+======================== ========================================
+features                  dependency
+======================== ========================================
+HTTPS                    OSX or GnuTLS or OpenSSL or Windows
+SFTP                     libssh2
+BitTorrent               None. Optional: libnettle+libgmp or libgcrypt
+                         or OpenSSL (see note)
+Metalink                 libxml2 or Expat.
+Checksum                 None. Optional: OSX or libnettle or libgcrypt
+                         or OpenSSL or Windows (see note)
+gzip, deflate in HTTP    zlib
+Async DNS                C-Ares
+Firefox3/Chromium cookie libsqlite3
+XML-RPC                  libxml2 or Expat.
+JSON-RPC over WebSocket  libnettle or libgcrypt or OpenSSL
+======================== ========================================
+.. note::
+  libxml2 has precedence over Expat if both libraries are installed.
+  If you prefer Expat, run configure with ``--without-libxml2``.
+.. note::
+  On Apple OSX the OS-level SSL/TLS support will be preferred. Hence
+  neither GnuTLS nor OpenSSL are required on that platform. If you'd
+  like to disable this behavior, run configure with
+  ``--without-appletls``.
+  GnuTLS has precedence over OpenSSL if both libraries are installed.
+  If you prefer OpenSSL, run configure with ``--without-gnutls``
+  ``--with-openssl``.
+  On Windows there is SSL implementation available that is based on
+  the native Windows SSL capabilities (Schannel) and it will be
+  preferred.  Hence neither GnuTLS nor OpenSSL are required on that
+  platform.  If you'd like to disable this behavior, run configure
+  with ``--without-wintls``.
+.. note::
+  On Apple OSX the OS-level checksum support will be preferred,
+  unless aria2 is configured with ``--without-appletls``.
+  libnettle has precedence over libgcrypt if both libraries are
+  installed.  If you prefer libgcrypt, run configure with
+  ``--without-libnettle --with-libgcrypt``. If OpenSSL is selected over
+  GnuTLS, neither libnettle nor libgcrypt will be used.
+  If none of the optional dependencies are installed, an internal
+  implementation that only supports md5 and sha1 will be used.
+  On Windows there is SSL implementation available that is based on
+  the native Windows capabilities and it will be preferred, unless
+  aria2 is configured with ``--without-wintls``.
+A user can have one of the following configurations for SSL and crypto
+libraries:
+* OpenSSL
+* GnuTLS + libgcrypt
+* GnuTLS + libnettle
+* Apple TLS (OSX only)
+* Windows TLS (Windows only)
+You can disable BitTorrent and Metalink support by providing
+``--disable-bittorrent`` and ``--disable-metalink`` to the configure
+script respectively.
+In order to enable async DNS support, you need c-ares.
+* c-ares: http://c-ares.haxx.se/
+How to build
+------------
+aria2 is primarily written in C++. Initially it was written based on
+C++98/C++03 standard features. We are now migrating aria2 to C++11
+standard. The current source code requires C++11 aware compiler. For
+well-known compilers, such as g++ and clang, the ``-std=c++11`` or
+``-std=c++0x`` flag must be supported.
+In order to build aria2 from the source package, you need following
+development packages (package name may vary depending on the
+distribution you use):
+* libgnutls-dev    (Required for HTTPS, BitTorrent, Checksum support)
+* nettle-dev       (Required for BitTorrent, Checksum support)
+* libgmp-dev       (Required for BitTorrent)
+* libssh2-1-dev    (Required for SFTP support)
+* libc-ares-dev    (Required for async DNS support)
+* libxml2-dev      (Required for Metalink support)
+* zlib1g-dev       (Required for gzip, deflate decoding support in HTTP)
+* libsqlite3-dev   (Required for Firefox3/Chromium cookie support)
+* pkg-config       (Required to detect installed libraries)
+You can use libgcrypt-dev instead of nettle-dev and libgmp-dev:
+* libgpg-error-dev (Required for BitTorrent, Checksum support)
+* libgcrypt-dev    (Required for BitTorrent, Checksum support)
+You can use libssl-dev instead of
+libgnutls-dev, nettle-dev, libgmp-dev, libgpg-error-dev and libgcrypt-dev:
+* libssl-dev       (Required for HTTPS, BitTorrent, Checksum support)
+You can use libexpat1-dev instead of libxml2-dev:
+* libexpat1-dev    (Required for Metalink support)
+On Fedora you need the following packages: gcc, gcc-c++, kernel-devel,
+libgcrypt-devel, libxml2-devel, openssl-devel, gettext-devel, cppunit
+If you downloaded source code from git repository, you have to install
+following packages to get autoconf macros:
+* libxml2-dev
+* libcppunit-dev
+* autoconf
+* automake
+* autotools-dev
+* autopoint
+* libtool
+And run following command to generate configure script and other files
+necessary to build the program::
+    $ autoreconf -i
+Also you need `Sphinx <http://sphinx-doc.org/>`_ to build man page.
+If you are building aria2 for Mac OS X, take a look at
+the makerelease-osx.mk GNU Make makefile.
+The quickest way to build aria2 is first run configure script::
+    $ ./configure
+To build statically linked aria2, use ``ARIA2_STATIC=yes``
+command-line option::
+    $ ./configure ARIA2_STATIC=yes
+After configuration is done, run ``make`` to compile the program::
+    $ make
+See `Cross-compiling Windows binary`_ to create a Windows binary.
+See `Cross-compiling Android binary`_ to create an Android binary.
+The configure script checks available libraries and enables as many
+features as possible except for experimental features not enabled by
+default.
+Since 1.1.0, aria2 checks the certificate of HTTPS servers by default.
+If you build with OpenSSL or the recent version of GnuTLS which has
+``gnutls_certificate_set_x509_system_trust()`` function and the
+library is properly configured to locate the system-wide CA
+certificates store, aria2 will automatically load those certificates
+at the startup. If it is not the case, I recommend to supply the path
+to the CA bundle file. For example, in Debian the path to CA bundle
+file is '/etc/ssl/certs/ca-certificates.crt' (in ca-certificates
+package). This may vary depending on your distribution. You can give
+it to configure script using ``--with-ca-bundle option``::
+    $ ./configure --with-ca-bundle='/etc/ssl/certs/ca-certificates.crt'
+    $ make
+Without ``--with-ca-bundle`` option, you will encounter the error when
+accessing HTTPS servers because the certificate cannot be verified
+without CA bundle. In such case, you can specify the CA bundle file
+using aria2's ``--ca-certificate`` option.  If you don't have CA bundle
+file installed, then the last resort is disable the certificate
+validation using ``--check-certificate=false``.
+Using the native OSX (AppleTLS) and/or Windows (WinTLS) implementation
+will automatically use the system certificate store, so
+``--with-ca-bundle`` is not necessary and will be ignored when using
+these implementations.
+By default, the bash_completion file named ``aria2c`` is installed to
+the directory ``$prefix/share/doc/aria2/bash_completion``.  To change
+the install directory of the file, use ``--with-bashcompletiondir``
+option.
+After a ``make`` the executable is located at ``src/aria2c``.
+aria2 uses CppUnit for automated unit testing. To run the unit test::
+    $ make check
+Cross-compiling Windows binary
+------------------------------
+In this section, we describe how to build a Windows binary using a
+mingw-w64 (http://mingw-w64.org/doku.php) cross-compiler on Debian
+Linux. The MinGW (http://www.mingw.org/) may not be able to build
+aria2.
+The easiest way to build Windows binary is use Dockerfile.mingw.  See
+Dockerfile.mingw how to build binary.  If you cannot use Dockerfile,
+then continue to read following paragraphs.
+Basically, after compiling and installing depended libraries, you can
+do cross-compile just passing appropriate ``--host`` option and
+specifying ``CPPFLAGS``, ``LDFLAGS`` and ``PKG_CONFIG_LIBDIR``
+variables to configure. For convenience and lowering our own
+development cost, we provide easier way to configure the build
+settings.
+``mingw-config`` script is a configure script wrapper for mingw-w64.
+We use it to create official Windows build.  This script assumes
+following libraries have been built for cross-compile:
+* c-ares
+* expat
+* sqlite3
+* zlib
+* libssh2
+* cppunit
+Some environment variables can be adjusted to change build settings:
+``HOST``
+  cross-compile to build programs to run on ``HOST``. It defaults to
+  ``i686-w64-mingw32``. To build 64bit binary, specify
+  ``x86_64-w64-mingw32``.
+``PREFIX``
+  Prefix to the directory where dependent libraries are installed.  It
+  defaults to ``/usr/local/$HOST``. ``-I$PREFIX/include`` will be
+  added to ``CPPFLAGS``. ``-L$PREFIX/lib`` will be added to
+  ``LDFLAGS``. ``$PREFIX/lib/pkgconfig`` will be set to
+  ``PKG_CONFIG_LIBDIR``.
+For example, to build 64bit binary do this::
+    $ HOST=x86_64-w64-mingw32 ./mingw-config
+If you want libaria2 dll with ``--enable-libaria2``, then don't use
+``ARIA2_STATIC=yes`` and prepare the DLL version of external
+libraries.
+Cross-compiling Android binary
+------------------------------
+In this section, we describe how to build Android binary using Android
+NDK cross-compiler on Debian Linux.
+At the time of this writing, Android NDK r21e should compile aria2
+without errors.
+``android-config`` script is a configure script wrapper for Android
+build.  We use it to create official Android build.  This script
+assumes the following libraries have been built for cross-compile:
+* c-ares
+* openssl
+* expat
+* zlib
+* libssh2
+When building the above libraries, make sure that disable shared
+library and enable only static library. We are going to link those
+libraries statically.
+``android-config`` assumes that ``$ANDROID_HOME`` and ``$NDK``
+environment variables are defined.
+We currently use Android NDK r21e.  ``$NDK`` should point to the
+directory to Anroid NDK.  The build tools will be found under
+``$NDK/toolchains/llvm/prebuilt/linux-x86_64/bin/``.
+All the dependent libraries must be installed under
+``$ANDROID_HOME/usr/local``.
+After ``android-config``, run ``make`` to compile sources.
+Building documentation
+----------------------
+`Sphinx <http://sphinx-doc.org/>`_ is used to build the
+documentation. aria2 man pages will be build when you run ``make`` if
+they are not up-to-date.  You can also build HTML version of aria2 man
+page by ``make html``. The HTML version manual is also available at
+`online <https://aria2.github.io/manual/en/html/>`_ (`Russian
+translation <https://aria2.github.io/manual/ru/html/>`_, `Portuguese
+translation <https://aria2.github.io/manual/pt/html/>`_).
+BitTorrent
+-----------
+About file names
+~~~~~~~~~~~~~~~~
+The file name of the downloaded file is determined as follows:
+single-file mode
+    If "name" key is present in .torrent file, file name is the value
+    of "name" key. Otherwise, file name is the base name of .torrent
+    file appended by ".file". For example, .torrent file is
+    "test.torrent", then file name is "test.torrent.file".  The
+    directory to store the downloaded file can be specified by -d
+    option.
+multi-file mode
+    The complete directory/file structure mentioned in .torrent file
+    is created.  The directory to store the top directory of
+    downloaded files can be specified by -d option.
+Before download starts, a complete directory structure is created if
+needed. By default, aria2 opens at most 100 files mentioned in
+.torrent file, and directly writes to and reads from these files.
+The number of files to open simultaneously can be controlled by
+``--bt-max-open-files`` option.
+DHT
+~~~
+aria2 supports mainline compatible DHT. By default, the routing table
+for IPv4 DHT is saved to ``$XDG_CACHE_HOME/aria2/dht.dat`` and the
+routing table for IPv6 DHT is saved to
+``$XDG_CACHE_HOME/aria2/dht6.dat`` unless files exist at
+``$HOME/.aria2/dht.dat`` or ``$HOME/.aria2/dht6.dat``. aria2 uses same
+port number to listen on for both IPv4 and IPv6 DHT.
+UDP tracker
+~~~~~~~~~~~
+UDP tracker support is enabled when IPv4 DHT is enabled.  The port
+number of UDP tracker is shared with DHT. Use ``--dht-listen-port``
+option to change the port number.
+Other things should be noted
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+* ``-o`` option is used to change the file name of .torrent file itself,
+  not a file name of a file in .torrent file. For this purpose, use
+  ``--index-out`` option instead.
+* The port numbers that aria2 uses by default are 6881-6999 for TCP
+  and UDP.
+* aria2 doesn't configure port-forwarding automatically. Please
+  configure your router or firewall manually.
+* The maximum number of peers is 55. This limit may be exceeded when
+  download rate is low. This download rate can be adjusted using
+  ``--bt-request-peer-speed-limit`` option.
+* As of release 0.10.0, aria2 stops sending request message after
+  selective download completes.
+Metalink
+--------
+The current implementation supports HTTP(S)/FTP/SFTP/BitTorrent.  The
+other P2P protocols are ignored. Both Metalink4 (RFC 5854) and
+Metalink version 3.0 documents are supported.
+For checksum verification, md5, sha-1, sha-224, sha-256, sha-384 and
+sha-512 are supported. If multiple hash algorithms are provided, aria2
+uses stronger one. If whole file checksum verification fails, aria2
+doesn't retry the download and just exits with non-zero return code.
+The supported user preferences are version, language, location,
+protocol and os.
+If chunk checksums are provided in Metalink file, aria2 automatically
+validates chunks of data during download. This behavior can be turned
+off by a command-line option.
+If signature is included in a Metalink file, aria2 saves it as a file
+after the completion of the download.  The file name is download
+file name + ".sig". If same file already exists, the signature file is
+not saved.
+In Metalink4, multi-file torrent could appear in metalink:metaurl
+element.  Since aria2 cannot download 2 same torrents at the same
+time, aria2 groups files in metalink:file element which has same
+BitTorrent metaurl and downloads them from a single BitTorrent swarm.
+This is basically multi-file torrent download with file selection, so
+the adjacent files which is not in Metalink document but shares same
+piece with selected file are also created.
+If relative URI is specified in metalink:url or metalink:metaurl
+element, aria2 uses the URI of Metalink file as base URI to resolve
+the relative URI. If relative URI is found in Metalink file which is
+read from local disk, aria2 uses the value of ``--metalink-base-uri``
+option as base URI. If this option is not specified, the relative URI
+will be ignored.
+Metalink/HTTP
+-------------
+The current implementation only uses rel=duplicate links only.  aria2
+understands Digest header fields and check whether it matches the
+digest value from other sources. If it differs, drop connection.
+aria2 also uses this digest value to perform checksum verification
+after download finished. aria2 recognizes geo value. To tell aria2
+which location you prefer, you can use ``--metalink-location`` option.
+netrc
+-----
+netrc support is enabled by default for HTTP(S)/FTP/SFTP.  To disable
+netrc support, specify -n command-line option.  Your .netrc file
+should have correct permissions(600).
+WebSocket
+---------
+The WebSocket server embedded in aria2 implements the specification
+defined in RFC 6455. The supported protocol version is 13.
+libaria2
+--------
+The libaria2 is a C++ library which offers aria2 functionality to the
+client code. Currently, libaria2 is not built by default. To enable
+libaria2, use ``--enable-libaria2`` configure option.  By default,
+only the shared library is built. To build static library, use
+``--enable-static`` configure option as well. See libaria2
+documentation to know how to use API.
+References
+----------
+* `aria2 Online Manual <https://aria2.github.io/manual/en/html/>`_
+* https://aria2.github.io/
+* `RFC 959 FILE TRANSFER PROTOCOL (FTP) <http://tools.ietf.org/html/rfc959>`_
+* `RFC 1738 Uniform Resource Locators (URL) <http://tools.ietf.org/html/rfc1738>`_
+* `RFC 2428 FTP Extensions for IPv6 and NATs <http://tools.ietf.org/html/rfc2428>`_
+* `RFC 2616 Hypertext Transfer Protocol -- HTTP/1.1 <http://tools.ietf.org/html/rfc2616>`_
+* `RFC 3659 Extensions to FTP <http://tools.ietf.org/html/rfc3659>`_
+* `RFC 3986 Uniform Resource Identifier (URI): Generic Syntax <http://tools.ietf.org/html/rfc3986>`_
+* `RFC 4038 Application Aspects of IPv6 Transition <http://tools.ietf.org/html/rfc4038>`_
+* `RFC 5854 The Metalink Download Description Format <http://tools.ietf.org/html/rfc5854>`_
+* `RFC 6249 Metalink/HTTP: Mirrors and Hashes <http://tools.ietf.org/html/rfc6249>`_
+* `RFC 6265 HTTP State Management Mechanism <http://tools.ietf.org/html/rfc6265>`_
+* `RFC 6266 Use of the Content-Disposition Header Field in the Hypertext Transfer Protocol (HTTP) <http://tools.ietf.org/html/rfc6266>`_
+* `RFC 6455 The WebSocket Protocol <http://tools.ietf.org/html/rfc6455>`_
+* `RFC 6555 Happy Eyeballs: Success with Dual-Stack Hosts <http://tools.ietf.org/html/rfc6555>`_
+* `The BitTorrent Protocol Specification <http://www.bittorrent.org/beps/bep_0003.html>`_
+* `BitTorrent: DHT Protocol <http://www.bittorrent.org/beps/bep_0005.html>`_
+* `BitTorrent: Fast Extension <http://www.bittorrent.org/beps/bep_0006.html>`_
+* `BitTorrent: IPv6 Tracker Extension <http://www.bittorrent.org/beps/bep_0007.html>`_
+* `BitTorrent: Extension for Peers to Send Metadata Files <http://www.bittorrent.org/beps/bep_0009.html>`_
+* `BitTorrent: Extension Protocol <http://www.bittorrent.org/beps/bep_0010.html>`_
+* `BitTorrent: Multitracker Metadata Extension <http://www.bittorrent.org/beps/bep_0012.html>`_
+* `BitTorrent: UDP Tracker Protocol for BitTorrent <http://www.bittorrent.org/beps/bep_0015.html>`_
+  and `BitTorrent udp-tracker protocol specification <http://www.rasterbar.com/products/libtorrent/udp_tracker_protocol.html>`_.
+* `BitTorrent: WebSeed - HTTP/FTP Seeding (GetRight style) <http://www.bittorrent.org/beps/bep_0019.html>`_
+* `BitTorrent: Private Torrents <http://www.bittorrent.org/beps/bep_0027.html>`_
+* `BitTorrent: BitTorrent DHT Extensions for IPv6 <http://www.bittorrent.org/beps/bep_0032.html>`_
+* `BitTorrent: Message Stream Encryption <http://wiki.vuze.com/w/Message_Stream_Encryption>`_
+* `Kademlia: A Peer-to-peer Information System Based on the  XOR Metric <https://pdos.csail.mit.edu/~petar/papers/maymounkov-kademlia-lncs.pdf>`_

share/doc/aria2/bash_completion/README.txt ADDED Viewed

	@@ -0,0 +1,11 @@

+Bash_completion for aria2c
+==========================
+Install
+-------
+Copy 'aria2c' to the directory where bash_completion searches
+completion files.  For Debian and Ubuntu, copy 'aria2c' to
+'/etc/bash_completion.d/' and run
+. /etc/bash_completion

share/doc/aria2/bash_completion/aria2c ADDED Viewed

	@@ -0,0 +1,90 @@

+_aria2c()
+{
+    local cur prev split=false
+    COMPREPLY=()
+    COMP_WORDBREAKS=${COMP_WORDBREAKS//=}
+    cmd=${COMP_WORDS[0]}
+    _get_comp_words_by_ref cur prev
+    case $prev in
+        --ftp-type)
+            COMPREPLY=( $( compgen -W 'binary ascii' -- "$cur" ) )
+            return 0
+            ;;
+        --proxy-method)
+            COMPREPLY=( $( compgen -W 'get tunnel' -- "$cur" ) )
+            return 0
+            ;;
+        --metalink-preferred-protocol)
+            COMPREPLY=( $( compgen -W 'http https ftp none' -- "$cur" ) )
+            return 0
+            ;;
+        --bt-min-crypto-level)
+            COMPREPLY=( $( compgen -W 'plain arc4' -- "$cur" ) )
+            return 0
+            ;;
+        --follow-metalink)
+            COMPREPLY=( $( compgen -W 'true mem false' -- "$cur" ) )
+            return 0
+            ;;
+        --file-allocation)
+            COMPREPLY=( $( compgen -W 'none prealloc trunc falloc' -- "$cur" ) )
+            return 0
+            ;;
+        --log-level)
+            COMPREPLY=( $( compgen -W 'debug info notice warn error' -- "$cur" ) )
+            return 0
+            ;;
+        --uri-selector)
+            COMPREPLY=( $( compgen -W 'inorder feedback adaptive' -- "$cur" ) )
+            return 0
+            ;;
+        --event-poll)
+            COMPREPLY=( $( compgen -W 'epoll poll select' -- "$cur" ) )
+            return 0
+            ;;
+        --follow-torrent)
+            COMPREPLY=( $( compgen -W 'true mem false' -- "$cur" ) )
+            return 0
+            ;;
+        --stream-piece-selector)
+            COMPREPLY=( $( compgen -W 'default inorder random geom' -- "$cur" ) )
+            return 0
+            ;;
+        --download-result)
+            COMPREPLY=( $( compgen -W 'default full hide' -- "$cur" ) )
+            return 0
+            ;;
+        --min-tls-version)
+            COMPREPLY=( $( compgen -W 'TLSv1.1 TLSv1.2 TLSv1.3' -- "$cur" ) )
+            return 0
+            ;;
+        --console-log-level)
+            COMPREPLY=( $( compgen -W 'debug info notice warn error' -- "$cur" ) )
+            return 0
+            ;;
+        --dir)
+            _filedir -d
+            return 0
+            ;;
+        --torrent-file)
+            _filedir '@(torrent)'
+            return 0
+            ;;
+        --metalink-file)
+            _filedir '@(meta4|metalink)'
+            return 0
+            ;;
+    esac
+    case $cur in
+        -*)
+            COMPREPLY=( $( compgen -W '--rpc-save-upload-metadata --rpc-save-upload-metadata=false --on-download-start --metalink-language --rpc-secret --torrent-file --enable-peer-exchange --enable-peer-exchange=false --http-proxy-passwd --bt-tracker-timeout --ftp-type --seed-time --keep-unfinished-download-result --keep-unfinished-download-result=false --bt-tracker-connect-timeout --bt-max-open-files --no-netrc --no-netrc=false --force-sequential --force-sequential=false --metalink-base-uri --private-key --ftp-passwd --allow-overwrite --allow-overwrite=false --rpc-allow-origin-all --rpc-allow-origin-all=false --bt-detach-seed-only --bt-detach-seed-only=false --dht-entry-point6 --summary-interval --lowest-speed-limit --bt-tracker-interval --proxy-method --metalink-preferred-protocol --enable-http-keep-alive --enable-http-keep-alive=false --metalink-version --stderr --stderr=false --bt-lpd-interface --force-save --force-save=false --rpc-secure --rpc-secure=false --listen-port --rpc-private-key --server-stat-of --server-stat-timeout --bt-load-saved-metadata --bt-load-saved-metadata=false --https-proxy-user --piece-length --dry-run --dry-run=false --truncate-console-readout --truncate-console-readout=false --save-not-found --save-not-found=false --async-dns-server --bt-max-peers --max-overall-upload-limit --rpc-user --optimize-concurrent-downloads --optimize-concurrent-downloads=true --optimize-concurrent-downloads=false --optimize-concurrent-downloads=A:B --dir --split --on-download-pause --auto-file-renaming --auto-file-renaming=false --http-proxy --save-session-interval --daemon --daemon=false --https-proxy --min-tls-version --save-cookies --out --rlimit-nofile --max-file-not-found --on-download-stop --certificate --bt-min-crypto-level --remove-control-file --remove-control-file=false --enable-dht --enable-dht=false --file-allocation --follow-metalink --on-bt-download-complete --ftp-proxy --show-files --show-files=false --timeout --bt-hash-check-seed --bt-hash-check-seed=false --ftp-pasv --ftp-pasv=false --check-certificate --check-certificate=false --always-resume --always-resume=false --load-cookies --bt-remove-unselected-file --bt-remove-unselected-file=false --bt-stop-timeout --version --max-concurrent-downloads --quiet --quiet=false --max-download-result --content-disposition-default-utf8 --content-disposition-default-utf8=false --max-resume-failure-tries --header --rpc-listen-all --rpc-listen-all=false --all-proxy-user --server-stat-if --dht-file-path6 --save-session --bt-external-ip --max-tries --conditional-get --conditional-get=false --ftp-reuse-connection --ftp-reuse-connection=false --gid --dscp --max-download-limit --bt-prioritize-piece --check-integrity --check-integrity=false --log-level --remote-time --remote-time=false --uri-selector --rpc-listen-port --index-out --bt-tracker --referer --ssh-host-key-md --console-log-level --connect-timeout --stream-piece-selector --dht-message-timeout --select-file --download-result --disable-ipv6 --disable-ipv6=false --rpc-max-request-size --rpc-passwd --stop-with-process --https-proxy-passwd --continue --continue=false --no-file-allocation-limit --netrc-path --ftp-proxy-user --enable-color --enable-color=false --metalink-location --allow-piece-length-change --allow-piece-length-change=false --max-connection-per-server --no-conf --no-conf=false --rpc-certificate --metalink-os --enable-http-pipelining --enable-http-pipelining=false --http-passwd --user-agent --enable-dht6 --enable-dht6=false --dht-file-path --http-auth-challenge --http-auth-challenge=false --bt-enable-hook-after-hash-check --bt-enable-hook-after-hash-check=false --peer-id-prefix --max-mmap-limit --enable-mmap --enable-mmap=false --use-head --use-head=false --bt-require-crypto --bt-require-crypto=false --show-console-readout --show-console-readout=false --conf-path --log --no-proxy --dht-entry-point --dht-listen-port --http-user --retry-wait --on-download-complete --help --help=#basic --help=#advanced --help=#http --help=#https --help=#ftp --help=#metalink --help=#bittorrent --help=#cookie --help=#hook --help=#file --help=#rpc --help=#checksum --help=#experimental --help=#deprecated --help=#help --help=#all --max-overall-download-limit --event-poll --http-accept-gzip --http-accept-gzip=false --metalink-file --all-proxy --disk-cache --hash-check-only --hash-check-only=false --dht-listen-addr6 --human-readable --human-readable=false --ftp-user --all-proxy-passwd --bt-exclude-tracker --pause-metadata --pause-metadata=false --http-proxy-user --deferred-input --deferred-input=false --metalink-enable-unique-protocol --metalink-enable-unique-protocol=false --stop --peer-agent --max-upload-limit --multiple-interface --realtime-chunk-checksum --realtime-chunk-checksum=false --http-no-cache --http-no-cache=false --ca-certificate --bt-force-encryption --bt-force-encryption=false --bt-save-metadata --bt-save-metadata=false --seed-ratio --follow-torrent --pause --pause=false --checksum --auto-save-interval --async-dns --async-dns=false --bt-enable-lpd --bt-enable-lpd=false --parameterized-uri --parameterized-uri=false --ftp-proxy-passwd --enable-rpc --enable-rpc=false --min-split-size --bt-seed-unverified --bt-seed-unverified=false --input-file --interface --enable-async-dns6 --enable-async-dns6=false --reuse-uri --reuse-uri=false --socket-recv-buffer-size --bt-request-peer-speed-limit --on-download-error --bt-metadata-only --bt-metadata-only=false ' -- "$cur" ) )
+            ;;
+        *)
+            _filedir '@(torrent|meta4|metalink|text|txt|list|lst)'
+            [ ${#COMPREPLY[@]} -eq 0 ] && _filedir
+            return 0
+    esac
+    return 0
+}
+complete -F _aria2c aria2c

share/doc/aria2/xmlrpc/README.txt ADDED Viewed

	@@ -0,0 +1,3 @@

+This directory contains sample scripts to interact with aria2 via
+XML-RPC. For more information, see
+https://aria2.github.io/manual/en/html/aria2c.html#rpc-interface

share/doc/aria2/xmlrpc/aria2mon ADDED Viewed

	@@ -0,0 +1,157 @@

+#!/usr/bin/env ruby
+# The MIT License
+#
+# Copyright (c) 2009 Tatsuhiro Tsujikawa
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+require 'xmlrpc/client'
+require 'optparse'
+program_name=File.basename($0)
+options={}
+args=nil
+OptionParser.new do |opt|
+  opt.on("--server SERVER", "hostname of XML-RPC server. Default: localhost"){|val| options["server"]=val }
+  opt.on("--port PORT", "port of XML-RPC server. Default: 6800"){|val| options["port"]=val }
+  opt.on("--user USERNAME", "XML-RPC username"){|val| options["user"]=val }
+  opt.on("--passwd PASSWORD", "XML-RPC password"){|val| options["passwd"]=val }
+  opt.on("--secret SECRET", "XML-RPC secret authorization token"){|val| options["secret"]=val }
+  opt.banner=<<EOS
+Usage: #{program_name} [options]
+EOS
+  args=opt.parse(ARGV)
+end
+def compute_eta speed,rem_length
+  return "n/a" if speed == 0
+  remsec=rem_length/speed
+  hr=remsec/3600
+  remsec=remsec%3600
+  min=remsec/60
+  remsec=remsec%60
+  result=""
+  result += "#{hr}h" if hr > 0
+  result += "#{min}m" if min > 0
+  result += "#{remsec}s"
+end
+def abbrev value
+  n=value/1024.0
+  if n < 1 then
+    return "#{value}"
+  end
+  value=n
+  n=value/1024.0
+  if n < 1 then
+    return sprintf("%.1fKi", value)
+  else
+    return sprintf("%.1fMi", n)
+  end
+end
+auth=""
+if options.has_key?("user") then
+  auth=options["user"]+":"+options["passwd"]+"@"
+end
+if not options.has_key?("server") then
+  options["server"]="localhost"
+end
+if not options.has_key?("port") then
+  options["port"]="6800"
+end
+secret = if options.has_key?("secret") then "token:"+options["secret"] else nil end
+client=XMLRPC::Client.new3({:host => options["server"],
+                             :port => options["port"],
+                             :path => "/rpc",
+                             :user => options["user"],
+                             :password => options["passwd"]})
+options.delete("server")
+options.delete("port")
+options.delete("user")
+options.delete("passwd")
+options.delete("secret")
+def client_call client, secret, method, *params
+  if secret.nil?
+    client.call(method, *params)
+  else
+    client.call(method, secret, *params)
+  end
+end
+result=client_call(client, secret, "aria2.tellActive")
+print "-- Download Progress --\n"
+result.each { |entry|
+  gid=entry['gid']
+  total_length=entry['totalLength'].to_i
+  completed_length=entry['completedLength'].to_i
+  upload_length=entry['uploadLength'].to_i
+  download_speed=entry['downloadSpeed'].to_i
+  print "GID##{gid}"
+  if total_length == completed_length then
+    if entry.key? 'infoHash' then
+      # for BitTorrent print seed status
+      print " SEEDING"
+      if completed_length > 0 then
+        print "(#{upload_length*100/completed_length}%)"
+      end
+    end
+  else
+    print " SIZE:#{abbrev completed_length}B/#{abbrev total_length}B"
+    if total_length > 0 then
+      print "(#{completed_length*100/total_length}%)"
+    end
+  end
+  print " CN:#{entry['connections']}"
+  if entry.key? 'numSeeders' then
+    print " SEED:#{entry['numSeeders']}"
+  end
+  print " SPD:#{abbrev download_speed}B/s"
+  if entry.key? 'infoHash'
+    printf " UP:#{abbrev entry['uploadSpeed'].to_i}B/s(#{abbrev upload_length}B)"
+  end
+  print " ETA:#{compute_eta(download_speed, total_length-completed_length)}"
+  print "\n"
+  if entry.key? 'infoHash'
+    print " InfoHash:#{entry['infoHash']}"
+  end
+  print "\n"
+  files=client_call(client,secret,"aria2.getFiles",entry['gid'])
+  if files.length > 0 then
+    first_file=files.find{|file| file["selected"]=="true"}
+    if first_file != nil then
+      print " File:#{first_file['path']}"
+      count=0
+      files.each {|file| count += 1 if file["selected"]=="true"}
+      if count > 1 then
+        print "(#{count-1}more)"
+      end
+      print "\n"
+    end
+  end
+  print "--------------------------------------------------------------------------------\n"
+}

share/doc/aria2/xmlrpc/aria2rpc ADDED Viewed

	@@ -0,0 +1,427 @@

+#!/usr/bin/env ruby
+# The MIT License
+#
+# Copyright (c) 2009 Tatsuhiro Tsujikawa
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+require 'xmlrpc/client'
+require 'pp'
+require 'optparse'
+program_name=File.basename($0)
+options={}
+args=nil
+OptionParser.new do |opt|
+  opt.on("-d","--dir DIR"){|val| options["dir"]=val}
+  opt.on("-V","--check-integrity [BOOL]", ["true","false"]){|val|
+    options["check-integrity"]= val||"true"
+  }
+  opt.on("-c","--continue [BOOL]",["true","false"]){|val|
+    options["continue"]=val||"true"
+  }
+  opt.on("--all-proxy PROXY"){|val| options["all-proxy"]=val}
+  opt.on("--all-proxy-user USER"){|val| options["all-proxy-user"]=val}
+  opt.on("--all-proxy-passwd PASSWD"){|val| options["all-proxy-passwd"]=val}
+  opt.on("--connect-timeout SEC"){|val| options["connect-timeout"]=val}
+  opt.on("--dry-run [BOOL]",["true","false"]){|val|
+    options["dry-run"]=val||"true"
+  }
+  opt.on("--lowest-speed-limit SPEED"){|val| options["lowest-speed-limit"]=val}
+  opt.on("--max-file-not-found NUM"){|val| options["max-file-not-found"]=val}
+  opt.on("-m","--max-tries N"){|val| options["max-tries"]=val}
+  opt.on("--no-proxy DOMAINS"){|val| options["no-proxy"]=val}
+  opt.on("-o","--out FILE"){|val| options["out"]=val}
+  opt.on("--proxy-method METHOD"){|val| options["proxy-method"]=val}
+  opt.on("-R","--remote-time [BOOL]",["true","false"]){|val|
+    options["remote-time"]=val||"true"
+  }
+  opt.on("-s","--split N"){|val| options["split"]=val}
+  opt.on("-t","--timeout SEC"){|val| options["timeout"]=val}
+  opt.on("--http-auth-challenge [BOOL]",["true","false"]){|val|
+    options["http-auth-challenge"]=val||"true"
+  }
+  opt.on("--http-no-cache [BOOL]",["true","false"]){|val|
+    options["http-no-cache"]=val||"true"
+  }
+  opt.on("--http-user USER"){|val| options["http-user"]=val}
+  opt.on("--http-passwd PASSWD"){|val| options["http-passwd"]=val}
+  opt.on("--http-proxy PROXY"){|val| options["http-proxy"]=val}
+  opt.on("--http-proxy-user USER"){|val| options["http-proxy-user"]=val}
+  opt.on("--http-proxy-passwd PASSWD"){|val| options["http-proxy-passwd"]=val}
+  opt.on("--https-proxy PROXY"){|val| options["https-proxy"]=val}
+  opt.on("--https-proxy-user USER"){|val| options["https-proxy-user"]=val}
+  opt.on("--https-proxy-passwd PASSWD"){|val| options["https-proxy-passwd"]=val}
+  opt.on("--referer REFERER"){|val| options["referer"]=val}
+  opt.on("--enable-http-keep-alive [BOOL]",["true","false"]){|val|
+    options["enable-http-keep-alive"]=val||"true"
+  }
+  opt.on("--enable-http-pipelining [BOOL]",["true","false"]){|val|
+    options["enable-http-pipelining"]=val||"true"
+  }
+  opt.on("--header HEADER"){|val|
+    options["header"] = [] if options["header"] == nil
+    options["header"] << val
+  }
+  opt.on("--use-head [BOOL]",["true","false"]){|val|
+    options["use-head"]=val||"true"
+  }
+  opt.on("-U","--user-agent USERAGENT"){|val| options["user-agent"]=val}
+  opt.on("--ftp-user USER"){|val| options["ftp-user"]=val}
+  opt.on("--ftp-passwd PASSWD"){|val| options["ftp-passwd"]=val}
+  opt.on("-p","--ftp-pasv [BOOL]",["true","false"]){|val|
+    options["ftp-pasv"]=val||"true"
+  }
+  opt.on("--ftp-proxy PROXY"){|val| options["ftp-proxy"]=val}
+  opt.on("--ftp-proxy-user USER"){|val| options["ftp-proxy-user"]=val}
+  opt.on("--ftp-proxy-passwd PASSWD"){|val| options["ftp-proxy-passwd"]=val}
+  opt.on("--ftp-type TYPE"){|val| options["ftp-type"]=val}
+  opt.on("--ftp-reuse-connection [BOOL]",["true","false"]){|val|
+    options["ftp-reuse-connection"]=val||"true"
+  }
+  opt.on("-n","--no-netrc [BOOL]",["true","false"]){|val|
+    options["no-netrc"]=val||"true"
+  }
+  opt.on("--reuse-uri [BOOL]",["true","false"]){|val|
+    options["reuse-uri"]=val||"true"
+  }
+  opt.on("--select-file INDEXES"){|val| options["select-file"]=val}
+  opt.on("--bt-enable-lpd [BOOL]",["true","false"]){|val|
+    options["bt-enable-lpd"]=val||"true"
+  }
+  opt.on("--bt-external-ip IPADDRESS"){|val| options["bt-external-ip"]=val}
+  opt.on("--bt-hash-check-seed [BOOL]",["true","false"]){|val|
+    options["bt-hash-check-seed"]=val||"true"
+  }
+  opt.on("--bt-max-open-files NUM"){|val| options["bt-max-open-files"]=val}
+  opt.on("--bt-max-peers NUM"){|val| options["bt-max-peers"]=val}
+  opt.on("--bt-metadata-only [BOOL]",["true","false"]){|val|
+    options["bt-metadata-only"]=val||"true"
+  }
+  opt.on("--bt-min-crypto-level LEVEL",["plain","arc4"]){|val|
+    options["bt-min-crypto-level"]=val
+  }
+  opt.on("--bt-prioritize-piece RANGE") {|val|
+    options["bt-prioritize-piece"]=val
+  }
+  opt.on("--bt-require-crypto [BOOL]",["true","false"]){|val|
+    options["bt-require-crypto"]=val||"true"
+  }
+  opt.on("--bt-request-peer-speed-limit SPEED"){|val|
+    options["bt-request-peer-speed-limit"]=val
+  }
+  opt.on("--bt-save-metadata [BOOL]",["true","false"]){|val|
+    options["bt-save-metadata"]=val||"true"
+  }
+  opt.on("--bt-seed-unverified [BOOL]",["true","false"]){|val|
+    options["bt-seed-unverified"]=val||"true"
+  }
+  opt.on("--bt-stop-timeout SEC"){|val| options["bt-stop-timeout"]=val}
+  opt.on("--bt-tracker-interval SEC"){|val| options["bt-tracker-interval"]=val}
+  opt.on("--bt-tracker-timeout SEC"){|val| options["bt-tracker-timeout"]=val}
+  opt.on("--bt-tracker-connect-timeout SEC"){|val|
+    options["bt-tracker-connect-timeout"]=val
+  }
+  opt.on("--enable-peer-exchange [BOOL]",["true","false"]){|val|
+    options["enable-peer-exchange"]=val||"true"
+  }
+  opt.on("--follow-torrent VALUE", ["true","false","mem"]){|val|
+    options["follow-torrent"]=val
+  }
+  opt.on("-O","--index-out INDEXPATH"){|val|
+    options["index-out"]=[] if options["index-out"] == nil
+    options["index-out"] << val
+  }
+  opt.on("-u","--max-upload-limit SPEED"){|val| options["max-upload-limit"]=val}
+  opt.on("--seed-ratio RATIO"){|val| options["seed-ratio"]=val}
+  opt.on("--seed-time MINUTES"){|val| options["seed-time"]=val}
+  opt.on("--follow-metalink VALUE", ["true","false","mem"]){|val|
+    options["follow-metalink"]=val
+  }
+  opt.on("-C","--metalink-servers NUM"){|val| options["metalink-servers"]=val}
+  opt.on("--metalink-language LANG"){|val| options["metalink-language"]=val}
+  opt.on("--metalink-location LOCS"){|val| options["metalink-location"]=val}
+  opt.on("--metalink-os OS"){|val| options["metalink-os"]=val}
+  opt.on("--metalink-version VERSION"){|val| options["metalink-version"]=val}
+  opt.on("--metalink-preferred-protocol PROTO"){|val|
+    options["metalink-preferred-protocol"]=val
+  }
+  opt.on("--metalink-enable-unique-protocol [BOOL]",["true","false"]){|val|
+    options["metalink-enable-unique-protocol"]=val||"true"
+  }
+  opt.on("--allow-overwrite [BOOL]",["true","false"]){|val|
+    options["allow-overwrite"]=val||"true"
+  }
+  opt.on("--allow-piece-length-change [BOOL]",["true","false"]){|val|
+    options["allow-piece-length-change"]=val||"true"
+  }
+  opt.on("--async-dns [BOOL]",["true","false"]){|val|
+    options["async-dns"]=val||"true"
+  }
+  opt.on("--auto-file-renaming [BOOL]",["true","false"]){|val|
+    options["auto-file-renaming"]=val||"true"
+  }
+  opt.on("--file-allocation METHOD",["none","prealloc","falloc"]){|val|
+    options["file-allocation"]=val
+  }
+  opt.on("--max-download-limit LIMIT"){|val| options["max-download-limit"]=val}
+  opt.on("--no-file-allocation-limit SIZE"){|val|
+    options["no-file-allocation-limit"]=val
+  }
+  opt.on("-P","--parameterized-uri [BOOL]",["true","false"]){|val|
+    options["parameterized-uri"]=val||"true"
+  }
+  opt.on("--realtime-chunk-checksum [BOOL]",["true","false"]){|val|
+    options["realtime-chunk-checksum"]=val||"true"
+  }
+  opt.on("--remove-control-file [BOOL]",["true","false"]){|val|
+    options["remove-control-file"]=val||"true"
+  }
+  opt.on("--always-resume [BOOL]",["true","false"]){|val|
+    options["always-resume"]=val||"true"
+  }
+  opt.on("--max-resume-failure-tries N"){|val|
+    options["max-resume-failure-tries"]=val
+  }
+  opt.on("--http-accept-gzip [BOOL]",["true","false"]){|val|
+    options["http-accept-gzip"]=val||"true"
+  }
+  opt.on("-x","--max-connection-per-server NUM"){|val| options["max-connection-per-server"]=val}
+  opt.on("-k","--min-split-size SIZE"){|val| options["min-split-size"]=val}
+  opt.on("--conditional-get [BOOL]",["true","false"]){|val|
+    options["conditional-get"]=val||"true"
+  }
+  opt.on("--enable-async-dns6 [BOOL]",["true","false"]){|val|
+    options["enable-async-dns6"]=val||"true"
+  }
+  opt.on("--bt-tracker URIS"){|val| options["bt-tracker"]=val}
+  opt.on("--bt-exclude-tracker URIS"){|val| options["bt-exclude-tracker"]=val}
+  opt.on("--retry-wait SEC"){|val| options["retry-wait"]=val}
+  opt.on("--metalink-base-uri URI"){|val| options["metalink-base-uri"]=val}
+  opt.on("--pause [BOOL]",["true","false"]){|val| options["pause"]=val||"true"}
+  opt.on("--stream-piece-selector SELECTOR"){|val| options["stream-piece-selector"]=val}
+  opt.on("--hash-check-only [BOOL]",["true","false"]){|val|
+    options["hash-check-only"]=val||"true"
+  }
+  opt.on("--checksum TYPE_DIGEST"){|val| options["checksum"]=val}
+  opt.on("--piece-length LENGTH"){|val| options["piece-length"]=val}
+  opt.on("--uri-selector SELECTOR"){|val| options["uri-selector"]=val}
+  opt.on("--max-overall-download-limit LIMIT"){|val| options["max-overall-download-limit"]=val}
+  opt.on("--max-overall-upload-limit LIMIT"){|val| options["max-overall-upload-limit"]=val}
+  opt.on("-j","--max-concurrent-downloads N"){|val| options["max-concurrent-downloads"]=val}
+  opt.on("-l","--log FILE"){|val| options["log"]=val}
+  opt.on("--max-download-result NUM"){|val| options["max-download-result"]=val}
+  opt.on("--download-result OPT"){|val| options["download-result"]=val}
+  opt.on("--keep-unfinished-download-result [BOOL]",["true","false"]){|val|
+    options["keep-unfinished-download-result"]=val||"true"
+  }
+  opt.on("--save-session FILE"){|val| options["save-session"]=val}
+  opt.on("--server-stat-of FILE"){|val| options["server-stat-of"]=val}
+  opt.on("--save-cookies FILE"){|val| options["save-cookies"]=val}
+  opt.on("--gid GID"){|val| options["gid"]=val}
+  opt.on("--pause-metadata [BOOL]",["true","false"]){|val| options["pause-metadata"]=val||"true"}
+  opt.on("--server SERVER", "hostname of XML-RPC server. Default: localhost"){|val| options["server"]=val }
+  opt.on("--port PORT", "port of XML-RPC server. Default: 6800"){|val| options["port"]=val }
+  opt.on("--user USERNAME", "XML-RPC username"){|val| options["user"]=val }
+  opt.on("--passwd PASSWORD", "XML-RPC password"){|val| options["passwd"]=val }
+  opt.on("--secure [BOOL]",["true","false"]){|val| options["secure"]=val||"true" }
+  opt.on("--check-rpc-cert [BOOL]",["true","false"]){|val| options["check-rpc-cert"]=val||"true" }
+  opt.on("--secret SECRET", "XML-RPC secret authorization token"){|val| options["secret"]=val }
+  opt.banner=<<EOS
+Usage: #{program_name} addUri URI... [options]
+       #{program_name} addTorrent /path/to/torrent_file URI... [options]
+       #{program_name} addMetalink /path/to/metalink_file [options]
+       #{program_name} remove GID [options]
+       #{program_name} forceRemove GID [options]
+       #{program_name} pause GID [options]
+       #{program_name} pauseAll [options]
+       #{program_name} forcePause GID [options]
+       #{program_name} forcePauseAll [options]
+       #{program_name} unpause GID [options]
+       #{program_name} unpauseAll [options]
+       #{program_name} changePosition GID pos how [options]
+       #{program_name} tellStatus GID [keys] [options]
+       #{program_name} tellActive [keys] [options]
+       #{program_name} tellWaiting offset num [keys] [options]
+       #{program_name} tellStopped offset num [keys] [options]
+       #{program_name} getOption GID [options]
+       #{program_name} getGlobalOption [options]
+       #{program_name} getFiles   GID [options]
+       #{program_name} getUris    GID [options]
+       #{program_name} getPeers   GID [options]
+       #{program_name} getServers GID [options]
+       #{program_name} purgeDownloadResult [options]
+       #{program_name} removeDownloadResult GID [options]
+       #{program_name} changeOption GID [options]
+       #{program_name} changeGlobalOption [options]
+       #{program_name} getVersion [options]
+       #{program_name} getSessionInfo [options]
+       #{program_name} shutdown [options]
+       #{program_name} forceShutdown [options]
+       #{program_name} getGlobalStat [options]
+       #{program_name} saveSession [options]
+       #{program_name} appendUri GID fileIndex URI... [options]
+           This command calls aria2.changeUri(GID, fileIndex, [], [URI,...])
+           internally.
+Options:
+EOS
+  args=opt.parse(ARGV)
+end
+if !args or args.size == 0 then
+  puts "No command specified"
+  exit 1
+end
+command=args[0]
+resources=args[1..-1]
+auth=""
+if options.has_key?("user") then
+  auth=options["user"]+":"+options["passwd"]+"@"
+end
+if not options.has_key?("server") then
+  options["server"]="localhost"
+end
+if not options.has_key?("port") then
+  options["port"]="6800"
+end
+if not options.has_key?("secure") then
+  options["secure"]="false"
+end
+if not options.has_key?("check-rpc-cert") then
+  options["check-rpc-cert"]="true"
+end
+secret = if options.has_key?("secret") then "token:"+options["secret"] else nil end
+client=XMLRPC::Client.new3({:host => options["server"],
+                             :port => options["port"],
+                             :path => "/rpc",
+                             :user => options["user"],
+                             :password => options["passwd"],
+                             :use_ssl => options["secure"] == "true"})
+if options["check-rpc-cert"] == "false" then
+  client.instance_variable_get(:@http).instance_variable_set(:@verify_mode, OpenSSL::SSL::VERIFY_NONE)
+end
+options.delete("server")
+options.delete("port")
+options.delete("user")
+options.delete("passwd")
+options.delete("secret")
+options.delete("secure")
+options.delete("check-rpc-cert")
+def client_call client, secret, method, *params
+  if secret.nil?
+    client.call(method, *params)
+  else
+    client.call(method, secret, *params)
+  end
+end
+if command == "addUri" then
+  result=client_call(client, secret, "aria2."+command, resources, options)
+elsif command == "addTorrent" then
+  torrentData=IO.read(resources[0])
+  result=client_call(client, secret, "aria2."+command,
+                     XMLRPC::Base64.new(torrentData), resources[1..-1], options)
+elsif command == "addMetalink" then
+  metalinkData=IO.read(resources[0])
+  result=client_call(client, secret, "aria2."+command,
+                     XMLRPC::Base64.new(metalinkData), options)
+elsif command == "tellStatus" then
+  result=client_call(client, secret, "aria2."+command,
+                     resources[0], resources[1..-1])
+elsif command == "tellActive" then
+  result=client_call(client, secret, "aria2."+command, resources[0..-1])
+elsif command == "tellWaiting" then
+  result=client_call(client, secret, "aria2."+command, resources[0].to_i(),
+                     resources[1].to_i(), resources[2..-1])
+elsif command == "tellStopped" then
+  result=client_call(client, secret, "aria2."+command, resources[0].to_i(),
+                     resources[1].to_i(), resources[2..-1])
+elsif command == "getOption" then
+  result=client_call(client, secret, "aria2."+command, resources[0])
+elsif command == "getGlobalOption" then
+  result=client_call(client, secret, "aria2."+command)
+elsif command == "pause" then
+  result=client_call(client, secret, "aria2."+command, resources[0])
+elsif command == "pauseAll" then
+  result=client_call(client, secret, "aria2."+command)
+elsif command == "forcePause" then
+  result=client_call(client, secret, "aria2."+command, resources[0])
+elsif command == "forcePauseAll" then
+  result=client_call(client, secret, "aria2."+command)
+elsif command == "unpause" then
+  result=client_call(client, secret, "aria2."+command, resources[0])
+elsif command == "unpauseAll" then
+  result=client_call(client, secret, "aria2."+command)
+elsif command == "remove" then
+  result=client_call(client, secret, "aria2."+command, resources[0])
+elsif command == "forceRemove" then
+  result=client_call(client, secret, "aria2."+command, resources[0])
+elsif command == "changePosition" then
+  result=client_call(client, secret, "aria2."+command, resources[0],
+                     resources[1].to_i(), resources[2])
+elsif command == "getFiles" then
+  result=client_call(client, secret, "aria2."+command, resources[0])
+elsif command == "getUris" then
+  result=client_call(client, secret, "aria2."+command, resources[0])
+elsif command == "getPeers" then
+  result=client_call(client, secret, "aria2."+command, resources[0])
+elsif command == "getServers" then
+  result=client_call(client, secret, "aria2."+command, resources[0])
+elsif command == "purgeDownloadResult" then
+  result=client_call(client, secret, "aria2."+command)
+elsif command == "removeDownloadResult" then
+  result=client_call(client, secret, "aria2."+command, resources[0])
+elsif command == "changeOption" then
+  result=client_call(client, secret, "aria2."+command, resources[0], options)
+elsif command == "changeGlobalOption" then
+  result=client_call(client, secret, "aria2."+command, options)
+elsif command == "getVersion" then
+  result=client_call(client, secret, "aria2."+command)
+elsif command == "getSessionInfo" then
+  result=client_call(client, secret, "aria2."+command)
+elsif command == "shutdown" then
+  result=client_call(client, secret, "aria2."+command)
+elsif command == "forceShutdown" then
+  result=client_call(client, secret, "aria2."+command)
+elsif command == "getGlobalStat" then
+  result=client_call(client, secret, "aria2."+command)
+elsif command == "saveSession" then
+  result=client_call(client, secret, "aria2."+command)
+elsif command == "appendUri" then
+  result=client_call(client, secret, "aria2.changeUri", resources[0],
+                     resources[1].to_i(), [], resources[2..-1])
+else
+  puts "Command not recognized"
+  exit 1
+end
+pp result

share/locale/ar/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (2.2 kB). View file

share/locale/bg/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (48.7 kB). View file

share/locale/bn/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (950 Bytes). View file

share/locale/ca/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (17.4 kB). View file

share/locale/da/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (10.1 kB). View file

share/locale/de/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (50.4 kB). View file

share/locale/el/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (113 kB). View file

share/locale/en@boldquot/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (155 kB). View file

share/locale/en@quot/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (154 kB). View file

share/locale/es/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (22.3 kB). View file

share/locale/fa/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (1.49 kB). View file

share/locale/fi/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (15.6 kB). View file

share/locale/fil/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (1.7 kB). View file

share/locale/fr/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (54.2 kB). View file

share/locale/he/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (9.69 kB). View file

share/locale/hr/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (1.33 kB). View file

share/locale/hu/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (892 Bytes). View file

share/locale/id/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (21.3 kB). View file

share/locale/it/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (56.5 kB). View file

share/locale/ja/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (85.4 kB). View file

share/locale/kk/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (1.79 kB). View file

share/locale/ko/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (2.19 kB). View file

share/locale/ms/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (1.46 kB). View file

share/locale/nb/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (1 kB). View file

share/locale/nl/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (5.8 kB). View file

share/locale/nn/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (1.55 kB). View file

share/locale/oc/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (1 kB). View file

share/locale/pl/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (14.1 kB). View file

share/locale/pt/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (17.6 kB). View file

share/locale/pt_BR/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (165 kB). View file

share/locale/ro/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (4.62 kB). View file

share/locale/ru/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (198 kB). View file

share/locale/sk/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (3.22 kB). View file

share/locale/sr/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (3.35 kB). View file

share/locale/sv/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (10.1 kB). View file

share/locale/th/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (1.02 kB). View file

share/locale/tr/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (24.8 kB). View file

share/locale/uk/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (77.7 kB). View file

share/locale/vi/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (1.64 kB). View file

share/locale/zh_CN/LC_MESSAGES/aria2.mo ADDED Viewed

Binary file (112 kB). View file