~fredg/snaps

ref: d2454b9f8816ee67383cffde6ebf46f4861520a0 snaps/snaps.1 -rw-r--r-- 2.3 KiB
d2454b9f — Fred. Galusik man page updated 11 months 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
80
81
82
83
84
85
.TH "SNAPS" 1 "12/04/2021" "Frédéric Galusik"


.SH NOM

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

.SH SYNOPSIS

.P
\fBsnaps\fR [\fIoptions\fR]

.SH DESCRIPTION

.P
\fBsnaps\fR 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 \fI$MIRROR\fR freshness in order to let you choose to run \fBsysupgrade\fR 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 \fBFollowing \-current and using snapshots\fR and see if you have to make some tweaks.
Nevertheless, \fIcurl\fR and \fIlinks\fR (or \fIlynx\fR) from packages, are mandatory to run \fBsnaps\fR.

.SH GENERAL OPTIONS

.TP
\fB\-h\fR
Print help and exit. It also print the content of the
\fI$MIRROR\fR variable based upon \fI/etc/installurl\fR for a quick look.

.TP
\fB\-s\fR
Check your BASE snapshot and your \fI$MIRROR\fR BASE and PACKAGES build dates to let you choose to run \fBsysupgrade \-s\fR or not.

.TP
\fB\-c\fR
Check your BASE snapshot and BASE and PACKAGES build dates from \fI$MIRROR\fR.

.TP
\fB\-a\fR
Check BASE and PACKAGES build dates from all available online mirrors.

.TP
\fB\-l\fR
List date and download places of the 3 last \fI\-s\fR from
/var/log/snaps.log.

.TP
\fB\-f\fR
Read the online FAQ : Following \-current and using snapshots.

.TP
\fB\-u\fR
Upgrade snaps to the last release.

.TP
\fB\-p\fR
Update the ports tree to \-current.

.SH COMMAND LINE USAGE

.P
Here is an usage example:

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

.SH WEBSITE

.P
https://dev.galusik.fr/cgi\-bin/gotweb/gotweb?path=snaps.git&action=summary

.SH AUTHOR

.P
Frédéric Galusik

.SH SEE ALSO

.P
\fBsysupgrade\fR(8), \fBsysmerge\fR(8), \fBpkg_add\fR(1)

.\" man code generated by txt2tags 2.6 (http://txt2tags.org)
.\" cmdline: txt2tags snaps.t2t