Difference between revisions of "Improve pacman performance"

From ArchWiki
Jump to: navigation, search
m (pacget (aria2) Mirror Script)
m (added ja)
(48 intermediate revisions by 18 users not shown)
Line 1: Line 1:
[[Category:Package management (English)]]
+
[[Category:Package management]]
[[Category:HOWTOs (English)]]
+
{{i18n|Improve_Pacman_Performance}}
+
 
[[de:Pacman beschleunigen]]
 
[[de:Pacman beschleunigen]]
 +
[[es:Improve Pacman Performance]]
 
[[fr:Ameliorer Pacman]]
 
[[fr:Ameliorer Pacman]]
 
+
[[it:Improve Pacman Performance]]
== Improving Database Access Speeds ==
+
[[ja:Improve Pacman Performance]]
 +
[[pl:Optymalizacja Pacmana]]
 +
[[ru:Improve Pacman Performance]]
 +
[[tr:Pacman_verimini_arttırmak]]
 +
[[zh-CN:Improve Pacman Performance]]
 +
[[zh-TW:Improve Pacman Performance]]
 +
== Improving database access speeds ==
  
 
Pacman stores all package information in a collection of small files, one for each package. Improving database access speeds reduces the time taken in database-related tasks, e.g. searching packages and resolving package dependencies. The safest and easiest method is to run as root:
 
Pacman stores all package information in a collection of small files, one for each package. Improving database access speeds reduces the time taken in database-related tasks, e.g. searching packages and resolving package dependencies. The safest and easiest method is to run as root:
Line 15: Line 20:
 
  # pacman -Sc && pacman-optimize
 
  # pacman -Sc && pacman-optimize
  
