share/man/man8/man8.amiga/binpatch.8

   1 .\"     $NetBSD: binpatch.8,v 1.6 2001/09/05 23:53:23 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
  52 is used to modify or examine the data associated with a symbol in a binary
  53 file
  54 .Ar binfile .
  55 The flags
  56 .Fl b ,
  57 .Fl w
  58 and
  59 .Fl l
  60 specify the size of the data to be modified or examined
  61 (byte, word and long respectively.)  The
  62 .Ar binfile
  63 is scanned in search of the symbol
  64 .Ar symname
  65 (specified with the
  66 .Fl s
  67 flag)
  68 If the symbol is found the current data and address are printed.  Next if the
  69 .Fl r
  70 flag has been given, the current data is replaced with that of
  71 .Ar value .
  72 .Pp
  73 If the second form is used the address
  74 .Ar addr
  75 specified with the
  76 .Fl a
  77 flag is used as a direct address into the data section of the binary and
  78 no symbol search is performed.
  79 .Pp
  80 The
  81 .Fl o
  82 flag specifies an offset in byte, word or long
  83 .Fl ( b ,
  84 .Fl w ,
  85 or
  86 .Fl l )
  87 units from the given locator
  88 .Fl ( s
  89 or
  90 .Fl a )
  91 for
  92 .Nm
  93 to perform its described actions.