coll. - Sourcer Commenting Disassembler

This book was produced in EPUB format by the Internet Archive.

The book pages were scanned and converted to EPUB format automatically. This process relies on optical character recognition, and is somewhat susceptible to errors. The book may not offer the correct reading sequence, and there may be weird characters, non-words, and incorrect guesses at structure. Some page numbers and headers or footers may remain from the scanned page. The process which identifies images might have found stray marks on the page which are not actually images from the book. The hidden page numbering which may be available to your ereader corresponds to the numbered pages in the print edition, but is not an exact match; page numbers will increment at the same rate as the corresponding print edition, but we may have started numbering before the print book's visible page numbers. The Internet Archive is working to improve the scanning process and resulting books, but in the meantime, we hope that this book will be useful to you.

The Internet Archive was founded in 1996 to build an Internet library and to promote universal access to all knowledge. The Archive's purposes include offering permanent access for researchers, historians, scholars, people with disabilities, and the general public to historical collections that exist in digital format. The Internet Archive includes texts, audio, moving images, and software as well as archived web pages, and provides specialized services for information access for the blind and other persons with disabilities.

Created with abbyy2epub (v.1.7.2)

'

V COMMUNICATIONS

COPYRIGHT NOTICE

Both the Sourcer program and the manual are proprietary copyrighted material, and no part of either may be reproduced, transmitted, stored or translated into any other computer or foreign language without the express prior written permission of V Communications, Inc.

TRADEMARKS

Sourcer, Unpacker, BIOS Pre-Processor, InView, and ASMtool are trademarks of V Communications, Inc.

Turbo Assembler is a registered trademark of Borland, International.

IBM is a registered trademark and PS/2, AT, XT, PC are trademarks of IBM Corporation Intel is a trademark of Intel Corporation.

Microsoft and MS-DOS are trademarks of Microsoft Corporation OPTASM is a trademark of SLR Systems.

Brief is a trademark of UnderWare, Inc.

Multi-Edit is a trademark of American Cybernetics, Inc.

PC-Write is a trademark of Quicksoft.

NOTICE

The information in this document is subject to change without notice. V Communications assumes no

responsibility for any errors that may appear in supplied materials or

programs.

EDITION September 1989

Copyright (c) 1988,1989 by V Communications, Inc. All rights reserved Part Number S0989-164 Printed in the United States

PUBLISHED BY V COMMUNICATIONS, INC. 3031 Tisch Way, Suite 802 San Jose, CA 95128 (408) 296-4224

ACKNOWLEDGEMENTS

Product Development: Geoff Caras, Frank Van Gilluwe

Sourcer was written entirely in assembly language. Documentation: Lisa Caras

Sourcer is both very powerful and straightforward to use. Depending on the complexity of the task you have at hand, you may need very little information about Sourcer to get started using it. The information program on the Sourcer distribution disk contains all the information you need to install and get started using Sourcer.

To run this program, insert the Sourcer distribution diskette into your diskette drive, change to that drive, and enter readme. Then select any of the options in the menu. For example, enter 1 for a quick introduction to Sourcer.

Before you continue, use the information program to install Sourcer on your hard disk or to copy it to a backup diskette. Enter 2 from the main menu and then follow the instructions the program presents.

When you need more information, turn to this manual. It contains a more detailed description of Sourcer basics and complete instructions for using more advanced features.

Sourcer User Manual iii

Chapter 1: Using Sourcer.1

Installing Sourcer.1

Starting Sourcer.2

Loading an Input File.3

Processing a File.3

Quitting Sourcer.5

An Example.5

Chapter 2: Reading a Sourcer Listing.7

Equates.8

Prefixes.9

Cross-references.10

Indexed Jumps and Calls.11

Chapter 3: Customizing Sourcer Operation....13

Setting the Code Style.13

Fragment Code Style.14

COM Code Style.14

EXE Code Style.14

Zero Start Code Style.14

Device Driver Code Style.15

Overlay Code Style.15

Setting the Number of Passes.15

Setting the Microprocessor Filter.15

Setting Analysis Options.17

Options A through C: Inaccessible Code Areas ....17

Options D and E: DS and ES Values.19

Option F: Terminated Subroutines.20

Options G and H: Indexed Data Handling.21

Option I: Graphics Characters.22

Option J: Interrupt Vector Entry Points.22

Option K: Absolute Location References.23

Option L: RETF and RETN Instructions.23

Option M: MASM 4.0 Compatibility.24

Sourcer User Manual v

Table of Contents

Option N: ASSUME Statements.24

Option O: Indexed Jumps and Calls.25

Option P: Index Register.26

Options Q through T: Cross-references.27

Option U: Indexed Data Values.28

Option V: Near Jump Fixup.28

Option W: Warning Comments.28

Option X: Final Pass References.29

Command Line Options.30

Setting Output Options.31

Output Formatting Commands.31

Analysis Options for Output.31

Definition File Output Options.31

Writing the Output File to a Printer.32

Chapter 4: Using Definition Files.33

Definition File Structure.33

Using Definition Files Generated by Sourcer.35

Using the Template Definition Files.35

Loading a Definition File.35

Specifying Control Information in Section One.36

Control Options.36

Control Information Example.42

Specifying Range Definitions in Section Two.42

Segment Variables.43

Range Definition Entries.43

Range Definition Example.45

Specifying Reference Definitions in Section Three ... 46

Reference Definition Entries.47

Reference Definition Examples.52

Chapter 5: Setting System Defaults.59

Chapter 6 Adding Comments to the

Output File.61

Using a Definition File to Add Comments.62

Using a Remarks File to Add Comments.62

Data Remarks Section.63

The Location Remarks Section.63

Subroutine Remarks Section.64

Remarks File Notes.65

vi Sourcer User Manual

Chapter 7: Reassembling Generated

Source Code.67

Generating Code for Assembler Compatibility..67

Microsoft Macro Assembler (MASM)

version 4.0 or earlier.68

Microsoft Macro Assembler (MASM)

versions 4.5 and later.68

Turbo Assembler (TASM).69

OPTASM versions 1.0 and 1.5.69

A86 version 3.0 and later versions.69

Reassembly Checklist.69

Indexed Jumps and Calls.70

Register Jumps and Calls.70

Immediate Fields within an Instruction.71

Incorrect Code or Data Determination.72

External Entry Points.74

Reassembly Errors.74

Block Nesting Errors.75

Syntax Error (RETN/RETF).75

Phase Errors Between Passes.75

Illegal Size for Operand Error.76

Changing Generated Source Code.77

Patching Programs.78