summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorTimo Teräs <timo.teras@iki.fi>2022-12-28 14:42:23 +0200
committerTimo Teräs <timo.teras@iki.fi>2022-12-28 14:57:38 +0200
commit60f8d520898bafcd9ce831b04ea4aee9c206fd1d (patch)
tree35d64b8d743a3c5380474618b9a04736c6de13e6 /doc
parentc24dc49a72155da2e35203cc3a3d3dba8efde220 (diff)
downloadapk-tools-60f8d520898bafcd9ce831b04ea4aee9c206fd1d.tar.gz
apk-tools-60f8d520898bafcd9ce831b04ea4aee9c206fd1d.tar.bz2
apk-tools-60f8d520898bafcd9ce831b04ea4aee9c206fd1d.tar.xz
apk-tools-60f8d520898bafcd9ce831b04ea4aee9c206fd1d.zip
cache, upgrade: do not continue if repositories have issues
There are subtle issues where solving fails with --available, and install_if rules if the repository indexes are not available. Also it can be considered upgrade failure if index update failed. Abort cache download, cache sync and upgrade operations early in the above mentioned cases. Also document side effects of --simulate that might affect upgrade. fixes #10726, #10764
Diffstat (limited to 'doc')
-rw-r--r--doc/apk.8.scd5
1 files changed, 4 insertions, 1 deletions
diff --git a/doc/apk.8.scd b/doc/apk.8.scd
index 86eae96..d924041 100644
--- a/doc/apk.8.scd
+++ b/doc/apk.8.scd
@@ -189,7 +189,10 @@ The following options are available for all commands.
The following options are available for all commands which commit the database.
*-s, --simulate*
- Simulate the requested operation without making any changes.
+ Simulate the requested operation without making any changes. The database
+ is opened in read only mode, and auto-updating of indexes is disabled.
+ You may want to run "apk update" before running a simulation to make sure
+ it is done with up-to-date repository indexes.
*--clean-protected*
Do not create .apk-new files in configuration directories.