diff options
| author | Timo Teräs <timo.teras@iki.fi> | 2022-01-21 14:29:46 +0200 |
|---|---|---|
| committer | Timo Teräs <timo.teras@iki.fi> | 2022-01-21 14:55:15 +0200 |
| commit | 2c68ee3873e4f53512f562aa0c4f144a785c2fa6 (patch) | |
| tree | 6d79671fe798c10cf97b385310196efe3524814c /doc | |
| parent | 1bc08a142cc8a9b35ef2e7d15d58ece3b8e00995 (diff) | |
| download | apk-tools-2c68ee3873e4f53512f562aa0c4f144a785c2fa6.tar.gz apk-tools-2c68ee3873e4f53512f562aa0c4f144a785c2fa6.tar.bz2 apk-tools-2c68ee3873e4f53512f562aa0c4f144a785c2fa6.tar.xz apk-tools-2c68ee3873e4f53512f562aa0c4f144a785c2fa6.zip | |
cache: allow various flags, and addition of dependencies
Allow controlling 'cache download' more closely to 'upgrade' so
it can be used to pre-download packages for ugprade.
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/apk-cache.8.scd | 28 |
1 files changed, 22 insertions, 6 deletions
diff --git a/doc/apk-cache.8.scd b/doc/apk-cache.8.scd index 1381d81..e5a9b6f 100644 --- a/doc/apk-cache.8.scd +++ b/doc/apk-cache.8.scd @@ -8,9 +8,9 @@ apk cache - manage a local cache of package files *apk cache* [<_options_>...] clean -*apk cache* [<_options_>...] download +*apk cache* [<_options_>...] download [_dependency_...] -*apk cache* [<_options_>...] sync +*apk cache* [<_options_>...] sync [_dependency_...] # DESCRIPTION @@ -18,16 +18,29 @@ Manage local package cache by removing obsolete packages, or downloading missing or newer packages from the repositories. *apk cache download* will fetch package files from the repositories and store -them in the cache, which must be enabled upfront (see *apk-cache*(5)). +them in the cache, which must be enabled upfront (see *apk-cache*(5)). By +default _world_ dependencies are used to determine what to download. If +_dependency_ arguments are given, they will by default replace the _world_. -*apk cache clean* will remove package files which are no longer necessary, -having been made obsolete by new versions or no longer being transitively -depended on by packages in _world_. +*apk cache clean* will remove package files which no longer exist in any +repository index. *apk cache sync* performs both operations. # OPTIONS +*--add-dependencies* + Add the argument dependencies to _world_ dependencies when determining + which packages to download. + +*-a, --available* + Selected packages to be downloaded from active repositories even if + it means replacing or downgrading the installed package. + +*--ignore-conflict* + Ignore conflicts when resolving dependencies. This can be useful when + pre-populating cache for creation of multiple images in one go. + *-l, --latest* Always choose the latest package by version. However, the versions considered are based on the package pinning. Primarily this overrides @@ -39,3 +52,6 @@ depended on by packages in _world_. avoid changing installed package unless it is required by the newly added _packages_ or their dependencies. This changes the default preference to upgrading the package to the latest installable version. + +*-s, --simulate* + Simulate the requested operation without making any changes. |