/* */ #include "common.h" #include "FeatureConfig.h" #include "messageDigest.h" void showVersion() { cout << PACKAGE << _(" version ") << PACKAGE_VERSION << endl; cout << "**Configuration**" << endl; cout << FeatureConfig::getInstance()->getConfigurationSummary(); #ifdef ENABLE_MESSAGE_DIGEST cout << "message digest algorithms: " << MessageDigestContext::getSupportedAlgoString() << endl; #endif // ENABLE_MESSAGE_DIGEST cout << endl; cout << "Copyright (C) 2006, 2007 Tatsuhiro Tsujikawa" << endl; cout << endl; cout << _("This program is free software; you can redistribute it and/or modify\n" "it under the terms of the GNU General Public License as published by\n" "the Free Software Foundation; either version 2 of the License, or\n" "(at your option) any later version.\n" "\n" "This program is distributed in the hope that it will be useful,\n" "but WITHOUT ANY WARRANTY; without even the implied warranty of\n" "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n" "GNU General Public License for more details.\n" "\n" "You should have received a copy of the GNU General Public License\n" "along with this program; if not, write to the Free Software\n" "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n"); cout << endl; cout << _("Contact Info:") << endl; cout << "Tatsuhiro Tsujikawa " << endl; cout << endl; } void showUsage() { printf(_("Usage: %s [options] URL ...\n"), PACKAGE_NAME); #ifdef ENABLE_BITTORRENT printf(_(" %s [options] -T TORRENT_FILE URL ...\n"), PACKAGE_NAME); #endif // ENABLE_BITTORRENT #ifdef ENABLE_METALINK printf(_(" %s [options] -M METALINK_FILE\n"), PACKAGE_NAME); #endif // ENABLE_METALINK cout << endl; cout << _("Options:") << endl; cout << _(" -d, --dir=DIR The directory to store the downloaded file.") << endl; cout << _(" -o, --out=FILE The file name of the downloaded file.") << endl; cout << _(" -l, --log=LOG The file name of the log file. If '-' is\n" " specified, log is written to stdout.") << endl; #ifdef HAVE_DAEMON cout << _(" -D, --daemon Run as daemon.") << endl; #endif // HAVE_DAEMON cout << _(" -s, --split=N Download a file using N connections. N must be\n" " between 1 and 5. This option affects all URLs.\n" " Thus, aria2 connects to each URL with\n" " N connections.\n" " Default: 1") << endl; cout << _(" --retry-wait=SEC Set the seconds to wait to retry after an error\n" " has occured. Specify a value between 0 and 60.\n" " Default: 5") << endl; cout << _(" -t, --timeout=SEC Set timeout in seconds. Default: 60") << endl; cout << _(" -m, --max-tries=N Set number of tries. 0 means unlimited.\n" " Default: 5") << endl; /* cout << _(" --min-segment-size=SIZE[K|M] Set minimum segment size. You can append\n" " K or M(1K = 1024, 1M = 1024K). This\n" " value must be greater than or equal to\n" " 1024. Default: 1M") << endl; */ cout << _(" --http-proxy=HOST:PORT Use HTTP proxy server. This affects all URLs.") << endl; cout << _(" --http-user=USER Set HTTP user. This affects all URLs.") << endl; cout << _(" --http-passwd=PASSWD Set HTTP password. This affects all URLs.") << endl; cout << _(" --http-proxy-user=USER Set HTTP proxy user. This affects all URLs.") << endl; cout << _(" --http-proxy-passwd=PASSWD Set HTTP proxy password. This affects all URLs.") << endl; cout << _(" --http-proxy-method=METHOD Set the method to use in proxy request.\n" " METHOD is either 'get' or 'tunnel'.\n" " Default: tunnel") << endl; cout << _(" --http-auth-scheme=SCHEME Set HTTP authentication scheme. Currently, basic\n" " is the only supported scheme.\n" " Default: basic") << endl; cout << _(" --referer=REFERER Set Referer. This affects all URLs.") << endl; cout << _(" --ftp-user=USER Set FTP user. This affects all URLs.\n" " Default: anonymous") << endl; cout << _(" --ftp-passwd=PASSWD Set FTP password. This affects all URLs.\n" " Default: ARIA2USER@") << endl; cout << _(" --ftp-type=TYPE Set FTP transfer type. TYPE is either 'binary'\n" " or 'ascii'.\n" " Default: binary") << endl; cout << _(" -p, --ftp-pasv Use passive mode in FTP.") << endl; cout << _(" --ftp-via-http-proxy=METHOD Use HTTP proxy in FTP. METHOD is either 'get' or\n" " 'tunnel'.\n" " Default: tunnel") << endl; cout << _(" --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.\n" " Default: 0") << endl; cout << _(" --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).\n" " Default: 0") << endl; cout << _(" --file-allocation=METHOD Specify file allocation method. METHOD is either\n" " 'none' or 'prealloc'. 'none' doesn't pre-allocate\n" " file space. 'prealloc' pre-allocates file space\n" " before download begins. This may take some time\n" " depending on the size of the file.\n" " Default: none") << endl; cout << _(" --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.\n" " Default: false") << endl; cout << _(" -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.\n" " Default: false") << endl; cout << _(" --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.\n" " Default: true") << endl; cout << _(" -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.\n" " Default: false") << endl; cout << _(" --enable-http-keep-alive[=true|false] Enable HTTP/1.1 persistant connection.\n" " Default: false") << endl; cout << _(" --enable-http-pipelining[=true|false] Enable HTTP/1.1 pipelining.\n" " Default: false") << endl; #ifdef ENABLE_MESSAGE_DIGEST cout << _(" --check-integrity=true|false Check file integrity by validating piece hash.\n" " This option only affects in BitTorrent downloads\n" " and Metalink downloads with chunk checksums.\n" " Use this option to re-download a damaged portion\n" " of a file.\n" " You may need to specify --allow-overwrite=true\n" " if the .aria2 file doesn't exist.\n" " Default: false") << endl; cout << _(" --realtime-chunk-checksum=true|false Validate chunk checksum while\n" " downloading a file in Metalink mode. This option\n" " on affects Metalink mode with chunk checksums.\n" " Default: true") << endl; #endif // ENABLE_MESSAGE_DIGEST cout << _(" -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.") << endl; cout << _(" -U, --user-agent=USER_AGENT Set user agent for http(s) downloads.") << endl; cout << _(" -n, --no-netrc Disables netrc support.") << endl; cout << _(" -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.") << endl; cout << _(" -j, --max-concurrent-downloads=N Set maximum number of concurrent downloads.\n" " It should be used with the -i option.\n" " Default: 5") << endl; cout << _(" --load-cookies=FILE Load cookies from FILE. The format of FILE is\n" " the same used by Netscape and Mozilla.") << endl; #if defined ENABLE_BITTORRENT || ENABLE_METALINK cout << _(" -S, --show-files Print file listing of .torrent or .metalink file\n" " and exit.") << endl; cout << _(" --select-file=INDEX... Set file to download by specifing 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).") << endl; #endif // ENABLE_BITTORRENT || ENABLE_METALINK #ifdef ENABLE_BITTORRENT cout << _(" -T, --torrent-file=TORRENT_FILE The path to the .torrent file.") << endl; cout << _(" --follow-torrent=true|false Set to false to prevent aria2 from\n" " entering BitTorrent mode even if the filename of\n" " the downloaded file ends with .torrent.\n" " Default: true") << endl; cout << _(" --direct-file-mapping=true|false Directly read from and write to each file\n" " mentioned in .torrent file.\n" " Default: true") << endl; cout << _(" --listen-port=PORT Set TCP port number for BitTorrent downloads.\n" " Default: 6881-6999") << endl; cout << _(" --max-upload-limit=SPEED Set max upload speed in bytes per sec.\n" " 0 means unrestricted.\n" " You can append K or M(1K = 1024, 1M = 1024K).\n" " Default: 0") << endl; cout << _(" --seed-time=MINUTES Specify seeding time in minutes. Also see the\n" " --seed-ratio option.") << endl; cout << _(" --seed-ratio=RATIO Specify share ratio. Seed completed torrents\n" " until share ratio reaches RATIO. 1.0 is\n" " encouraged. If --seed-time option is specified\n" " along with this option, seeding ends when at\n" " least one of the conditions is satisfied.") << endl; cout << _(" --peer-id-prefix=PEERI_ID_PREFIX Specify the prefix of peer ID. The peer ID in\n" " in 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.\n" " Default: -aria2-") << endl; #endif // ENABLE_BITTORRENT #ifdef ENABLE_METALINK cout << _(" -M, --metalink-file=METALINK_FILE The file path to the .metalink file.") << endl; cout << _(" -C, --metalink-servers=NUM_SERVERS The number of servers to connect to\n" " simultaneously.\n" " Default: 5") << endl; cout << _(" --metalink-version=VERSION The version of the file to download.") << endl; cout << _(" --metalink-language=LANGUAGE The language of the file to download.") << endl; cout << _(" --metalink-os=OS The operating system of the file to download.") << endl; cout << _(" --metalink-location=LOCATION The location of the prefered server.") << endl; cout << _(" --follow-metalink=true|false Set to false to prevent aria2 from\n" " entering Metalink mode even if the filename of\n" " the downloaded file ends with .metalink.\n" " Default: true") << endl; #endif // ENABLE_METALINK cout << _(" -v, --version Print the version number and exit.") << endl; cout << _(" -h, --help Print this message and exit.") << endl; cout << endl; cout << "URL:" << endl; cout << _(" You can specify multiple URLs. All URLs must point to the same file\n" " or downloading will fail.") << endl; cout << endl; cout << _("Examples:") << endl; cout << _(" Download a file using 1 connection:") << endl; cout << " aria2c http://AAA.BBB.CCC/file.zip" << endl; cout << _(" Download a file using 2 connections:") << endl; cout << " aria2c -s 2 http://AAA.BBB.CCC/file.zip" << endl; cout << _(" Download a file using 2 connections, each connects to a different server:") << endl; cout << " aria2c http://AAA.BBB.CCC/file.zip http://DDD.EEE.FFF/GGG/file.zip" << endl; cout << _(" You can mix up different protocols:") << endl; cout << " aria2c http://AAA.BBB.CCC/file.zip ftp://DDD.EEE.FFF/GGG/file.zip" << endl; cout << _(" Parameterized URI:") << endl; cout << " aria2c -P http://{server1,server2,server3}/file.iso" << endl; cout << _(" Parameterized URI. -Z option is required in this case:") << endl; cout << " aria2c -P -Z http://host/file[001-100:2].img" << endl; #ifdef ENABLE_BITTORRENT cout << endl; cout << _(" Download a torrent:") << endl; cout << " aria2c -o test.torrent http://AAA.BBB.CCC/file.torrent" << endl; cout << _(" Download a torrent using a local .torrent file:") << endl; cout << " aria2c -T test.torrent" << endl; cout << _(" Download only selected files:") << endl; cout << " aria2c -T test.torrent dir/file1.zip dir/file2.zip" << endl; cout << _(" Print file listing of .torrent file:") << endl; cout << " aria2c -T test.torrent -S" << endl; #endif // ENABLE_BITTORRENT #ifdef ENABLE_METALINK cout << endl; cout << _(" Metalink downloading:") << endl; cout << " aria2c http://AAA.BBB.CCC/file.metalink" << endl; cout << _(" Download a file using local .metalink file:") << endl; cout << " aria2c -M test.metalink" << endl; cout << _(" Metalink downloading with preferences:") << endl; cout << " aria2c -M test.metalink --metalink-version=1.1.1 --metalink-language=en-US" << endl; cout << _(" Download only selected files:") << endl; cout << " aria2c -M test.metalink --metalink-language=en-US dir/file1.zip dir/file2.zip" << endl; cout << _(" Download only selected files using index:") << endl; cout << " aria2c -M test.metalink --metalink-language=en-US --select-file 1,3-5" << endl; cout << _(" Print file listing of .metalink file:") << endl; cout << " aria2c -M test.metalink -S --metalink-language=en-US" << endl; #endif // ENABLE_METALINK cout << endl; printf(_("Report bugs to %s"), ""); cout << endl; }