SPARCompiler Ada Reference Guide - Oracle Documentation

428 Pages·1999·0.68 MB·English

SPARCompiler Ada Reference Guide
A Sun Microsystems, Inc. Business
2550 Garcia Avenue
Mountain View, CA 94043
U.S.A.
Part No.: 802-3640-10
Revision A, November, 1995
(cid:211) 1995 Sun Microsystems, Inc. All rights reserved.
2550 Garcia Avenue, Mountain View, California 94043-1100 U.S.A.
This product and related documentation are protected by copyright and distributed under licenses restricting its use, copying,
distribution, and decompilation. No part of this product or related documentation may be reproduced in any form by any
means without prior written authorization of Sun and its licensors, if any.
Portions of this product may be derived from the UNIX® and Berkeley 4.3 BSD systems, licensed from UNIX System
Laboratories, Inc., a wholly owned subsidiary of Novell, Inc., and the University of California, respectively. Third-party font
software in this product is protected by copyright and licensed from Sun’s font suppliers.
RESTRICTED RIGHTS LEGEND: Use, duplication, or disclosure by the United States Government is subject to the restrictions
set forth in DFARS 252.227-7013 (c)(1)(ii) and FAR 52.227-19.
The product described in this manual may be protected by one or more U.S. patents, foreign patents, or pending applications.
TRADEMARKS
Sun, the Sun logo, Sun Microsystems, Solaris, are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S.
and certain other countries. UNIX is a registered trademark in the United States and other countries, exclusively licensed
through X/Open Company, Ltd. OPEN LOOK is a registered trademark of Novell, Inc. PostScript and Display PostScript are
trademarks of Adobe Systems, Inc. All other product names mentioned herein are the trademarks of their respective owners.
All SPARC trademarks, including the SCD Compliant Logo, are trademarks or registered trademarks of SPARC International,
Inc. SPARCstation, SPARCserver, SPARCengine, SPARCstorage, SPARCware, SPARCcenter, SPARCclassic, SPARCcluster,
SPARCdesign, SPARC811, SPARCprinter, UltraSPARC, microSPARC, SPARCworks, and SPARCompiler are licensed
exclusively to Sun Microsystems, Inc. Products bearing SPARC trademarks are based upon an architecture developed by Sun
Microsystems, Inc.
The OPEN LOOK® and Sun™ Graphical User Interfaces were developed by Sun Microsystems, Inc. for its users and licensees.
Sun acknowledges the pioneering efforts of Xerox in researching and developing the concept of visual or graphical user
interfaces for the computer industry. Sun holds a non-exclusive license from Xerox to the Xerox Graphical User Interface,
which license also covers Sun’s licensees who implement OPEN LOOK GUIs and otherwise comply with Sun’s written license
agreements.
X Window System is a trademark of the X Consortium.
THIS PUBLICATION IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
PARTICULAR PURPOSE, OR NON-INFRINGEMENT.
THIS PUBLICATION COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL ERRORS. CHANGES ARE
PERIODICALLY ADDED TO THE INFORMATION HEREIN; THESE CHANGES WILL BE INCORPORATED IN NEW
EDITIONS OF THE PUBLICATION. SUN MICROSYSTEMS, INC. MAY MAKE IMPROVEMENTS AND/OR CHANGES IN
THE PRODUCT(S) AND/OR THE PROGRAM(S) DESCRIBED IN THIS PUBLICATION AT ANY TIME.
Please
Recycle
Contents
1. Files and Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
1.1 Topics. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
1.2 Ada compilation Units — units and dependencies. . . 1-2
1.3 File Formats — types of files used by SCAda. . . . . . . 1-4
1.4 SCAda Release Libraries — contents of the SCAda libraries
1-6
1.5 standard. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7
1.6 verdixlib. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-16
1.7 publiclib. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-17
1.8 examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-18
1.9 SCAda User Libraries — for source file compilations 1-20
1.10 The ada.lib File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-21
1.11 The GVAS_table File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-25
1.12 The .LINK_INFO File. . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-27
2. Command Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
2.1 Command Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
iii
2.2 ada — invoke the Ada compiler. . . . . . . . . . . . . . . . . . . 2-4
2.3 a.app — invoke the Ada preprocessor . . . . . . . . . . . . . 2-13
2.4 a.ar — create an archive library of Ada object files . . . 2-15
2.5 a.cleanlib — reinitialize library directory . . . . . . . . . . 2-18
2.6 a.cp — copy unit and library information . . . . . . . . . . 2-20
2.7 a.das — disassemble object files . . . . . . . . . . . . . . . . . . 2-22
2.8 a.db — debug Ada and C source code programs . . . . 2-25
2.9 a.du — summarize disk usage for Ada libraries . . . . 2-32
2.10 a.error — analyze and disperse error messages. . . . . 2-34
2.11 a.header — print information stored in unit’s net header2-37
2.12 a.help — invoke the interactive help utility . . . . . . . . 2-44
2.13 a.info — list or change SC Ada library directives. . . . 2-46
2.14 a.ld — build an executable program from compiled units
2-60
2.15 a.list — produce source code listing. . . . . . . . . . . . . . . 2-65
2.16 a.ls — list compiled units . . . . . . . . . . . . . . . . . . . . . . . 2-66
2.17 a.make — recompile source files in dependency order 2-69
2.18 a.mklib — create a SC Ada library directory . . . . . . . 2-78
2.19 a.mv — move unit and library information . . . . . . . . 2-81
2.20 a.path — report or change SC Ada library search list. 2-84
2.21 a.pr — format source code . . . . . . . . . . . . . . . . . . . . . . 2-87
2.22 a.prof — analyze and display profile data. . . . . . . . . . 2-93
2.23 a.report — report deficiency or suggestion. . . . . . . . . 2-96
2.24 a.rm — remove an Ada unit from a library. . . . . . . . . 2-98
iv SPARCompiler Ada Reference Guide
2.25 a.rmlib — remove a compilation library. . . . . . . . . . . . 2-100
2.26 a.symtab - display symbol information. . . . . . . . . . . . . 2-102
2.27 a.tags — create a source file cross reference of units. . 2-111
2.28 a.vadsrc — display versions and create library configuration
file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-114
2.29 a.version — display if licensed for Multithreaded Ada 2-116
2.30 a.view — provide aliases and history for C shell user 2-117
2.31 a.which — determine which project library contains a unit
2-120
2.32 a.xdb — X-Window Debugger Interface . . . . . . . . . . . . 2-121
2.33 a.xref — print cross-reference information . . . . . . . . . . 2-123
3. Debugger Reference. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
List of All Commands and Concepts . . . . . . . . . . . . . . . . . . . . . 3-1
a — (advance) step one source line over calls. . . . . . . . . . . . . 3-5
activate — activate breakpoint(s) . . . . . . . . . . . . . . . . . . . . . . . . 3-7
address — address memory directly . . . . . . . . . . . . . . . . . . . . 3-8
ai — (advance instruction) single-step machine code over calls 3-9
as — (advance signal) advance, pass signal to program . . . . 3-10
:= — assign a value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-12
asynchronous debugging - run the debugger in asynchronous mode
3-14
b — (break) break at a line or beginning of a subprogram . . 3-18
bd — (break down) break after current subprogram . . . . . . . 3-23
bi — (break instruction) break at machine instruction . . . . . 3-25
br — (break return) set permanent breakpoint at return . . . 3-27
Contents v
breakpoints — control program execution . . . . . . . . . . . . . . . 3-29
bx — (break exception) break when an Ada exception occurs 3-32
call stack — display current state of program. . . . . . . . . . . . . . 3-37
cb — (call bottom) move to the call stack bottom frame . . . . 3-39
cd — (call down) move down on the call stack . . . . . . . . . . . 3-40
cifo — (CIFO) display CIFO data structures . . . . . . . . . . . . . . 3-42
command syntax — syntax of debugger commands . . . . . . . . 3-45
core file - debugging a program that produced a core file . . . 3-47
cs — (call stack) display the call stack . . . . . . . . . . . . . . . . . . . 3-49
ct — (call top) move to the call stack top frame . . . . . . . . . . . 3-52
cu — (call up) move up on the call stack . . . . . . . . . . . . . . . . . 3-53
current frame — current position on the call stack . . . . . . . . 3-55
current position — current position in a source file . . . . . . . 3-56
d — (delete) delete breakpoints . . . . . . . . . . . . . . . . . . . . . . . . 3-57
deactivate — deactivate breakpoint(s)) . . . . . . . . . . . . . . . . . . . 3-59
debugger variables - creation and use of debugger variables 3-60
define - define a debugger variable . . . . . . . . . . . . . . . . . . . . . 3-65
disassembly — display disassembled source code . . . . . . . . . 3-67
display memory — display raw memory . . . . . . . . . . . . . . . . 3-70
dm —delete macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-79
e — (enter) navigate to a declaration, subprogram or source file (like
vi tags) 3-80
edit — edit a subprogram or a file . . . . . . . . . . . . . . . . . . . . . . 3-82
em — edit macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-83
vi SPARCompiler Ada Reference Guide
env - customize target program environment . . . . . . . . . . . . . 3-84
examine — display program elements and components . . . 3-86
exceptions — exception handling in the debugger . . . . . . . . . 3-87
exit — terminate the debugger session . . . . . . . . . . . . . . . . . . 3-89
expressions — arithmetic expressions in the debugger . . . . 3-90
files — specify files to debug . . . . . . . . . . . . . . . . . . . . . . . . . . 3-93
g — (go) continue executing . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-94
gs — (go signal) continue executing, pass signal to program 3-95
gw — (go while) continue executing until a variable changes 3-96
help — print help text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-97
home position — execution point in current frame . . . . . . . . 3-99
inline expansions — debugging inline expansions . . . . . . . . . 3-100
invocation — invoking the debugger . . . . . . . . . . . . . . . . . . . . 3-102
l — (list) display part of a source program . . . . . . . . . . . . . . . 3-108
lb — (list breakpoints) list all currently set breakpoints . . . . 3-110
li — (list instructions) list disassembled instructions . . . . . . 3-111
line editing — command history and line editing functions . 3-113
line numbers — move to a specified line . . . . . . . . . . . . . . . . 3-119
lm — list macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-121
lt — (list tasks) list all active tasks . . . . . . . . . . . . . . . . . . . . . . 3-122
lu — (list processes) list UNIX processes . . . . . . . . . . . . . . . . 3-133
lv — list all debugger variables . . . . . . . . . . . . . . . . . . . . . . . . . 3-135
macros — macro preprocessing support . . . . . . . . . . . . . . . . . . 3-136
overloading — disambiguate overloaded names . . . . . . . . . . 3-141
Contents vii
p — (print) display the value of a variable or expression . . . 3-143
pm — print macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-148
procedure calls — call subprograms from the program . . . . . 3-149
profiling — invoking the Statistical Profiler from the debugger 3-151
put - (put) send characters to program input . . . . . . . . . . . . . . 3-152
put_line - (put line) send characters to program input, append new
line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-154
quit — terminate the debugger session . . . . . . . . . . . . . . . . . . 3-156
r — run a program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-157
raise — raise exception . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-159
read — read debugger commands from a file . . . . . . . . . . . . 3-160
reg — list the current machine register contents . . . . . . . . . . 3-162
register variables — debugging with register variables . . . . . 3-165
<RETURN> — re-execute debugger command . . . . . . . . . . . 3-169
return — return from all called subprograms . . . . . . . . . . . . 3-170
s — (step) single step source code into subprograms . . . . . . 3-171
screen mode — screen-oriented debugger interface . . . . . . . 3-173
search — search for a pattern in the current file . . . . . . . . . . 3-182
set — set debugger parameters . . . . . . . . . . . . . . . . . . . . . . . . 3-184
si — (step instruction) single-step machine code into program 3-191
signals — set/ignore signals . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-192
ss — (step signal) single-step, pass signal to program . . . . . 3-194
stop — stop the debugger or program . . . . . . . . . . . . . . . . . . 3-196
strings — string operations and support . . . . . . . . . . . . . . . . . 3-197
viii SPARCompiler Ada Reference Guide
task — perform a task action command . . . . . . . . . . . . . . . . . 3-201
terminal control — catching program input/output . . . . . . . 3-203
v — (visit) navigate to a declaration, subprogram or source file (like
vi tags) 3-204
vb - (visit breakpoint) move source location to breakpoint . 3-206
vi — (visual) switch the debugger to screen mode . . . . . . . . 3-207
visibility rules — determine visible identifiers at a breakpoint 3-208
w — (window) list a group of source lines . . . . . . . . . . . . . . . 3-209
wi — (window instruction) list disassembled and original code
3-210
x — (eXamine) monitor memory location(s) . . . . . . . . . . . . . 3-212
X-Window Debugging — debugging in the X-Window environment
3-221
A. Limits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1
A.1 Compiler and Tool Limits . . . . . . . . . . . . . . . . . . . . . . . . A-1
A.2 Source File Limits. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-2
Contents ix
x SPARCompiler Ada Reference Guide