xref: /openbsd-src/usr.sbin/syspatch/syspatch.8 (revision 611a204ab73f3f19cdd26b0b5b30ff9de77f9950)
1*611a204aSajacoutot.\"	$OpenBSD: syspatch.8,v 1.11 2016/11/29 09:00:05 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*611a204aSajacoutot.Dd $Mdocdate: November 29 2016 $
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
25cbc95686Sajacoutot.Op Fl c | l | 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
344b940db2Sajacoutotwill apply all missing patches by saving the original release kernel if needed,
354b940db2Sajacoutotcreating a rollback tarball containing the files it is about to replace,
364b940db2Sajacoutotthen extracting and installing all files contained in the syspatch tarball.
374b940db2Sajacoutot.Pp
3800bd6dacSajacoutotThe options are as follows:
3900bd6dacSajacoutot.Bl -tag -width Ds
4000bd6dacSajacoutot.It Fl c
4163880a3fSajacoutotList available patches; suitable for
424b940db2Sajacoutot.Xr cron 8 .
4300bd6dacSajacoutot.It Fl l
4400bd6dacSajacoutotList installed patches.
4500bd6dacSajacoutot.It Fl r
46ed78b536SajacoutotRevert the most recently installed patch.
4700bd6dacSajacoutot.El
484b940db2Sajacoutot.Sh FILES
494b940db2Sajacoutot.Bl -tag -width "/var/syspatch/${OSREV}/*.tgz" -compact
50ff826bc8Sajacoutot.It Pa /bsd.syspatch${OSrev}
5163880a3fSajacoutotBackup of the original
524b940db2Sajacoutot.Pa /bsd
534b940db2Sajacoutotrelease kernel.
544b940db2Sajacoutot.It Pa /var/syspatch/${OSREV}/*.sig
554b940db2SajacoutotInformation on installed patches.
564b940db2Sajacoutot.It Pa /var/syspatch/${OSREV}/*.tgz
574b940db2SajacoutotRollback tarballs for reverting patches.
584b940db2Sajacoutot.El
59cb6f7b6fSajacoutot.Sh SEE ALSO
60b1898abeSajacoutot.Xr signify 1 ,
61cb6f7b6fSajacoutot.Xr release 8
62cb6f7b6fSajacoutot.Sh HISTORY
63cb6f7b6fSajacoutot.Nm
64cb6f7b6fSajacoutotfirst appeared in
65cb6f7b6fSajacoutot.Ox 6.1 .
66cb6f7b6fSajacoutot.Sh AUTHORS
67cb6f7b6fSajacoutot.Nm
68cb6f7b6fSajacoutotwas written by
69cb6f7b6fSajacoutot.An Antoine Jacoutot Aq Mt ajacoutot@openbsd.org .
70*611a204aSajacoutot.Sh CAVEATS
71*611a204aSajacoutot.Nm
72*611a204aSajacoutotonly works on official releases and will always sync and apply all patches
73*611a204aSajacoutotregardless of the installed sets.
74