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>
 
 	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
 \fB\-\-private\-key\fR=FILE
 .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
 option\&.
 .RE
@@ -1192,6 +1192,42 @@ aria2c \-c \-s2 http://host/partiallydownloadedfile\&.zip
 .fi
 .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"
 .sp
 .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>
   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 <strong>--certificate</strong> option.
 </p>
 </dd>
@@ -1669,6 +1670,25 @@ forwarding, it's up to you to do it manually.</td>
 <div class="content">
 <pre><tt>aria2c -c -s2 http://host/partiallydownloadedfile.zip</tt></pre>
 </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>
 <h4 id="_throttle_download_speed">Throttle download speed</h4>
 <div class="listingblock">
@@ -1942,7 +1962,7 @@ files in the program, then also delete it here.</p></div>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2008-11-09 17:57:01 JST
+Last updated 2008-11-09 18:05:02 JST
 </div>
 </div>
 </body>

+ 16 - 0
doc/aria2c.1.txt

@@ -201,6 +201,7 @@ HTTP Specific Options
 *--private-key*=FILE::
   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 *--certificate* option.
 
 *--referer*=REFERER::
@@ -734,6 +735,21 @@ Resume download started by web browsers or another programs
 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
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 Throttle download speed