PGI Tools User’s Guide Parallel Tools for Scientists and Engineers The Portland Group Compiler Technology STMicroelectronics 9150 SW Pioneer Court, Suite H Wilsonville, OR 97070 www.pgroup.com While every precaution has been taken in the preparation of this document, The Portland Group™ Compiler Technology, Microelectronics makes no warranty for the use of its products and assumes no responsibility for any errors that may appear, or for damages resulting from the use of the information contained herein. The Portland Group™ Compiler Technology, Microelectronics retains the right to make changes to this information at any time, without notice. The software described in this document is distributed under license from The Portland Group™ Compiler Technology, STMicroelectronics and may be used or copied only in accordance with the terms of the license agreement. No part of this document may be reproduced or transmitted in any form or by any means, for any purpose other than the purchaser’s personal use without the express written permission of The Portland Group™ Compiler Technology, STMicroelectronics Many of the designations used by manufacturers and sellers to distinguish their products are claimed as trademarks. Where those designations appear in this manual, The Portland Group™ Compiler Technology, Microelectronics was aware of a trademark claim. The designations have been printed in caps or initial caps. CDK and The Portland Group are trademarks and Cluster Development Kit, PGI, PGF90, PGHPF, PGF77, PGCC, PGPROF, and PGDBG are registered trademarks of STMicroelectronics, Inc. Other brands and names are the property of their respective owners. PGI Tools User’s Guide Copyright © 1998 - 2003 STMicroelectronics, Inc. All rights reserved. Printed in the United States of America First Printing: Release 5.0, June 2003 Part Number: 2040-990-888-0603 Technical support: [email protected] Sales: [email protected] http://www.pgroup.com Table of Contents TABLE OF CONTENTS ............................................................................................................ III PREFACE........................................................................................................................................1 AUDIENCE DESCRIPTION................................................................................................................1 COMPATIBILITY AND CONFORMANCE TO STANDARDS...................................................................1 ORGANIZATION..............................................................................................................................2 CONVENTIONS ...............................................................................................................................3 RELATED PUBLICATIONS ...............................................................................................................3 SYSTEM REQUIREMENTS................................................................................................................4 THE PGDBG DEBUGGER ...........................................................................................................5 1.1 DEFINITION OF TERMS .............................................................................................................5 1.1.1 Compiler Options for Debugging ....................................................................................6 1.2 INVOCATION AND INITIALIZATION ...........................................................................................6 1.3 COMMAND-LINE ARGUMENTS.................................................................................................7 1.4 COMMAND LANGUAGE ............................................................................................................8 1.4.1 Constants .........................................................................................................................8 1.4.2 Symbols ............................................................................................................................8 1.4.3 Scope Rules ......................................................................................................................9 1.4.4 Register Symbols..............................................................................................................9 1.4.5 Source Code Locations ..................................................................................................10 1.4.6 Lexical Blocks ................................................................................................................11 1.4.7 Statements ......................................................................................................................12 1.4.8 Events.............................................................................................................................12 1.4.9 Expressions ....................................................................................................................15 1.5 SIGNALS.................................................................................................................................17 1.5.1 Signals Used Internally by PGDBG...............................................................................17 1.6 DEBUGGING FORTRAN ...........................................................................................................18 1.6.1 Arrays.............................................................................................................................18 1.6.2 Operators .......................................................................................................................18 1.6.3 Name of Main Routine ...................................................................................................18 1.6.4 Fortran Common Blocks................................................................................................18 1.6.5 Nested Subroutines.........................................................................................................19 1.6.6 Fortran 90 Modules .......................................................................................................20 1.7 DEBUGGING C++ ..................................................................................................................21 1.8 CORE FILES............................................................................................................................22 1.9 PGDBG COMMANDS.............................................................................................................22 Table of Contents iii 1.9.1 Commands .....................................................................................................................22 1.9.1.1 Process Control ..........................................................................................................22 1.9.1.2 Process-Thread Sets ...................................................................................................25 1.9.1.3 Events..........................................................................................................................26 1.9.1.4 Program Locations .....................................................................................................33 1.9.1.5 Printing and Setting Variables....................................................................................35 1.9.1.6 Symbols and Expressions............................................................................................37 1.9.1.7 Scope...........................................................................................................................39 1.9.1.8 Register Access ...........................................................................................................40 1.9.1.9 Memory Access ...........................................................................................................41 1.9.1.10 Conversions ..............................................................................................................43 1.9.1.11 Miscellaneous ...........................................................................................................44 1.10 COMMANDS SUMMARY .......................................................................................................49 1.10.1 Command Summary.....................................................................................................50 1.11 REGISTER SYMBOLS ............................................................................................................57 1.11.1 X86 Register Symbols ..................................................................................................58 1.11.2 AMD64 Register Symbols ............................................................................................59 1.12 X-WINDOWS GRAPHICAL USER INTERFACE ........................................................................61 1.12.1 Main Window...............................................................................................................62 1.12.2 Disassembly Window ...................................................................................................63 1.12.3 Register Window..........................................................................................................64 1.12.4 Memory Window..........................................................................................................65 1.12.5 Custom Window ...........................................................................................................66