.\" Generated by scdoc 1.11.3
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "apk-cache" "8" "2024-04-29"
.PP
.SH NAME
.PP
apk cache - manage a local cache of package files
.PP
.SH SYNOPSIS
.PP
\fBapk cache\fR [<\fIoptions\fR>.\&.\&.\&] clean
.PP
\fBapk cache\fR [<\fIoptions\fR>.\&.\&.\&] download [\fIdependency\fR.\&.\&.\&]
.PP
\fBapk cache\fR [<\fIoptions\fR>.\&.\&.\&] purge
.PP
\fBapk cache\fR [<\fIoptions\fR>.\&.\&.\&] sync [\fIdependency\fR.\&.\&.\&]
.PP
.SH DESCRIPTION
.PP
Manage local package cache by removing obsolete packages, or downloading
missing or newer packages from the repositories.\&
.PP
\fBapk cache download\fR will fetch package files from the repositories and store
them in the cache, which must be enabled upfront (see \fBapk-cache\fR(5)).\& By
default \fIworld\fR dependencies are used to determine what to download.\& If
\fIdependency\fR arguments are given, they will by default replace the \fIworld\fR.\&
.PP
\fBapk cache clean\fR will remove package files which no longer exist in any
repository index.\& Specifying the global option \fB--purge\fR will additionally
remove all uninstalled package on tmpfs installations, and all packages on
disk installations.\&
.PP
\fBapk cache purge\fR is a synonym for \fBclean --purge\fR.\&
.PP
\fBapk cache sync\fR performs both operations.\&
.PP
.SH OPTIONS
.PP
\fB--add-dependencies\fR
.RS 4
Add the argument dependencies to \fIworld\fR dependencies when determining
which packages to download.\&
.PP
.RE
\fB-a, --available\fR
.RS 4
Selected packages to be downloaded from active repositories even if
it means replacing or downgrading the installed package.\&
.PP
.RE
\fB--ignore-conflict\fR
.RS 4
Ignore conflicts when resolving dependencies.\& This can be useful when
pre-populating cache for creation of multiple images in one go.\&
.PP
.RE
\fB-l, --latest\fR
.RS 4
Always choose the latest package by version.\& However, the versions
considered are based on the package pinning.\& Primarily this overrides
the default heuristic and will cause an error to displayed if all
dependencies cannot be satisfied.\&
.PP
.RE
\fB-u, --upgrade\fR
.RS 4
Upgrade \fIpackages\fR and it'\&s dependencies.\& Normally \fBapk add\fR will
avoid changing installed package unless it is required by the newly
added \fIpackages\fR or their dependencies.\& This changes the default
preference to upgrading the package to the latest installable version.\&
.PP
.RE
\fB-s, --simulate\fR
.RS 4
Simulate the requested operation without making any changes.\&