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:59:32 +0200
commit40f6720a3ffd448bd338412cf975befc71461abd (patch)
treec92a833ffbced3e683fab1a8acc1e28d7c915c6f /doc
parent22cc01645d93b6cf97e8d154f04c7ce3c5d74597 (diff)
downloadapk-tools-40f6720a3ffd448bd338412cf975befc71461abd.tar.gz
apk-tools-40f6720a3ffd448bd338412cf975befc71461abd.tar.bz2
apk-tools-40f6720a3ffd448bd338412cf975befc71461abd.tar.xz
apk-tools-40f6720a3ffd448bd338412cf975befc71461abd.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 3b5797e..1b9b6f3 100644
--- a/doc/apk.8.scd
+++ b/doc/apk.8.scd
@@ -179,7 +179,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.