===pacman-cage===
+
== Improving download speeds ==
{{Note|pacman-cage is now not needed anymore, as pacman 3.5 sync DBs read directly from the database tarball. See [[https://bbs.archlinux.org/viewtopic.php?pid=907253#p907253]].}}
+
'''pacman-cage''' is a script that puts the pacman database, {{Filename|/var/lib/pacman}}, in a single loop file containing its own file-system that can speed up access times. This very simple alteration that improves pacman's speed for tasks like searching and updating. The script makes a backup (at installation only) in case something goes wrong but has caused some users to lose their database (e.g. when used in a chroot).  Use with caution.
+
  
{{Package AUR|pacman-cage}} can be found in [[AUR]].
+
{{Note|If your download speeds have been reduced to a crawl, ensure you are using one of the many [[mirrors]] and not ftp.archlinux.org, which is [https://www.archlinux.org/news/302/ throttled since  March 2007].}}
 
+
== Improving Download Speeds ==
+
 
+
{{Note|If your download speeds have been reduced to a crawl, ensure you are using one of the many [[mirrors]] and not ftp.archlinux.org, which is [http://www.archlinux.org/news/302/ throttled since  March 2007].}}
+
  
 
Pacman's speed in downloading packages can be improved by using a different application to download packages instead of Pacman's built-in file downloader.
 
Pacman's speed in downloading packages can be improved by using a different application to download packages instead of Pacman's built-in file downloader.
Line 30: Line 29:
  
 
  # pacman -Syu
 
  # pacman -Syu
 +
 +
=== Using Powerpill ===
 +
 +
Powerpill is a full wrapper for Pacman that uses parallel and segmented downloads to speed up the download process. Normally Pacman will download one package at a time, waiting for it to complete before beginning the next download. Powerpill takes a different approach: it tries to download as many packages as possible at once.
 +
 +
The [[Powerpill | Powerpill wiki page]] provides basic configuration and usage examples along with package and upstream links.
 +
 +
=== Using powerpill-light (deprecated) ===
 +
 +
[http://xyne.archlinux.ca/projects/pacman2aria2/ pacman2aria2] provides a script named "powerpill-light", which was a stopgap created after the deprecation of the original powerpill written in Perl. Now that [[Powerpill | Powerpill]] has been re-released, powerpill-light is deprecated.
  
 
=== Using wget ===
 
=== Using wget ===
Line 35: Line 44:
 
This is also very handy if you need more powerful proxy settings than pacman's built-in capabilities.  
 
This is also very handy if you need more powerful proxy settings than pacman's built-in capabilities.  
  
To use <code>wget</code>, first install it with <code>pacman -S wget</code> and then modify <code>/etc/pacman.conf</code> by adding the following line to the <code>[options]</code> section:
+
To use {{ic|wget}}, first install it with {{ic|pacman -S wget}} and then modify {{ic|/etc/pacman.conf}} by adding the following line to the {{ic|[options]}} section:
  
 
  XferCommand = /usr/bin/wget -c --passive-ftp -c %u
 
  XferCommand = /usr/bin/wget -c --passive-ftp -c %u
  
Instead of putting <code>wget</code> parameters in {{Filename|/etc/pacman.conf}}, you can also modify the {{Filename|wget}} configuration file directly (the system-wide file is {{Filename|/etc/wgetrc}}, per user files are {{Filename|$HOME/.wgetrc}}.
+
Instead of putting {{ic|wget}} parameters in {{ic|/etc/pacman.conf}}, you can also modify the {{ic|wget}} configuration file directly (the system-wide file is {{ic|/etc/wgetrc}}, per user files are {{ic|$HOME/.wgetrc}}.
  
 
=== Using aria2 ===
 
=== Using aria2 ===
  
[[aria2]] is a lightweight download utility with support for resumable and segmented HTTP/HTTPS and FTP downloads. [http://aria2.sourceforge.net/ aria2] allows for multiple and simultaneous HTTP/HTTPS and FTP connections to an Arch mirror, which should result in an increase in download speeds for both file and package retrieval.  
+
[[aria2]] is a lightweight download utility with support for resumable and segmented HTTP/HTTPS and FTP downloads. [http://aria2.sourceforge.net/ aria2] allows for multiple and simultaneous HTTP/HTTPS and FTP connections to an Arch mirror, which should result in an increase in download speeds for both file and package retrieval.
 +
 
 +
{{Note|Using aria2c in Pacman's XferCommand will '''not''' result in parallel downloads of multiple packages. Pacman invokes the XferCommand with a single package at a time and waits for it to complete before invoking the next. To download multiple packages in parallel, see the [[Improve_Pacman_Performance#Using_Powerpill | powerpill]] section above.}}
  
 
==== Installation ====
 
==== Installation ====
  
Download and install {{Package Official|aria2}} and its dependencies:
+
Download and install {{Pkg|aria2}} and its dependencies:
  
 
  # pacman -S aria2
 
  # pacman -S aria2
Line 53: Line 64:
 
==== Configuration ====
 
==== Configuration ====
  
Edit {{Filename|/etc/pacman.conf}} by adding the following line to the <code>[options]</code> section:
+
Edit {{ic|/etc/pacman.conf}} by adding the following line to the {{ic|[options]}} section:
  
XferCommand = /usr/bin/aria2c --allow-overwrite=true -c --file-allocation=none --log-level=error \
+
{{bc|1=XferCommand = /usr/bin/aria2c --allow-overwrite=true -c --file-allocation=none --log-level=error -m2 -x2 --max-file-not-found=5 -k5M --no-conf -Rtrue --summary-interval=60 -t5 -d / -o %o %u}}
-m2 --max-connection-per-server=2 --max-file-not-found=5 --min-split-size=5M --no-conf \
+
--remote-time=true --summary-interval=60 -t5 -d / -o %o %u
+
  
 
==== Option Details ====
 
==== Option Details ====
  
; <tt>/usr/bin/aria2c</tt>: The full PATH to the aria2 executable.
+
; {{Ic|/usr/bin/aria2c}}: The full PATH to the aria2 executable.
; <tt>--allow-overwrite=true</tt>: Restart download if a corresponding control file does not exist. (Default: false)
+
; {{Ic|1=--allow-overwrite=true}}: Restart download if a corresponding control file does not exist. (Default: false)
; <tt>-c, --continue</tt>: Continue downloading a partially downloaded file if a corresponding control file exists.
+
; {{Ic|-c, --continue}}: Continue downloading a partially downloaded file if a corresponding control file exists.
; <tt>--file-allocation=none</tt>: Do not pre-allocate file space before download begins. (Default: prealloc) <b><sup>1</sup></b>
+
; {{Ic|1=--file-allocation=none}}: Do not pre-allocate file space before download begins. (Default: prealloc) <b><sup>1</sup></b>
; <tt>--log-level=error</tt>: Set log level to output errors only. (Default: debug)
+
; {{Ic|1=--log-level=error}}: Set log level to output errors only. (Default: debug)
; <tt>-m2, --max-tries=2</tt>: Make 2 maximum attempts to download specified file(s) per mirror. (Default: 5)
+
; {{Ic|1=-m2, --max-tries=2}}: Make 2 maximum attempts to download specified file(s) per mirror. (Default: 5)
; <tt>--max-connection-per-server=2</tt>: Set a maximum of 2 connections to each mirror per file. (Default: 1)
+
; {{Ic|1=-x2, --max-connection-per-server=2}}: Set a maximum of 2 connections to each mirror per file. (Default: 1)
; <tt>--max-file-not-found=5</tt>: Force download to fail if a single byte is not received within 5 attempts. (Default: 0)
+
; {{Ic|1=--max-file-not-found=5}}: Force download to fail if a single byte is not received within 5 attempts. (Default: 0)
; <tt>--min-split-size=5M</tt>: Only split the file if the size is larger than 2;5MB = 10MB. (Default: 20M)
+
; {{Ic|1=-k5M, --min-split-size=5M}}: Only split the file if the size is larger than 2;5MB = 10MB. (Default: 20M)
; <tt>--no-conf</tt>: Disable loading an {{Filename|aria2.conf}} file if it exists. (Default: {{Filename|~/.aria2/aria2.conf}})
+
; {{Ic|--no-conf}}: Disable loading an {{ic|aria2.conf}} file if it exists. (Default: {{ic|~/.aria2/aria2.conf}})
; <tt>--remote-time=true</tt>: Apply timestamps of the remote file(s) and apply them to the local file(s). (Default: false)
+
; {{Ic|1=-Rtrue, --remote-time=true}}: Apply timestamps of the remote file(s) and apply them to the local file(s). (Default: false)
; <tt>--summary-interval=60</tt>: Output download progress summary every 60 seconds. (Default: 60) <b><sup>2</sup></b>
+
; {{Ic|1=--summary-interval=60}}: Output download progress summary every 60 seconds. (Default: 60) <b><sup>2</sup></b>
; <tt>-t5, --timeout=5</tt>: Set a 5 second timeout per mirror after a connection is established. (Default: 60)
+
; {{Ic|1=-t5, --timeout=5}}: Set a 5 second timeout per mirror after a connection is established. (Default: 60)
; <tt>-d, --dir</tt>: The directory to store the downloaded file(s) as specified by [[pacman|pacman]].
+
; {{Ic|-d, --dir}}: The directory to store the downloaded file(s) as specified by [[pacman|pacman]].
; <tt>-o, --output</tt>: The output file name(s) of the downloaded file(s).  
+
; {{Ic|-o, --out}}: The output file name(s) of the downloaded file(s).  
; <tt>%o</tt>: Variable which represents the local filename(s) as specified by pacman.
+
; {{Ic|%o}}: Variable which represents the local filename(s) as specified by pacman.
; <tt>%u</tt>: Variable which represents the download URL as specified by pacman.
+
; {{Ic|%u}}: Variable which represents the download URL as specified by pacman.
  
==== Additional Notes ====
+
==== Additional notes ====
  
; <sup>1</sup> <tt>--file-allocation=falloc</tt>: Recommended for newer file systems such as ext4 (with extents support), btrfs or xfs as it allocates large files (GB) almost instantly. Do not use falloc with legacy file systems such as ext3 as prealloc consumes approximately the same amount of time as standard allocation would while locking the aria2 process from proceeding to download.
+
; <sup>1</sup> {{Ic|1=--file-allocation=falloc}}: Recommended for newer file systems such as ext4 (with extents support), btrfs or xfs as it allocates large files (GB) almost instantly. Do not use falloc with legacy file systems such as ext3 as prealloc consumes approximately the same amount of time as standard allocation would while locking the aria2 process from proceeding to download.
  
;<sup>2</sup> <tt>--summary-interval=0</tt>: Supresses download progress summary output and may improve overall performance. Logs will continue to be output according to the value specified in the <tt>log-level</tt> option.
+
; <sup>2</sup> {{Ic|1=--summary-interval=0}}: Supresses download progress summary output and may improve overall performance. Logs will continue to be output according to the value specified in the {{Ic|log-level}} option.
<!--
+
===Powerpill===
+
{{Warning|''Powerpill'' development has been officially discontinued: its latest version does not work with ''pacman>&#61;3.5''. See [https://bbs.archlinux.org/viewtopic.php?id&#61;115660].}}
+
'''''[http://xyne.archlinux.ca/old_projects/powerpill Powerpill]''''' is a wrapper for pacman that uses aria2 to download packages. Unlike the other aria2 solutions, powerpill uses '''simultaneous''' downloads for all files and segmented downloads only for larger files, which really makes the most of your bandwidth without wasting time splitting small files unnecessarily.
+
  
For more info, see the [[Powerpill]] wiki article.
+
; <sup>3</sup> {{Ic|1=<nowiki>XferCommand = /usr/bin/printf 'Downloading ' && echo %u | awk -F/ '{printf $NF}' && printf '...' && /usr/bin/aria2c -q --allow-overwrite=true -c --file-allocation=none --log-level=error -m2 --max-connection-per-server=2 --max-file-not-found=5 --min-split-size=5M --no-conf --remote-time=true --summary-interval=0 -t5 -d / -o %o %u && echo ' Complete!'</nowiki>}}: Using this XferCommand gives less useful, but much more readable, output.
-->
+
  
=== Using airpac ===
+
=== pacget (aria2) mirror script ===
  
In a nutshell, [http://aur.archlinux.org/packages.php?ID=26118 airpac] is an aria2c wrapper for pacman. Unlike powerpill, which acts as a frontend to pacman, airpac serves as a backend downloader for pacman. On the other hand, however, it behaves similarly to powerpill, as far as downloading is concerned, since both use aria2c to actually download the files. Because it is a backend though, it cannot download multiple packages simultaneously as powerpill can.
+
This script will greatly improve the download speed for broadband users. It uses the servers in {{ic|/etc/pacman.d/mirrorlist}} as mirrors in aria2. What happens is that aria2 downloads a single package from multiple servers simultaneously which gives a huge boost in download speed.
  
Essentially, airpac is the Python implementation of the pacget script below. However, the main difference lies in the handling of aria2c output. airpac shows only the most relevant info, i.e., the download progress, although it currently doesn't use a progressbar (maybe in the near future). Also, airpac caches the db files so that they won't be downloaded for every <code>pacman -Sy</code>. On the downside, this breaks <code>pacman -Syy</code> since airpac has no way of knowing the options pacman is executed with. As a workaround, however, one can use <code>pacman -Sc</code> to delete the cached files in '''/var/lib/pacman/.airpac'''.
+
{{Note|You have to put 'exec' before /usr/bin/pacget in the XferCommand. This is needed so that when you terminate pacget or aria2 (with process id used by pacget), pacman would also terminate. This would prevent inconvenience because Pacman would not persist downloading a file when you tell it not to.}}
  
The configuration file is located in '''/etc/airpac.conf'''. This is actually an aria2c config file. Because of this, the user can directly configure how aria2c is used by airpac without meddling with airpac's code. For more info about the available options, consult the aria2c manpage.
+
{{Warning|You may experience some problems if the mirrors used are out-of-sync or are simply not up-to-date. Just use the [[Reflector]] script to generate a list of up-to-date and ''fast'' mirrors. Also, ftp.archlinux.org resolves to two IPs. You may want to choose only one of them and hard code ftp.archlinux.org and the chosen IP address to {{ic|/etc/hosts}}.}}
  
airpac also uses the ''Server Performance Profile'' feature of aria2c by default. The statistics file is located in '''/var/lib/airpac.stats'''. The default URI selector is ''adaptive''.
+
{{hc|/usr/bin/pacget|<nowiki>
 
+
'''Usage in /etc/pacman.conf'''
+
XferCommand = /usr/bin/airpac %u %o
+
 
+
=== pacget (aria2) Mirror Script ===
+
 
+
This script will greatly improve the download speed for broadband users. It uses the servers in /etc/pacman.d/mirrorlist as mirrors in aria2. What happens is that aria2 downloads from multiple servers simultaneously which gives a huge boost in download speed.
+
 
+
Take note that you have to put 'exec' before /usr/bin/pacget in the XferCommand. This is needed so that when you terminate pacget or aria2 (with process id used by pacget), pacman would also terminate. This would prevent inconvenience because Pacman would not persist downloading a file when you tell it not to.
+
 
+
WARNING: You may experience some problems if the mirrors used are out-of-sync or are simply not up-to-date. Just use the [[Reflector]] script to generate a list of up-to-date and ''fast'' mirrors. Also, ftp.archlinux.org resolves to two IPs. You may want to choose only one of them and hard code ftp.archlinux.org and the chosen IP address to /etc/hosts.
+
 
+
'''/usr/bin/pacget'''
+
<pre>
+
 
#!/bin/bash
 
#!/bin/bash
  
Line 173: Line 163:
  
 
exit $?
 
exit $?
</pre>
+
</nowiki>}}
  
'''/etc/pacget.conf'''
+
{{hc|/etc/pacget.conf|<nowiki>
<pre>
+
 
# The log file
 
# The log file
 
log=/var/log/pacget.log
 
log=/var/log/pacget.log
 
# Number of servers to download from
 
# Number of servers to download from
 
split=5
 
split=5
 +
# Minimum file size that justifies a split, i.e. concurrent download (default 20M)
 +
min-split-size=1M
 
# Maximum download speed (0 = unrestricted)
 
# Maximum download speed (0 = unrestricted)
 
max-download-limit=0
 
max-download-limit=0
# Minimum download speed (0 = don't care)
+
# Minimum download speed (0 = do not care)
 
lowest-speed-limit=0
 
lowest-speed-limit=0
 
# Server timeout period
 
# Server timeout period
Line 189: Line 180:
 
# 'none' or 'falloc'
 
# 'none' or 'falloc'
 
file-allocation=none
 
file-allocation=none
</pre>
+
</nowiki>}}
  
 
Save this script as /usr/bin/pacget.
 
Save this script as /usr/bin/pacget.
  chmod 755 /usr/bin/pacget
+
  # chmod 755 /usr/bin/pacget
 
This makes the script an executable
 
This makes the script an executable
  
Line 198: Line 189:
 
  XferCommand = exec /usr/bin/pacget %u %o
 
  XferCommand = exec /usr/bin/pacget %u %o
  
PS: If you use ftp.archlinux.org as the first server listed in your include files (/etc/pacman.d/*), some problems may occur when the mirrors you are using have not yet synced. To make great use of this script, choose a mirror (that syncs in a timely manner) that is more appropriate for you, then put that on top of the server lists. This is to prevent downloading only from ftp.archlinux.org when the mirrors have not yet synced. The rankmirrors script can be useful in this case.
+
{{Note|If you use ftp.archlinux.org as the first server listed in your include files (/etc/pacman.d/*), some problems may occur when the mirrors you are using have not yet synced. To make great use of this script, choose a mirror (that syncs in a timely manner) that is more appropriate for you, then put that on top of the server lists. This is to prevent downloading only from ftp.archlinux.org when the mirrors have not yet synced. The rankmirrors script can be useful in this case.}}
  
 
=== Using other applications ===
 
=== Using other applications ===
Line 204: Line 195:
 
There are other downloading applications that you can use with Pacman. Here they are, and their associated XferCommand settings:
 
There are other downloading applications that you can use with Pacman. Here they are, and their associated XferCommand settings:
  
* <code>snarf</code>: <code>XferCommand = /usr/bin/snarf -N %u</code>
+
* {{ic|snarf}}: {{ic|1=XferCommand = /usr/bin/snarf -N %u}}
* <code>lftp</code>: <code>XferCommand = /usr/bin/lftp -c pget %u</code>
+
* {{ic|lftp}}: {{ic|1=XferCommand = /usr/bin/lftp -c pget %u}}
* <code>axel</code>: <code>XferCommand = /usr/bin/axel -n 2 -v -a -o %o %u</code>
+
* {{ic|axel}}: {{ic|1=XferCommand = /usr/bin/axel -n 2 -v -a -o %o %u}}
  
 
== Choosing the fastest mirror ==
 
== Choosing the fastest mirror ==
When downloading packages pacman uses the mirrors in the order they are in /etc/pacman.d/mirrorlist.The mirror which is at the top of the list by default however may not be the fastest for you.
+
When downloading packages pacman uses the mirrors in the order they are in {{ic|/etc/pacman.d/mirrorlist}}. The mirror which is at the top of the list by default however may not be the fastest for you. To select a faster mirror, see [[Mirrors]].
 
+
=== Choosing a local mirror ===
+
The simple way is to edit mirrorlist file by placing a local mirror at the top of the list. pacman will then use this mirror for preference.
+
 
+
Alternativley the pacman.conf file can be edited by placing a local mirror before the line sourcing the mirrorlist file, i.e. where it says "add your preferred servers here". It is safer if you use the same server for each repository.
+
 
+
=== Using rankmirrors ===
+
 
+
You can use [[Mirrors#List_by_speed|rankmirrors]] to rank pacman mirrors by their connection and opening speed.
+
 
+
=== After changing mirrors ===
+
 
+
After changing your mirror it is a good idea to refresh the pacman database. Using two y's forces a download of a fresh copy of the master package list from the server even if they are thought to be up to date.
+
 
+
# pacman -Syy
+
  
 
== Sharing packages over your LAN ==
 
== Sharing packages over your LAN ==

Revision as of 14:15, 13 October 2013

Improving database access speeds

Pacman stores all package information in a collection of small files, one for each package. Improving database access speeds reduces the time taken in database-related tasks, e.g. searching packages and resolving package dependencies. The safest and easiest method is to run as root:

# pacman-optimize

This will attempt to put all the small files together in one (physical) location on the hard disk so that the hard disk head does not have to move so much when accessing all the packages. This method is safe, but is not foolproof. It depends on your filesystem, disk usage and empty space fragmentation. Another more aggressive option would be to first remove uninstalled packages from cache and to remove unused repositories before database optimization:

# pacman -Sc && pacman-optimize

Improving download speeds

Note: If your download speeds have been reduced to a crawl, ensure you are using one of the many mirrors and not ftp.archlinux.org, which is throttled since March 2007.

Pacman's speed in downloading packages can be improved by using a different application to download packages instead of Pacman's built-in file downloader.

In all cases, make sure you have the latest Pacman before doing any modifications.

# pacman -Syu

Using Powerpill

Powerpill is a full wrapper for Pacman that uses parallel and segmented downloads to speed up the download process. Normally Pacman will download one package at a time, waiting for it to complete before beginning the next download. Powerpill takes a different approach: it tries to download as many packages as possible at once.

The Powerpill wiki page provides basic configuration and usage examples along with package and upstream links.

Using powerpill-light (deprecated)

pacman2aria2 provides a script named "powerpill-light", which was a stopgap created after the deprecation of the original powerpill written in Perl. Now that Powerpill has been re-released, powerpill-light is deprecated.

Using wget

This is also very handy if you need more powerful proxy settings than pacman's built-in capabilities.

To use wget, first install it with pacman -S wget and then modify /etc/pacman.conf by adding the following line to the [options] section:

XferCommand = /usr/bin/wget -c --passive-ftp -c %u

Instead of putting wget parameters in /etc/pacman.conf, you can also modify the wget configuration file directly (the system-wide file is /etc/wgetrc, per user files are $HOME/.wgetrc.

Using aria2

aria2 is a lightweight download utility with support for resumable and segmented HTTP/HTTPS and FTP downloads. aria2 allows for multiple and simultaneous HTTP/HTTPS and FTP connections to an Arch mirror, which should result in an increase in download speeds for both file and package retrieval.

Note: Using aria2c in Pacman's XferCommand will not result in parallel downloads of multiple packages. Pacman invokes the XferCommand with a single package at a time and waits for it to complete before invoking the next. To download multiple packages in parallel, see the powerpill section above.

Installation

Download and install aria2 and its dependencies:

# pacman -S aria2

Configuration

Edit /etc/pacman.conf by adding the following line to the [options] section:

XferCommand = /usr/bin/aria2c --allow-overwrite=true -c --file-allocation=none --log-level=error -m2 -x2 --max-file-not-found=5 -k5M --no-conf -Rtrue --summary-interval=60 -t5 -d / -o %o %u

Option Details

/usr/bin/aria2c
The full PATH to the aria2 executable.
--allow-overwrite=true
Restart download if a corresponding control file does not exist. (Default: false)
-c, --continue
Continue downloading a partially downloaded file if a corresponding control file exists.
--file-allocation=none
Do not pre-allocate file space before download begins. (Default: prealloc) 1
--log-level=error
Set log level to output errors only. (Default: debug)
-m2, --max-tries=2
Make 2 maximum attempts to download specified file(s) per mirror. (Default: 5)
-x2, --max-connection-per-server=2
Set a maximum of 2 connections to each mirror per file. (Default: 1)
--max-file-not-found=5
Force download to fail if a single byte is not received within 5 attempts. (Default: 0)
-k5M, --min-split-size=5M
Only split the file if the size is larger than 2;5MB = 10MB. (Default: 20M)
--no-conf
Disable loading an aria2.conf file if it exists. (Default: ~/.aria2/aria2.conf)
-Rtrue, --remote-time=true
Apply timestamps of the remote file(s) and apply them to the local file(s). (Default: false)
--summary-interval=60
Output download progress summary every 60 seconds. (Default: 60) 2
-t5, --timeout=5
Set a 5 second timeout per mirror after a connection is established. (Default: 60)
-d, --dir
The directory to store the downloaded file(s) as specified by pacman.
-o, --out
The output file name(s) of the downloaded file(s).
%o
Variable which represents the local filename(s) as specified by pacman.
%u
Variable which represents the download URL as specified by pacman.

Additional notes

1 --file-allocation=falloc
Recommended for newer file systems such as ext4 (with extents support), btrfs or xfs as it allocates large files (GB) almost instantly. Do not use falloc with legacy file systems such as ext3 as prealloc consumes approximately the same amount of time as standard allocation would while locking the aria2 process from proceeding to download.
2 --summary-interval=0
Supresses download progress summary output and may improve overall performance. Logs will continue to be output according to the value specified in the log-level option.
3 XferCommand = /usr/bin/printf 'Downloading ' && echo %u | awk -F/ '{printf $NF}' && printf '...' && /usr/bin/aria2c -q --allow-overwrite=true -c --file-allocation=none --log-level=error -m2 --max-connection-per-server=2 --max-file-not-found=5 --min-split-size=5M --no-conf --remote-time=true --summary-interval=0 -t5 -d / -o %o %u && echo ' Complete!'
Using this XferCommand gives less useful, but much more readable, output.

pacget (aria2) mirror script

This script will greatly improve the download speed for broadband users. It uses the servers in /etc/pacman.d/mirrorlist as mirrors in aria2. What happens is that aria2 downloads a single package from multiple servers simultaneously which gives a huge boost in download speed.

Note: You have to put 'exec' before /usr/bin/pacget in the XferCommand. This is needed so that when you terminate pacget or aria2 (with process id used by pacget), pacman would also terminate. This would prevent inconvenience because Pacman would not persist downloading a file when you tell it not to.
Warning: You may experience some problems if the mirrors used are out-of-sync or are simply not up-to-date. Just use the Reflector script to generate a list of up-to-date and fast mirrors. Also, ftp.archlinux.org resolves to two IPs. You may want to choose only one of them and hard code ftp.archlinux.org and the chosen IP address to /etc/hosts.
/usr/bin/pacget
#!/bin/bash

msg() {
  echo ""
  echo -e "   \033[1;34m->\033[1;0m \033[1;1m${1}\033[1;0m" >&2
}

error() {
  echo -e "\033[1;31m==> ERROR:\033[1;0m \033[1;1m$1\033[1;0m" >&2
}

CONF=/etc/pacget.conf
STATS=/etc/pacget.stats
ARIA2=$(which aria2c 2> /dev/null)

# ----- do some checks first -----
if [ ! -x "$ARIA2" ]; then
  error "aria2c was not found or isn't executable."
  exit 1
fi

if [ $# -ne 2 ]; then
  error "Incorrect number of arguments"
  exit 1
fi

filename=$(basename $1)
server=${1%/$filename}
arch=$(grep ^Architecture /etc/pacman.conf | cut -d '=' -f2 | sed 's/ //g')
if [[ $arch = "auto" ]]; then
  arch=$(uname -m)
fi
# Determine which repo is being used
repo=$(awk -F'/' '$(NF-2)~/^(community|core|extra|testing|comunity-testing|multilib)$/{print $(NF-2)}' <<< $server)
[ -z $repo ] && repo="custom"

# For db files, or when using a custom repo (which most likely doesn't have any mirror),
# use only the URL passed by pacman; Otherwise, extract the list of servers (from the include file of the repo) to download from
url=$1
if ! [[ $filename = *.db || $repo = "custom" ]]; then
  mirrorlist=$(awk -F' *= *' '$0~"^\\["r"\\]",/Include *= */{l=$2} END{print l}' r=$repo /etc/pacman.conf)
  if [ -n mirrorlist ]; then
    num_conn=$(grep ^split $CONF | cut -d'=' -f2)
    url=$(sed -r '/^Server *= */!d; s/Server *= *//; s/\$repo'"/$repo/"'; s/\$arch'"/$arch/; s/$/\/$filename/" $mirrorlist | head -n $(($num_conn *2)) )
  fi
fi

msg "Downloading $filename"
cd /var/cache/pacman/pkg/

touch $STATS

$ARIA2 --conf-path=$CONF --max-tries=1 --max-file-not-found=5 \
  --uri-selector=adaptive --server-stat-if=$STATS --server-stat-of=$STATS \
  --allow-overwrite=true --remote-time=true --log-level=error --summary-interval=0 \
  $url --out=${filename}.pacget && [ ! -f ${filename}.pacget.aria2 ] && mv ${filename}.pacget $2 && chmod 644 $2

exit $?
/etc/pacget.conf
# The log file
log=/var/log/pacget.log
# Number of servers to download from
split=5
# Minimum file size that justifies a split, i.e. concurrent download (default 20M)
min-split-size=1M
# Maximum download speed (0 = unrestricted)
max-download-limit=0
# Minimum download speed (0 = do not care)
lowest-speed-limit=0
# Server timeout period
timeout=5
# 'none' or 'falloc'
file-allocation=none

Save this script as /usr/bin/pacget.

# chmod 755 /usr/bin/pacget

This makes the script an executable

In /etc/pacman.conf, in the [options] section, the following needs to be added:

XferCommand = exec /usr/bin/pacget %u %o
Note: If you use ftp.archlinux.org as the first server listed in your include files (/etc/pacman.d/*), some problems may occur when the mirrors you are using have not yet synced. To make great use of this script, choose a mirror (that syncs in a timely manner) that is more appropriate for you, then put that on top of the server lists. This is to prevent downloading only from ftp.archlinux.org when the mirrors have not yet synced. The rankmirrors script can be useful in this case.

Using other applications

There are other downloading applications that you can use with Pacman. Here they are, and their associated XferCommand settings:

  • snarf: XferCommand = /usr/bin/snarf -N %u
  • lftp: XferCommand = /usr/bin/lftp -c pget %u
  • axel: XferCommand = /usr/bin/axel -n 2 -v -a -o %o %u

Choosing the fastest mirror

When downloading packages pacman uses the mirrors in the order they are in /etc/pacman.d/mirrorlist. The mirror which is at the top of the list by default however may not be the fastest for you. To select a faster mirror, see Mirrors.

Sharing packages over your LAN

If you happen to run several Arch boxes on your LAN, you can share packages so that you can greatly decrease your download times. Keep in mind you should not share between different architectures (i.e. i686 and x86_64) or you'll get into troubles.

See Pacman_Tips#Network_shared_pacman_cache.