debug.doc

来自「开放源码的编译器open watcom 1.6.0版的源代码」· DOC 代码 · 共 825 行 · 第 1/2 页

	    Typed Symbols (T)
	    - Only show symbols with type information
    
    *** The image Window
	    New Symbols (N)
	    - Add symbolic debugging information for the selected image
	    Delete Symbols (D)
	    - Delete the symbolic debugging information for the selected image
	    ---------
	    Modules (M)
	    - Show all modules in the selected image
	    Functions (F)
	    - Show all functions in the selected image
	    Globals (G)
	    - Show all global variables in the selected image
    
--- Controlling program execution
    
    *** The Run Menu
	    Run (R)
	    - Control program execution
		Go (G)                F5
		- Resume program execution
		Run to Cursor (C)
		- Execute until the cursor position is reached
		Execute to... (x)     g
		- Execute until a given address is reached
		Step Over (S)         F10
		- Trace once, stepping over calls
		Trace Into (T)        F8
		- Trace once, stepping into calls
		Next Sequential (N)   x
		- Trace until the next sequential address is reached
		Until Return (U)
		- Execute until this function returns
		---------
		Skip to Cursor (k)
		- Re-position the instruction pointer at the cursor position
		Restart (R)
		- Restart the program
		---------
		Save... (v)
		- Save event replay information to a file
		Restore... (o)
		- Restore event replay information from a file
    
    *** The Undo Menu
	    Undo (U)
	    - Browse through the execution history
		Undo (U)              CTRL-LEFT
		- Undo the last program execution or modification
		Redo (R)              CTRL-RIGHT
		- Undo the last undo
		Unwind Stack (n)      CTRL-UP
		- Move up the call stack
		Rewind Stack (e)      CTRL-DOWN
		- Move down the call stack
		Home (H)              CTRL-BACKSPACE
		- Move to the currently executing location
    
    *** The replay Window
	    Goto (G)
	    - Execute until the program returns to the selected level in the call history
	    Source (S)
	    - Show the source code associated with the selected line
	    Assembly (A)
	    - Show the assembly code associated with the selected line
    
    *** The calls Window
	    Unwind (U)
	    - Unwind the call stack to the selected level
	    Break... (B)
	    - Set a break point at the selected line
	    Goto (G)
	    - Execute until the program returns to the selected level in the call history
	    ---------
	    Source (S)
	    - Show the source code associated with the selected line
	    Assembly (A)
	    - Show the assembly code associated with the selected line
    
    *** The thread Window
	    Switch to (S)
	    - Set the debugger to the selected thread context
	    Freeze (F)
	    - Do not allow the selected thread to execute
	    Thaw (T)
	    - Allow the selected thread to execute
    
--- Examining and Modifying The Program State
    
    *** The watch/variable/filescope/locals Window
	    Modify... (M)
	    - Modify the selected item
	    Inspect (I)
	    - Inspect the selected item
	    Break (B)
	    - Stop when the selected value changes or the selected function is entered
	    Watch (W)
	    - Add the selected item to the watches window
	    Edit... (E)
	    - Edit the selected expression. Type casts are allowed
	    New... (N)
	    - Add a new item to this window
	    Delete (D)                CTRL-y
	    - Delete the selected item from this window
	    Root (R)
	    - Move the selected item to the root of this structure/array
	    Type (T)
	    - Display as a different data type
		Hex (H)
		Decimal (c)
		Character (r)
		- Display the selected variable as a character
		String (S)
		- Display the selected variable as a character string
		Pointer (P)
		- Display the selected variable as a pointer
		Array... (A)
		- Expand variable as an array with given dimensions
	    Show (S)
		Raw Memory (R)
		- Display the memory associated with this variable
		Pointer Memory (P)
		- Display the memory associated with this pointer value
		Pointer Code (C)
		- Display the source or assembly associated with this pointer
	    Options (O)
	    - Set window options for this window only
		Whole Expression (W)
		- Show the entire expression on each line
		Functions (F)
		- Show C++ member functions
		Inherited (I)
		- Show C++ inherited members
		Compiler (C)
		- Show C++ compiler generated members
		Members (M)
		- Show C++ 'this' members
		Private (P)
		- Show C++ private members
		Protected (r)
		- Show C++ protected members
    
    *** The memory Window
	    Modify... (M)
	    - Modify the selected item
	    Break on Write (B)
	    - Stop when the selected value changes
	    ---------
	    Near Follow (N)
	    - Follow the near pointer under the cursor
	    Far Follow (F)
	    - Follow the far pointer under the cursor
	    Segment Follow (S)
	    - Follow the segment under the cursor
	    Cursor Follow (C)
	    - Make the cursor position the new starting address
	    Repeat (R)
	    - Repeat the previous follow using the same offset
	    Previous (P)
	    - Backout to the previous position in the follow chain
	    Home (H)
            - Return to the home memory location
	    ---------
	    Address... (d)
	    - Position the window at a given address
	    Assembly (A)
	    - Show the assembly code associated with the selected line
	    Type (T)
	    - Display as a different data type
		Byte (B)
		Word (W)
		DWord (D)
		Char (C)
		Short (S)
		Long (L)
		Unsigned Char (r)
		Unsigned Short (t)
		Unsigned Long (g)
		16:16 Pointer (6)
		16:32 Pointer (3)
		Binary (i)
		Float (F)
		Double (o)
	
    
