summaryrefslogtreecommitdiffstats
path: root/upstream/archlinux/man8/paccache.8
blob: 6d6cd2258537ae4a4e89cdc952207ab32a7fca61 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
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
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
'\" t
.\"     Title: paccache
.\"    Author: [see the "Authors" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 2024-05-10
.\"    Manual: Pacman-contrib Manual
.\"    Source: Pacman-contrib 1.10.6
.\"  Language: English
.\"
.TH "PACCACHE" "8" "2024\-05\-10" "Pacman\-contrib 1\&.10\&.6" "Pacman\-contrib Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
paccache \- flexible pacman cache cleaning utility
.SH "SYNOPSIS"
.sp
\fIpaccache\fR <operation> [options] [target \&...]
.SH "DESCRIPTION"
.sp
\fIpaccache\fR removes old packages from the pacman cache directory\&. By default the last three versions of a package are kept\&.
.SH "OPERATIONS"
.PP
\fB\-d, \-\-dryrun\fR
.RS 4
Perform a dry run, only finding candidate packages\&.
.RE
.PP
\fB\-m, \-\-move <dir>\fR
.RS 4
Move candidate packages from the cache directory to
\fIdir\fR\&.
.RE
.PP
\fB\-r, \-\-remove\fR
.RS 4
Remove candidate packages from the cache directory\&.
.RE
.SH "OPTIONS"
.PP
\fB\-a, \-\-arch <arch>\fR
.RS 4
Scan for packages for a specific architecture\&. Default is to scan for all architectures\&.
.RE
.PP
\fB\-c, \-\-cachedir <dir>\fR
.RS 4
Specify a different cache directory\&. This option can be used more than once\&. Default is to use the cache directory configured in
\fIpacman\&.conf\fR\&.
.RE
.PP
\fB\-f, \-\-force\fR
.RS 4
Apply force to
\fImv\fR
and
\fIrm\fR
operations\&.
.RE
.PP
\fB\-h, \-\-help\fR
.RS 4
Display syntax and command\-line options\&.
.RE
.PP
\fB\-i, \-\-ignore <pkgs>\fR
.RS 4
Specify packages to ignore, comma\-separated\&. Alternatively "\-" can be used to read the package names from stdin, newline\-delimited\&.
.RE
.PP
\fB\-k, \-\-keep <num>\fR
.RS 4
Specify how many versions of each package are kept in the cache directory, default is 3\&.
.RE
.PP
\fB\-\-min\-atime <time>\fR, \fB\-\-min\-mtime <time>\fR
.RS 4
Keep packages with an atime/mtime that is not older than the time given, even if this means keeping more than specified through the
\fI\-\-keep\fR
option\&. Accepts arguments according to
\fIinfo "Date input formats"\fR, e\&.g\&.
\fI30 days ago\fR\&.
.RE
.PP
\fB\-\-nocolor\fR
.RS 4
Do not colorize output\&.
.RE
.PP
\fB\-z, \-\-null\fR
.RS 4
Use null delimiters for candidate names (only with \-v and \-vv)\&.
.RE
.PP
\fB\-q, \-\-quiet\fR
.RS 4
Minimize the output\&.
.RE
.PP
\fB\-u, \-\-uninstalled\fR
.RS 4
Target uninstalled packages\&.
.RE
.PP
\fB\-v, \-\-verbose\fR
.RS 4
Increase verbosity, can be specified up to 3 times\&.
.RE
.PP
\fB\-V, \-\-version\fR
.RS 4
Display version information\&.
.RE
.SH "SYSTEMD TIMER"
.sp
The package cache can be cleaned periodically using the systemd timer \fIpaccache\&.timer\fR\&. If the timer is enabled the cache will be cleaned weekly with paccache\(cqs default options\&.
.SH "SEE ALSO"
.sp
\fBpacman\fR(8), \fBpacman.conf\fR(5), \fBsystemctl\fR(1)
.SH "BUGS"
.sp
Bugs? You must be kidding; there are no bugs in this software\&. But if we happen to be wrong, file an issue with as much detail as possible at https://gitlab\&.archlinux\&.org/pacman/pacman\-contrib/\-/issues/new\&.
.SH "AUTHORS"
.sp
Current maintainers:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Johannes Löthberg <johannes@kyriasis\&.com>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Daniel M\&. Capella <polyzen@archlinux\&.org>
.RE
.sp
For additional contributors, use git shortlog \-s on the pacman\-contrib\&.git repository\&.