Liren Large Software Subsidy 7

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

/ Liren Large Software Subsidy 7 / 07.iso / c / c221 / 2.ddi / MWHC.002 / 6 < prev next >

Wrap

Text File | 1992-03-24 | 25.6 KB | 660 lines

# # MDB/386X Menu/Window Help # # @(#)help.txt 1.21 12/3/91 14:41:29 # *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: Clear the command line Ctrl-G: Increase size of dialog window (grow) Ctrl-T: Decrease size of dialog window (tiny) Left-Arrow Move left one character Right-Arrow Move right one character 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, BINary, BREak, BYTe, CALlstack, CASe, CAUse, CHAr, CLOse, COMpare, CONtinue, COPy, CW, DASm, DECimal, DEFault, DIRectory MACro, DIRectory MODule, DIRectory STRucture, DISplay MACro, DISplay STRucture, DISplay TRAce, DOUble, DOWn, DT, DWOrd, EDit, EFOr, EIF, ELSe, EMAcro, ENV, ESCape, ESWitch, EWHile, EXAmine EXIt, FINd, FLAg, FLOat, FOR, FREe, GDT, GLObal, Go, GOTo, HALt, HELp, HEXadecimal, IDT, IF, INClude or @, INPut, IStep, JOUrnal, LDT, LiNEar or LNE, LISt, LOAd, LOCal, MACro, MEMory, NO JOUrnal, NO LISt, OCTal, OPEn, ORIf, OUTput, PD, PHYsical, POInter, PUT, QUIt, QWOrd, R287, R387, REAd, REGister, RELoad, REMove MACro, REPeat, RERun, RESet, RUN, SCReen, SET, SHOw, SOUrce, ST, STEp or S, STRucture, SWItch, SYMbol, TIMe, TRAce, TREal, TSS, TW, TYPe, UNTil, UP, USE or WIDth, 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: Find 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 (Step) F8: Execute one procedure call or statement (Step Into) 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 back through 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 back through 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, closing this window 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, leaving this window open cursor keys: Move within the window *RTRACE WINDOW RunTrace displays collected trace information. F1: Help F2: Return to the home window, closing this window F3: Enable or disable tracing F4: Select display format (source or disassembly) F5: Clear the trace buffer F9: Search back through 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, leaving this window open cursor keys: Move within the window *REGISTER WIN The register window displays and allows editing of the current register values. F1: Help F2: Return to the home window, closing this window 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, leaving this window open cursor keys: Move within the window *REGISTER MENUS ┌───┐ │386 ── 80386 CPU Registers │387 ── 80387 Numeric Data Processor │Gdt ── Global Descriptor Table │Idt ── Interrupt Descriptor Table │Ldt ── Local Descriptor Table │Pd ─── Page Directory │Tss ── Task State Segment └───┘ *REGISTER X87 The numeric data processor window displays and allows editing of the current register values. F1: Help F2: Return to the home window, closing this window F3: Select register value format (Float/Hex) 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, leaving this window open cursor keys: Move within the window *X87 FORMAT ┌─────┐ │Float ── Floating Point │Hex ── Hexadecimal └─────┘ *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, closing this window 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, leaving this window open 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, closing this window 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, leaving this window open *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 │ OS shell ───── Start-up a DOS shell │ Edit... ────── Edit a text file (see Config:Editor) │ Browse... ──── Browse a module in the Source window │ Exit ───────── Exit the debugger └────────────┘ *EXECUTE MENUS ┌────────────────┐ │ Run... ────────── Specify program arguments and run │ Load... ───────── Load a program to be debugged │ Step ──────────── Execute a statement (through calls) │ Istep ─────────── Execute an instruction (through calls) │ Step into ─────── Execute a statement (into calls) │ Istep into ────── Execute an instruction (into 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 *SYMBOL MENUS ┌──────────┐ │ Examine ─── Examine a symbol or evaluate an expression │ 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 F9: Search for a struct 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 F9: Search for a module 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 │ Call stack ─── Display the currently active procedures │ Trace ──────── 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 │ Function keys... ───── Define keyboard macros └─────────────────┘ *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 │ Toggles ────────────────────── Enter the toggles submenu │ Module source filenames... ─── Associate a source file with a module │ Journal file... ────────────── Specify a journal file │ List file... ───────────────── Specify a list file │ Input radix ────────────────── Set the default input radix │ Home window ────────────────── Set the default control window │ Source file path... ────────── Set the search path for source files │ Help file directory... ─────── Set the directory for help files │ Temporary file directory... ── Set the directory for temporary files │ Editor... ──────────────────── Set the macro/text file editor │ Tab size... ────────────────── Set the tab expansion size └─────────────────────────────┘ *TOGGLE MENUS ┌──────────────────────────────┐ │ Case sensitive search ───────── Toggle case sensitive symbol access │ List macro expansion ────────── Toggle macro expansion listing │ Beep on error ───────────────── Toggle beeping on errors │ Automatically execute prolog ── Toggle auto-execution of function prologs │ Repeat command on <Enter> ───── Toggle auto-repeating of last command │ Expression reevaluation ─────── Toggle reevaluation of watched expressions │ Verify memory access ────────── Toggle limit checking on memory access │ Symbolic disassembly ────────── Toggle symbol listing in disassembly │ Object code in disassembly ──── Toggle object code listing in disassembly │ Number source lines ─────────── Toggle source line number listing │ Start at main ───────────────── Toggle auto-execution of start-up code │ Pause in full dialog window ─── Toggle pausing after full dialog window │ VGA-50/EGA-43 line mode ─────── Toggle "tall" display mode │ Flip screens on execution ───── Toggle auto-display of user screen │ Tandem monitor mode ─────────── Toggle dual-monitor debugging │ C++ features ────────────────── Toggle C++ features └───────────────────────────┘ *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 ┌─────────────┐ │Source ───────── 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 ┌────────────┐ │Source ──────── 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. *CONFIG 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 └────────┘ *CONFIG HOME ┌────────┐ │Command ── Return to the command-line after an action │Source ─── Return to the Source window after an action └────────┘ *GENERIC STR Enter a string. *GENERIC INT Enter an integer value.