Liren Large Software Subsidy 10

home *** CD-ROM | disk | FTP | other *** search

/ Liren Large Software Subsidy 10 / 10.iso / l / l353 / 1.img / BIN / MDB.TXT < prev next >

Wrap

Text File | 1991-04-08 | 23.3 KB | 610 lines

# # MDB Menu/Window Help # # @(#)help.txt 1.19 2/18/91 13:39:47 # *F1 HELP To get help on commands, type HELP or HELP <command>. To get help on the menu bar, access the menu bar, use cursor keys to move to the desired field, then press F1. Menu Bar: There are two ways to access the individual fields on the menu bar. (1) Press F10, then use -> or <- cursor keys. (2) Press ALT and an appropriate letter key simultaneously. For example, press ALT-S to access the Symbol menu and ALT-A to access the mAcro menu. Press Esc to exit from the menu bar. Command-Line Control Keys: F1: Help F10: Go to the main menu bar F2 to F9: Assignable from Macro:Key Alt-F1 to -F10: Assignable from Macro:Key Shift-F1 to -F10: Assignable from Macro:Key Esc: Abort operation Ctrl-G: Increase size of dialog window (grow) Ctrl-T: Decrease size of dialog window (tiny) Up-Arrow: Enter command history window Ins: Toggle insert mode Del: Delete a character Alt-0 to Alt-9: Enter window 0 to 9; 0 is the command-line Alt-X: Exit the debugger Commands: Command keywords that are longer than 3 letters may be uniquely specified by their first three characters or the letters shown in upper case. The HELp command gives detailed command descriptions. ! (invoke shell), # (symbol operator), ## (procedure operator), $ (module operator), & (address operator), // (specify comment), : (invoke macro or define label), :: (line continuation), ? (evaluate expression), @ (read command file), B, BEEp, BINary, BREak, BYTe, CALlstack, CASe, CAUse, CHAr, CLOse, CODe, COMpare, CONtinue, COPy, CRRepeat, DASm, DECimal, DEFault, DIRectory MACro, DIRectory MODule, DIRectory STRucture, DISplay MACro, DISplay STRucture, DISplay TRAce, DOUble, DOWn, DT, DWOrd, EDit, EFOr, EGA, EIF, ELSe, EMAcro, ENV, ESCape, ESWitch, EVAluate or ?, EWHile, EXIt, FINd, FLAg, FLIp, FLOat, FOR, FREe, GDT, GLObal, Go, GOTo, HALt, HELp, HEXadecimal, HOMe, IDT, IF, INClude or @, INPut, JOUrnal, KEEpheap, LDT, LINe or L, LiNEar or LNE, LISt, LOAd, LOCal, MACro, MEMory, MLIst, NO JOUrnal, NO LISt, NO MLIst, NUMber, OCTal, OPEn, ORIf, OUTput, PAUse, PD, PHYsical, PLIne or P, POInter, PROlog, PSTep or PS, PUT, QUIt, QWOrd, R287, R387, RADix, REAd, REGister, RELoad, REMove MACro, REPeat, RERun, RESet, RUN, SENsitive, SET, SOUrce, SPAth, STEp or S, STRucture, SWItch, SYMbol, TIMe, TRAce, TREal, TSS, TYPe, UNTil, UP, USC, USE or WIDth, VeRiFy, VERsion, VIEw, WAIt, WHIle, WIDth, WORd, WRIte *SOURCE WINDOW The source window allows you to browse through source code or disassembly while stepping through your code. F1: Help F2: Read source for the routine called at the cursor F3: Select format (asm/source/mix, numbers on/off, code on/off) F4: View program output screen F5: Toggle breakpoint at the cursor position F6: Execute to the cursor position F7: Execute one statement F8: Execute one procedure call or statement F9: Search the window for a pattern F10: Go to the main menu bar Alt-0 to -9: Enter window 0 to 9 Alt-G: View at a new position (specify address, line, or symbol) Alt-X: Exit the debugger Ctrl-G: Increase size of dialog window (grow) Ctrl-T: Decrease size of dialog window (tiny) Esc: Return to the home window cursor keys: Move within the window other keys: Enter a command on the command line *DIALOG WINDOW The dialog window holds all command input and output. Use the LIST command to redirect its contents to a file. F1: Help F9: Search the window for a pattern F10: Go to the main menu bar Alt-0 to -9: Enter window 0 to 9 Alt-X: Exit the debugger Ctrl-G: Increase size of dialog window (grow) Ctrl-T: Decrease size of dialog window (tiny) Esc: Return to the home window cursor keys: Move within the window *HISTORY WINDOW The history window holds all entered commands. Use the JOURNAL command to redirect its contents to a file. F1: Help F9: Search the window for a pattern F10: Go to the main menu bar Alt-0 to -9: Enter window 0 to 9 Alt-X: Exit the debugger Ctrl-G: Increase size of dialog window (grow) Ctrl-T: Decrease size of dialog window (tiny) Enter: Select the command line to be recalled Esc: Return to the home window cursor keys: Move within the window *CTRACE WINDOW CallStack gives a list of currently active functions and their arguments. F1: Help F2: Return to the home window, leaving this window open F3: Display local variables for the selected scope F9: Search the window for a pattern F10: Go to the main menu bar Alt-0 to -9: Enter window 0 to 9 Alt-L: Move or resize the window (change the Look) Alt-X: Exit the debugger Enter: Select the scope for source and local variable access Esc: Return to the home window cursor keys: Move within the window *RTRACE WINDOW RunTrace displays collected trace information. F1: Help F2: Return to the home window, leaving this window open F3: Enable or disable tracing F4: Select display format (source or disassembly) F5: Clear the trace buffer F9: Search the window for a pattern F10: Go to the main menu bar Alt-0 to -9: Enter window 0 to 9 Alt-G: Go to a specific frame Alt-L: Move or resize the window (change the Look) Alt-X: Exit the debugger Enter: Select a frame for contextual display in the Source window Esc: Return to the home window cursor keys: Move within the window *REGISTER WINDOW The register window displays and allows editing of the current register values and descriptor tables. F1: Help F2: Return to the home window, leaving this window open F3: Choices of other registers or tables to display F10: Go to the main menu bar Alt-0 to -9: Enter window 0 to 9 Alt-L: Move or resize the window (change the Look) Alt-X: Exit the debugger Esc: Return to the home window cursor keys: Move within the window *REG OPTIONS ┌───┐ │387 ── 80387 Numeric Data Processor │Gdt ── Global Descriptor Table │Idt ── Interrupt Descriptor Table │Ldt ── Local Descriptor Table │Pd ─── Page Directory │Tss ── Task State Segment └───┘ *PRE MEMORY Enter the address (virtual, linear, physical, or symbolic) for memory display. *MEMORY SCROLLABLE The memory window displays and allows the editing of memory values in any of several format and size combinations. Multiple memory windows can be active at any time. F1: Help F2: Return to the home window, leaving this window open F3: Select the display format F4: Select the memory object size F9: Search memory for a pattern F10: Go to the main menu bar Alt-0 to -9: Enter window 0 to 9 Alt-G: Go to a new memory address Alt-L: Move or resize the window (change the Look) Alt-X: Exit the debugger Esc: Return to the home window cursor keys: Move within the window *FORMAT CLIST ┌────────┐ │Hex ────── Display as base-16 unsigned values -- Byte shows ASCII too │Octal ──── Display as base-8 unsigned values │Decimal ── Display as base-10 signed values │Binary ─── Display as base-2 unsigned values │Real ───── Display as 32-bit single precision floating-point values │Double ─── Display as 64-bit double precision floating-point values │Ten-Byte ─ Display as 80-bit extended precision floating-point values └────────┘ *SIZE CLIST Select the size to display Hex, Octal, Binary or Decimal formatted memory: ┌─────┐ │Byte ── 8-bit -- when in Hex format, ASCII will also be displayed │Word ── 16-bit │Dword ─ 32-bit │Qword ─ 64-bit └─────┘ *MEMORY GO TO Enter the new address (virtual, linear, physical, or symbolic) for memory display. *MEMORY SEARCH Enter a list of values or a string to be searched for in memory starting at the displayed location and ending at the end of the segment. *BREAKPOINT WINDOW The breakpoint window displays and allows the editing of execution breakpoints. F1: Help F2: Return to the home window, leaving this window open F3: Enable or disable the highlighted breakpoint F10: Go to the main menu bar Enter: Edit the highlighted breakpoint Ins: Add a new breakpoint Del: Remove the highlighted breakpoint cursor keys: Move within the window Alt-0 to -9: Enter window 0 to 9 Alt-L: Move or resize the window (change the Look) Alt-X: Exit the debugger Esc: Return to the home window *BREAKPOINT DEFINE WINDOW ┌─────────────────────────┐ │ ADDRESS:───── the code or memory address of interest │ TYPE:───┐ (may be virtual or linear address, symbol, or line number) │ COUNT:──┐└─ the address access type │CONDITION:─┐│ (may be executable, memory read/write, or memory write) │ ACTION:┐│└── the number of events before the breakpoint is triggered └──────────│└─── a condition which must be satisfied before breaking │ (may be any valid C integer expression) └──── a command to be executed after hitting the breakpoint (may be a simple command or a macro invocation) *BREAKPOINT DEFINE CLIST ┌───┐ │EXE ── Break before execution at this address │R/W ── Break after a read or write to this address │WRI ── Break after a write to this address └───┘ *MENU HELP Menu Descriptions: O/S: DOS related operations Debug: Special debugging features Execute: Program execution mAcro: Macro processing Memory: Memory display/edit Window: Window management Register: Register display/edit Config: Debugger configuration Symbol: Symbol display/edit F1-Help: Confusion alleviation *OS MENUS ┌────────────┐ │ Version ────── Display debugger version number │ Time ───────── Display the current time and date │ O/S Shell ──── Start-up a DOS shell │ Exit ───────── Exit the debugger └────────────┘ *EXECUTE MENUS ┌────────────────┐ │ Load... ───────── Load a program to be debugged │ Run... ────────── Specify program arguments and run │ Step ──────────── Execute an instruction (into calls) │ Pstep ─────────── Execute an instruction (through calls) │ Line ──────────── Execute a statement (into calls) │ Pline ─────────── Execute a statement (through calls) │ Go ────────────── Go with breakpoints enabled │ Go Forever ────── Go without breakpoints enabled │ Go till ... ───── Go until some address │ Go till Return ── Go until the current procedure returns │ Go till Call ──── Go until a new procedure is active └────────────────┘ *MEMORY MENUS *REGISTER MENUS *SYMBOL MENUS ┌──────────┐ │ Evaluate ── Evaluate an expression │ Examine ─── Examine, watch, or trace a symbol │ Modules ─── List the names of all modules and source files │ Globals ─── Display all global symbols │ Locals ──── Display currently active local variables │ Structs ─── Display defined structures └──────────┘ *PRE SYMBOL Enter the symbol or lvalue to be examined. *SYMBOL EXAM The Symbol:Examine window displays and allows the editing, watching and tracing of symbols or lvalues (assignable expressions). Tracing collects the values written to a location and the code addresses at which the writes occurred. F1: Help F2: Return to the home window, leaving this window open F4: Follow (dereference) the highlighted pointer F5: Change the display format of the symbol value F10: Go to the main menu bar Enter: Edit the highlighted symbol cursor keys: Move within the window Alt-0 to -9: Enter window 0 to 9 Alt-L: Move or resize the window (change the Look) Alt-X: Exit the debugger Esc: Return to the home window *SYM FORMAT CLIST ┌────────┐ │Hex ────── Display as a base-16 unsigned value │Octal ──── Display as a base-8 unsigned value │Decimal ── Display as a base-10 signed value │Unsigned ─ Display as a base-10 unsigned value │Real ───── Display as a floating-point value │ASCII ──── Display as an ASCII character or C-style octal character └────────┘ *SYM DIR This window displays a list of symbols or modules. F1: Help F9: Search for a symbol F10: Go to the main menu bar cursor keys: Move within the window Alt-0 to -9: Enter window 0 to 9 Alt-X: Exit the debugger Esc: Return to the home window *SYMBOL DIR SEARCH Enter a search pattern. *SYM STRUCT The Symbol:Structs window displays the names of all tagged structs and unions and allows the display of their definitions. F1: Help F10: Go to the main menu bar Enter: Select a struct definition for display cursor keys: Move within the window Alt-0 to -9: Enter window 0 to 9 Alt-X: Exit the debugger Esc: Return to the home window *SYM A STRUCT The Struct window displays a structure template. F1: Help F9: Search F10: Go to the main menu bar cursor keys: Move within the window Alt-0 to -9: Enter window 0 to 9 Alt-X: Exit the debugger Esc: Return to the Symbol:Structs window *SYM MODULE The Symbol:Modules window displays the names of all modules in the program and allows the display of symbols defined within each module. F1: Help F10: Go to the main menu bar Enter: Select a module for which symbols will be displayed cursor keys: Move within the window Alt-0 to -9: Enter window 0 to 9 Alt-X: Exit the debugger Esc: Return to the home window *SYM MOD SYM The Module:Symbols window displays all of the symbols defined within a given module. F1: Help F9: Search for a symbol F10: Go to the main menu bar cursor keys: Move within the window Alt-0 to -9: Enter window 0 to 9 Alt-X: Exit the debugger Esc: Return to the Symbol:Modules window *DEBUG MENUS ┌─────────────┐ │ BreakPoints ── Set or display execution breakpoints │ CallStack ──── Display the currently active procedures │ RunTrace ───── Display the execution trace buffer └─────────────┘ *MACRO MENUS ┌────────┐ │ Edit ──── Edit or create a macro definition │ Invoke ── Invoke a macro │ Save ──── Save a macro definition in a file │ Load ──── Load a macro definition from a file │ Dir ───── List the names of all defined macros │ Remove ── Remove a macro definition │ Key ───── Define keyboard macros -- Also see the JOURNAL KEYBOARD command └────────┘ *MACRO EDIT Enter the name of the macro definition to be created or edited. *MACRO INVOKE Enter the name of the macro to be invoked. *MACRO LOAD Enter the name of the file containing the macro definition(s) to be loaded. *MAC DIR The Macro:Directory window displays a list of all macros and allows the display of any macro body. F1: Help F10: Go to the main menu bar Enter: Select a macro to be displayed cursor keys: Move within the window Alt-0 to -9: Enter window 0 to 9 Alt-X: Exit the debugger Esc: Return to the home window *MAC DISPLAY The Macro:Display window displays and allows the change of a macro body. F1: Help F2: Edit the macro body F10: Go to the main menu bar Enter: Select a macro to be displayed cursor keys: Move within the window Alt-0 to -9: Enter window 0 to 9 Alt-X: Exit the debugger Esc: Return to the Macro:Directory window *MACRO DISPLAY Enter the name of the macro definition to be displayed. *MACRO REMOVE Enter the name of the macro definition to be removed. *MACRO SAVE Saves the specified macro(s) in the specified text file. If the Macro Name field is left blank, all macros in the macro directory will be written to the text file. *MACRO MLIST ON displays the macro body during macro expansion. OFF inhibits the display. *WINDOW MENUS ┌─────────────┐ │ Select ─────── Select the a window to become active │ Dump ───────── Dump a window's contents to a file │ Resize/Move ── Select a window to resize or move └─────────────┘ *CONFIG MENUS ┌──────────────────────┐ │ Save Configuration ──── Save the current configuration │ Case Sensitivity ────── Enable/disable case sensitive symbol access │ Module <-> File ─────── Associate a source file with a module │ EGA-43/VGA-50 Line ──── Enable/disable "tall" display mode │ Input Radix ─────────── Set the default input radix │ Source Path ─────────── Set/display the search path for source files │ Source Window Format ── Set the display format for the source window │ Macro Listing ───────── Enable/disable macro expansion listing │ Error Beep ──────────── Enable/disable beeping on errors │ Journal File ────────── Specify a journal file │ List File ───────────── Specify a list file └──────────────────────┘ *HOST LOAD Loads an 80386 DOS extender program module into memory for debugging. Examples: test1 \project\test.exp *HOST INCLUDE Executes commands from the specified text file. Commands are executed one at a time. Each text line should contain only one command. Examples: autotest.inc \project\combo.cmd *OPTION CAPITAL ON makes symbolic reference case sensitive. OFF makes symbolic reference case insensitive. Startup default is OFF. *OPTION JOURNAL Records all input commands in the specified text file. The text file may be used as an include file in a later debug session. Examples: testcmd.txt \project\test\test.cmd *OPTION LIST Records all screen display in the specified text file. The text file provides a history of the debug session. Examples: session.log \project\log\test.log *OPTION VIEW ┌─────────────┐ │High Level ───── Display trace as source statements │Assembly ─────── Display trace as assembler mnemonics │Mixed ────────── Display both source and assembly │Line numbers ─── Enable or disable the display of line numbers │Code display ─── Enable or disable the display of object code └─────────────┘ *OPTION LINENUM ON displays line numbers on Source Window. OFF inhibits the display. *OPTION CODE ON displays object code on Source Window. OFF inhibits the display. *OPTION BEEP ON enables beeping on errors. OFF inhibits beeping. *SETUP EGA EGA ON enables 43-line display mode on EGA monitor, or 50-line display mode on a VGA monitor. EGA OFF returns to 25-line display mode. *SETUP KEYMACRO The Macro:Key window allows strings to be assigned to function keys for use on the command-line. Strings can be assigned to F2 through F9, Shift-F1 through Shift-F10, and Alt-F1 through Alt-F10. The key definitions can be saved in an environment file using the ENV command. F1: Help F10: Accept changes Enter: Go to next field cursor keys: Move within the window Alt-0 to -9: Enter window 0 to 9 Alt-X: Exit the debugger Esc: Return to the home window *INFO EVAL Evaluates an expression. Full C expression syntax is supported. Defined symbol names may be used in the expression as well as names of the registers and flags. Examples: ++count 1fh + 77q + 101y + 98t '<' count + 8 *RTRACE SEARCH Enter a pattern for a textual search. *RTRACE GOTO Enter a trace frame number as a new position. Frame 0 refers to the last instruction executed; frame -1 refers to the next to last, etc. *RTRACE FORMAT ┌────────────┐ │High Level ──── Display trace as source statements │Assembly ────── Display trace as assembler mnemonics │Mixed ───────── Display both source and assembly │Code display ── Enable or disable the display of object code └────────────┘ *CTRACE SEARCH Enter a pattern for a textual search. *DUMP FILE Enter the name of the file to which the window image will be saved. *SELECT WINDOW The Window:Select window presents a list of windows from which a new active window may be selected. Return: Select the window to be made active Esc: Return to the home window cursor keys: Move within the window *DUMP WINDOW The Window:Dump window presents a list of windows from which one may be selected for a "snapshot." The displayed contents of that window will be saved in the specified file. Return: Select the window to dump Esc: Return to the home window cursor keys: Move within the window *MOVE WINDOW The Window:Move window presents a list of windows from which one may be chosen to resize or move. Once in the move/select mode, cursors move the window, Ctrl-cursors shrink the window, Shift- or Alt-cursors enlarge the window, Return or F10 accepts the new window size/position, and Esc cancels the change. Return: Select the window to be moved or resized Esc: Return to the home window cursor keys: Move within the window *WINDOW DRAG You are now in window move/resize mode. F1: Help F10: Accept the new size/position Enter: Accept the new size/position cursor keys: Move the window Ctrl-cursor: Shrink the window in the specified direction Alt-cursor: Enlarge the window (for separate cursor keypad) Shift-cursor: Enlarge the window (for numeric keypad) Esc: Cancel the changes *EXECUTE RUN Enter the arguments to the program. Arguments should be separated by white-space. *GOTIL EXEC Enter an address (virtual, linear, physical, symbolic, or a line number). Examples: cs:100h // virtual 100hn // linear 100hp // physical foo // symbolic #27 // line number *SOURCE PATH Enter the semi-colon separated directory list to be used for source file access. *CONFIG ENV Enter the name of the environment file. Normally, this would be MDB.ENV unless changed by the MDBENV DOS environment variable. *PROGRAM MODSET Enter the module name and the source file to be associated with the module. *OPTION RADIX ┌────────┐ │Hex ────── Make hexadecimal the default input radix │Decimal ── Make decimal the default input radix │Octal ──── Make octal the default input radix │Binary ─── Make binary the default input radix └────────┘