xref: /openbsd-src/usr.sbin/syspatch/syspatch.8 (revision 91cb7cd0534179111e18f0ec92f74506fd62dcd5)
1*91cb7cd0Sajacoutot.\"	$OpenBSD: syspatch.8,v 1.22 2020/12/07 21:19:28 ajacoutot Exp $
2cb6f7b6fSajacoutot.\"
3cb6f7b6fSajacoutot.\" Copyright (c) 2016 Antoine Jacoutot <ajacoutot@openbsd.org>
4cb6f7b6fSajacoutot.\"
5cb6f7b6fSajacoutot.\" Permission to use, copy, modify, and distribute this software for any
6cb6f7b6fSajacoutot.\" purpose with or without fee is hereby granted, provided that the above
7cb6f7b6fSajacoutot.\" copyright notice and this permission notice appear in all copies.
8cb6f7b6fSajacoutot.\"
9cb6f7b6fSajacoutot.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10cb6f7b6fSajacoutot.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11cb6f7b6fSajacoutot.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12cb6f7b6fSajacoutot.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13cb6f7b6fSajacoutot.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14cb6f7b6fSajacoutot.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15cb6f7b6fSajacoutot.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16cb6f7b6fSajacoutot.\"
17*91cb7cd0Sajacoutot.Dd $Mdocdate: December 7 2020 $
18cb6f7b6fSajacoutot.Dt SYSPATCH 8
19cb6f7b6fSajacoutot.Os
20cb6f7b6fSajacoutot.Sh NAME
21cb6f7b6fSajacoutot.Nm syspatch
2200bd6dacSajacoutot.Nd manage base system binary patches
23cb6f7b6fSajacoutot.Sh SYNOPSIS
24cb6f7b6fSajacoutot.Nm syspatch
25b40f9483Sajacoutot.Op Fl c | l | R | r
26cb6f7b6fSajacoutot.Sh DESCRIPTION
2700bd6dacSajacoutot.Nm
283cab49e4Sajacoutotis a utility to fetch, verify, install and revert
2900bd6dacSajacoutot.Ox
3000bd6dacSajacoutotbinary patches.
3100bd6dacSajacoutot.Pp
3263880a3fSajacoutotWhen run without any options,
334b940db2Sajacoutot.Nm syspatch
34e6d78d6eSajacoutotwill apply
35c408c745Sschwarze.Em all
36a8f86fd3Sajacoutotmissing patches, creating a rollback tarball containing the files it is about
37a8f86fd3Sajacoutotto replace, then extracting and installing all files contained in the syspatch
38a8f86fd3Sajacoutottarball.
396205d5a7SajacoutotIf any sets are missing, patches are skipped accordingly.
404c9e7d12SajacoutotPatches are cumulative and as such it is not possible to install only a subset
414c9e7d12Sajacoutotof them.
424b940db2Sajacoutot.Pp
4300bd6dacSajacoutotThe options are as follows:
4400bd6dacSajacoutot.Bl -tag -width Ds
4500bd6dacSajacoutot.It Fl c
4663880a3fSajacoutotList available patches; suitable for
474b940db2Sajacoutot.Xr cron 8 .
4800bd6dacSajacoutot.It Fl l
4900bd6dacSajacoutotList installed patches.
50b40f9483Sajacoutot.It Fl R
51b40f9483SajacoutotRevert all patches.
5200bd6dacSajacoutot.It Fl r
53ed78b536SajacoutotRevert the most recently installed patch.
5400bd6dacSajacoutot.El
554b940db2Sajacoutot.Sh FILES
56a8f86fd3Sajacoutot.Bl -tag -width "/etc/installurl" -compact
578b55056cSajacoutot.It Pa /etc/installurl
583965237cSjmc.Ox
593965237cSjmcmirror top-level URL for fetching patches.
6008a8da71Sajacoutot.It Pa /var/syspatch/*
6108a8da71SajacoutotDirectories containing the rollback tarball and original signed
6208a8da71Sajacoutot.Xr diff 1
6308a8da71Sajacoutotof installed patches.
644b940db2Sajacoutot.El
65735d7ac9Ssolene.Sh EXIT STATUS
66735d7ac9Ssolene.Ex -std syspatch
67*91cb7cd0SajacoutotIn particular, 2 indicates that applying patches was requested but no
68*91cb7cd0Sajacoutotadditional patch was installed.
69cb6f7b6fSajacoutot.Sh SEE ALSO
70b1898abeSajacoutot.Xr signify 1 ,
718b55056cSajacoutot.Xr installurl 5 ,
72cb6f7b6fSajacoutot.Xr release 8
73cb6f7b6fSajacoutot.Sh HISTORY
74cb6f7b6fSajacoutot.Nm
75cb6f7b6fSajacoutotfirst appeared in
76cb6f7b6fSajacoutot.Ox 6.1 .
77cb6f7b6fSajacoutot.Sh AUTHORS
78cb6f7b6fSajacoutot.Nm
79cb6f7b6fSajacoutotwas written by
80cb6f7b6fSajacoutot.An Antoine Jacoutot Aq Mt ajacoutot@openbsd.org .
81611a204aSajacoutot.Sh CAVEATS
82611a204aSajacoutot.Nm
83e6d78d6eSajacoutotis designed to work solely on official
84e6d78d6eSajacoutot.Ox
85e6d78d6eSajacoutotreleases.
86