HP 68000 Series User manual

User’s Guide
HP B1466
68000 Series
Debugger/Simulator

Notice
Hewlett-Packard makes no warranty of any kind with regard to this material,
including, but not limited to, the implied warranties of merchantabilityand
fitness for a particular purpose. Hewlett-Packard shall not be liable for errors
contained herein or for incidental or consequential damages in connection
with the furnishing,performance, or use ofthis material.
Hewlett-Packard assumes no responsibility for the use or reliabilityof its
software on equipment that is not furnished byHewlett-Packard.
© Copyright 1989-1992, 1995, Hewlett-Packard Company.
This document contains proprietaryinformation, which is protected by
copyright. All rights are reserved. No part ofthis document maybe
photocopied,reproduced or translated to another language without the prior
written consent of Hewlett-Packard Company. The information contained in
this document issubject to change without notice.
HP-UX 9.* and 10.0 for HP 9000 Series 700 and 800 computers are X/Open
CompanyUNIX 93 branded products.
UNIX® is a registered trademark in the United States and other countries,
licensed exclusivelythrough X/Open CompanyLimited.
Hewlett-Packard Company
P.O . Box 2197
1900 Garden of the Gods Road
Colorado Springs, CO 80901-2197, U.S.A.
RESTRICTED RIGHTS LEGEND Use,duplication, or disclosure bythe U.S.
Government is subject to restrictionsset forth in subparagraph (C) (1) (ii) of
the Rights in Technical Data and Computer Software Clause in DFARS
252.227-7013. Hewlett-Packard Company, 3000 Hanover Street, Palo Alto,
CA 94304 U.S.A.
Rights for non-DOD U.S. Government Departments and Agencies are set
forth in FAR 52.227-19(c)(1,2).
ii

About this edition
Manyproduct updates and fixes do not require manual changes, and manual
correctionsmaybe done without accompanying product changes. Therefore,
do not expect a one-to-one correspondence between product updates and
manual revisions.
Edition dates and the corresponding HP manual part numbers are as follows:
Edition 1 B1466-97003, November 1992
Edition 2 B1466-97004, July 1995
B1466-97003 incorporatesinformation which previouslyappeared in
B1466-92000, B1466-92001, B1466-97000, B1466-97001, B1466-97002,
64360-92003, 64360-97011, 64360-97008, and 64360-97009.
Certification and Warranty
Certification and warrantyinformation can be found at the end ofthismanual
on the pagesbefore the back cover.
iii

Debugging C Programs for
6800x/010/020/3xx Microprocessors
The HP B1466 68000 Series Debugger/Simulator is a debugging tool for
6800x/010/020/3xx microprocessor code. The debugger loads and executes C
programs or assemblylanguage programsusinga simulator on your host
system.
With the Debugger, You Can ...
•Browse and edit C and C+ + source files.
•ViewC and C+ + functions on the stack.
•Monitor variables as the program executes.
•Viewassemblylanguage code with source lines.
•Viewregisters and stack contents.
•Step through programsbyC or C+ + source linesor byassemblylanguage
instructions.
•Stop programs upon the execution of selected instructionsor upon a read
or write ofselected memorylocations.
•Create conditional breakpoints usingmacros.
•Patch C or C+ + code without recompiling.
•Simulate input and output devices using your computer’s keyboard,
display, and file system.
•Tune code byusing the clock cycle count pseudo register to time code
modules during simulation.
•Save and execute command files.
•Log debugger commands and output.
•Examine the inheritance relationships ofC+ + classes.
With the Graphical Interface You Can ...
•Use the debugger under an X WindowSystem that supports OSF/Motif
interfaces.
•Enter debugger commands using pull-down or pop-up menus.
•Set source-level breakpoints using the mouse.
iv

•Create custom action keys for commonlyused debugger commands or
command files.
•Viewsource code,monitored data,registers,stack contents, and backtrace
information in separate windows on the debugger’smain display.
•Access on-line help information.
•Quicklyenter commands using the guided syntaxof the standard interface.
With the Standard Interface You Can ...
•Use the debugger with a terminal or terminal emulator.
•Quicklyenter commands using guided syntax, command recall, and
command editing.
•Viewsource code,monitored data,registers,stack contents, and backtrace
information in separate windows on the debugger’smain display.
•Define your own screensand windows in the debugger’smain display.
•Access on-line help information.
Compatibility with Other Products
The debugger/emulator hasbeen designed to work with HP-UX (version 8.0
or greater), SunOS,or Solaris (see the Installation Notice for version
requirements) and the following Hewlett-Packard language products:
HP B3640, Motorola 68000 FamilyC Cross Compiler, Version 4.00
HP B3641, Motorola 68000 FamilyAssembler, Linker, Librarian,
Version 2.00.
HP B1471, HP 64000-UX Operating Environment Software,Version 6.20.
See the “Loading and Executing Programs” chapter if you are using the
Microteclanguage tools.
v

