Blame
Date:
Sat May 9 15:32:47 2020 UTC
Message:
update manpage and do v2.0 tarball
01
2016-05-15
dev1
# Snaps
02
2015-05-06
f
03
2016-05-15
dev1
An admin utility designed for the [OpenBSD operating system](http://www.openbsd.org) and published under the BSD licence.
04
2015-05-06
f
05
2016-05-15
dev1
## Purpose
06
2016-05-15
dev1
07
2016-05-15
dev1
It is made for users who use [-current](https://www.openbsd.org/faq/current.html) and jump from snapshot to snapshot.
08
2016-05-15
dev1
09
2020-05-09
f
**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.
10
2016-05-15
dev1
11
2020-05-09
f
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.
12
2016-10-15
dev1
13
2020-05-09
f
Nevertheless, **curl** and **links** (or **lynx**) from packages, are mandatory to run **snaps**.
14
2020-05-09
f
15
2020-05-09
f
16
2016-05-15
dev1
## Usage
17
2016-05-15
dev1
18
2017-04-17
dev1
Snaps will use your `/etc/installurl` file to setup automatically the `$MIRROR` variable.
19
2016-05-15
dev1
20
2016-05-15
dev1
You can also want to setup this variable manually:
21
2016-05-15
dev1
22
2016-05-15
dev1
```
23
2020-05-09
f
$ MIRROR=http://another/openbsd/mirror/pub/OpenBSD doas snaps -s
24
2016-05-15
dev1
```
25
2016-05-15
dev1
26
2017-04-17
dev1
Note that you have to indicate the root of the MIRROR followed with **/pub/OpenBSD**.
27
2017-04-17
dev1
This one have to follow the OpenBSD [directory layout](http://www.openbsd.org/ftp.html#layout).
28
2016-10-15
dev1
29
2020-05-09
f
### -s
30
2016-05-15
dev1
31
2020-05-09
f
Check your BASE snapshot and your *$MIRROR* BASE and PACKAGES build dates to let you choose to run **sysupgrade -s** or not.
32
2016-05-15
dev1
33
2016-05-15
dev1
```
34
2020-05-09
f
$ doas snaps -s
35
2016-05-15
dev1
```
36
2016-05-15
dev1
37
2020-05-09
f
### -c
38
2016-05-15
dev1
39
2020-05-09
f
Check BASE and PACKAGES build dates from *$MIRROR*.
40
2016-05-15
dev1
41
2016-05-15
dev1
```
42
2020-05-09
f
$ snaps -c
43
2016-05-15
dev1
```
44
2016-05-15
dev1
45
2020-05-09
f
### -a
46
2016-09-11
dev1
47
2020-05-09
f
Check BASE and PACKAGES build dates from all available online mirrors.
48
2016-09-11
dev1
49
2016-09-11
dev1
```
50
2020-05-09
f
$ snaps -a
51
2016-09-11
dev1
```
52
2016-09-11
dev1
53
2016-05-15
dev1
### -l
54
2016-05-15
dev1
55
2016-10-15
dev1
List date and download places of the 3 last -G from /var/log/snaps.log
56
2016-05-15
dev1
57
2016-05-15
dev1
```
58
2016-05-15
dev1
$ snaps -l
59
2020-05-09
f
2020-04-18 22:16 FROM http://ftp.fr.openbsd.org/pub/OpenBSD/snapshots/amd64/
60
2020-05-09
f
2020-05-02 11:03 FROM http://mirrors.ircam.fr/pub/OpenBSD/snapshots/amd64/
61
2020-05-09
f
2016-05-09 13:37 FROM http://ftp.fr.openbsd.org/pub/OpenBSD/snapshots/amd64/
62
2016-05-15
dev1
```
63
2016-05-15
dev1
64
2020-05-09
f
### -f
65
2020-05-09
f
66
2020-05-09
f
Read the online FAQ **Following -current and using snapshots**.
67
2020-05-09
f
68
2020-05-09
f
```
69
2020-05-09
f
$ snaps -f
70
2020-05-09
f
```
71
2020-05-09
f
72
2016-09-11
dev1
### -u
73
2016-06-11
dev1
74
2016-09-11
dev1
Upgrade snaps to the last release.
75
2016-06-11
dev1
76
2016-06-11
dev1
```
77
2016-09-11
dev1
$ doas snaps -u
78
2016-06-11
dev1
```
79
2016-06-11
dev1
80
2020-05-09
f
### -p
81
2020-05-09
f
82
2020-05-09
f
Update the ports tree to -current.
83
2020-05-09
f
84
2020-05-09
f
```
85
2020-05-09
f
$ doas snaps -p
86
2020-05-09
f
```
87
2020-05-09
f
88
2016-05-15
dev1
### -h
89
2016-05-15
dev1
90
2016-05-15
dev1
Print help and exit. It also print the content of the MIRROR variable based upon /etc/pkg.conf for a quick look.
91
2016-05-15
dev1
92
2016-05-15
dev1
```
93
2016-05-15
dev1
$ snaps -h
94
2016-05-15
dev1
```
Frédéric Galusik