Macsbug 6.1 Reference

('', 9. Macintosh~ MacsBug 6.1 Reference ti APPLE COMPUTER, INC. This manual and the software described in iI are c0pyrighted, with all rights reserved. Under the copyright laws, this manual or the software may not be copied, in whole or part, without written consent of Apple, except in the normal use of the software or to make a backup copy of the software. The same proprietary and copyright notices must be aff'ixed to any permitted copies as were aff'ixed to the original. This exception does not allow copies to be made far others, whether or not sold, but all cf the material purchased (with all backup copies) may be sold, given, or loaned to another person. Under the law, copying includes uamlating into another language or fonnat. You may use the software oo any computer owned by you, but extra copies cannot be made for this purpose. © Apple Computer, Inc., 1989 20525 Mariani Avenue Cupertino, CA 95014 (408) 996-1010 Apple, the Apple logo, HyperCard, ImageWriier, LiserWriier, and Macintosh are registered trademarks of Apple Computer, Inc. Apple Desktop Bus, .Extended Discipline, Finder, MPW, MultiFinder, RAMDump, ResEdit and SADE are trademarks of Apple Computer, Inc. ITC Garamond and ITC 1.apf Dingbats are registered trademarks of International Typeface Corporation. Microsoft is a registered trademark of Microsoft Corporation. PostScript is a registered trademark of Adobe Systems Incorporated. Simultaneously published in the United States and Canida. Contents Preface About ThJs Manual vii Overview ix Notation conventions x Aids to understanding x 1 MacsBug Overview 1 About MacsBug 3 Macintosh debugging 3 .MacsBug fifes 5 2 Debugging With MacsBug 7 Getting started 9 · Specifying things 12 How did I get here? 13 Controlling· program execution 14 Stopping at a particular place 15 Watching for memory to change 16 Displaying and setting memory 16 Checking the heap 17 Exertising your program 17 The dot address 17 MacsBug resources 19 Figure 2-1 MacsBug display 10 ill 3 MacsBug Commands 21 Command syntax 23 Values 23 Operators 24 Command descriptions 25 ATB-A Trap Break 26 ATC-A Trap Clear 27 ATD-A Trap Display 28 ATIIC-A Trap Heap Check 29 ATP-A Trap Playback 30 ATR-A Trap Record 31 ATSS-A Trap Step Spy 32 ATI-A Trap Trace 33 BR-Breakpoint 34 BRC-Breakpoint Clear 36 BRO-Breakpoint Display 37 BRM-Multiple Breakpoints 38 CS-Checksum 39 DB-Display Byte 40 DH-Disassemble Hexadecimal 41 DL-Display Long 42 OM-Display Memory 43 DP-Display Page 44 DSC-Extended Discipline 45 DY-Display Version 46 OW-Display Word 47 DX-Debugger Exchange 48 EA-Exit to Application 49 • ES-Exit to Shell 50 F-Find 51 G-Go 52 GT-Go Till 53 HC-Heap Check 54 HD-Heap Display 55 HELP-Help 57 HOW-Display Break Message 58 HS-Heap Scramble 59 HT-Heap Tota~ 60 HX-Heap Exchange 61 iv MacsBug 6.1 Reference HZ-Heap Zones 62 ID-Disassemble One tine 63 IL-Disassemble From Address 64 IP-Disassemble Around Addres.5 65 IR-Disassemble Until End of Procedure 66 LOG-Ing to a prin…