diff --git a/doc/aria2c.1.txt b/doc/aria2c.1.txt index bf699c08..12c04e1f 100644 --- a/doc/aria2c.1.txt +++ b/doc/aria2c.1.txt @@ -12,7 +12,7 @@ aria2c ['OPTIONS'] ['URL' | 'TORRENT_FILE' | 'METALINK_FILE']... DESCRIPTION ----------- -aria2 is a utility for downloading files. The supported protocols are HTTP(S), FTP, BitTorrent, and Metalink. It 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 and BitTorrent at the same time, while the data downloaded from HTTP(S)/FTP is uploaded to the BitTorrent swarm. Using Metalink's chunk checksums, aria2 automatically validates chunks of data while downloading a file like BitTorrent. +aria2 is a utility for downloading files. The supported protocols are HTTP(S), FTP, 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 and BitTorrent at the same time, while the data downloaded from HTTP(S)/FTP is uploaded to the BitTorrent swarm. Using Metalink's chunk checksums, aria2 automatically validates chunks of data while downloading a file like BitTorrent. OPTIONS ------- @@ -65,8 +65,8 @@ Basic Options HTTP/FTP Options ~~~~~~~~~~~~~~~~ *--all-proxy*=PROXY:: - Use this proxy server in the all protocols. - You can override this setting and specify a proxy server for particular + Use this proxy server for all protocols. + You can override this setting and specify a proxy server for a particular proctol using *--http-proxy*, *--https-proxy* and *--ftp-proxy* options. This affects all URLs. The format of PROXY is [\\http://][USER:PASSWORD@]HOST[:PORT] @@ -89,7 +89,7 @@ HTTP/FTP Options If aria2 recieves `file not found' status from the remote HTTP/FTP servers NUM times without getting a single byte, then force the download to fail. Specify '0' to disable this option. This options is - only effective only when using HTTP/FTP servers. + effective only when using HTTP/FTP servers. Default: '0' *-m*, *--max-tries*=N:: @@ -97,16 +97,16 @@ HTTP/FTP Options Default: '5' *--no-proxy*=DOMAINS:: - Specify comma separated hostnames or domains to which proxy should not be + Specify comma separated hostnames or domains where proxy should not be used. *-o*, *--out*=FILE:: The file name of the downloaded file. [NOTE] -In Metalink, BitTorrent download you cannot specify file name. +In Metalink or BitTorrent download you cannot specify file name. The file name specified here is only used when the URLs fed to aria2 -is done by command line without *-i*, *-Z* option. For example: +are done by command line without *-i*, *-Z* option. For example: aria2c -o myfile.zip \http://mirror1/file.zip \http://mirror2/file.zip *--proxy-method*=METHOD:: @@ -226,11 +226,11 @@ HTTP Specific Options aria2c *--header*="X-A: b78" *--header*="X-B: 9J1" \http://host/file *--load-cookies*=FILE:: - Load Cookies from FILE using the Firefox3 format(SQLite3) and the + Load Cookies from FILE using the Firefox3 format (SQLite3) and the Mozilla/Firefox(1.x/2.x)/Netscape format. [NOTE] -If aria2 is build without libsqlite3, then it doesn't support Firefox3 cookie. +If aria2 is built without libsqlite3, then it doesn't support Firefox3 cookie format. *-U*, *--user-agent*=USER_AGENT:: Set user agent for HTTP(S) downloads. @@ -269,7 +269,7 @@ FTP Specific Options BitTorrent/Metalink Options ~~~~~~~~~~~~~~~~~~~~~~~~~~~ *--select-file*=INDEX...:: - Set file to download by specifing its index. + Set file to download by specifying its index. You can find the file index using the *--show-files* option. Multiple indexes can be specified by using ",", for example: '3,6'. You can also use "-" to specify a range: '1-5'. @@ -296,7 +296,7 @@ BitTorrent Specific Options *--bt-min-crypto-level*='plain'|'arc4':: Set minimum level of encryption method. - If several encryption methods are provided by a peer, aria2 chooses a lowest + If several encryption methods are provided by a peer, aria2 chooses the lowest one which satisfies the given level. Default: 'plain' @@ -380,7 +380,7 @@ Make sure that the specified ports are open for incoming TCP traffic. *--seed-ratio*=RATIO:: Specify share ratio. Seed completed torrents until share ratio reaches] RATIO. - I strongly encourages you to specify equals or more than '1.0' here. + You are strongly encouraged to specify equals or more than '1.0' here. Specify '0.0' if you intend to do seeding regardless of share ratio. If *--seed-time* option is specified along with this option, seeding ends when at least one of the conditions is satisfied. @@ -391,13 +391,13 @@ Make sure that the specified ports are open for incoming TCP traffic. *-T*, *--torrent-file*=TORRENT_FILE:: The path to the .torrent file. - You may not use this option because you can specify torrent file without -T. + You are not required touse this option because you can specify a torrent file without -T. Metalink Specific Options ~~~~~~~~~~~~~~~~~~~~~~~~~ *--follow-metalink*='true'|'false'|'mem':: If 'true' or 'mem' is specified, when a file whose suffix is ".metaink" or content - type is "application/metalink+xml" is downloaded, aria2 parses it as a metalink + type of "application/metalink+xml" is downloaded, aria2 parses it as a metalink file and downloads files mentioned in it. If 'mem' is specified, a metalink file is not written to the disk, but is just kept in memory. @@ -405,12 +405,12 @@ Metalink Specific Options Default: 'true' *-M*, *--metalink-file*=METALINK_FILE:: - The file path to .metalink file. You may not use this option because you can - specify metalink file without -M. + The file path to .metalink file. You are not required to use this option because you can + specify a metalink file without -M. *-C*, *--metalink-servers*=NUM_SERVERS:: The number of servers to connect to simultaneously. - Some Metalinks regulates the number of servers to connect. + Some Metalinks regulate the number of servers to connect. aria2 strictly respects them. This means that if Metalink defines the maxconnections attribute lower than NUM_SERVERS, then aria2 uses the value of maxconnections attribute @@ -423,7 +423,7 @@ Metalink Specific Options *--metalink-location*=LOCATION[,...]:: The location of the preferred server. - A comma-deliminated list of locations is acceptable, for example, 'JP,US'. + A comma-delimited list of locations is acceptable, for example, 'JP,US'. *--metalink-os*=OS:: The operating system of the file to download. @@ -506,8 +506,8 @@ Advanced Options Default: '60' [NOTE] -In multi file torrent, the files adjacent forward to the specified files -are also allocated if they share a same piece. +In multi file torrent downloads, the files adjacent forward to the specified files +are also allocated if they share the same piece. *-Z*, *--force-sequential*[='true'|'false']:: Fetch URIs in the command-line sequentially and download each URI in a @@ -538,12 +538,12 @@ are also allocated if they share a same piece. Default: 'false' *-q*, *--quiet*[='true'|'false']:: - Make aria2 quite (no console output). + Make aria2 quiet (no console output). Default: 'false' *--realtime-chunk-checksum*='true'|'false':: - Validate chunk of data by calculating checkusm while download a file if - chunk checksums are provided. Currently Metalink is the only way to to + Validate chunk of data by calculating checksum while downloading a file if + chunk checksums are provided. Currently Metalink is the only way to provide chunk checksums. Default: 'true' @@ -561,7 +561,7 @@ OPTIONS THAT TAKE AN OPTIONAL ARGUMENT The options that have its argument surrounded by square brackets([]) take an optional argument. Usually ommiting the argument is evaluated to 'true'. If you use short form of these options(such as '-V') and give -an arugment, then the option name and its argument should be concatenated(e.g. +an argument, then the option name and its argument should be concatenated(e.g. '-Vfalse'). If any spaces are inserted between the option name and the argument, the argument will be treated as URI and usually this is not what you expect. @@ -571,11 +571,11 @@ You can specify multiple URLs in command-line. Unless you specify *-Z* option, all URLs must point to the same file or downloading will fail. You can also specify arbitrary number of torrent files and metalink files -stored in a local drive. Please note that they are always treated as a +stored on a local drive. Please note that they are always treated as a separate download. You can specify both torrent file with -T option and URLs. By doing this, -download a file from both torrent swarm and HTTP(S)/FTP server at the same time, +you can download a file from both torrent swarm and HTTP(S)/FTP server at the same time, while the data from HTTP(S)/FTP are uploaded to the torrent swarm. Note that only single file torrent can be integrated with HTTP(S)/FTP. @@ -605,7 +605,7 @@ aria2 uses 5 connections to download 1 file by default. -s1 limtis the number of connections to just 1. [NOTE] -To pause a download, press Ctrl-C. You can resume the transfer by running aria2c with the same argument at the same directory. You can change URLs as long as they are pointing to the same file. +To pause a download, press Ctrl-C. You can resume the transfer by running aria2c with the same argument in the same directory. You can change URLs as long as they are pointing to the same file. Download a file from 2 different HTTP servers ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -619,7 +619,7 @@ Download a file from HTTP and FTP servers aria2c http://host1/file.zip ftp://host2/file.zip ------------------------------------------------- -Download files listed in a file concurrently +Download files listed in a text file concurrently ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ------------------------ aria2c -ifiles.txt -j2 @@ -664,7 +664,7 @@ aria2c -p --lowest-speed-limit=4000 file.metalink ---------------------------------------------------------- [NOTE] To pause a download, press Ctrl-C. -You can resume the transfer by running aria2c with the same argument at the same +You can resume the transfer by running aria2c with the same argument in the same directory. Download several local metalink files @@ -704,7 +704,7 @@ aria2c --max-upload-limit=40K file.torrent --max-upload-limit specifies the max of upload rate. [NOTE] -To pause a download, press Ctrl-C. You can resume the transfer by run aria2c with the same argument at the same directory. +To pause a download, press Ctrl-C. You can resume the transfer by run aria2c with the same argument in the same directory. Download 2 torrents ^^^^^^^^^^^^^^^^^^^ @@ -744,7 +744,7 @@ aria2c --seed-time=120 --seed-ratio=1.0 file.torrent ------------------------------------------------------- [NOTE] -In the above example, the program exists when the 120 minutes has elapsed since download completed or seed ratio reaches 1.0. +In the above example, the program exits when the 120 minutes has elapsed since download completed or seed ratio reaches 1.0. Throttle upload speed ^^^^^^^^^^^^^^^^^^^^^ @@ -853,13 +853,13 @@ RESUME DOWNLOAD Usually, you can resume transfer by just issuing same command(aria2c URL) if the previous transfer is made by aria2. -If the previous transfer is made by a browser or wget like sequencial +If the previous transfer is made by a browser or wget like sequential download manager, then use -c option to continue the transfer(aria2c -c URL). CONTROL FILE ------------ -aria2 uses a control file to keep track the progress of download. -A control file is placed at the same directory of the dowloading file and +aria2 uses a control file to track the progress of a download. +A control file is placed in the same directory as the dowloading file and its filename is the filename of downloading file with ".aria2" appended. For example, if you are downloading file.zip, then the control file should be file.zip.aria2. @@ -887,7 +887,7 @@ aria2c -V file.torrent INPUT FILE ---------- -The input file can contain list of URIs to feed them into aria2. +The input file can contain a list of URIs for aria2 to download. You can specify multiple URIs for a single entity: separate URIs on a single line using the TAB character. @@ -896,7 +896,7 @@ Therefore they are affected by *-Z* and *-P* options. The additional *out* and *dir* options can be specified after each line of URIs. This optional line must start with white space(s). -For example, let the content of uri.txt be +For example, the content of uri.txt is ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ http://server/file.iso http://mirror/file.iso @@ -940,7 +940,7 @@ status:: Those fields must exist in one line. The order of the fields is not significant.You can put pairs other than above; they are simply ignored. -An example is follow: +An example follows: -------------------------------------------------------------------------------- host=localhost, protocol=http, dl_speed=32000, last_updated=1222491640, status=OK host=localhost, protocol=ftp, dl_speed=0, last_updated=1222491632, status=ERROR @@ -951,7 +951,7 @@ FILES aria2.conf ~~~~~~~~~~ User configuration file. -It must be placed under $HOME/.aria2 and must be named as aria2.conf. +It must be placed under $HOME/.aria2 and must be named aria2.conf. In each line, there is 1 parameter whose syntax is name=value pair, where name is the long command-line option name without '--' prefix. The lines beginning '#' are treated as comments.