Fix small typos and grammer in man page.

pull/1/head
Anthony Bryan 2008-11-27 22:24:13 +00:00
parent b3aa7cef1d
commit 796f8373cd
1 changed files with 38 additions and 38 deletions

View File

@ -12,7 +12,7 @@ aria2c ['OPTIONS'] ['URL' | 'TORRENT_FILE' | 'METALINK_FILE']...
DESCRIPTION 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 OPTIONS
------- -------
@ -65,8 +65,8 @@ Basic Options
HTTP/FTP Options HTTP/FTP Options
~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~
*--all-proxy*=PROXY:: *--all-proxy*=PROXY::
Use this proxy server in the all protocols. Use this proxy server for all protocols.
You can override this setting and specify a proxy server for particular You can override this setting and specify a proxy server for a particular
proctol using *--http-proxy*, *--https-proxy* and *--ftp-proxy* options. proctol using *--http-proxy*, *--https-proxy* and *--ftp-proxy* options.
This affects all URLs. This affects all URLs.
The format of PROXY is [\\http://][USER:PASSWORD@]HOST[:PORT] 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 If aria2 recieves `file not found' status from the remote HTTP/FTP
servers NUM times without getting a single byte, then force the servers NUM times without getting a single byte, then force the
download to fail. Specify '0' to disable this option. This options is 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' Default: '0'
*-m*, *--max-tries*=N:: *-m*, *--max-tries*=N::
@ -97,16 +97,16 @@ HTTP/FTP Options
Default: '5' Default: '5'
*--no-proxy*=DOMAINS:: *--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. used.
*-o*, *--out*=FILE:: *-o*, *--out*=FILE::
The file name of the downloaded file. The file name of the downloaded file.
[NOTE] [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 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 aria2c -o myfile.zip \http://mirror1/file.zip \http://mirror2/file.zip
*--proxy-method*=METHOD:: *--proxy-method*=METHOD::
@ -226,11 +226,11 @@ HTTP Specific Options
aria2c *--header*="X-A: b78" *--header*="X-B: 9J1" \http://host/file aria2c *--header*="X-A: b78" *--header*="X-B: 9J1" \http://host/file
*--load-cookies*=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. Mozilla/Firefox(1.x/2.x)/Netscape format.
[NOTE] [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:: *-U*, *--user-agent*=USER_AGENT::
Set user agent for HTTP(S) downloads. Set user agent for HTTP(S) downloads.
@ -269,7 +269,7 @@ FTP Specific Options
BitTorrent/Metalink Options BitTorrent/Metalink Options
~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~
*--select-file*=INDEX...:: *--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. You can find the file index using the *--show-files* option.
Multiple indexes can be specified by using ",", for example: '3,6'. Multiple indexes can be specified by using ",", for example: '3,6'.
You can also use "-" to specify a range: '1-5'. You can also use "-" to specify a range: '1-5'.
@ -296,7 +296,7 @@ BitTorrent Specific Options
*--bt-min-crypto-level*='plain'|'arc4':: *--bt-min-crypto-level*='plain'|'arc4'::
Set minimum level of encryption method. 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. one which satisfies the given level.
Default: 'plain' Default: 'plain'
@ -380,7 +380,7 @@ Make sure that the specified ports are open for incoming TCP traffic.
*--seed-ratio*=RATIO:: *--seed-ratio*=RATIO::
Specify share ratio. Seed completed torrents until share ratio reaches] Specify share ratio. Seed completed torrents until share ratio reaches]
RATIO. 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. 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 If *--seed-time* option is specified along with this option, seeding ends when
at least one of the conditions is satisfied. 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:: *-T*, *--torrent-file*=TORRENT_FILE::
The path to the .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 Metalink Specific Options
~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~
*--follow-metalink*='true'|'false'|'mem':: *--follow-metalink*='true'|'false'|'mem'::
If 'true' or 'mem' is specified, when a file whose suffix is ".metaink" or content 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. file and downloads files mentioned in it.
If 'mem' is specified, a metalink file is not written to the disk, but is just If 'mem' is specified, a metalink file is not written to the disk, but is just
kept in memory. kept in memory.
@ -405,12 +405,12 @@ Metalink Specific Options
Default: 'true' Default: 'true'
*-M*, *--metalink-file*=METALINK_FILE:: *-M*, *--metalink-file*=METALINK_FILE::
The file path to .metalink file. You may not use this option because you can The file path to .metalink file. You are not required to use this option because you can
specify metalink file without -M. specify a metalink file without -M.
*-C*, *--metalink-servers*=NUM_SERVERS:: *-C*, *--metalink-servers*=NUM_SERVERS::
The number of servers to connect to simultaneously. 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. aria2 strictly respects them.
This means that if Metalink defines the maxconnections attribute lower This means that if Metalink defines the maxconnections attribute lower
than NUM_SERVERS, then aria2 uses the value of maxconnections attribute than NUM_SERVERS, then aria2 uses the value of maxconnections attribute
@ -423,7 +423,7 @@ Metalink Specific Options
*--metalink-location*=LOCATION[,...]:: *--metalink-location*=LOCATION[,...]::
The location of the preferred server. 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:: *--metalink-os*=OS::
The operating system of the file to download. The operating system of the file to download.
@ -506,8 +506,8 @@ Advanced Options
Default: '60' Default: '60'
[NOTE] [NOTE]
In multi file torrent, the files adjacent forward to the specified files In multi file torrent downloads, the files adjacent forward to the specified files
are also allocated if they share a same piece. are also allocated if they share the same piece.
*-Z*, *--force-sequential*[='true'|'false']:: *-Z*, *--force-sequential*[='true'|'false']::
Fetch URIs in the command-line sequentially and download each URI in a 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' Default: 'false'
*-q*, *--quiet*[='true'|'false']:: *-q*, *--quiet*[='true'|'false']::
Make aria2 quite (no console output). Make aria2 quiet (no console output).
Default: 'false' Default: 'false'
*--realtime-chunk-checksum*='true'|'false':: *--realtime-chunk-checksum*='true'|'false'::
Validate chunk of data by calculating checkusm while download a file if Validate chunk of data by calculating checksum while downloading a file if
chunk checksums are provided. Currently Metalink is the only way to to chunk checksums are provided. Currently Metalink is the only way to
provide chunk checksums. provide chunk checksums.
Default: 'true' Default: 'true'
@ -561,7 +561,7 @@ OPTIONS THAT TAKE AN OPTIONAL ARGUMENT
The options that have its argument surrounded by square brackets([]) The options that have its argument surrounded by square brackets([])
take an optional argument. Usually ommiting the argument is evaluated to 'true'. 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 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, '-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. 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. 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 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. separate download.
You can specify both torrent file with -T option and URLs. By doing this, 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 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. 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. -s1 limtis the number of connections to just 1.
[NOTE] [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 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 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 aria2c -ifiles.txt -j2
@ -664,7 +664,7 @@ aria2c -p --lowest-speed-limit=4000 file.metalink
---------------------------------------------------------- ----------------------------------------------------------
[NOTE] [NOTE]
To pause a download, press Ctrl-C. 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. directory.
Download several local metalink files 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. --max-upload-limit specifies the max of upload rate.
[NOTE] [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 Download 2 torrents
^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^
@ -744,7 +744,7 @@ aria2c --seed-time=120 --seed-ratio=1.0 file.torrent
------------------------------------------------------- -------------------------------------------------------
[NOTE] [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 Throttle upload speed
^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^
@ -853,13 +853,13 @@ RESUME DOWNLOAD
Usually, you can resume transfer by just issuing same command(aria2c URL) 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 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). download manager, then use -c option to continue the transfer(aria2c -c URL).
CONTROL FILE CONTROL FILE
------------ ------------
aria2 uses a control file to keep track the progress of download. aria2 uses a control file to track the progress of a download.
A control file is placed at the same directory of the dowloading file and 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. 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 For example, if you are downloading file.zip, then the control file should be
file.zip.aria2. file.zip.aria2.
@ -887,7 +887,7 @@ aria2c -V file.torrent
INPUT FILE 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: You can specify multiple URIs for a single entity:
separate URIs on a single line using the TAB character. 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 The additional *out* and *dir* options can be specified after each line of
URIs. This optional line must start with white space(s). 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 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. 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=http, dl_speed=32000, last_updated=1222491640, status=OK
host=localhost, protocol=ftp, dl_speed=0, last_updated=1222491632, status=ERROR host=localhost, protocol=ftp, dl_speed=0, last_updated=1222491632, status=ERROR
@ -951,7 +951,7 @@ FILES
aria2.conf aria2.conf
~~~~~~~~~~ ~~~~~~~~~~
User configuration file. 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, In each line, there is 1 parameter whose syntax is name=value pair,
where name is the long command-line option name without '--' prefix. where name is the long command-line option name without '--' prefix.
The lines beginning '#' are treated as comments. The lines beginning '#' are treated as comments.