/////
vim:set ts=4 sw=4 syntax=asciidoc noet spell spelllang=en_us:
/////
paccache(8)
=========

Name
----
paccache - flexible pacman cache cleaning utility


Synopsis
--------
'paccache' <operation> [options] [targets...]


Description
-----------
Paccache removes old packages from the pacman cache directory.
By default the last three versions of a package are kept.


Operations
----------
*-d, \--dryrun*::
	Perform a dry run, only finding candidate packages.

*-m, \--move <dir>*::
	Move candidate packages from the cache directory to 'dir'.

*-r, \--remove*::
	Remove candidate packages from the cache directory.


Options
-------
*-a, \--arch <arch>*::
	Scan for packages for a specific architecture. Default is to scan for
	all architectures.

*\--min-atime <age>*::
*\--min-mtime <age>*::
	Only consider packages for removal with atime respectively mtime older than
	specified. The age can be given as '10d', '1m', '1y', '1y1m' etc.

*-c, \--cachedir <dir>*::
	Specify a different cache directory. This option can be used more than once.
	Default is to use the cache directory configured in 'pacman.conf'.

*-f, \--force*::
	Apply force to 'mv' and 'rm' operations.

*-h, \--help*::
	Display syntax and command line options.

*-i, \--ignore <pkgs>*::
	Specify packages to ignore, comma-separated. Alternatively "-" can be used
	to read the package names from stdin, newline-delimited.

*-k, \--keep <num>*::
	Specify how many versions of each package are kept in the cache directory,
	default is 3.

*\--nocolor*::
	Remove color from the output.

*-q, \--quiet*::
	Minimize the output.

*-u, \--uninstalled*::
	Target uninstalled packages.

*-v, \--verbose*::
	Increase verbosity, can be specified up to 3 times.

*-z, \--null*::
	Use null delimiters for candidate names (only with -v and -vv).


Systemd Timer
-------------
The package cache can be cleaned periodically using the systemd timer 'paccache.timer'.
If the timer is enabled the cache will be cleaned weekly with paccache's default options.


See Also
--------
linkman:pacman[8], linkman:pacman.conf[5], linkman:systemctl[1]

include::footer.txt[]
