Extended Discipline Users Manual Draft 3

ti* Macintosh"' Extended Discipline Users Manual Working Draft 3 12May1988 Rob Dearborn ( Table of Contents 1. lnttcxluction •.••.........•..•.•.••..•................•.......•••.......•...•...•••.............•. 1 Extended Discipline ..................•..........•••..•.•........•.....................•.•. 2 This Dc:x:ument ...•.•..•.•...........•...••.••.••.•....••.•......•...••..•....•.•.•........ 2 2. Becoming Disciplined .....•.•.....•......•.........•.......•.•..•..••••••.....•...•............ 3 Installation •.••••.••.•..•.•..•..••..••••..•....••••••..••.•.••.••••.••.••.•.•.•••••.•..••••.4 How It Works ........................................•................•...................4 Par81lleter Pass~g ................................ ~ .................•............4 3. Applying Extended Discipline .................................................................6 Tlmling It On ..............................................................................7 The Desk Acce.ssory ....•..........•..............•....•...................•..•.....••....7 The Extended Discipline Menu ..........................................................9 Revert to Saved Configuration .................................................9 Save Configuration ..•.....•..............•..•......•..•....•...•................9 Show Traps/Parameter Types .................................................. 1O Show Calling Application On Enor ........................................... 10 ROM Result Code Checking ................................................... 10 Q.D.t ••••••••••••••••••.••••••••••••••••••••••••••••••••••••.••••••••••••••••••.••.•• 10 4. Extended Discipline Reports .•..........•.....•.......•....•....••.....•..•....••••.•......... 11 Error Messages ............................................................................ 12 Stack-based Paraineter EITors .................................................. 12 Register-based Paran:ieter Enors ............................................... 12 Tra.shed. Register ...........•...................••....•..............••........... 13 En-OJ" Return fto.m Trap .................•..•••.•.•..•.•......•... ~ •...•......... 13 Warnings ................................................................................... 13 Appendix ..............................................................................•............. 15 Index ................................................................................................ 17 Discipline Users Manual c. Chapter 1 Introduction 1 Discipline Users Manual Working Draft 3 Extended Discipline Extended Discipline™ is a programming utility that allows the user to monitor the parameters passed to Macintosh Toolbox and Operating System routines. Upon encountering a Toolbox call with an invalid or inappropriate parameter, Discipline calls on Macsbug (or any Discipline-friendly debugger) to display information about the intercepted call. Aside from the memory it uses, D…