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:36:31 +0200 |
| commit | 10d00430636266d7bb70caacbd3e0642b3f70ceb (patch) | |
| tree | c6850a9d62f4f9ebe6ee17955737974358912400 /doc | |
| parent | a2cd188039231e1cb8d218e75970900bb4a9ae22 (diff) | |
| download | apk-tools-10d00430636266d7bb70caacbd3e0642b3f70ceb.tar.gz apk-tools-10d00430636266d7bb70caacbd3e0642b3f70ceb.tar.bz2 apk-tools-10d00430636266d7bb70caacbd3e0642b3f70ceb.tar.xz apk-tools-10d00430636266d7bb70caacbd3e0642b3f70ceb.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. |