~fredg/snaps

8306e7fbfaed67c288b11634b98e29bad763db2b — Fred. Galusik 2 years ago 1b79e0f
update manpage and do v2.0 tarball
3 files changed, 47 insertions(+), 54 deletions(-)

D snaps-1.3.tar.gz
M snaps.1
M snaps.t2t
D snaps-1.3.tar.gz => snaps-1.3.tar.gz +0 -0
M snaps.1 => snaps.1 +25 -28
@@ 1,10 1,10 @@
.TH "SNAPS" 1 "08/25/2017" "Frédéric Galusik"
.TH "SNAPS" 1 "05/09/2020" "Frédéric Galusik"


.SH NOM

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

.SH SYNOPSIS



@@ 14,12 14,10 @@ SNAPS \- An OpenBSD admin utility to upgrade to last \-current base snapshot.
.SH DESCRIPTION

.P
\fBsnaps\fR will help you to download the needed \fBbsd.rd\fR, check it and move it to
the right place before rebooting. A backup of your last bsd.rd is made. All
steps are verbose. It can be run with only the base system. Nevertheless if you
install \fIcurl\fR from packages, it will check your \fI$MIRROR\fR build date of
base and packages. You will be able to decide if you want to do the update right now
or wait for the synchronicity of the two directories.
\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



@@ 29,45 27,44 @@ 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\-g\fR
Fetch and check (SHA256 and signify) bsd.rd from \fI$MIRROR\fR (no need
to be root for that one).
\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\-G\fR
Fetch, check bsd.rd from \fI$MIRROR\fR then, move it to the right place,
backup your last bsd.rd, print some reminders and reboot.
\fB\-c\fR
Check BASE and PACKAGES build dates from \fI$MIRROR\fR.

.TP
\fB\-p\fR
Update your \fI\-current\fR port tree.
\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\-G\fR from
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 are some usage examples:
Here is an usage example:

.TP
\fBMIRROR=http://another/openbsd/mirror/pub/OpenBSD doas snaps \-G\fR
\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 \fIMIRROR\fR, \fBdoas\fR have to be setup with the \fIkeepenv\fR option.

.TP
\fBRL=62 doas snaps \-G\fR
Bypass the default signify key which used.
Usefull when beta is coming because the release number is setup for the next release/stable.
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



@@ 82,7 79,7 @@ Frédéric Galusik
.SH SEE ALSO

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

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

M snaps.t2t => snaps.t2t +22 -26
@@ 9,7 9,7 @@ Frédéric Galusik

= NOM =[nom]

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


= SYNOPSIS =[synopsis]


@@ 19,12 19,10 @@ SNAPS - An OpenBSD admin utility to upgrade to last -current base snapshot.

= DESCRIPTION =[description]

**snaps** will help you to download the needed **bsd.rd**, check it and move it to
the right place before rebooting. A backup of your last bsd.rd is made. All
steps are verbose. It can be run with only the base system. Nevertheless if you
install //curl// from packages, it will check your //$MIRROR// build date of
base and packages. You will be able to decide if you want to do the update right now
or wait for the synchronicity of the two directories.
**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]


@@ 33,39 31,37 @@ or wait for the synchronicity of the two directories.
Print help and exit. It also print the content of the
//$MIRROR// variable based upon ///etc/installurl// for a quick look.

: **-g**
Fetch and check (SHA256 and signify) bsd.rd from //$MIRROR// (no need
to be root for that one).
: **-s**
Check your BASE snapshot and your //$MIRROR// BASE and PACKAGES build dates to let you choose to run **sysupgrade -s** or not.

: **-G**
Fetch, check bsd.rd from //$MIRROR// then, move it to the right place,
backup your last bsd.rd, print some reminders and reboot.
: **-c**
Check BASE and PACKAGES build dates from //$MIRROR//.

: **-p**
Update your //-current// port tree.
: **-a**
Check BASE and PACKAGES build dates from all available online mirrors.

: **-l**
List date and download places of the 3 last //-G// from
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 are some usage examples:
Here is an usage example:

: **MIRROR=http://another/openbsd/mirror/pub/OpenBSD doas snaps -G**
: **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.

: **RL=62 doas snaps -G**
Bypass the default signify key which used.
Usefull when beta is coming because the release number is setup for the next release/stable.
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]


@@ 80,4 76,4 @@ Frédéric Galusik

= SEE ALSO =[see-also]

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