PGI® Tools Guide Parallel Tools for Scientists and Engineers All rights reserved. The Portland Group™ STMicroelectronics Two Centerpointe Drive, Suite 320 Lake Oswego, OR 97035 While every precaution has been taken in the preparation of this document, The Portland Group™, a wholly-owned subsidiary of STMicroelectronics, 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 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 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. 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 was aware of a trademark claim. The designations have been printed in caps or initial caps. Thanks is given to the Parallel Tools Consortium and, in particular, to the High Performance Debugging Forum for their efforts. PGF95, PGF95, PGC++, PVF, CDK and The Portland Group are trademarks and PGI, PGHPF, PGF77, PGCC, Cluster Development Kit, PGPROF, and PGDBG are registered trademarks of STMicroelectronics, Inc. Other brands and names are the property of their respective owners. The use of STLport, a C++ Library, is licensed separately and license, distribution and copyright notice can be found in the online documentation for a given release of the PGI compilers and tools. PGI® Tools Guide Copyright © 2004 – 2007 STMicroelectronics, Inc. All rights reserved. Printed in the United States of America First Printing: Release 5.2, June 2004 Second Printing: Release 6.0, March 2005 Third Printing: Release 6.1, December 2005 Fourth Printing: Release 6.2, August 2006 Fifth Printing: Release 7.0-1, December, 2006 Sixth Printing: Release 7.0-2, February, 2007 Seventh Printing: Release 7.1, October, 2007 Technical support: http://www.pgroup.com/support/ Sales: [email protected] Web: http://www.pgroup.com Contents Preface .................................................................................................................................... xiii Intended Audience ................................................................................................................ xiii Supplementary Documentation ............................................................................................... xiii Compatibility and Conformance to Standards ............................................................................ xiii Organization ......................................................................................................................... xiv Conventions .......................................................................................................................... xv Related Publications .............................................................................................................. xvi System Requirements ............................................................................................................ xvii 1. The PGDBG Debugger ....................................................................................................... 1 Definition of Terms ................................................................................................................. 1 Building Applications for Debug ............................................................................................... 2 PGDBG Invocation and Initialization .......................................................................................... 2 Invoking PGDBG ............................................................................................................. 2 Selecting a Version of Java ............................................................................................... 3 PGDBG Command-Line Options ........................................................................................ 3 PGDBG Graphical User Interface ............................................................................................... 4 Main Window ................................................................................................................. 5 Source Panel ................................................................................................................ 12 Source Panel Pop-Up Menus ........................................................................................... 17 Subwindows ................................................................................................................. 19 PGDBG Command Language ................................................................................................... 26 Constants ..................................................................................................................... 27 Symbols ....................................................................................................................... 27 Scope Rules ................................................................................................................. 27 Register Symbols ........................................................................................................... 27 Source Code Locations ................................................................................................... 28 Lexical Blocks .............................................................................................................. 28 Statements .................................................................................................................... 29 Events ........................................................................................................................ 30 Expressions .................................................................................................................. 32 PGDBG Commands ................................................................................................................ 33 Notation Used in Command Sections ................................................................................ 33 iii PGI® Tools Guide Commands Summary ............................................................................................................. 34 PGDBG Command Reference .................................................................................................. 38 Process Control ............................................................................................................ 39 Process-Thread Sets ...................................................................................................... 42 Events .......................................................................................................................... 42 Program Locations ........................................................................................................ 49 Printing Variables and Expressions .................................................................................. 51 Symbols and Expressions ............................................................................................... 53 Scope .......................................................................................................................... 56 Register Access ............................................................................................................. 57 Memory Access ............................................................................................................. 58 Conversions .................................................................................................................. 60 Miscellaneous ............................................................................................................... 61 Signals ................................................................................................................................. 66 Control-C ..................................................................................................................... 66 Signals Used Internally by PGDBG ................................................................................... 66 Signals Used by Linux Libraries ....................................................................................... 66 Register Symbols ................................................................................................................... 66 X86 Register Symbols .................................................................................................... 67 AMD64/EM64T Register Symbols ..................................................................................... 67 SSE Register Symbols ..................................................................................................... 69 Debugging Fortran ................................................................................................................ 70 Fortran Types ............................................................................................................... 70 Arrays .........................................................................................................................