Annotation of pkgsrc/pkgtools/binpatch/files/binpatch.1, revision 1.2
1.2 ! wiz 1: .\" $NetBSD: binpatch.1,v 1.1.1.1 2004/07/23 03:37:26 atatat Exp $
1.1 atatat 2: .\"
3: .\" Copyright (c) 2004 by Andrew Brown <atatat@netbsd.org>
4: .\" Absolutely no warranty.
5: .\"
6: .Dd July 20, 2004
7: .Dt BINPATCH 1
8: .Sh NAME
9: .Nm binpatch
10: .Nd trivial binary patch applicator
11: .Sh SYNOPSIS
12: .Nm
13: .Pa file=...
14: .Pa size=...
15: .Pa offset=...
16: .Pa compare=...
17: .Pa skip=...
18: .Pa replace=...
19: .Sh DESCRIPTION
20: The
21: .Nm
22: utility can read and replace a small section of a given file.
23: It is designed for use in those instances where a problem exists with
24: a given binary that cannot be reconstructed from source code, but the
25: required change can be implemented by replacing a few bytes in the
26: existing binary.
27: All arguments must be given.
28: .Sh EXAMPLES
29: Given a binary called
30: .Dq a.out
31: of 10713 bytes in size with the following text segment:
32: .Bd -literal -offset indent
33: % objdump -h a.out
34: .sp
35: a.out: file format elf32-i386
36: .sp
37: Sections:
38: Idx Name Size VMA LMA File off Algn
39: [...]
40: 9 .text 00000be4 08048968 08048968 00000968 2**2
41: CONTENTS, ALLOC, LOAD, READONLY, CODE
42: [...]
43: % objdump -d -j .text a.out
44: [...]
45: 8048b0f: 83 ef 04 sub $0x4,%edi
46: 8048b12: ff d0 call *%eax
47: 8048b14: 83 fe ff cmp $0xffffffff,%esi
48: [...]
49: .sp
50: .Ed
51: where we wish to elide the call through
52: .Ar %eax
53: by replacing it with a series of
54: .Ar nop
55: (or
56: .Dq no operation )
57: instructions (the machine code for this on the i386 platform is 0x90),
58: we first calculate the offset into the file of the previous
59: .Ar sub
60: instruction. To do this, we take the address of the
61: .Ar sub
62: instruction as given by the dissassembly output, subtract the
63: .Dq LMA
64: and add the
65: .Dq File off
66: values from the objdump output (note that
67: .Xr bc 1
68: expects hexadecimal values to be given using upper case):
69: .Bd -literal -offset indent
70: % bc
71: ibase=16
72: 8048B0F-08048968+00000968
73: 2831
74: .sp
75: .Ed
76: The region of the binary we want to compare to before applying the
77: patch is the concatenation of the relevant machine codes from the
78: dissassembly dump (\c
79: .Ar 83ef04ffd083feff )
80: and the replacement is simply two
81: .Ar nop
82: instructions (\c
83: .Ar 9090 ) ,
84: that will replace the
85: .Ar ffd0
86: of the original call.
87: The offset of the replacement is 3, since that is the number of bytes
88: in the
89: .Ar sub
90: instruction.
91: From this we have our patch:
92: .Bd -literal -offset indent
93: % binpatch file=a.out size=10713 offset=2831 \\
94: compare=83ef04ffd083feff skip=3 replace=9090
95: % objdump -d -j .text a.out
96: [...]
97: 8048b0f: 83 ef 04 sub $0x4,%edi
98: 8048b12: 90 nop
99: 8048b13: 90 nop
100: 8048b14: 83 fe ff cmp $0xffffffff,%esi
101: [...]
102: .sp
103: .Ed
104: And thus the call is removed.
105: .Sh DIAGNOSTICS
106: The diagnostics are terse and almost unhelpful, but are more verbose
107: than users of
108: .Xr ed 1
109: might be used to.
110: They typically mention the command line argument that was in error.
111: .Sh SEE ALSO
112: .Xr bc 1 ,
113: .Xr objdump 1 ,
114: .Xr patch 1
115: .Sh AUTHORS
1.2 ! wiz 116: .An Andrew Brown Aq Mt atatat@netbsd.org
CVSweb <webmaster@jp.NetBSD.org>