~fredg/snaps

ref: 6a13b547720f81a9a84af9e3f71179bfe4674eb6 snaps/snaps.t2t -rw-r--r-- 2.2 KiB
6a13b547 — Fred. Galusik version bump 1 year, 1 month ago
                                                                                
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
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)