--- Breakpoints

    *** what is a breakpoint
    *** types of break points
	    break on execute
	    break on write
	    conditional breakpoints
    
    *** how can they be used during debugging
	    setting breakpoints
	    clearing breakpoints
	    disabling breakpoints
	    enabling breakpoints
    
    *** The Break Menu
	    Break (B)
	    - Break point operations
		Toggle (T)            F9
		- Toggle the break point at the cursor position
		At Cursor (A)         b
		- Create/Modify the break point at the cursor position
		New... (N)
		- Create a new break point
		---------
		On DLL Load (O)
		- Stop whenever a DLL is dynamically loaded
		View All (V)
		- Show a list of all break points
		Clear All (C)
		- Delete all break points
		Disable All (D)
		- Disable, but do not delete, all break points
		Enable All (E)
		- Enable all break points
		---------
		Save... (S)
		- Save all break points to a file
		Restore... (R)
		- Restore all break points from a file
    
    *** The break Window
	    Modify... (M)
	    - Modify the selected item
	    New... (N)
	    - Add a new item to this window
	    Delete (D)
	    - Delete the selected item from this window
	    ---------
	    Source (S)
	    - Show the source code associated with the selected line
	    Assembly (A)
	    - Show the assembly code associated with the selected line
    
    *** The Breakpoint Dialog
	    Address
	    Condition
	    Break On
		Execute
		Byte
		Word
		DWord
	    Countdown
	    Total Hits
		Reset
	    Execute When Hit
		Resume
	    Active
	    Value
	    OK
	    Clear
	    Symbol ...
	    Cancel
    
--- Expressions
    
    *** Lift this chapter from the old manual
    
--- Techniques for tracking down bugs in a program

    *** using map files to help
    
--- Assembly Level Debugging
    
    *** WASM/MASM
	    Debugging options
    
    *** in-line assembly
    
    *** The register Window
	    Modify... (M)
	    - Modify the selected item
	    Inspect (I)
	    - Inspect the selected item
	    ---------
	    Hex (H)
	    Extended (E)
	    - Show the extended 386 register set
    
    *** The assembly Window
	    Inspect (I)
	    - Inspect the selected item
	    Break (B)
	    - Stop when the selected value changes or the selected function is entered
	    Enter Function (E)
	    - Execute until the selected function is entered
	    Show (S)
		Source (S)
		- Show the source code associated with the selected line
		Functions (F)
		- Show all functions in the selected module
		Address... (d)
		- Position the window at a given address
		Module... (M)         v
		- Show a given module
	    Home (H)
	    - Move to the currently executing location
	    Hex (x)
    
    *** The io Window
	    Modify... (M)
	    - Modify the selected item
	    New... (N)
	    - Add a new item to this window
	    Delete (D)
	    - Delete the selected item from this window
	    Read (R)
	    - Read the displayed value from the selected port
	    Write (W)
	    - Write the displayed value to the selected port
	    Type (T)
	    - Display as a different data type
		Byte (B)
		Word (W)
		DWord (D)
		Char (C)
		Short (S)
		Long (L)
		Unsigned Char (r)
		Unsigned Short (t)
		Unsigned Long (g)
	
    *** The fpu Window
	    Modify... (M)
	    - Modify the selected item
	    ---------
	    Hex (H)
    
    *** The STack Window
	    - see memory window
    
    
--- Remote debugging

    *** Overview with pretty pictures
    *** Link specific information and parameters
	    dqv
	    net
	    nmp
	    nov
	    par
	    ser
	    tcp
	    vdm
	    win
    *** RFX
            borrow from old manual
    
--- Advanced Techniques
    
    *** Call
    *** Capture
    *** .DBG files
    *** Patching using BreakPoints
    *** Resuming after Undo or Unwind
    *** Custom debugger setups
    *** Debugging multi-threaded applications
    *** Debugging DLLs
    *** Following data structures in the absence of debugging information
    
    
Appendicies

--- Debugger Commands

	see cmd.doc

--- Command Files

--- Predefined Symbols

	see predef.doc

--- Main Menu

	see mainmenu.doc

--- Right Mouse button menus

	see ritemous.doc
	
--- Error messages with explanations

--- Parallel Port Wiring

 	see old manual

--- Serial Port Wiring

 	see old manual

--- System Specific Debugging Techniques

	PM
	Windows
	NT
	NetWare loadable modules
	PenPoint
	AutoCAD ADS
	QNX

--- Technical Notes

    *** description of Undo mechanism.
    *** description of Replay mechanism.