POWERPILL(1)							  POWERPILL(1)



NAME
       powerpill - a wrapper and download accelerator for pacman


SYNOPSIS
       powerpill [options] [packages]


DESCRIPTION
       Powerpill  is  a	 wrapper  for  the pacman package manager used by Arch
       Linux and other GNU/Linux distributions. It determines the target pack‐
       ages  of	 a  requested synchronization operation and then uses the mir‐
       rorlist to create a comprehensive metalink. This metalink is then piped
       to the download manager aria2 for package retrieval. Significant reduc‐
       tions in download times are often possible due to the combined  effects
       of simultaneous and segmented downloads.

       Powerpill also internally supports database updates via Rebase, package
       retrieval via PkgD, and mirrorlist retrieval via Reflector.


OPTIONS
       Powerpill supports the following in addition to Pacman's arguments:



       --aria2-args [args]
	      Additional arguments to aria2c. These will be  appended  to  the
	      internal	list of default arguments, replacing some of them when
	      appropriate. The format used is the same as in aria2c configura‐
	      tion files, e.g. "lowest-speed-limit=10K"

	      Options  of  immediate  interest are "lowest-speed-limit", which
	      can be used to filter slow mirrors  while	 the  download	is  in
	      progress, and "max-download-limit", to limit download speed.

	      Options  which are required by Powerpill will be ignored. Beyond
	      that, Powerpill does not	check  the  sanity  of	the  arguments
	      given.

	      Consult  aria2c's	 documentation	for  a	full list of available
	      options and information about what they do.

	      This option may be repeated to pass multiple values.


       --aria2-bin <path>
	      The path to the aria2c binary.


       --config <path>
	      Specify a different configuration file to use.


       --get-config-template
	      Print powerpill's configuration file template.


       --get-metalink
	      Output a metalink for the requested operation and exit.


       --help, -h
	      Print powerpill's help message and exit.


       --log <path>
	      Powerpill output will be logged to this path if it is given.


       --man  Print powerpill's man page and exit.


       --man-nroff
	      Print powerpill's man page in nroff format.


       --no-color
	      Suppress colored output.


       --pacman-bin <path>
	      The path to the pacman binary or an equivalent, such as  pacman-
	      color.


       --pacman-config <path>
	      Specify a different pacman configuration file to use.


       --pacman-help
	      Print pacman's help message and exit.


       --pkgd [address:port]
	      Specify PkgD servers to query for packages before using external
	      mirrors.

	      This option may be repeated to pass multiple values.


       --rebase
	      Use the Rebase module to	update	the  sync  database.  See  the
	      Rebase documentation for more information.


       --reflect "[Reflector arguments]"
	      Enable retrieval of mirrors from the MirrorStatus webpage during
	      a sync operation. This uses the Reflector module internally  and
	      accepts  the same arguments that Reflector does. See the Reflec‐
	      tor documentation for more information.

	      There is absolutely no reason to pass any of the ranking options
	      with  this  command  as  the  order of the servers is completely
	      irrelevant.


       --retry-limit <int>
	      The number of times that a failed	 download  should  be  retried
	      when run automatically.


       --split-size <int>
	      The minimum size, in MB (not MiB), that a file must be before it
	      is split for segmented downloading.




AUTHORS
       Xyne




				 January 2010			  POWERPILL(1)