Commit Diff
Fred. Galusik <>
Fred. Galusik <>
Sat May 9 15:28:50 2020 UTC
take care of last changes
blob - 1267ec60ac776b1624cbc5566e1cc4ebd4446b95
blob + b41837442a1dfc2b67eebda4111a6c4f6c2864d2
@@ -6,14 +6,13 @@ An admin utility designed for the [OpenBSD operating s
It is made for users who use [-current]( 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](
-### -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
-2016-05-10 11:03 FROM
-2016-05-14 11:11 FROM
+2020-04-18 22:16 FROM
+2020-05-02 11:03 FROM
+2016-05-09 13:37 FROM
+### -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