1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
|
/* <!-- copyright */
/*
* aria2 - The high speed download utility
*
* Copyright (C) 2006 Tatsuhiro Tsujikawa
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
*
* In addition, as a special exception, the copyright holders give
* permission to link the code of portions of this program with the
* OpenSSL library under certain conditions as described in each
* individual source file, and distribute linked combinations
* including the two.
* You must obey the GNU General Public License in all respects
* for all of the code used other than OpenSSL. If you modify
* file(s) with this exception, you may extend this exception to your
* version of the file(s), but you are not obligated to do so. If you
* do not wish to do so, delete this exception statement from your
* version. If you delete this exception statement from all source
* files in the program, then also delete it here.
*/
/* copyright --> */
#define TEXT_DIR \
_(" -d, --dir=DIR The directory to store the downloaded file.")
#define TEXT_OUT \
_(" -o, --out=FILE The file name of the downloaded file.")
#define TEXT_LOG \
_(" -l, --log=LOG The file name of the log file. If '-' is\n"\
" specified, log is written to stdout.")
#define TEXT_DAEMON \
_(" -D, --daemon Run as daemon.")
#define TEXT_SPLIT \
_(" -s, --split=N Download a file using N connections. If more\n"\
" than N URLs are given, first N URLs are used and\n"\
" remaining URLs are used for backup. If less than\n"\
" N URLs are given, those URLs are used more than\n"\
" once so that N connections total are made\n"\
" simultaneously. Please see -j option too.\n"\
" Please note that in Metalink download, this\n"\
" option has no effect and use -C option instead.")
#define TEXT_RETRY_WAIT \
_(" --retry-wait=SEC Set the seconds to wait to retry after an error\n"\
" has occured.")
#define TEXT_TIMEOUT \
_(" -t, --timeout=SEC Set timeout in seconds.")
#define TEXT_MAX_TRIES \
_(" -m, --max-tries=N Set number of tries. 0 means unlimited.")
#define TEXT_HTTP_PROXY \
_(" --http-proxy=PROXY Use this proxy server for HTTP.\n"\
" See also --all-proxy option.\n"\
" This affects all URLs.")
#define TEXT_HTTPS_PROXY \
_(" --https-proxy=PROXY Use this proxy server for HTTPS.\n"\
" See also --all-proxy option.\n"\
" This affects all URLs.")
#define TEXT_FTP_PROXY \
_(" --ftp-proxy=PROXY Use this proxy server for FTP.\n"\
" See also --all-proxy option.\n"\
" This affects all URLs.")
#define TEXT_ALL_PROXY \
_(" --all-proxy=PROXY Use this proxy server for all protocols.\n"\
" You can override this setting and specify a\n"\
" proxy server for a particular protocol using\n"\
" --http-proxy, --https-proxy and --ftp-proxy\n"\
" options.\n"\
" This affects all URLs.")
#define TEXT_HTTP_USER \
_(" --http-user=USER Set HTTP user. This affects all URLs.")
#define TEXT_HTTP_PASSWD \
_(" --http-passwd=PASSWD Set HTTP password. This affects all URLs.")
#define TEXT_PROXY_METHOD \
_(" --proxy-method=METHOD Set the method to use in proxy request.")
#define TEXT_HTTP_AUTH_SCHEME \
_(" --http-auth-scheme=SCHEME Set HTTP authentication scheme. Currently, basic\n"\
" is the only supported scheme.")
#define TEXT_REFERER \
_(" --referer=REFERER Set Referer. This affects all URLs.")
#define TEXT_FTP_USER \
_(" --ftp-user=USER Set FTP user. This affects all URLs.")
#define TEXT_FTP_PASSWD \
_(" --ftp-passwd=PASSWD Set FTP password. This affects all URLs.")
#define TEXT_FTP_TYPE \
_(" --ftp-type=TYPE Set FTP transfer type.")
#define TEXT_FTP_PASV \
_(" -p, --ftp-pasv[=true|false] Use the passive mode in FTP. If false is given,\n"\
" the active mode will be used.")
#define TEXT_LOWEST_SPEED_LIMIT \
_(" --lowest-speed-limit=SPEED Close connection if download speed is lower than\n"\
" or equal to this value(bytes per sec).\n"\
" 0 means aria2 does not have a lowest speed limit.\n"\
" You can append K or M(1K = 1024, 1M = 1024K).\n"\
" This option does not affect BitTorrent downloads.")
#define TEXT_MAX_DOWNLOAD_LIMIT \
_(" --max-download-limit=SPEED Set max download speed in bytes per sec.\n"\
" 0 means unrestricted.\n"\
" You can append K or M(1K = 1024, 1M = 1024K).")
#define TEXT_FILE_ALLOCATION \
_(" --file-allocation=METHOD Specify file allocation method.\n"\
" 'none' doesn't pre-allocate file space. 'prealloc'\n"\
" pre-allocates file space before download begins.\n"\
" This may take some time depending on the size of\n"\
" the file.")
#define TEXT_NO_FILE_ALLOCATION_LIMIT \
_(" --no-file-allocation-limit=SIZE No file allocation is made for files whose\n"\
" size is smaller than SIZE.\n"\
" You can append K or M(1K = 1024, 1M = 1024K).")
# define TEXT_ENABLE_DIRECT_IO \
_(" --enable-direct-io[=true|false] Enable directI/O, which lowers cpu usage while\n"\
" allocating files.\n"\
" Turn off if you encounter any error")
#define TEXT_ALLOW_OVERWRITE \
_(" --allow-overwrite=true|false If false, aria2 doesn't download a file which\n"\
" already exists but the corresponding .aria2 file\n"\
" doesn't exist.")
#define TEXT_ALLOW_PIECE_LENGTH_CHANGE \
_(" --allow-piece-length-change=true|false If false is given, aria2 aborts download\n"\
" when a piece length is different from one in\n"\
" a control file. If true is given, you can proceed\n"\
" but some download progress will be lost.")
#define TEXT_FORCE_SEQUENTIAL \
_(" -Z, --force-sequential[=true|false] Fetch URIs in the command-line sequentially\n"\
" and download each URI in a separate session, like\n"\
" the usual command-line download utilities.")
#define TEXT_AUTO_FILE_RENAMING \
_(" --auto-file-renaming[=true|false] Rename file name if the same file already\n"\
" exists. This option works only in http(s)/ftp\n"\
" download.\n"\
" The new file name has a dot and a number(1..9999)\n"\
" appended.")
#define TEXT_PARAMETERIZED_URI \
_(" -P, --parameterized-uri[=true|false] Enable parameterized URI support.\n"\
" You can specify set of parts:\n"\
" http://{sv1,sv2,sv3}/foo.iso\n"\
" Also you can specify numeric sequences with step\n"\
" counter:\n"\
" http://host/image[000-100:2].img\n"\
" A step counter can be omitted.\n"\
" If all URIs do not point to the same file, such\n"\
" as the second example above, -Z option is\n"\
" required.")
#define TEXT_ENABLE_HTTP_KEEP_ALIVE \
_(" --enable-http-keep-alive[=true|false] Enable HTTP/1.1 persistent connection.")
#define TEXT_ENABLE_HTTP_PIPELINING \
_(" --enable-http-pipelining[=true|false] Enable HTTP/1.1 pipelining.")
#define TEXT_CHECK_INTEGRITY \
_(" -V, --check-integrity[=true|false] Check file integrity by validating piece\n"\
" hashes. This option has effect only in BitTorrent\n"\
" and Metalink downloads with chunk checksums.\n"\
" Use this option to re-download a damaged portion\n"\
" of a file.")
#define TEXT_REALTIME_CHUNK_CHECKSUM \
_(" --realtime-chunk-checksum=true|false Validate chunk of data by calculating\n"\
" checksum while downloading a file if chunk\n"\
" checksums are provided.")
#define TEXT_CONTINUE \
_(" -c, --continue Continue downloading a partially downloaded\n"\
" file. Use this option to resume a download\n"\
" started by a web browser or another program\n"\
" which downloads files sequentially from the\n"\
" beginning. Currently this option is only\n"\
" applicable to http(s)/ftp downloads.")
#define TEXT_USER_AGENT \
_(" -U, --user-agent=USER_AGENT Set user agent for http(s) downloads.")
#define TEXT_NO_NETRC \
_(" -n, --no-netrc Disables netrc support.")
#define TEXT_INPUT_FILE \
_(" -i, --input-file=FILE Downloads URIs found in FILE. You can specify\n"\
" multiple URIs for a single entity: separate\n"\
" URIs on a single line using the TAB character.\n"\
" Reads input from stdin when '-' is specified.\n"\
" The additional out and dir options can be\n"\
" specified after each line of URIs. This optional\n"\
" line must start with white space(s). See INPUT\n"\
" FILE section of man page for details.")
#define TEXT_MAX_CONCURRENT_DOWNLOADS \
_(" -j, --max-concurrent-downloads=N Set maximum number of parallel downloads for\n"\
" every static (HTTP/FTP) URL, torrent and metalink.\n"\
" See also -s and -C options.")
#define TEXT_LOAD_COOKIES \
_(" --load-cookies=FILE Load Cookies from FILE using the Firefox3 format\n"\
" and Mozilla/Firefox(1.x/2.x)/Netscape format.")
#define TEXT_SHOW_FILES \
_(" -S, --show-files Print file listing of .torrent or .metalink file\n"\
" and exit. More detailed information will be listed\n"\
" in case of torrent file.")
#define TEXT_SELECT_FILE \
_(" --select-file=INDEX... Set file to download by specifying its index.\n"\
" You can find the file index using the\n"\
" --show-files option. Multiple indexes can be\n"\
" specified by using ',', for example: \"3,6\".\n"\
" You can also use '-' to specify a range: \"1-5\".\n"\
" ',' and '-' can be used together.\n"\
" When used with the -M option, index may vary\n"\
" depending on the query(see --metalink-* options).")
#define TEXT_TORRENT_FILE \
_(" -T, --torrent-file=TORRENT_FILE The path to the .torrent file.")
#define TEXT_FOLLOW_TORRENT \
_(" --follow-torrent=true|false|mem If true or mem is specified, when a file\n"\
" whose suffix is .torrent or content type is\n"\
" application/x-bittorrent is downloaded, aria2\n"\
" parses it as a torrent file and downloads files\n"\
" mentioned in it.\n"\
" If mem is specified, a torrent file is not\n"\
" written to the disk, but is just kept in memory.\n"\
" If false is specified, the action mentioned above\n"\
" is not taken.")
#define TEXT_DIRECT_FILE_MAPPING \
_(" --direct-file-mapping=true|false Directly read from and write to each file\n"\
" mentioned in .torrent file.")
#define TEXT_LISTEN_PORT \
_(" --listen-port=PORT... Set TCP port number for BitTorrent downloads.\n"\
" Multiple ports can be specified by using ',',\n"\
" for example: \"6881,6885\". You can also use '-'\n"\
" to specify a range: \"6881-6999\". ',' and '-' can\n"\
" be used together.")
#define TEXT_MAX_OVERALL_UPLOAD_LIMIT \
_(" --max-overall-upload-limit=SPEED Set max overall upload speed in bytes/sec.\n"\
" 0 means unrestricted.\n"\
" You can append K or M(1K = 1024, 1M = 1024K).\n"\
" To limit the upload speed per torrent, use\n"\
" --max-upload-limit option. If non-zero value is\n"\
" specified, --max-upload-limit option is ignored.")
#define TEXT_MAX_UPLOAD_LIMIT \
_(" -u, --max-upload-limit=SPEED Set max upload speed per each torrent in\n"\
" bytes/sec. 0 means unrestricted.\n"\
" You can append K or M(1K = 1024, 1M = 1024K).\n"\
" To limit the overall upload speed, use\n"\
" --max-overall-upload-limit option.")
#define TEXT_SEED_TIME \
_(" --seed-time=MINUTES Specify seeding time in minutes. Also see the\n"\
" --seed-ratio option.")
#define TEXT_SEED_RATIO \
_(" --seed-ratio=RATIO Specify share ratio. Seed completed torrents\n"\
" until share ratio reaches RATIO.\n"\
" You are strongly encouraged to specify equals or\n"\
" more than 1.0 here. Specify 0.0 if you intend to\n"\
" do seeding regardless of share ratio.\n" \
" If --seed-time option is specified along with\n"\
" this option, seeding ends when at least one of\n"\
" the conditions is satisfied.")
#define TEXT_PEER_ID_PREFIX \
_(" --peer-id-prefix=PEERI_ID_PREFIX Specify the prefix of peer ID. The peer ID in\n"\
" BitTorrent is 20 byte length. If more than 20\n"\
" bytes are specified, only first 20\n"\
" bytes are used. If less than 20 bytes are\n"\
" specified, the random alphabet characters are\n"\
" added to make it's length 20 bytes.")
#define TEXT_ENABLE_PEER_EXCHANGE \
_(" --enable-peer-exchange[=true|false] Enable Peer Exchange extension.")
#define TEXT_ENABLE_DHT \
_(" --enable-dht[=true|false] Enable DHT functionality.")
#define TEXT_DHT_LISTEN_PORT \
_(" --dht-listen-port=PORT... Set UDP listening port for DHT.\n"\
" Multiple ports can be specified by using ',',\n"\
" for example: \"6881,6885\". You can also use '-'\n"\
" to specify a range: \"6881-6999\". ',' and '-' can\n"\
" be used together.")
#define TEXT_DHT_ENTRY_POINT \
_(" --dht-entry-point=HOST:PORT Set host and port as an entry point to DHT\n"\
" network.")
#define TEXT_DHT_FILE_PATH \
_(" --dht-file-path=PATH Change the DHT routing table file to PATH.")
#define TEXT_BT_MIN_CRYPTO_LEVEL \
_(" --bt-min-crypto-level=plain|arc4 Set minimum level of encryption method.\n"\
" If several encryption methods are provided by a\n"\
" peer, aria2 chooses the lowest one which satisfies\n"\
" the given level.")
#define TEXT_BT_REQUIRE_CRYPTO \
_(" --bt-require-crypto=true|false If true is given, aria2 doesn't accept and\n"\
" establish connection with legacy BitTorrent\n"\
" handshake. Thus aria2 always uses Obfuscation\n"\
" handshake.")
#define TEXT_BT_REQUEST_PEER_SPEED_LIMIT \
_(" --bt-request-peer-speed-limit=SPEED In BitTorrent downloads, if the download\n"\
" speed is lower than SPEED, aria2 initiates and\n"\
" accepts connections ignoring max peer cap.\n"\
" You can append K or M(1K = 1024, 1M = 1024K).")
#define TEXT_BT_MAX_OPEN_FILES \
_(" --bt-max-open-files=NUM Specify maximum number of files to open in each\n"\
" BitTorrent download.")
#define TEXT_BT_SEED_UNVERIFIED \
_(" --bt-seed-unverified[=true|false] Seed previously downloaded files without\n"\
" verifying piece hashes.")
#define TEXT_METALINK_FILE \
_(" -M, --metalink-file=METALINK_FILE The file path to the .metalink file.")
#define TEXT_METALINK_SERVERS \
_(" -C, --metalink-servers=NUM_SERVERS The number of servers to connect to\n"\
" simultaneously. Some Metalinks regulate the\n"\
" number of servers to connect. aria2 strictly\n"\
" respects them. This means that if Metalink defines\n"\
" the maxconnections attribute lower than\n"\
" NUM_SERVERS, then aria2 uses the value of\n"\
" maxconnections attribute instead of NUM_SERVERS.\n"\
" See also -s and -j options.")
#define TEXT_METALINK_VERSION \
_(" --metalink-version=VERSION The version of the file to download.")
#define TEXT_METALINK_LANGUAGE \
_(" --metalink-language=LANGUAGE The language of the file to download.")
#define TEXT_METALINK_OS \
_(" --metalink-os=OS The operating system of the file to download.")
#define TEXT_METALINK_LOCATION \
_(" --metalink-location=LOCATION[,...] The location of the preferred server.\n"\
" A comma-delimited list of locations is\n"\
" acceptable.")
#define TEXT_METALINK_PREFERRED_PROTOCOL \
_(" --metalink-preferred-protocol=PROTO Specify preferred protocol. Specify 'none'\n"\
" if you don't have any preferred protocol.")
#define TEXT_FOLLOW_METALINK \
_(" --follow-metalink=true|false|mem If true or mem is specified, when a file\n"\
" whose suffix is .metaink or content type of\n"\
" application/metalink+xml is downloaded, aria2\n"\
" parses it as a metalink file and downloads files\n"\
" mentioned in it.\n"\
" If mem is specified, a metalink file is not\n"\
" written to the disk, but is just kept in memory.\n"\
" If false is specified, the action mentioned above\n"\
" is not taken.")
#define TEXT_METALINK_ENABLE_UNIQUE_PROTOCOL \
_(" --metalink-enable-unique-protocol=true|false If true is given and several\n"\
" protocols are available for a mirror in a metalink\n"\
" file, aria2 uses one of them.\n"\
" Use --metalink-preferred-protocol option to\n"\
" specify the preference of protocol.")
#define TEXT_VERSION \
_(" -v, --version Print the version number and exit.")
#define TEXT_HELP \
_(" -h, --help[=CATEGORY] Print usage and exit.\n"\
" The help messages are classified in several\n"\
" categories. For example, type \"--help=http\" for\n"\
" detailed explanation for the options related to\n"\
" http. If no matching category is found, search\n"\
" option name using a given word in middle match\n"\
" and print the result.")
#define TEXT_NO_CONF \
_(" --no-conf Disable loading aria2.conf file.")
#define TEXT_CONF_PATH \
_(" --conf-path=PATH Change the configuration file path to PATH.")
#define TEXT_STOP \
_(" --stop=SEC Stop application after SEC seconds has passed.\n" \
" If 0 is given, this feature is disabled.")
#define TEXT_HEADER \
_(" --header=HEADER Append HEADER to HTTP request header. You can use\n"\
" this option repeatedly to specify more than one\n"\
" header:\n"\
" aria2c --header=\"X-A: b78\" --header=\"X-B: 9J1\"\n"\
" http://host/file")
#define TEXT_QUIET \
_(" -q, --quiet[=true|false] Make aria2 quiet(no console output).")
#define TEXT_ASYNC_DNS \
_(" --async-dns[=true|false] Enable asynchronous DNS.")
#define TEXT_FTP_REUSE_CONNECTION \
_(" --ftp-reuse-connection[=true|false] Reuse connection in FTP.")
#define TEXT_SUMMARY_INTERVAL \
_(" --summary-interval=SEC Set interval to output download progress summary.\n"\
" Setting 0 suppresses the output.")
#define TEXT_LOG_LEVEL \
_(" --log-level=LEVEL Set log level to output.")
#define TEXT_REMOTE_TIME \
_(" -R, --remote-time[=true|false] Retrieve timestamp of the remote file from the\n"\
" remote HTTP/FTP server and if it is available,\n"\
" apply it to the local file.")
#define TEXT_CONNECT_TIMEOUT \
_(" --connect-timeout=SEC Set the connect timeout in seconds to establish\n"\
" connection to HTTP/FTP/proxy server. After the\n"\
" connection is established, this option makes no\n"\
" effect and --timeout option is used instead.")
#define TEXT_MAX_FILE_NOT_FOUND \
_(" --max-file-not-found=NUM If aria2 receives `file not found' status from the\n"\
" remote HTTP/FTP servers NUM times without getting\n"\
" a single byte, then force the download to fail.\n"\
" Specify 0 to disable this option.\n"\
" This options is effective only when using\n"\
" HTTP/FTP servers.")
#define TEXT_URI_SELECTOR \
_(" --uri-selector=SELECTOR Specify URI selection algorithm.\n"\
" If 'inorder' is given, URI is tried in the order\n"\
" appeared in the URI list.\n"\
" If 'feedback' is given, aria2 uses download speed\n"\
" observed in the previous downloads and choose\n"\
" fastest server in the URI list. This also\n"\
" effectively skips dead mirrors. The observed\n"\
" download speed is a part of performance profile\n"\
" of servers mentioned in --server-stat-of and\n"\
" --server-stat-if options.")
#define TEXT_SERVER_STAT_OF \
_(" --server-stat-of=FILE Specify the filename to which performance profile\n"\
" of the servers is saved. You can load saved data\n"\
" using --server-stat-if option.")
#define TEXT_SERVER_STAT_IF \
_(" --server-stat-if=FILE Specify the filename to load performance profile\n"\
" of the servers. The loaded data will be used in\n"\
" some URI selector such as 'feedback'.\n"\
" See also --uri-selector option")
#define TEXT_SERVER_STAT_TIMEOUT \
_(" --server-stat-timeout=SEC Specifies timeout in seconds to invalidate\n"\
" performance profile of the servers since the last\n"\
" contact to them.")
#define TEXT_AUTO_SAVE_INTERVAL \
_(" --auto-save-interval=SEC Save a control file(*.aria2) every SEC seconds.\n"\
" If 0 is given, a control file is not saved during\n"\
" download. aria2 saves a control file when it stops\n"\
" regardless of the value.")
#define TEXT_CERTIFICATE \
_(" --certificate=FILE Use the client certificate in FILE.\n"\
" The certificate must be in PEM format.\n"\
" You may use --private-key option to specify the\n"\
" private key.")
#define TEXT_PRIVATE_KEY \
_(" --private-key=FILE Use the private key in FILE.\n"\
" The private key must be decrypted and in PEM\n"\
" format. See also --certificate option.")
#define TEXT_CA_CERTIFICATE \
_(" --ca-certificate=FILE Use the certificate authorities in FILE to verify\n"\
" the peers. The certificate file must be in PEM\n"\
" format and can contain multiple CA certificates.\n"\
" Use --check-certificate option to enable\n"\
" verification.")
#define TEXT_CHECK_CERTIFICATE \
_(" --check-certificate[=true|false] Verify the peer using certificates specified\n"\
" in --ca-certificate option.")
#define TEXT_NO_PROXY \
_(" --no-proxy=DOMAINS Specify comma separated hostnames or domains where\n"\
" proxy should not be used.")
|
