Difference between revisions of "DSDP/DD/MultiContext"

Revision as of 19:12, 16 May 2008

This sub-group is focused on improving the workflow of multi-context debugging. Multi-context refers to simultaneous debugging of multiple cores, processes, threads, or other objects which are represented in standard debugger views. This sub-group was created following a discussion about platform debug dev: "ideas for improving multi-context debugging". The first document produced by this group was Unlink View Context proposal, this document is now deprecated and the current effort is organized around this wiki page being created by the community interested in this problem.

Use cases

Use cases to be considered when evaluating the multi-context debugging workflow.

Format:

• Family of use cases

  Use case 

  Description of the use case

  Scenario

  • Step

• I. Programs with multiple threads

  1 Two or more threads interacting 

  User is debugging a program with multiple threads which are interacting with each other.

  a) Debugging threads which contend for the same lock. 

  1. When a thread blocks while stepping,
  2. User switches focus to another thread and steps until the lock is released,
  3. User switches focus back to the first thread and continues debugging.

  b) Debugging race conditions where multiple threads are reading and writing some shared data 

  1. User sets a breakpoint at a location where a shared variable is written.
  2. Multiple threads hit the breakpoint
  3. User looks at each threads to see the thread-private data in each thread.
  4. User steps the threads individually to watch what happens to the shared data.
  5. Alternatively, user steps all threads.
  6. Multiple threads may hit the breakpoint at the same time.
  7. User sets another breakpoint further down in routines that access the shared data.
  8. User continues some or all of the threads which stopped at the first breakpoint so that they may reach the second breakpoint.

  2 Debugging a subset of threads 

  User is debugging a program with multiple threads, but he is interested only in interacting with some of the threads.

  a) User debugs with breakpoints restricted to a sub-set of threads.

  1. User creates a breakpoint on the routine to be debugged.
  2. User defines which threads should be allowed to hit the breakpoint.
  3. The threads hit the breakpoint and user steps through them.

  b) Run control for a subset of threads 

  User repeatedly suspends and resumes a subset of threads.

  c) Terminating/re-launching 

  1. User debugs a subset of threads (using filtered breakpoints, etc.).
  2. User terminates and relaunches a process, and continues to debug the same set of threads.

  d) Tasks submitted to a thread pool 

  1. User is debugging a routine which may be executed by any thread in a thread pool at any time, and by some threads in the thread pool at the same time.
  2. User sets a conditional breakpoint where the condition is used to identify a specific tasks. For example, an instance of an update object when debugging flexible hierarchy views.

  3 Program with large number (100+) of threads 

  User is debugging programs with large numbers of threads and he needs to manage those threads effectively.

  a) User needs to switch between suspended threads

  1. User sets a breakpoint that some threads may hit.
  2. Some threads hit the breakpoint.
  3. User switches focus between suspended threads to control them and examine their data.

  b) Threads created/destroyed rapidly

  User is debugging a process with threads being created and destroyed at a rapid rate (more than 1 thread/sec.)

• II. Multiple processes that interact with each other

  1 Launching multiple processes at the same time 

  When starting a debug session, user creates multiple processes and debugs them.

  2 Attaching to multiple processes 

  Instead of launching, user attaches to multiple processes and debugs them simultaneously.

  3 Debugging a process that forks 

  User is debugging a process that forks. After the fork user debugs both processes.

• III. Systems with multiple cores (On Chip Debugging)

  1 Hardware bring-up debugging 

  User attaches a debugger to a multi-core system for purpose of hardware configuration, such as configuring registers, IO devices, etc. (no OS, no symbol data, no executable image)

  2 No-OS debugging 

  User attaches to a multi-core system and downloads simple executable image to each core and debugs them.

  3 Debugging with OS-awareness 

  User attaches to a multi-core system, downloads an OS image to each, starts debugging the entire OS on each board, or specific tasks/processes running on specific cores.

Problems with workflow

Issues with the user experience when executing the above use cases.

• (I.1) There is no way to get the debugger to focus on more than one context at a time. It is true that multiple workbench windows can be opened, but splitting the whole screen between the two windows is not practical.
  • There is no simple way to compare data (variables, registers, memory,etc) from multiple contexts
• (all) Switching between contexts requires that the Debug view be visible. The Debug view takes a lot of screen space which could be used to view code or other program data.
• (I.1.b) If two instruction pointers are shown in the same editor, there is no way to distinguish which IP belongs to which context.
• (all) It is difficult to specify and manage breakpoint filters. Breakpoints get applied to wrong threads/processes/cores.
  • Breakpoint filters have to be specified after breakpoints are created.
  • Breakpoint filters are not persisted between debug sessions.
• (I.3) With large stack traces and lots of threads, it is difficult to find things in Debug view.
• (I.3.b) Processes/Threads being started rapidly can make the debug view flicker degrading UI performance.
• (I.2.d.2) Creating a conditional breakpoint is error prone, because values from the variables/expressions views have to be cut and pasted into a modal dialog.

Proposed changes

Proposals for new features and changes in existing workflow.

Comments

To comment and discuss the content on this page use the Talk page. You can get to this page by clicking on the "Discussion" link on the menu on the left side of the page.