HPD Version 1 Standard:
Command Interface for Parallel Debuggers

Contents of HPD Version 1 Standard

• Introduction
• Part 1: High-Level Overview
  • 1.1 The Debugger Interface
    • 1.1.1 What Is a Parallel Debugger?
    • 1.1.2 How a Debugger Operates
    • 1.1.3 The Debugger Interface
    • 1.1.4 Command Model
    • 1.1.5 Command and Prompt Formats
    • 1.1.6 Debugger Output
    • 1.1.7 Debugger Initialization and Modes of Operation
    • 1.1.8 References Cited in This Chapter
  • 1.2 Effects of Parallelism on Debugger Behavior
    • 1.2.1 Naming Individual Processes and Threads
    • 1.2.2 Process/Thread Sets
    • 1.2.3 Named Sets
    • 1.2.4 Handling Command Output from Multiple Threads
    • 1.2.5 References Cited in This Chapter
  • 1.3 Controlling Program Execution
    • 1.3.1 Starting and Stopping Model
    • 1.3.2 Advancing Program Execution
    • 1.3.3 Actionpoints
    • 1.3.4 References Cited in This Chapter
  • 1.4 Machine State, Program State, and Debugger State
    • 1.4.1 State Model: Machine State and Program State
    • 1.4.2 Debugger State
  • 1.5 Symbols, Names, and Expressions
    • 1.5.1 Symbol Names and Scope
    • 1.5.2 Explicit Qualification of Symbol Names
    • 1.5.3 Expressions
    • 1.5.4 Language Support
  • 1.6 Terminology and Notational Conventions
    • 1.6.1 Definitions of Key Terms
    • 1.6.2 Notational Conventions
  
  
• Part 2: Command Descriptions
  • 2.1 General Debugger Interface
    • # - Ignore remainder of this line ("comment command")
    • alias - Create or view user-defined command(s)
    • unalias - Remove previously defined command
    • history - View the session command history
    • ! - Execute a previous command from the command history
    • set - Change or view value(s) of debugger state variable(s)
    • unset - Restore default setting(s) for debugger state variable(s)
    • log - Start or stop the logging of debugger input/output
    • input - Read and execute commands stored in a file
    • proginput - Send command-line input to the target program, rather than the debugger
    • info - Display debugger environment information
    • help - Display help information
  • 2.2 Process/Thread Sets
    • focus - Change the current process/thread set
    • defset - Assign a set name to a group of processes/threads
    • undefset - Undefine a previously defined process/thread set
    • viewset - List the members of a process/thread set
    • whichsets - List all sets to which a process/thread belongs
  • 2.3 Debugger Initialization/Termination
    • load - Load debugging information about target program and prepare for execution
    • run - Start or re-start execution of target process(es)
    • attach - Bring currently executing process(es) under control of the debugger
    • detach - Detach debugger from target process(es), leaving it executing
    • kill - Terminate execution of target process(es)
    • core - Load core-file image of process(es) for examination
    • status - Show current status of processes and threads
    • quit, exit - Terminate the debugging session
  • 2.4 Program Information
    • list - Display source code lines
    • where - Display the current execution location and call stack
    • up - Move up one or more levels in the call stack
    • down - Move down one or more levels in the call stack
    • what - Determine what a target program name refers to
  • 2.5 Data Display and Manipulation
    • print - Evaluate and display the value of a program variable or expression
    • assign - Change the value of a scalar program variable
  • 2.6 Execution Control
    • step - Execute statement(s) by a specific process/thread
    • go - Resume execution of process(es)
    • halt - Suspend execution of process(es)
    • cont - Resume execution of process(es), blocking further commands
    • wait - Block command input until process(es) stop
  • 2.7 Actionpoints
    • break - Define a breakpoint
    • barrier - Define a barrier point
    • watch - Define an unconditional watchpoint
    • actions - Display a list of actionpoints
    • delete - Delete actionpoint(s)
    • disable - Temporarily disable actionpoint(s)
    • enable - Re-enable actionpoint(s) that has been disabled
    • export - Store actionpoint settings for future re-use
    
    
  • Part 3: HPD User Guide

  • Part 4: Reference Summaries
    • 4.1 Command Syntax Summary
      • 4.1.1 Basic (Shared) Syntax
      • 4.1.2 Required Commands
      • 4.1.3 Language Extensions
    • 4.2 Comprehensive Index

  ---

  Copyright © 1998, High Performance Debugging Forum and Oregon State University