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>