SNAPS
Frédéric Galusik
%%mtime(%m/%d/%Y)

%!target: man
%!encoding: utf-8
%!outfile: snaps.1


= NOM =[nom]

SNAPS - An OpenBSD admin utility to deal with -current base snapshot.


= SYNOPSIS =[synopsis]

**snaps** [//options//]


= DESCRIPTION =[description]

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


= GENERAL OPTIONS =[general-options]

: **-h**
Print help and exit. It also print the content of the
//$MIRROR// variable based upon ///etc/installurl// for a quick look.

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

: **-c**
Check BASE and PACKAGES build dates from //$MIRROR//.

: **-a**
Check BASE and PACKAGES build dates from all available online mirrors.

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

: **-f**
Read the online FAQ : Following -current and using snapshots.

: **-u**
Upgrade snaps to the last release.

: **-p**
Update the ports tree to -current.


= COMMAND LINE USAGE =[command-line-usage]

Here is an usage example:

: **MIRROR=http://another/openbsd/mirror/pub/OpenBSD doas snaps -s**
Bypass your ///etc/installurl// file and manually setup the //$MIRROR//
variable. Note that you have to indicate the root of the //$MIRROR// followed
by **/pub/OpenBSD** (no **/** at the end). This one have to follow the OpenBSD directory layout. Moreover, in order to play with //$MIRROR//, **doas** have to be setup with the //keepenv// option.


= WEBSITE =[website]

https://framagit.org/fredg/snaps


= AUTHOR =[author]

Frédéric Galusik


= SEE ALSO =[see-also]

**sysupgrade**(8), **sysmerge**(8), **pkg_add**(1)