uvmac/docs/extras/findcode/index.html

1 line
4.2 KiB
HTML
Raw Permalink Normal View History

2020-03-14 19:28:01 +00:00
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title> FindCode </title> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> <meta name="viewport" content="width=device-width, initial-scale=1"> <link rel="canonical" href="index.html"> </head> <body> <div> <i> <a href="https://www.gryphel.com/index.html">www.gryphel.com</a>/c/<a href="../../index.html">minivmac</a>/<a href="../index.html">extras</a>/findcode - <a href="https://www.gryphel.com/c/feedback.html">feedback</a> </i> </div> <hr> <h2 align=center> FindCode </h2> <hr> <p> Download </p> <blockquote> <p> <a href="https://www.gryphel.com/d/minivmac/extras/findcode/findcode-1.1.0.zip">findcode-1.1.0.zip</a> (84K) a zipped hfs disk image and checksum file. The disk image can be mounted with Mini vMac. Includes source code. </p> </blockquote> <p> FindCode helps to create "bin_map" and "bin_names" files used by <a href="../fdisasm/index.html">FDisasm</a>. </p> <p> To use FindCode, place it in the same folder as a file named "bin" that you are trying to disassemble. Launch FindCode and you will see a simple text editing window. Type a location within the "bin" file that you believe contains code, in hexadecimal notation. For example, "2A" (without the quotes), for an offset of 42 (decimal) from the beginning of "bin". Then choose the "Go" command from the "File" menu. </p> <p> Assuming there is code at offset 42, FindCode will find every instruction that it thinks can definitely be reached from there, and add this to the file "bin_map". (The file is created if it doesn't already exist.) It will also create labels for the targets of branches and other memory accesses within "bin" that it can identify, and add them to the file "bin_names". (This file also is created if it doesn't already exist.) It will not change labels that already exist in "bin_names". </p> <p> If FindCode thinks that an invalid instruction can definitely be reached from the starting offset you specified, it will give an error message and make no changes to "bin_map" and "bin_names". </p> <p> When FindCode is done, it will automatically launch FDisasm if it is located in the same folder. You can then enter other locations into FindCode and choose the "Go" command. FindCode will open and close the "bin_map" and "bin_names" files every time the "Go" command is chosen, so you can manually edit these files and still leave FindCode running. </p> <p> You can specify more than one starting offset, separated by spaces or returns. </p> <p> Here is the md5 checksum for the download, signed with <a href="https://www.gryphel.com/c/keys/k5.html">Gryphel Key 5</a>: </p> <blockquote> <pre> --------- GRY SIGNED TEXT --------- efba08018ae7cdd01e6e68066f3a2cf9 findcode-1.1.0.zip ------- BEGIN GRY SIGNATURE ------- Gry/4Xa8CFcUzxdN/IdOitw2A0Gu6IdLW0B7pR/2qxh/z3pM7Yi9eUbH7RRk7BPL QlryT1lAmu2mUZ7//uKz7G5YoTEzvE0Sv0T66P8RtAn8AUbWmONO78CXcxeTJRNR tz2s8Q9rUavz8MSK5klD7piqze/9T7tCQ8QvYMk33cwzrHd3h8UKMVYkJsZbz5XV -------- END GRY SIGNATURE -------- </pre> </blockquote> <p> See the <a href="../../appc/index.html">Compiling</a> page for instructions on compiling FindCode from the source code. </p> <p> You can redistribute FindCode and/or modify it under the terms of version 2 of the GNU General Public License as published by the Free Software Foundation. See the included file COPYING. </p> <p> FindCode is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the license for more details. </p> <p> : </p> <p> If you find FindCode useful, please consider <a href="https://www.gryphel.com/c/help/index.html">helping the Gryphel Project</a>, of which it is a part. </p> <a href="https://www.gryphel.com/index.html"> <img src="https://www.gryphel.com/d/gryphel-32.gif" width=32 height=32 border=0 alt="gryphel logo, 1K" > </a> <hr> <div> <i> <a href="https://www.gryphel.com/index.html">www.gryphel.com</a>/c/<a href="../../index.html">minivmac</a