METEOR DISSASSEMBLER DOCUMENTS ËENNETH ËAHL ÍARCH 25, 1988 ÍETEOR DISSASSEMBLER IS A PROGRAM WHICH É WROTE FOR MY OWN USE WHICH É HAVE DECIDED TO RELEASE ON A SHAREWARE BASIS. ÁS FAR AS É KNOW THERE ARE NO OTHER TWO PASS SYMBOLIC DISSASSEMBLERS AVAILABLE FOR THE C128 ON A COMMERCIAL (OR ANY OTHER) BASIS. ÓOME OF THE FEATURES OF THIS PROGRAM INCLUDE: ÄISSASSEMBLES MACHINE LANGUAGE PROGRAMS FROM ANY BANK OR FROM DISK FILE (UP TO 40K BYTES LONG). ÓENDS ASSEMBLY LANGUAGE SOURCE TRANSLATION TO SCREEN, PRINTER, OR WRITES ÐÁÌ/SYMASS COMPATABLE SOURCE DIRECTLY TO DISK. ÁSSIGNS PSUEDO LABELS TO ALL INTERNAL REFERENCES. ÁLLOWS USER INPUT OF ADDITIONAL LABELS AND AUTOMATIC DEFINITION OF ALL KERNAL CALLS. ÅASY FLAGGING OF PROGRAM TABLE AREAS TO BE DUMPED AS 'BYTE' TABLES. Á LIMITED ABILITY TO RECOGNIZE IMBEDDED TEXT STRINGS. ÄETECTS AND FLAGS ALL POSSIBLE PHASE ERRORS. ÁLL OPTIONS IN THIS PROGRAM ARE MENU SELECTED AND ARE PRETTY MUCH SELF EXPLAINATORY. ÔHERE ARE SOME POSSIBLE PROBLEMS THAT YOU SHOULD BE AWARE OF HOWEVER: 1 ÌABELS WILL BE ASSIGNED TO ALL BRANCH INSTRUCTIONS. ÔHIS COULD LEAD TO PROBLEMS IF THE BRANCH IS TO AN AREA OUTSIDE OF THE AREA BEING DISS- ASSEMBLE. ÔRY TO DISSASSEMBLE ONLY SELF CONTAINED PRO#RAMS OR SUBROUTINES TO AVOID THIS. 2 ÎO LABEL WILL BE GENERATED FOR MASKED INSTRUCTIONS (EG BIT $00A9 WHICH MASKS A LDA #$00 INSTRUCTION). ÉN THE EXAMPLE ANY BRANCH OR JUMP TO THE LDA #$00 WOULD NOT HAVE A CORRESPENDING DESTINATION LABEL. 3 ÁLL USER ASSIGNED LABELS ARE DEFINED AT THE START OF THE ASSEMBLY LISTING FOR REFERENCE. ÔHIS CAN LEAD TO REASSIGNED LABEL ERRORS ON ASSEMBLY. ÙOU MAY HAVE TO DELETE SOME OF DIRECT LABEL ASSIGNEMENTS IF THE LABELS ARE FOR AN AREA WITHIN THE PROGRAM. 4 ÔRY TO AVOID LABELS WHICH CONTAIN IMBEDED BASIC COMMANDS. ÔHESE CAN CAUSE PROBLEMS WHEN YOU START TO EDIT A LISTING SINCE THEY GET CRUNCHED. ÔHIS CAN LEAD TO DIFFERENT LABELS WHICH LIST THE SAME. ÙOU SHOULD BE AWARE THAT SOME OF THE KERNAL NAMES CAN CAUSE PROBLEMS IN THIS REGARD, AND SOME HEXADECIMAL NUMBERS CONTAIN THE 'DEF' (DEFINE FUNCTION) COMMAND. ÍNEMONICS WHICH CONTAIN BASIC COMMANDS (EOR,AND,ETC.) ARE WRITTEN TO THE DISK SOURCE FILE AS THEIR CRUNCHED FORMS. 5 É HAVE REMOVED THE SPACES FROM SOME OF THE KERNAL NAMES. ÏTHERWISE THEY ARE STANDARD ÃOMMODORE NAMES. 6 ÕNIMPLEMENTED OR 'CODA OBSCURA' OPCODES ARE NOT DISSASSEMBLED BUT APPEAR AS 'BYTE' ASSIGNMENTS. 7 ÕSER ASSIGNED LABELS MAY BE ASSIGNED TO ANY AREA OF MEMORY WITH THE EXCEPTION OF THE ZERO PAGE. 8 ÁLTHOUGH THIS PROGRAM PRODUCES ÐÁÌ/SYMASS COMPATIBLE SOURCE, IT COULD PROBABLY BE MODIFIED FOR ANY OTHER ASSEMBLER WHICH USES THE BASIC EDITOR. ÁS A FINAL NOTE YOU WILL NOTICE THAT É AM RELEASING THIS AS A BASIC PROGRAM AND NOT A COMPILED VERSION AS IS THE CASE WITH MOST OTHER SHAREWARE PROGRAMS. ÉN EFFECT É AM GIVING OUT THE SOURCE CODE. É BELIEVE THAT THIS GREATLY INCREASES THE USEFULLNESS OF THE PROGRAM AND WILL (É HOPE) INCREASE MY REVENUES FROM IT. ÔIME WILL TELL IF THIS EXPERIMENT IS A SUCCESS OR IF É AM (AS SOME HAVE TOLD ME) A FOOL. É HAVE BEEN CALLED WORSE NAMES FOR BETTER REASONS. ÙOURS, ËENNETH Å. ËAHL 73027,454
Amiga7878