Commit Diff
Diff:
94c73b6c4ca44aeb9f71a210bdfcea56ebbae835
f6f54932ed848e6b7e32c8496df196a25497a6f0
Commit:
f6f54932ed848e6b7e32c8496df196a25497a6f0
Tree:
fbca119304c8a06da60e23a6e1a6eb1228e1e41d
Author:
Fred. Galusik <f@galusik.fr>
Committer:
Fred. Galusik <f@galusik.fr>
Date:
Sat May 9 15:28:50 2020 UTC
Message:
take care of last changes
blob - 1267ec60ac776b1624cbc5566e1cc4ebd4446b95
blob + b41837442a1dfc2b67eebda4111a6c4f6c2864d2
--- README.md
+++ README.md
@@ -6,14 +6,13 @@ An admin utility designed for the [OpenBSD operating s
It is made for users who use [-current](https://www.openbsd.org/faq/current.html) and jump from snapshot to snapshot.
-It will help you to download the needed bsd.rd, check it and move it to the right place before rebooting.
-A backup of your last bsd.rd is made. All steps are verbose.
+**snaps** helps you to see if you need and/or can upgrade your -current BASE and PACKAGES system to next snapshots. It can show you when your system has been upgraded, which BASE snapshot you are using and compare it to your *$MIRROR* freshness in order to let you choose to run **sysupgrade** or not.
-It can be run with only the base system. Nevertheless if you install *curl*
-from packages, it will check your $MIRROR build date of base and packages. You
-will be able to decide if you want to do the update now or wait for the
-synchronicity of the two directories.
+If you need to, it can also ckeck available mirrors and show you their BASE and PACKAGES build dates. Moreover, you can also read the online FAQ **Following -current and using snapshots** and see if you have to make some tweaks.
+Nevertheless, **curl** and **links** (or **lynx**) from packages, are mandatory to run **snaps**.
+
+
## Usage
Snaps will use your `/etc/installurl` file to setup automatically the `$MIRROR` variable.
@@ -21,34 +20,34 @@ Snaps will use your `/etc/installurl` file to setup au
You can also want to setup this variable manually:
```
-$ MIRROR=http://another/openbsd/mirror/pub/OpenBSD doas snaps -G
+$ MIRROR=http://another/openbsd/mirror/pub/OpenBSD doas snaps -s
```
Note that you have to indicate the root of the MIRROR followed with **/pub/OpenBSD**.
This one have to follow the OpenBSD [directory layout](http://www.openbsd.org/ftp.html#layout).
-### -g
+### -s
-Fetch and check (SHA256 and signify) bsd.rd from $MIRROR (no need to be root for that one)
+Check your BASE snapshot and your *$MIRROR* BASE and PACKAGES build dates to let you choose to run **sysupgrade -s** or not.
```
-$ snaps -g
+$ doas snaps -s
```
-### -G
+### -c
-Fetch, check bsd.rd from $MIRROR then, move it to the right place, backup your last bsd.rd, print some reminders and reboot.
+Check BASE and PACKAGES build dates from *$MIRROR*.
```
-$ doas snaps -G
+$ snaps -c
```
-### -p
+### -a
-Update your -current port tree
+Check BASE and PACKAGES build dates from all available online mirrors.
```
-$ doas snaps -p
+$ snaps -a
```
### -l
@@ -57,11 +56,19 @@ List date and download places of the 3 last -G from /v
```
$ snaps -l
-2016-04-30 22:16 FROM http://ftp.fr.openbsd.org/pub/OpenBSD/snapshots/amd64/
-2016-05-10 11:03 FROM http://mirrors.ircam.fr/pub/OpenBSD/snapshots/amd64/
-2016-05-14 11:11 FROM http://ftp.fr.openbsd.org/pub/OpenBSD/snapshots/amd64/
+2020-04-18 22:16 FROM http://ftp.fr.openbsd.org/pub/OpenBSD/snapshots/amd64/
+2020-05-02 11:03 FROM http://mirrors.ircam.fr/pub/OpenBSD/snapshots/amd64/
+2016-05-09 13:37 FROM http://ftp.fr.openbsd.org/pub/OpenBSD/snapshots/amd64/
```
+### -f
+
+Read the online FAQ **Following -current and using snapshots**.
+
+```
+$ snaps -f
+```
+
### -u
Upgrade snaps to the last release.
@@ -70,6 +77,14 @@ Upgrade snaps to the last release.
$ doas snaps -u
```
+### -p
+
+Update the ports tree to -current.
+
+```
+$ doas snaps -p
+```
+
### -h
Print help and exit. It also print the content of the MIRROR variable based upon /etc/pkg.conf for a quick look.
Frédéric Galusik