In This Book
This book is organized into five parts:
Part 1. Quick Start Guide
An overviewofthe debugger and a short lesson to get you started.
Part 2. User’s Guide
Howto use the debugger to solve your problems.
Part 3. Concept Guide
Conceptual information on CPU simulation and on X resources.
Part 4. Reference
Descriptions of what each debugger command does,details of how the
debugger works, and a list of error messages.
Part 5. Installation
Howto install the debugger software on your computer.
vi

Contents
Part 1 Quick Start Guide
1 Getting Started with the Graphical Interface
The GraphicalInterface at a Glance 5
Pointer and cursor shapes 5
The Debugger Window 6
Graphical Interface Conventions 8
Mouse Buttons 9
Platform Differences 10
The Quick Start Tutorial 11
The Demonstration Program 11
To prepare to run the debugger 12
To start the debugger 13
To activate displayarea windows 14
To run until main() 15
To scroll the Code window 16
To displaya function 17
To run until a line 18
To edit the program 19
To displayinit_system() again 20
To set a breakpoint 20
To run until the breakpoint 21
To patch code usinga macro 22
To delete a single breakpoint 23
To delete all breakpoints 24
To step through a program 25
To run until a stack level 25
To step over functions 26
To step out ofa function 26
To displaythe value of a variable 26
To change the value of a variable 27
vii

To recall an entrybuffer value 28
To displaythe addressof a variable 29
To break on an access to a variable 30
To use the command line 31
To use a C printf command 31
To turn the command line off 32
To see on-line help 33
To end the debugging session 34
Part 2 User’s Guide
2 Entering Debugger Commands
Starting the Debugger 41
Using Menus, the EntryBuffer, and Action Keys 42
To choose a pull-down menu item using the mouse (method 1) 42
To choose a pull-down menu item using the mouse (method 2) 43
To choose a pull-down menu item using the keyboard 44
To choose pop-up menu items 45
To use pop-up menu shortcuts 46
To place values into the entrybuffer using the keyboard 46
To copy-and-paste to the entrybuffer 46
To recall entrybuffer values 48
To edit the entrybuffer 49
To use the entrybuffer 49
To copy-and-paste from the entrybuffer to the command line entryarea 49
To use the action keys 50
To use dialog boxes 51
To access help information 55
Usingthe Command Line with the Mouse 56
To turn the command line on or off 57
To enter a command 58
To edit the command line usingthe command line pushbuttons 59
To edit the command line usingthe command line pop-up menu 60
Contents
viii

To recall commands 60
To get help about the command line 61
To find commands which duplicate a menu selection 61
Usingthe Command Line with the Keyboard 62
To enter debugger commands from the keyboard 62
To edit the command line 64
To recall commands using the command line recall feature 64
To displaythe help window 65
Viewing Debugger Status 67
Debugger Status 67
Indicator Characters 68
CPU Simulated 68
Current Module 68
Last Breakpoint 68
To displayinformation about the debugger version 69
Solving problems with the interface 70
Ifpop-up menusdon’t pop up 70
3 Loading and Executing Programs
Compiling Programs for the Debugger 72
Writing programs for simulation 72
68020 Module Support —CALLM and RTM 72
Using a Hewlett-Packard C Cross Compiler 73
Using Microtec Language Tools 75
Loading Programs and Symbols 78
To specifythe location of C source files 78
To load programs 79
To load program code only 80
To load symbols only 81
To load additional programs 82
To turn demand loading of symbols on or off 83
Stepping Through and Running Programs 84
To step through programs 84
Contents
ix

To step over functions 85
To run from the current program counter (PC) address 86
To run from a start address 86
To run until a stop (break) address 87
To count simulated clock cycles 88
To add simulated wait states 89
Using Breakpoints 90
To set a memoryaccess breakpoint 90
To set an instruction breakpoint 91
To set a breakpoint for a C+ + object instance 92
To set a breakpoint for overloaded C+ + functions 93
To set a breakpoint for C+ + functions in a class 93
To clear selected breakpoints 94
To clear all breakpoints 95
To displaybreakpoint information 96
To halt program execution on return to a stack level 99
UsingSimulated Interrupts 100
To define simulated interrupts 100
To remove simulated interrupts 101
RestartingPrograms 102
To reset the processor 102
To reset the program counter to the startingaddress 102
To reset program variables 103
Savingand Loadingthe CPU State 104
To save the current CPU state 104
MappingMemory 105
To prevent accessto memorylocations 105
To prevent writingto memorylocations 105
To allowaccess to memorylocations 106
To displaycurrent memorymap assignments 106
Accessing Input Ports 108
To set or alter input port status 108
To delete an input port 109
Contents
x