axel.1 5.73 KB
Newer Older
1
.\" Text automatically generated by txt2man
2
.TH axel 1 "10 September 2017" "axel-2.14" "light command line download accelerator"
3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21
.SH NAME
\fBaxel \fP- light command line download accelerator
\fB
.SH SYNOPSIS
.nf
.fam C
 \fBaxel\fP [\fIOPTIONS\fP] \fIurl1\fP [\fIurl2\fP] [url\.\.\.]

.fam T
.fi
.fam T
.fi
.SH DESCRIPTION
Axel is a program that downloads a file from a FTP or HTTP server through multiple connection.
Each connection downloads its own part of the file.
.PP
Unlike most other programs, Axel downloads all the data directly to the destination file, using
one single thread. It just saves some time at the end because the program does not have to
concatenate all the downloaded parts.
22 23
.PP
Axel supports HTTP, HTTPS, FTP and FTPS protocols.
24 25 26
.SH OPTIONS
One argument is required, the URL to the file you want to download. When downloading from FTP,
the filename may contain wildcards and the program will try to resolve the full filename. Multiple
27 28 29 30
mirror URLs to an identical file can be specified as well and the program will use all those URLs
for the download.
.PP
Please note that the program does not check whether the files are equal.
31 32 33 34 35 36 37 38 39 40 41 42 43 44
.PP
Other options:
.TP
.B
\fB--max-speed\fP=x, \fB-s\fP x
Specify a speed (bytes per second) to try to keep the average speed around this
speed. This is useful if you do not want the program to suck up all of your
bandwidth.
.TP
.B
\fB--num-connections\fP=x, \fB-n\fP x
Specify an alternative number of connections.
.TP
.B
45 46 47 48 49
\fB--max-redirect\fP=x
Specify an alternative number of redirections to follow when connecting to the
server (default is 20).
.TP
.B
50 51 52 53 54 55 56 57 58 59 60 61 62 63
\fB--output\fP=x, \fB-o\fP x
Downloaded data will be put in a local file with the same name, unless you specify
a different name using this option. You can specify a directory as well, the program
will append the filename.
.TP
.B
\fB--search\fP[=x], \fB-S\fP[x]
Axel can do a search for mirrors using the filesearching.com search engine. This
search will be done if you use this option. You can specify how many different
mirrors should be used for the download as well. The search for mirrors can be
time-consuming because the program tests every server's speed, and it checks
whether the file's still available.
.TP
.B
64 65 66 67 68 69 70 71
\fB--ipv6\fP, \fB-6\fP
Use the IPv6 protocol only when connecting to the host.
.TP
.B
\fB--ipv4\fP, \fB-4\fP
Use the IPv4 protocol only when connecting to the host.
.TP
.B
72 73 74 75 76
\fB--no-proxy\fP, \fB-N\fP
Do not use any proxy server to download the file. Not possible when a transparent proxy
is active somewhere, of course.
.TP
.B
77 78 79
\fB--insecure\fP, \fB-k\fP
Do not verify the SSL certificate. Only use this if you are getting certificate errors
and you are sure of the sites authenticity.
80 81
.PP
\fB--no-clobber\fP, \fB-c\fP Skip download if a file with the same name already exists in the current folder and no state file is found.
82 83
.TP
.B
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
\fB--verbose\fP, \fB-v\fP
Show more status messages. Use it more than once to see more details.
.TP
.B
\fB--quiet\fP, \fB-q\fP
No output to stdout.
.TP
.B
\fB--alternate\fP, \fB-a\fP
This will show an alternate progress indicator. A bar displays the progress and status
of the different threads, along with current speed and an estimate for the remaining
download time.
.TP
.B
\fB--header\fP=x, \fB-H\fP x
Add an additional HTTP header. This option should be in the form "Header: Value". See
RFC 2616 section 4.2 and 14 for details on the format and standardized headers.
.TP
.B
\fB--user-agent\fP=x, \fB-U\fP x
Set the HTTP user agent to use. Some websites serve different content based upon
this parameter. The default value will include "Axel", its version and the platform.
.TP
.B
\fB--help\fP, \fB-h\fP
A brief summary of all the options.
.TP
.B
\fB--version\fP, \fB-V\fP
Get version information.
.SH NOTE
Long (double dash) options are supported only if your platform knows about the getopt_long call. If it
does not (like *BSD), only the short options can be used.
.SH RETURN VALUE
The program returns 0 when the download was successful, 1 if something really went wrong and 2 if the
download was interrupted. If something else comes back, it must be a bug.
.SH EXAMPLES
121 122 123 124
The trivial usage to download a file is similar to:
.PP
.nf
.fam C
125
    $ axel http://cdimage.debian.org/debian-cd/current/amd64/iso-cd/debian-9.1.0-amd64-netinst.iso
126

127 128 129 130
    $ axel ftp://ftp.nl.kernel.org/pub/linux/kernel/v2.2/linux-2.2.20.tar.bz2

.fam T
.fi
131 132 133 134 135
This will use the Belgian, Dutch, English and German kernel.org mirrors to download a Linux 2.4.17
kernel image.
.PP
.nf
.fam C
136
    $ axel ftp://ftp.{be,nl,uk,de}.kernel.org/pub/linux/kernel/v2.4/linux-2.4.17.tar.bz2
137 138 139 140 141 142 143 144 145

.fam T
.fi
This will do a search for the linux-2.4.17.tar.bz2 file on filesearching.com and it'll use the four (if possible)
fastest mirrors for the download (possibly including ftp.kernel.org). Of course, the commands are a single
line, but they're too long to fit on one line in this page.
.PP
.nf
.fam C
146
    $ axel -S4 ftp://ftp.kernel.org/pub/linux/kernel/v2.4/linux-2.4.17.tar.bz2
147 148 149 150 151 152 153 154 155 156 157

.fam T
.fi
.SH FILES
.TP
.B
/etc/axelrc
System-wide configuration file.
.TP
.B
~/.axelrc
158
Personal configuration file.
159 160
.PP
These files are not documented in a manpage, but the example file which comes with the program contains
161 162
enough information. The position of the system-wide configuration file might be different. In source code this
example file is at doc/ directory. On Debian systems, it is at /usr/share/doc/\fBaxel\fP/examples/ directory.
163
.SH COPYRIGHT
164
Axel was originally written by Wilmer van der Gaast and other authors over time. Please, see the AUTHORS and CREDITS files.
165
.PP
166
The current Axel homepage (since 2015) is https://github.com/\fBaxel\fP-download-accelerator/\fBaxel\fP
167
.SH HELP THIS PROJECT
168 169
If you intent to help, please, read the CONTRIBUTING.md file. On Debian systems, this file will be available at
/usr/share/doc/\fBaxel\fP/ directory.