From 69966d7ac995436695b59ac8e9b736343308c277 Mon Sep 17 00:00:00 2001 From: Tatsuhiro Tsujikawa Date: Sat, 29 Oct 2011 00:16:20 +0900 Subject: [PATCH] Updated doc about netrc --- doc/aria2c.1.asciidoc | 22 ++++++++++++++++++---- 1 file changed, 18 insertions(+), 4 deletions(-) diff --git a/doc/aria2c.1.asciidoc b/doc/aria2c.1.asciidoc index 12b4003f..8ba7934f 100644 --- a/doc/aria2c.1.asciidoc +++ b/doc/aria2c.1.asciidoc @@ -177,6 +177,16 @@ then you get HTTP proxy "http://proxy" with user "user" and password [[aria2_optref_no_netrc]]*-n*, *--no-netrc*[='true'|'false']:: Disables netrc support. netrc support is enabled by default. +[NOTE] + +netrc file is only read at the startup if +*<>* is 'false'. +So if *<>* is 'true' at the startup, +no netrc is available throughout the session. +You cannot get netrc enabled even if you send +*<>*='false' using +*<>*. + [[aria2_optref_no_proxy]]*--no-proxy*=DOMAINS:: Specify comma separated hostnames, domains and network address with or without CIDR block where proxy should not be used. @@ -1463,7 +1473,7 @@ Netrc support is enabled by default for HTTP(S)/FTP. To disable netrc support, specify *<>* option. Your .netrc file should have correct permissions(600). -If machine name starts ".", aria2 performs domain match instead of +If machine name starts ".", aria2 performs domain-match instead of exact match. This is an extension of aria2. For example of domain match, imagine the following .netrc entry: @@ -1471,9 +1481,13 @@ match, imagine the following .netrc entry: machine .example.org login myid password mypasswd ------------------------------------------------- -In domain match, aria2.example.org matches .example.org and uses myid -and mypasswd. example.org also matches .example.org. But example.net -does not match .example.org. +"aria2.example.org" domain-matches ".example.org" and uses 'myid' and +'mypasswd'. + +Some domain-match example follow: "example.net" does not domain-match +".example.org". "example.org" does not domain-match ".example.org" +because of preceding ".". If you want to match "example.org", specify +"example.org". Control File ~~~~~~~~~~~~