1.\" $NetBSD: binpatch.8,v 1.7 2001/11/26 00:06:40 wiz Exp $ 2.\" 3.\" Copyright (c) 1994 Christian E. Hopps 4.\" All rights reserved. 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: 9.\" 1. Redistributions of source code must retain the above copyright 10.\" notice, this list of conditions and the following disclaimer. 11.\" 2. Redistributions in binary form must reproduce the above copyright 12.\" notice, this list of conditions and the following disclaimer in the 13.\" documentation and/or other materials provided with the distribution. 14.\" 3. All advertising materials mentioning features or use of this software 15.\" must display the following acknowledgement: 16.\" This product includes software developed by Christian E. Hopps. 17.\" 4. The name of the author may not be used to endorse or promote products 18.\" derived from this software without specific prior written permission 19.\" 20.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 21.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 22.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 23.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 24.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 25.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 26.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 27.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 28.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 29.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 30.\" 31.Dd February 2, 1994 32.Dt BINPATCH 8 amiga 33.Os 34.Sh NAME 35.Nm binpatch 36.Nd "examine and or modify initialized data in a binary file" 37.Sh SYNOPSIS 38.Nm binpatch 39.Op Fl b | Fl w | Fl l 40.Op Fl o Ar offset 41.Fl s Ar symname 42.Op Fl r Ar value 43.Ar binfile 44.Nm binpatch 45.Op Fl b | Fl w | Fl l 46.Op Fl o Ar offset 47.Fl a Ar addr 48.Op Fl r Ar value 49.Ar binfile 50.Sh DESCRIPTION 51.Nm 52is used to modify or examine the data associated with a symbol in a binary 53file 54.Ar binfile . 55The flags 56.Fl b , 57.Fl w 58and 59.Fl l 60specify the size of the data to be modified or examined 61(byte, word and long respectively.) The 62.Ar binfile 63is scanned in search of the symbol 64.Ar symname 65(specified with the 66.Fl s 67flag) 68If the symbol is found the current data and address are printed. Next if the 69.Fl r 70flag has been given, the current data is replaced with that of 71.Ar value . 72.Pp 73If the second form is used the address 74.Ar addr 75specified with the 76.Fl a 77flag is used as a direct address into the data section of the binary and 78no symbol search is performed. 79.Pp 80The 81.Fl o 82flag specifies an offset in byte, word or long 83.Fl ( b , 84.Fl w , 85or 86.Fl l ) 87units from the given locator 88.Fl ( s 89or 90.Fl a ) 91for 92.Nm 93to perform its described actions. 94