#Snaps

An admin utility designed for the OpenBSD operating system and published under the BSD licence.

#Purpose

It is made for users who use -current and jump from snapshot to snapshot.

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.

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.

You can also want to setup this variable manually:

$ 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.

#-s

Check your BASE snapshot and your $MIRROR BASE and PACKAGES build dates to let you choose to run sysupgrade -s or not.

$ doas snaps -s

#-c

Check BASE and PACKAGES build dates from $MIRROR.

$ snaps -c

#-a

Check BASE and PACKAGES build dates from all available online mirrors.

$ snaps -a

#-l

List date and download places of the 3 last -s from /var/log/snaps.log

$ snaps -l
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.

$ 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.

$ snaps -h