xref: /aosp_15_r20/external/bsdiff/bsdiff.1 (revision a3a45f308bd90ef1a6e6a5e8fb92fe449b895909)
1*a3a45f30SXin Li.\"-
2*a3a45f30SXin Li.\" Copyright 2003-2005 Colin Percival
3*a3a45f30SXin Li.\" All rights reserved
4*a3a45f30SXin Li.\"
5*a3a45f30SXin Li.\" Redistribution and use in source and binary forms, with or without
6*a3a45f30SXin Li.\" modification, are permitted providing that the following conditions
7*a3a45f30SXin Li.\" are met:
8*a3a45f30SXin Li.\" 1. Redistributions of source code must retain the above copyright
9*a3a45f30SXin Li.\"    notice, this list of conditions and the following disclaimer.
10*a3a45f30SXin Li.\" 2. Redistributions in binary form must reproduce the above copyright
11*a3a45f30SXin Li.\"    notice, this list of conditions and the following disclaimer in the
12*a3a45f30SXin Li.\"    documentation and/or other materials provided with the distribution.
13*a3a45f30SXin Li.\"
14*a3a45f30SXin Li.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
15*a3a45f30SXin Li.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
16*a3a45f30SXin Li.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17*a3a45f30SXin Li.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
18*a3a45f30SXin Li.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19*a3a45f30SXin Li.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20*a3a45f30SXin Li.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21*a3a45f30SXin Li.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
22*a3a45f30SXin Li.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
23*a3a45f30SXin Li.\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
24*a3a45f30SXin Li.\" POSSIBILITY OF SUCH DAMAGE.
25*a3a45f30SXin Li.\"
26*a3a45f30SXin Li.\" $FreeBSD: src/usr.bin/bsdiff/bsdiff/bsdiff.1,v 1.1 2005/08/06 01:59:05 cperciva Exp $
27*a3a45f30SXin Li.\"
28*a3a45f30SXin Li.Dd May 18, 2003
29*a3a45f30SXin Li.Dt BSDIFF 1
30*a3a45f30SXin Li.Os FreeBSD
31*a3a45f30SXin Li.Sh NAME
32*a3a45f30SXin Li.Nm bsdiff
33*a3a45f30SXin Li.Nd generate a patch between two binary files
34*a3a45f30SXin Li.Sh SYNOPSIS
35*a3a45f30SXin Li.Nm
36*a3a45f30SXin Li.Ar oldfile newfile patchfile
37*a3a45f30SXin Li.Sh DESCRIPTION
38*a3a45f30SXin Li.Nm
39*a3a45f30SXin Licompares
40*a3a45f30SXin Li.Ar oldfile
41*a3a45f30SXin Lito
42*a3a45f30SXin Li.Ar newfile
43*a3a45f30SXin Liand writes to
44*a3a45f30SXin Li.Ar patchfile
45*a3a45f30SXin Lia binary patch suitable for use by
46*a3a45f30SXin Li.Xr bspatch 1 .
47*a3a45f30SXin LiWhen
48*a3a45f30SXin Li.Ar oldfile
49*a3a45f30SXin Liand
50*a3a45f30SXin Li.Ar newfile
51*a3a45f30SXin Liare two versions of an executable program, the
52*a3a45f30SXin Lipatches produced are on average a factor of five smaller
53*a3a45f30SXin Lithan those produced by any other binary patch tool known
54*a3a45f30SXin Lito the author.
55*a3a45f30SXin Li.Pp
56*a3a45f30SXin Li.Nm
57*a3a45f30SXin Liuses memory equal to 17 times the size of
58*a3a45f30SXin Li.Ar oldfile ,
59*a3a45f30SXin Liand requires
60*a3a45f30SXin Lian absolute minimum working set size of 8 times the size of oldfile.
61*a3a45f30SXin Li.Sh SEE ALSO
62*a3a45f30SXin Li.Xr bspatch 1
63*a3a45f30SXin Li.Sh AUTHORS
64*a3a45f30SXin Li.An Colin Percival Aq [email protected]
65