xds.err

VRTX 商用嵌入式实时操作系统

 class member.

 > browse cout
#h
 CEXPRESSION (C):
 CEXPRESSION expression

 The CEXPRESSION command calculates the value of any valid C 
 expression or assigns a value to a variable. The result is
 displayed in decimal, hexadecimal, and ASCII formats. The 
 ASCII representation is only displayed if the expression 
 value results in a printable ASCII character.  Functions 
 returning simple types may be used within an expression.

 > c count = 4
#h
 CLEAR (CL):
 CLEAR [breakpoint_number | breakpoint_number_range]

 The CLEAR command cancels one or more breakpoints previously
 set. When a breakpoint is set, the debugger automatically
 assigns it a breakpoint number. This number is used to clear
 a specific breakpoint.  Breakpoint numbers are displayed in
 the break viewport. If a breakpoint number is not specified,
 all breakpoints are canceled.

 > cl 5..7
#h
 COMPARE (COM):
 COMPARE [/R] [address_range, address]

 The COMPARE command examines the contents of two blocks of
 memory to determine their similarities or differences. The
 block of memory specified by 'address_range' is compared to
 the same size block starting at 'address'. Mismatched values
 and addresses are displayed in the command viewport. The
 COMPARE command terminates when a mismatch is found unless
 the '/R' qualifier is used, in which case it terminates at
 the end of the block.

 > com/r 21bch..+10h, 0x4000
#h
 CONTEXT (CON):
 CONTEXT [/F]

 The CONTEXT command shows the current scoping context. The
 context defines how symbol names will be interpreted. The
 '/F' qualifier is used to show the context of other roots.
 This command shows the same information as the PRINTSYMBOLS
 command with no arguments.

 > context/f
#h
 COPY (COP):
 COPY address_range, target_address

 The COPY command copies the contents identified by 
 'address_range' to a block of the same size starting at
 'target_address'. 

 > cop 21bch..+10h, 0x4000
#h
 DEFINE (DEF):
 DEFINE [/R][type] macro_name ([parameter_list])  

 The DEFINE command creates a macro with the name, result
 type and definition you specify. Once the DEFINE command is
 entered, the macro text prompt (colon) is displayed,
 indicating that the macro body can be entered. The macro 
 definition consists of all lines after the macro name and 
 before the terminating period.  Use the /R qualifier to
 replace an existing macro with the same name.

 [press RETURN to continue]
#h
 DEFINE (continued):

 > def int trace(vpnum)
 : int vpnum;
 : {
 :   dumpregs();
 :   stepcount--;
 :   $ fprintf vpnum,"%m  %05d\n",@pc,@cycles $;
 :   return (stepcount > 0); /* gostep halts at 0 */
 : } 
 : .
 > trace (28)
#h
 DELETE (DEL):
 DELETE {symbol_name | \ | \\ } [,y]

 The DELETE command removes the specified symbol from the 
 symbol table. To delete all symbols within a module or
 procedure, append a backslash [\] to the module or procedure
 name. Entering only a backslash deletes all symbols in all 
 modules of the current root, If a symbol name is specified
 without a module specification, the current module is
 assumed. Only program symbols and user-defined debugger 
 symbols can be deleted. Entering ,y after the symbol name
 provides automatic confirmation of the request.

 > del outchrx\c
#h
 DIN (DIN):
 DIN [port_address | port_address_range]

 The DIN command displays the value stored in the buffer of
 the specified input port(s). Each input port has a one value
 buffer associated with it.  If no parameters are specified,
 all input ports that have been declared are displayed with
 their port address, size, value, and data source.

 > din 2..3
#h
 DISASSEMBLE (D):
 DISASSEMBLE [address]

 The DISASSEMBLE command (assembly-level mode only) displays
 assembly code starting at the specified memory location. If
 you do not specify an address, memory is displayed beginning
 with the address pointed to by the program counter.

 > d 2000h
#h
 DOUT (DO):
 DOUT [port_address | port_address_range]

 The DOUT command displays the value stored in the buffer of
 the specified output port(s). Each output port has a one
 value buffer associated with it, which contains the last
 value written to the port. If no parameters are entered, all
 output ports that have been declared are displayed with
 their port addresses, sizes, values, and data destinations.

 > dout 2..3
#h
 DOWN (DOW):
 DOWN [number_of_levels]

 The UP and DOWN commands allow you to move the current scope
 up or down the runtime stack.  This is especially helpful
 when debugging recursive functions.  It is not a good idea
 to go down farther than you have gone up.

 > down 5
#h
 DUMP (DU):
 DUMP [/B | /W | /L] [address | address_range]

 The DUMP command displays memory contents in the command
 viewport in hexadecimal and ASCII formats. A non-printable
 ASCII character is represented by a period (.). Memory 
 contents are displayed in the size specified by one of the
 size flags (/B=BYTE, /W=WORD, /L=LONG). The default size is
 BYTE.

 > du/l 0x2000..+40h
#h
 ERROR (ER):
 ERROR [=] {QUIT | ABORT | CONTINUE}

 The ERROR command determines what action XRAY should take
 when an error occurs while reading an include file. If an
 error occurs, you can direct the debugger to do one of the
 following:
 QUIT     - exit the debugger when an error occurs.
 ABORT    - return to the command line. (Default).
 CONTINUE - continue onto the next command after an error.

 > er = cont
#h
 EXPAND (EXP):
 EXPAND [stack_level] [,viewport_number]

 The EXPAND command displays values of the parameters passed
 to a procedure, and the local variables in a procedure. To
 display a procedure's calling parameters and local
 variables, specify the procedure's 'stack_level' preceded by
 a commercial at sign (@). The current procedure is level @0,
 the caller is always @1, etc. If no arguments are given, all
 stack levels are shown.
 A viewport number may be given to write the information to
 a user defined viewport.

 > exp @2
