Allinea DDT User Guide Version 3.1-21691 Allinea DDT v3.1-21691 Contents Contents ......................................................................................................................................................1 1 Introduction .............................................................................................................................................6 1.1 Licence Options................................................................................................................................6 1.2 Obtaining Help..................................................................................................................................7 2 Installation and Configuration ................................................................................................................8 2.1 Installation ........................................................................................................................................8 2.1.1 Graphical Install ........................................................................................................................8 2.1.2 Text-mode Install ......................................................................................................................9 2.1.3 Licence Files ...........................................................................................................................10 2.1.4 Floating Licences ....................................................................................................................10 2.2 Configuration .................................................................................................................................11 2.2.1 Site Wide Configuration .........................................................................................................13 2.3 Integrating DDT With Queuing Systems ......................................................................................14 2.3.1 The Template Script ................................................................................................................14 2.3.2 OpenMPI, Altix, Blue Gene/P and Cray MPT .......................................................................15 2.3.3 MPICH based MPI .................................................................................................................16 2.3.4 Other MPIs ..............................................................................................................................16 2.3.5 Scalar Programs ......................................................................................................................16 2.3.6 Defining New Tags .................................................................................................................16 2.3.7 Configuring Queue Commands ..............................................................................................18 2.4 Connecting to remote programs (remote-exec) .............................................................................19 2.4.1 SSH based remote-exec ..........................................................................................................19 2.4.2 Testing .....................................................................................................................................20 2.5 Optional Configuration ..................................................................................................................20 2.5.1 System .....................................................................................................................................20 2.5.2 Job Submission .......................................................................................................................21 2.5.3 Remote Launch .......................................................................................................................21 2.5.4 Appearance ..............................................................................................................................21 2.5.5 Look & Feel ............................................................................................................................21 2.5.6 Code Viewer Settings .............................................................................................................21 2.5.7 Override System Font Settings ...............................................................................................22 3 Starting DDT .........................................................................................................................................23 3.1 Running a Program ........................................................................................................................23 3.2 Notes on the MPICH Standard and OpenMPI options .................................................................26 3.3 Debugging Single-Process Programs ............................................................................................26 3.4 Debugging OpenMP Programs ......................................................................................................27 3.5 Debugging Multi-Process Non-MPI programs .............................................................................27 3.6 Debugging OpenMPI MPMD Programs .......................................................................................28 3.7 Opening Core Files ........................................................................................................................29 3.8 Attaching To Running Programs ...................................................................................................29 3.8.1 Automatically Detected MPI Jobs ..........................................................................................30 3.8.2 Attaching To A Subset Of A n MPI Job ................................................................................30 3.8.3 Manual Process Selection .......................................................................................................30 3.8.4 Configuring Attaching to Remote Hosts ................................................................................31 3.8.5 Using LaunchMON for high-speed attaching ........................................................................31 3.8.6 Using DDT Command-Line Arguments ................................................................................32 3.9 Starting A Job In A Queue .............................................................................................................32 3.10 Using Custom MPI Scripts ..........................................................................................................33 3.11 Starting DDT From A Job Script .................................................................................................35 3.12 Notes on X Forwarding or VNC for remote users ......................................................................35 4 DDT Overview ......................................................................................................................................37 4.1 Saving And Loading Sessions .......................................................................................................38 4.2 Source Code ...................................................................................................................................38 4.3 Finding Lost Source Files ..............................................................................................................38 © 2012 Allinea Software 1 Allinea DDT v3.1-21691 4.4 Finding Code Or Variables ............................................................................................................38 4.4.1 Find File or Function ..............................................................................................................38 4.4.2 Find ..........................................................................................................................................39 4.4.3 Find in Files ............................................................................................................................39 4.5 Jump To Line / Jump To Function ................................................................................................40 4.6 Static Analysis.................................................................................................................................41 4.7 Editing Source Code ......................................................................................................................41 5 Controlling Program Execution ............................................................................................................42 5.1 Process Control And Process Groups ............................................................................................42 5.1.1 Detailed View .........................................................................................................................42 5.1.2 Summary View .......................................................................................................................43 5.2 Focus Control .................................................................................................................................43 5.2.1 Overview of changing focus ...................................................................................................44 5.2.2 Process Group Viewer ............................................................................................................44