# Snaps

An admin utility designed for the [OpenBSD operating system](http://www.openbsd.org) and published under the BSD licence.

## Purpose

It is made for users who use [-current](https://www.openbsd.org/faq/current.html) 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](http://www.openbsd.org/ftp.html#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
```