#h
 FILL (FIL):
 FILL [/B | /W | /L] address_range [=expression | 
                                        =expression_string]

 The FILL command fills a range of memory locations indicated
 by 'address_range' with the value or values indicated by an
 expression(s) in an expression string. The size of the value 
 is determined by one of the size flags (/B=BYTE, /W=WORD, 
 /L=LONG). The default size is BYTE.

 > fill/w 0x4000..+10h = "abc",0
#h
 FIND (FIN):
 FIND [/B] string [,line_number]

 The FIND command searches a high-level source file for the 
 specified string. If you provide a line number, XRAY 
 searches for the string starting at the given line number. 
 Otherwise, the string search starts at the top of the code
 viewport. Non-alphanumeric characters in the specified
 string must be enclosed in double quotation marks. The B
 options causes a backwards search.

 > fin "port = c;", OUTCHRX\#4
#h
 FOPEN (FO):
 FOPEN [/A | /R] viewport_number, {"filename" | device_name}
 
 The FOPEN command opens a specified file or device and
 assigns a viewport number. The /A qualifier specifies
 opening the file or device for appending. The /R qualifier
 specifies opening the file for read-only.  After you have
 issued an FOPEN command, you can use the FPRINTF command
 to write debugging information to the file or device.
 Legal MS-DOS device names are AUX, COM1, COM2, CON, LST,
 PRN, LPT1, LPT2, LPT, and NUL.  Use of the CON (console)
 device is not recommended with FOPEN.
 
 > fo 101, "ref\tracerun"
#h
 FPRINTF (F):
 FPRINTF viewport_number, "format_string" [,argument...]

 The FPRINTF command prints formatted output to the viewport
 specified. Formatted output may be written to a file that 
 was specified by the FOPEN command. The FPRINTF command is
 identical to the C run-time fprintf function. Since FPRINTF
 uses the 'format_string' to determine the number of argu-
 ments to print, the number of conversion specifications must
 equal the number of arguments. The log file is viewport 28.

 > f 101, "Now at %m  %05d\n", @pc, @cycles
#h
 GO (G):
 GO [= start_address [,]] 
     [temp_break1 [%%passcount] [,] ...] [;macro_name]
 The GO command executes the target program until it
 encounters a permanent or temporary breakpoint, an error,
 a halt instruction, or a CONTROL-C from the keyboard.

 [Press RETURN to continue]
#h
 GO (continued):

 If a 'start_address' is not specified, execution begins at
 the current program counter address. 'temp_break' acts as
 a temporary instruction breakpoint, 'passcount' specifies
 the number of times the temporary breakpoint is executed 
 before the command actually halts; a macro, if specified,
 is invoked when the temporary break occurs.

 > g =2000h, 0x21bc%%4; trace()
#h
 GOSTEP (GOS):
 GOSTEP macro_name

 The GOSTEP command single-steps through program execution
 and invokes the specified macro on every instruction. The
 macro determines whether program execution continues or
 halts. Single-stepping is done by C source line in
 high-level mode and by microprocessor instruction in
 assembly-level mode.

 > gos trace()
#h
 HELP (H):
 HELP [topic]

 The HELP command displays the on-line help menu.  The help
 menu lists all supported debugger commands along with a
 short one-line description. Select help topics by moving the 
 cursor key to the desired command, or by typing the first 
 letter(s) of the desired topic.  In each case, press return
 once the cursor is on the chosen topic. To exit help, press 
 either the escape key (ESC) or the F5 function key.

 > help host
#h
 HISTORY (HI):
 HISTORY [prev_cmd]

 The history command displays all commands in the history
 buffer if given without arguments. If an argument is
 specified, the most recent command matching the string
 will be selected. This command is used in conjunction
 with the PREV_CMD key.

 > his
#h
 HOST (HO):
 HOST

 The HOST command temporarily leaves the XRAY debugging
 environment and creates a new host operating system command
 mode. In this mode, you may enter operating system commands.
 The HOST command does not terminate the debugger; it
 temporarily suspends program operation. To return to the
 debugger, exit from the host system (usually ^D, 'logout').

 > host
#h
 ICE (IC):
 ICE [command]

 Note: this command is used with emulators only. The ICE 
 command sets up a "dumb terminal" environment for entering
 the in-circuit emulator's internal commands. The XRAY 
 debugging is returned to with the NOICE command. If a 
 command argument is specified, only that ICE command is 
 executed; this allows include files and macros to execute 
 emulator commands.

 > ice
#h
 INCLUDE (INC):
 INCLUDE "filename"

 The INCLUDE command executes a group of commands that reside
 in the specified file as though they were entered from the
 keyboard. Commands in the specified file are executed until
 the end of the file is reached, at which point input
 continues from the previous source. Include files can be 
 automatically executed at startup by using the include
 command or the startup file. The default filetype is '.inc'. 

 > inc "ref\run14.log"
#h
 INPORT (INP):
 INPORT [/B | /W | /L] port_address [,input_source]

 The INPORT command specifies simulated input port and 
 enables you to specify the source of input data for that 
 port. The port address can be any valid address. The input
 port will read data from one of the following sources:

 [Press RETURN to continue]
#h
 INPORT (continued):

           c          - Command viewport
           std        - Standard I/O screen 
           f=filename - Specified file
           i[=value]  - Input buffer at same address
           o[=value]  - Output buffer at same address
           s="string" - Specified string
	   m=macro()  - specify macro call with args.

 > inp 2, o = 'c'