Piper's Pit BBS/FTP: ibm 0010

home *** CD-ROM | disk | FTP | other *** search

/ Piper's Pit BBS/FTP: ibm 0010 - 0019 / ibm0010-0019 / ibm0010.tar / ibm0010 / MKEY30.ZIP / README.NOW < prev next >

Wrap

Text File | 1989-08-23 | 16.2 KB | 405 lines

MASTER*KEY Ver 3.0 - Copyright 1985-1989, Larry G. Grimes ALL RIGHTS RESERVED 08/23/89 SHARPE SYSTEMS CORPORATION 2320 'E' Street La Verne, CA 91750 (714) 596-0070 -------------> NOTE 1: *** NEW DATA SEPARATION INFORMATION *** MASTER*KEY's MIXED-MODE (combination of code and data, "DB's") is ONLY output AFTER the Branch Addresses have been loaded (-L from command line, or #1 from Miscellaneous Menu, #5 from Main Menu). To allow for creating the largest possible file without "Symbol not found" errors, if Branch Addresses have been loaded, MASTER*KEY will often assume some short branches (i.e. JNZ) may be data. These lines will be marked with "MASM_Syntax_Error" messages and be commented out with a DB line underneath. If these are valid branches, you may want to edit out the DB lin or remoe MASM optimization with -M on the command line. Its best to use MKDATA.EXE to patch in most of your o data areas after you have your desired source file. NOTE 2: If your computer is not completely IBM PC BIOS Compatible or Master*Key will not run on your computer, use the -Q1 argument from the command line. This possibly applys to the Tandy 2000, NEC, Wang. etc. (mk3 filespec.ext -q1), refer to the rest of the readme file and manual. You may also want to try different screen colors and video attributes. NOTE 3: Get Microsoft's (R) 'MS-DOS Encyclopedia' and Thom Hogan's 'The Programmer's PC Sourcebook' both published by Microsoft Press. MASTER*KEY Version 3.0 with MASM 5.1 with these two books are all you need to disassemble almost anything. You may also need a good book on assembly language in addition to the MASM manuals. The 'Visible Computer Assembly Language Teaching System' by Software Masters is highly recommended for novices. NOTE 4: Batch files are included to automatically process COMMAND.COM from Drive C:, and 32K and 64K BIOS from memory. (mkcmdcom.bat, mkbios32 & 64.bat). Alter these to use from a different drive, different bios size, or different bios location. NOTE 5: When disassembling an entire EXE file, make sure you use -B0 on the command line. If you don't do this the disassembly will begin at the program's entry point (CS:IP). ----------------------------------------------------------------------- MASTER*KEY Ver 3.0 COMMAND LINE: mk3 filespec [-argument -argument...] Optional Arguments: * = (new to version 3.0) -A<filespec> *APPEND to Output File Name, to be used by MASTER*KEY cross-reference, it must have the extension: .DIS. There is no interactive mode when outputting from the command line. -B<hex#> BEGINNING OFFSET. Sets the offset to start disas- sembling, rather than the default 100h for .COM and the (code segment *16) + instruction pointer for .EXE files. Can be up to 5 hexadecimal digits. -CC Output ALL CODE (similar to MS-DOS debug). -CD Output ALL DATA. -CI Output EXCEPTIONS ONLY (funcs, int's, sgmt chgs). -CB Output BRANCH LABELS Only. -CR Output DATA REFERENCES Only. -CO Output DATA ONLY (just the DB's in the file). -E<hex#> ENDING OFFSET. Sets the offset to stop disas- sembling, rather than the default end of file. Can be up to 5 hexadecimal digits. -H<hex#> CODE ORIGIN or PSP HEADER SIZE. Changes the default PSP size of 100h for non-EXE files such as device drivers, code fragments, and programs loaded at static locations. You may use DEBUG to break a large file into several smaller files and use the code origin of each file to maintain correct addressing. -L *LOAD BRANCH ADDRESS Array. It is a good idea to use this flag if you need to reference all of the branch locations, since it takes some time to accomplish. Three different passes are made through the file to remove most of the "Symbol not found" errors. Most of the remaining errors are probably in data areas. Either edit the file or patch in a block of data created by MKDATA. -M *Turn OFF MASM Optimizations & Syntax Errors (DB's). MASM will optimize some of the code and some opcodes have several hex values. Not using this argument will make the reassembled file exactly as the original. -O<string> OUTPUT FILE Name, to be used by the MASTER*KEY cross- reference, it must have the extension: .DIS. There is no interactive mode when outputting from the command line. -P *PRINTER OUTPUT from Command Line. An extra carriage return is output to be compatible with most printers. If your printed output is double spaced, use -P1; -P1 *PRINTER OUTPUT without extra CARRIAGE RETURN. -Q<0-2> VIDEO BIOS selection (for Non-IBM Compatibles): 0 = Write Screen Display directly to Video memory. Default & fastest. If your computer is not completely IBM video-graphics BIOS compatible, you may need to use Q1 or Q2. 1 = Do not use Video BIOS (extremely slow). Screen output is completely software emulated. 2 = Use Video BIOS, but remove snow (somewhat slower). The screen refresh is slowed down. -T<0-9> Change Tab Spacing on output to file or printer. The default value is 8. Tab Characters are used to fill large blank areas on the listings and keep file sizes to a minimum. If your printer does not recognize tabs, the output will not be aligned properly. Also, your editor may have different spacing for tabs (C programmers tend to use 3 or 4). The default value is 8. An entry of -T or -T0 will disable tab characters completely. You may have to disable tabs with some non-IBM compatible printers. -V If your computer doesn't seem to be Video Display compatible with MASTER*KEY, -V with no arguments will attempt to interpret the given display colors and attributes. If the result isn't satisfactory, use VA or VC. These arguments are for true IBM- compatibility (you may need to experiment with different combinations to achieve the desired display colors and attributes, also refer to your technical reference manual): MASTER*KEY IBM-PC Video Display Colors: Color Hex Value Black 0h Blue 1h Green 2h Cyan 3h Red 4h Magenta 5h Yellow 6h White 7h MASTER*KEY IBM-PC Video Display Attributes Color Display: Attribute Hex Value Binary Mask Normal 0h 0000b Reverse 1h 0001b Bright 2h 0010b Reverse Bright 3h 0011b Blink 4h 0100b Reverse Blink 5h 0101b Bright Blink 6h 0110b Reverse Bright Blink 7h 0111b Monochrome Display: Attribute Hex Value Binary Mask Normal 0h 0000b Reverse 1h 0001b Bright 2h 0010b Blink 4h 0100b Reverse Blink 5h 0101b Bright Blink 6h 0110b Reverse Bright Blink 7h 0111b Underline 8h 1000b Underline Bright Ah 1010b Underline Blink Ch 1100b Underline Bright Blink Eh 1110b -VA<2hex#'s> Two hex digits for Display Attributes: 1-normal and 2-alternate (default: high-intensity). -VC<4#'s> Four hex digits for Display & Border colors: 1-foreground (text), 2-background, 3-alternate foreground (enhanced), and 4-border. ----------------------------------------------------------------------- MASTER*KEY'S Version 3.0 BINARY COMPARISON PROGRAM MKCOMP will compare any two files binarily. This will help you create a file exactly as the original. EXE headers are ignored, so you can compare a COM file with an EXE file without having to use EXE2BIN. You can determine branch location changes by single differences. You know when there is a difference in the files when every location is different. Edit your source disassembly file with DB's to fix all of the differences before trying to change the file. *** CAUTION! *** Since EXE headers are ignored, DO NOT run a newly created EXE program until the CODE SEGMENT and STACK SEGMENT is correct in the header. Use MKHEADER and Microsoft's (R) EXEMOD programs. COMMAND LINE: mkcomp filespec1 filespec2 [-argument] [>out_filespec] Filespec1 is the original file. Filespec2 is the correctly reassembled file. Out_filespec will save the output into a file. Optional Argument: -H<hex#> CODE ORIGIN or PSP HEADER SIZE. Changes the default PSP size of 100h for non-EXE files such as device drivers, code fragments, and programs loaded at static locations. You may use DEBUG to break a large file into several smaller files and use the code origin of each file to maintain correct addressing. (Same as MK3.EXE). ----------------------------------------------------------------------- MASTER*KEY'S Version 3.0 DATA EXTRACTION PROGRAM MKDATA will create assembly language compatible code in data form from any file. MKHEADER's list of relo- catable items will help you find data segments in EXE programs. These large areas of data should be created using MKDATA instead of MK3. The -X argument will filter out most of the data so you will have a place to begin looking for data. COMMAND LINE: mkdata filespec [-argument -argument...] Optional Arguments: -A<filespec> APPEND to Output File Name, to be used by MASTER*KEY cross-reference, it must have the extension: .DIS. There is no interactive mode when outputting from the command line. (Same as MK3). -B<hex#> BEGINNING OFFSET. Sets the offset to start disas- sembling, rather than the default 100h for .COM and the (code segment *16) + instruction pointer for .EXE files. Can be up to 5 hexadecimal digits. (Same as MK3). -D Turn DUPS() output OFF. This will turn DUPS() psuedops into DW's for data labeling. -E<hex#> ENDING OFFSET. Sets the offset to stop disas- sembling, rather than the default end of file. Can be up to 5 hexadecimal digits. (Include PSP header size). (Same as MK3). -H<hex#> CODE ORIGIN or PSP HEADER SIZE. Changes the default PSP size of 100h for non-EXE files such as device drivers, code fragments, and programs loaded at static locations. You may use DEBUG to break a large file into several smaller files and use the code origin of each file to maintain correct addressing. This argument can help keep code with labels the same as DEBUG. (Same as MK3). -O<filespec> Output File (file must not exist). -T<0-9> Change Tab Spacing on output to File. -W1 OUTPUT code in ALL DB's. -W2 OUTPUT code in ALL DW's on EVEN Word Boundary. This is the default. Most data words are on an even word boundary beginning with 0; -W3 OUTPUT code in ALL DW's on ODD Word Boundary. -W4 OUTPUT code as data with NO DW's. -X Output DATA ONLY (ignore most code areas). This is a filter to find the approximate areas of data. ----------------------------------------------------------------------- MASTER*KEY'S Version 3.0 EXE HEADER PROGRAM MKHEADER will display EXE header information including relocatable items. The relocatable items are locations in the EXE file where the address of the end of the PSP is added for multiple segments. These locations will help you determine different segment areas for separate disassembly, both code and data. Use Microsoft's (R) EXEMOD program to change EXE headers. COMMAND LINE: mkheader filespec[.EXE] [-argument] [>out_filespec] Optional Argument: -X DO NOT Print Relocation Addresses. Sometimes a large program will have several hundred items. ----------------------------------------------------------------------- MASTER*KEY'S Version 3.0 CROSS-REFERENCE PROGRAM MKXREF will organize MK3 source files into a sequential reference for branch labels, data locations, MASM syntax errors, functions, interrupts, and potential trouble spots. If you run out of memory, output different -C options from MK3 and create an .XRF file for each, or use your text editor or word processor to break a large file into individual segment files. The author uses and recommends Solution Systems 'BRIEF'. COMMAND LINE: mkxref filespec[.DIS] (creates a filespec.xrf file).