SAS/C Development System User's Guide, Volume 2: Debugger, Utilities, Assembler, Version 6

416 Pages·1993·6.6 MB·English

SASIC Development
System User’s Guide,
Volume Debugger,
2:
Assembler
Utilities,
Version 6.50
BB//I//SBm® SSAASS CInasmtiptuutseDIrnic.ve
Cary, NC 27513
The correct bibliographic citation for this manual is as follows: SAS Institute Inc.,
SAS/C Development System User’s Guide, Volume 2: Debugger, Utilities,
Assembler, Version 6.50, Cary, NC: SAS Institute Inc., 1993. 389 pp.
SAS/C'Development System User’s Guide, Volume 2: Debugger, Utilities,
Assembler, Version 6.50
Copyright © 1993 by SAS Institute Inc., Cary, NC, USA.
ISBN 1-55544-584-5
All rights reserved. Printed in the United States of America. No part of this
publication may be reproduced, stored in a retrieval system, or transmitted, in
any form or by any means, electronic, mechanical, photocopying, or otherwise,
without the prior written permission ofthe publisher, SAS Institute Inc.
1st printing, October 1993
The SAS® System is an integrated system of software providing complete control
over data access, management, analysis, and presentation. Base SAS software is
the foundation of the SAS System. Products withinthe SAS System include
SAS/ACCESS? SAS/AF? SAS/ASSIST? SAS/CALC? SAS/CONNECT? SAS/CPE?
SAS/DMI? SAS/EIS? SAS/ENGLISH? SAS/ETS? SAS/FSP? SAS/GRAPH?
SAS/IML? SAS/IMS-DL/I? SAS/INSIGHT? SAS/LAB? SAS/OR? SAS/PH-Clinical?
SAS/QC? SAS/REPLAY-CICS? SAS/SHARE? SAS/STAT? SAS/TOOLKIT?
SAS/TUTOR? SAS/DB2'," SAS/GIS? SAS/IMAGE? SAS/NVISION? SAS/SESSION?
and SAS/SQL-DS" software. Other SAS Institute products are SYSTEM 2000®
Data Management Software, with basic SYSTEM 2000, CREATE? Multi-User,"
QueX? Screen Writer, and CICS interface software; NeoVisuals® software; JMP?
"
JMP IN? JMP Serve? and JMP Design® software; SAS/RTERM* software; and the
SAS/C® Compiler and the SAS/CX® Compiler; and Emulus" software. MultiVendor
Architecture’" and MVA" are trademarks of SAS Institute Inc. SAS Video
Productions” and the SVP logo are service marks of SAS Institute Inc. SAS
Institute also offers SAS Consulting? Ambassador Select? and On-Site
Ambassador” services. Authorline? Observations? SAS Communications? SAS
Training? SAS Views? the SASware Ballot? and JMPer Cable" are published by SAS
Institute Inc. All trademarks above are registered trademarks or trademarks of
SAS Institute Inc. in the USA and other countries. ® indicates USA registration.
The Institute is a private company devoted to the support and further
development of its software and related services.
Amiga Includes and Development Tools Version 3.0
Copyright © 1985-1992 Commodore-Amiga, Inc. All Rights Reserved.
Distributed under license from Commodore.
Amiga Workbench” Version 2.0
Copyright © 1988, 1990 Commodore-Amiga, Inc. All Rights Reserved.
Installer
Copyright © 1991-1993 Commodore-Amiga, Inc. All Rights Reserved.
AmigaGuide” and WDisplay
Copyright © 1991-1993 Commodore-Amiga, Inc. All Rights Reserved.
Distributed under license from Commodore.
Enforcer and Mungwall
Copyright © 1990-1993 Commodore-Amiga, Inc.
Distributed with permission from Commodore.
Amiga? AmigaDOS'," AmigaGuide'," Intuition? and WorkBench" are registered
trademarks or trademarks of Commodore-Amiga, Inc. Commodore® is a registered
trademark or trademark of Commodore Electronics Limited.
Other brand and product names are registered trademarks or trademarks oftheir
respective companies.
Doc S17, Ver214.4, 091593
Contents
vii Reference Aids
ix Credits
xi Acknowledgments
xiii Using This Book
xxi Changes and Enhancements
Part 1 Using the SAS/C Debugger
Page 3 Chapter 1 Getting Started
3 Introduction
4 Overview of CodeProbe
5 Debugging a Program
5 Compiling and Linking Your Program
9 Running CodeProbe
13 Using the Windowing Interface
17 Getting Help
18 Entering Commands
36 Ending Your Program and Quitting the Debugger
36 How CodeProbe Works
39 Chapter 2 Customizing the Debugging Environment
39 Introduction
39 Setting the Source File Location
41 Using Command Files
42 Displaying and Setting Options within CodeProbe
43 Using Aliases (alias and unalias)
46 Using Macros (define and undefine)
49 Chapter 3 Debugging C Programs
49 Introduction
49 Running The Example
50 Debugging The Example
67 Chapter 4 Debugging C++ Programs
67 Introduction
67 Running The Example
69 Debugging The Program
73
73 Chapter 5 Debugging Shared Libraries
Introduction
7735 Setting Breakpoints
74 Loading Debug Information (symload)
74 Displaying the List of Loaded Libraries (libraries.cpr)
75 Tracing Into A Shared Library
Debugging UserLiblnit and UserLibCleanup
75 Example
79 Chapter 6 Debugging Multitasking Programs
79 Introduction
80 How CodeProbe Handles Tasks
80 Redefining Exception and Trap Handlers
81 Commands for Debugging Multitasking Programs
82 Example: Debugging a Child Process
83 Example: Finding Enforcer Hits In Child Processes
8959 Example: Catching Tasks That Are Already Running
88 Example: Debugging Devices
93 Chapter 7 Using AREXX Macros with CodeProbe
93 Introduction
93 Macros Provided with CodeProbe
95 Invoking Macros
96 Using Debugger Command Return Codes in Macros
96 Using Debugger Command Output in Macros
97 Using Macros from Outside of CodeProbe
99 Chapter 8 Using the Cross Debugger
Introduction
99 Why Debug in Cross-Debugging Mode?
100 Preparing to Use Cross-Debugging Mode
101 Using Cross-Debugging Mode
104 Example: Using the Serial Port
104 Example: Using Named Pipes
105 Chapter 9 Command and Built-in Function Reference
105 Introduction
105 Summary of CodeProbe Commands
109 Command Reference
195 Using CodeProbe’s Built-in Functions
196 Summary of Built-in Functions
196 Built-in Function Reference
Part 2 Using the SAS/C Utilities
c
Contents
207 Chapter 10 Utility Reference
Part 3 Using the SAS/C Macro Assembler
307 Chapter 11 Using Assembly Language with C Language
307 Introduction
308 Writing Assembly Language Functions
322 Communicating between Assembly Language and C Language
332 Running the Assembler
Part 4 Using the SAS/C Optimizers
339 Chapter 12 Optimizing Your Code
339 Introduction
339 The Global Optimizer
345 The Peephole Optimizer
335435 The Scheduler
346 Running the Optimizers
Part 5 Appendices
351 Appendix 1 diff File-Matching Algorithm
353 Appendix 2 Source Code for Debugger Examples
Introduction
353 smain.c
354 sort.c
355 swap.c
355 chessl.cxx
358 mylib.c
359 mylib.fd
359 test.c (for shared libraries)
360 process.c
362 test.c (for child processes)
364 loop.c
364 dummy.
364 serial.c
369 driver.c
371 Glossary of Debugger Terms
373 Index
VI
Vll
Reference Aids
Displays
14 1.1 Initial CodeProbe Window
14 1.2 Five Different CodeProbe Windows
18 1.3 CodeProbe Help Window
51 3.1 CodeProbe Windows Showing the sort Program
54 3.2 Dialog Window In Zoom Mode
55 3.3 Source and Dialog Windows Showing Initialized Array
56 3.4 Source Window Showing init
60 3.5 Help Window for dump Command
62 3.6 Memory Window Showing Array Contents
63 3.7 Memory Window Showing Changed Values
64 3.8 Source Window Showing swap.c
68 4.1 Initial Results of chess
72 4.2 Final Results of chess
Figures
272 10.1 Example File Dependencies
325 11.1 The Stack after the func Module Is Called
Tables
20 1.1 Command Line Editing Functions
20 1.2 Pull-down Menu Items
24 1.3 Function and Special Keys
25 1.4 Menu Accelerator Keys
32 1.5 Escape Sequences in Character Strings and Character Constants
35 1.6 Escape Sequences in Other Command Parameters
viii
IX
Credits
Software
The SAS/C Development System is designed, built, and tested through
the combined effort of many people at SAS Institute. The AmigaDOS
development group includes the following individuals:
Principal Harold L. Clapper, Steve Krueger, Douglas Walker
Developers
Testing and Twilah K. Blevins, Jim Cooper, Steve Evans,
Technical Khristi Tomlinson
Support
These individuals continue to support future development of the
SAS/C Development System. Others who have contributed to the
SAS/C Development System are as follows:
Development Edmund Burnette, Dave Frederick, Russell
Gonsalves, Tony Hefner, Joseph E. Hutchinson,
Glenn Musial, John Roth
Testing and Alan R. Beale, John W. Gillikin, Charles Tudor
Technical
Support
Documentation
Design, Design, Production, and Printing Services
Production, and
Printing
Proofreading Patsy P. Blessis, Heather B. Dees, Karen A.
Olander, Josephine P. Pope, Susan E. Willard
Technical Review Harold L. Clapper, Jim Cooper, Steve Krueger,
Khristi Tomlinson, Douglas Walker
Writing and Jeanne Ferneyhough, Steve Krueger, N. Elizabeth
Editing Malcom, Khristi Tomlinson, Douglas Walker