Browse Source

2008-11-09 Tatsuhiro Tsujikawa <t-tujikawa@users.sourceforge.net>

	Added usage for --ca-certificate, --certificate, --private-key
	and --check-certificate options.
	* doc/aria2c.1.txt
Tatsuhiro Tsujikawa 17 years ago
parent
commit
5a1f1fbd1a
4 changed files with 80 additions and 2 deletions
  1. 6 0
      ChangeLog
  2. 37 1
      doc/aria2c.1
  3. 21 1
      doc/aria2c.1.html
  4. 16 0
      doc/aria2c.1.txt

+ 6 - 0
ChangeLog

@@ -1,3 +1,9 @@
+2008-11-09  Tatsuhiro Tsujikawa  <t-tujikawa@users.sourceforge.net>
+
+	Added usage for --ca-certificate, --certificate, --private-key and
+	--check-certificate options.
+	* doc/aria2c.1.txt
+
 2008-11-09  Tatsuhiro Tsujikawa  <t-tujikawa@users.sourceforge.net>
 2008-11-09  Tatsuhiro Tsujikawa  <t-tujikawa@users.sourceforge.net>
 
 
 	Updated man page
 	Updated man page

+ 37 - 1
doc/aria2c.1

@@ -272,7 +272,7 @@ option\&. This affects all URLs\&. The format of PROXY is [http://][USER:PASSWOR
 .PP
 .PP
 \fB\-\-private\-key\fR=FILE
 \fB\-\-private\-key\fR=FILE
 .RS 4
 .RS 4
-Use the private key in FILE\&. The private key must be decrypted and in PEM format\&. See also
+Use the private key in FILE\&. The private key must be decrypted and in PEM format\&. The behavior when encrypted one is given is undefined\&. See also
 \fB\-\-certificate\fR
 \fB\-\-certificate\fR
 option\&.
 option\&.
 .RE
 .RE
@@ -1192,6 +1192,42 @@ aria2c \-c \-s2 http://host/partiallydownloadedfile\&.zip
 .fi
 .fi
 .RE
 .RE
 .RE
 .RE
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+Client certificate authorization for SSL/TLS
+.RS
+.sp
+.RS 4
+.nf
+aria2c \-\-certificate=/path/to/mycert\&.pem \-\-private\-key=/path/to/mykey\&.pem https://host/file
+.fi
+.RE
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+Note
+The file specified in \fB\-\-private\-key\fR must be decrypted\&. The behavior when encrypted one is given is undefined\&.
+.sp
+.RE
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+Verify peer in SSL/TLS using given CA certificates
+.RS
+.sp
+.RS 4
+.nf
+aria2c \-\-ca\-certificate=/path/to/ca\-certificates\&.crt \-\-check\-certificate https://host/file
+.fi
+.RE
+.RE
 .SS "And more advanced features"
 .SS "And more advanced features"
 .sp
 .sp
 .it 1 an-trap
 .it 1 an-trap

+ 21 - 1
doc/aria2c.1.html

@@ -733,6 +733,7 @@ aria2c -o myfile.zip <a href="http://mirror1/file.zip">http://mirror1/file.zip</
 <p>
 <p>
   Use the private key in FILE.
   Use the private key in FILE.
   The private key must be decrypted and in PEM format.
   The private key must be decrypted and in PEM format.
+  The behavior when encrypted one is given is undefined.
   See also <strong>--certificate</strong> option.
   See also <strong>--certificate</strong> option.
 </p>
 </p>
 </dd>
 </dd>
@@ -1669,6 +1670,25 @@ forwarding, it's up to you to do it manually.</td>
 <div class="content">
 <div class="content">
 <pre><tt>aria2c -c -s2 http://host/partiallydownloadedfile.zip</tt></pre>
 <pre><tt>aria2c -c -s2 http://host/partiallydownloadedfile.zip</tt></pre>
 </div></div>
 </div></div>
+<h4 id="_client_certificate_authorization_for_ssl_tls">Client certificate authorization for SSL/TLS</h4>
+<div class="listingblock">
+<div class="content">
+<pre><tt>aria2c --certificate=/path/to/mycert.pem --private-key=/path/to/mykey.pem https://host/file</tt></pre>
+</div></div>
+<div class="admonitionblock">
+<table><tr>
+<td class="icon">
+<div class="title">Note</div>
+</td>
+<td class="content">The file specified in <strong>--private-key</strong> must be decrypted. The behavior when
+encrypted one is given is undefined.</td>
+</tr></table>
+</div>
+<h4 id="_verify_peer_in_ssl_tls_using_given_ca_certificates">Verify peer in SSL/TLS using given CA certificates</h4>
+<div class="listingblock">
+<div class="content">
+<pre><tt>aria2c --ca-certificate=/path/to/ca-certificates.crt --check-certificate https://host/file</tt></pre>
+</div></div>
 <h3 id="_and_more_advanced_features">And more advanced features</h3><div style="clear:left"></div>
 <h3 id="_and_more_advanced_features">And more advanced features</h3><div style="clear:left"></div>
 <h4 id="_throttle_download_speed">Throttle download speed</h4>
 <h4 id="_throttle_download_speed">Throttle download speed</h4>
 <div class="listingblock">
 <div class="listingblock">
@@ -1942,7 +1962,7 @@ files in the program, then also delete it here.</p></div>
 </div>
 </div>
 <div id="footer">
 <div id="footer">
 <div id="footer-text">
 <div id="footer-text">
-Last updated 2008-11-09 17:57:01 JST
+Last updated 2008-11-09 18:05:02 JST
 </div>
 </div>
 </div>
 </div>
 </body>
 </body>

+ 16 - 0
doc/aria2c.1.txt

@@ -201,6 +201,7 @@ HTTP Specific Options
 *--private-key*=FILE::
 *--private-key*=FILE::
   Use the private key in FILE.
   Use the private key in FILE.
   The private key must be decrypted and in PEM format.
   The private key must be decrypted and in PEM format.
+  The behavior when encrypted one is given is undefined.
   See also *--certificate* option.
   See also *--certificate* option.
 
 
 *--referer*=REFERER::
 *--referer*=REFERER::
@@ -734,6 +735,21 @@ Resume download started by web browsers or another programs
 aria2c -c -s2 http://host/partiallydownloadedfile.zip 
 aria2c -c -s2 http://host/partiallydownloadedfile.zip 
 ---------------------------------------------------
 ---------------------------------------------------
 
 
+Client certificate authorization for SSL/TLS
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+------------------------------------------------------------------------------------------
+aria2c --certificate=/path/to/mycert.pem --private-key=/path/to/mykey.pem https://host/file
+------------------------------------------------------------------------------------------
+[NOTE]
+The file specified in *--private-key* must be decrypted. The behavior when
+encrypted one is given is undefined.
+
+Verify peer in SSL/TLS using given CA certificates
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+------------------------------------------------------------------------------------------
+aria2c --ca-certificate=/path/to/ca-certificates.crt --check-certificate https://host/file
+------------------------------------------------------------------------------------------
+
 And more advanced features
 And more advanced features
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 Throttle download speed
 Throttle download speed