HP IA-64, Ski Simulator manual Eval expressionwithoutspaces+, Help commandname

Page 91

Ski IA-64 Simulator Reference Manual 1.0L

df [count]

Move the Data Window forward count lines or one windowful if no count is given. See “Data Window Commands” on page 5-5.

dh

Display Data Window contents in hexadecimal format. See “Data Window Commands” on page 5-5.

eval expression_without_spaces+

Evaluate one or more expression_without_spaces and print the result in an appropriate format, typically hexadecimal and/or decimal, or symbolically. An expression_without_spaces can include numbers, registers, internal variables, program-defined symbols, operators, and parentheses for grouping. See “Evaluating Formulas and Formatting Data” on page 8-4.

fr

ski: Show the floating point registers in the Register Window. See “Register Window Commands” on page 5-1.

xski: Toggle the display of the floating point registers pane. See “Register Window Commands” on page 5-1.

goto label

Causes execution to continue following the first line in the file which contains the label. Goto’s may be forward or backward. Goto’s are valid only in command files. See “The goto Command and Labels” on page 9-1.

gr

ski: Show the general registers in the Register Window. See “Register Window Commands” on page 5-1.

xski: Toggle the display of the general registers pane. See “Register Window Commands” on page 5-1.

help [command_name]

Display a list of the commands Ski recognizes, or, if a command_name is specified, a syntax description for that command. See “Command Entry” on page 4-1.

iar

ski: Show the IA-32 registers in the Register Window. See “Register Window Commands” on page 5-1.

xski: Toggle the display of the IA-32 registers pane. See “Register Window Commands” on page 5-1.

iabs [address]

Set IA-32 breakpoint at address or at the current value of ip if address is omitted. (IA-32 code only) See “Setting Program Breakpoints” on page 8-4.

iaload filename address [mapfile [args]+]

Prepare for IA-32 application-mode simulation: Load an IA-32 executable file ( .com or .exe) and prepare to pass the program args using the MS-DOS command line parameter mechanism. address specifies where to load the pro- gram. mapfile provides Ski with the mapping between program-defined symbols and their addresses and must spec- ify an ASCII text file exactly compatible with mapfiles produced by the Microsoft “ML” linker. See “How to Load a Program” on page 6-3.

if expression_without_spaces true_command [: false_command]

Execute true_command if the expression_without_spaces evaluates to a non-zero value, false_command if it evalu- ates to zero. See “The if Command” on page 9-2.

Copyright © 2000 Hewlett-Packard Co.

Command Reference A-3

Image 91
Contents Copyright 2000 Hewlett-Packard Co Ski IA-64 Simulator Reference ManualTrademarks Printing HistorySyntax Conventions How to Use This ManualPreface Font ConventionsItalic+ Table of Contents Ski IA-64 Simulator Reference Manual Vii Ski IA-64 Simulator Reference Manual Viii Table of Contents List of Figures Ski IA-64 Simulator Reference Manual 1.0L List of Tables Ski IA-64 Simulator Reference Manual 1.0L Xii List of Tables Starting xski How to Run an IA-64 Application ProgramGetting Started a Ski Tutorial Ski SimulatorStarting xski From the Command Line Loading Your Program Exiting SkiLoading the hello Program Xski Data Window Inspecting DataChanging the Data Window Display Data Window Showing argv and envp Strings in Hexadecimal Looking at Code Viewing Data in Ascii12. Jumping the Program Window to the Beginning of main Viewing Source Code Mixed In with Assembly Code14. The Program Window Showing a Breakpoint at main Controlling Breakpoints15. The Breakpoint List Window Running a Program16. The Terminal Window After the hello Program is Run Single-stepping a Program18. The Main Window After Reaching the Breakpoint at main+10 Changing Registers and MemorySki IA-64 Simulator Reference Manual 1.0L 20. The xski Register Window After Changing the ip Register 21. The xski Data Window Widened to Show Ascii Next Steps Getting HelpCopyright 2000 Hewlett-Packard Co Defects and Defect Reporting OverviewIntroduction What You Need to Know to Use This ManualSki Variations Using bski for Batch SimulationsX Window System, Motif-based xski Interface Starting Ski Command Line Flags1.1 Summary of Flags XSki FileQuitting Ski Summary of the Quit CommandQuit expression Ski’s Use of Windows Screen PresentationRegister Window Register Window in xski User Registers PaneFloating Point Registers Pane General Registers PaneIA-32 Registers Pane System Registers PaneRegister Window and ski Resizing Register Window Panes with xski1 IA-64 Instruction Display Program WindowSki IA-64 Simulator Reference Manual 1.0L 2 IA-32 Instruction Display Invalid Code and the Program Window Changing the Range of Locations Shown in the Program Window12. xski’s Program Window Showing Illegal Instructions Data WindowChanging the Range of Locations Shown in the Data Window Invalid Code and the Data Window Command/Main WindowXski Main Window 16. xski’s Main Command Window Ski Command WindowOther Windows 17. ski’s Command Window at Bottom18. xski’s Symbol List Window Copyright 2000 Hewlett-Packard Co Command Sequences, Repetition, and Abbreviation Command LanguageCommand Entry Command ArgumentsExpressions Argument SpecificationNumeric Arguments Numbers and CountsXski Evaluating Expressions Ski Simulator Arithmetic and Logic OperatorsProgram-Defined Symbols Symbolic ArgumentsAddresses Filenames Resolving Ambiguous Symbols and NumbersInternal Variables LabelsSki IA-64 Simulator Reference Manual 1.0L Xski Register Window Commands Screen Manipulation CommandsRegister Window Commands Summary of Register Window CommandsSummary of Program Window Commands Program Window CommandsXski’s Program Window Showing IA-64 Assembly Language Code Pd startingaddress endingaddress filename Xski’s Assembly Language Dump WindowDf count Data Window CommandsSummary of Data Window Commands Dj addressDd startingaddress endingaddress filename Xski Showing Data in Raw Hexadecimal and AsciiSki Support for System-Mode Programs Program SimulationApplication-Mode and System-Mode Simulation Ski Support for Application-Mode ProgramsSystem-Mode TLB Simulation Summary of TLB Display CommandsSystem-Mode IA-64 Programs System-Mode IA-32 ProgramsHow to Load a Program Misaligned Data Access TrapProgram Loading Creating the argc, argv, and envp Parameters Summary of Program Loading CommandsLoad filename args+ Adding Information after LoadingProgram Execution Summary of Program Execution CommandsSki IA-64 Simulator Reference Manual 1.0L Program Simulation Interruptions Linux and MS-DOS ABI EmulationLinux Application Environment Linux System Calls Accepted but Ignored by Ski Linux System Calls Supported by SkiProgram I/O MS-DOS Application EnvironmentMS-DOS System Calls in Hexadecimal Supported by Ski Copyright 2000 Hewlett-Packard Co Debugging Changing Registers and Memory with Assignment CommandsSummary of Assignment Commands Examples of Assignment CommandsOriginal Program Loaded in ski Allocation Bit-encoded RegistersProgram Breakpoints Summary of The eval CommandSetting Program Breakpoints Evaluating Formulas and Formatting DataListing Program Breakpoints Deleting Program BreakpointsUnexpected Breakpoints Summary of Program Breakpoint CommandsBs address Deleting Data Breakpoints Setting Data BreakpointsSummary of Data Breakpoint Commands Data BreakpointsDumping Registers and Memory to a File Symbol Table CommandsSummary of Save and Restore Commands Summary of Symbol CommandsIsyms filename Symlist Output from xskiSki IA-64 Simulator Reference Manual 1.0L Debugging Initialization File Command FilesLabels and Control Flow in Command Files Goto Command and LabelsAn Example Command File Comments in Command FilesIf Command Label Summary of Command File Commandsfilename # comment Ski IA-64 Simulator Reference Manual 1.0L Command Files =s address stringwithoutspaces Command ReferenceDbd breakpointnumber Dbs address length rwrwEval expressionwithoutspaces+ Help commandnameRest filename Quit returnvalueforshellStep until expressionwithoutspaces Ski IA-64 Simulator Reference Manual 1.0L IA-64 Registers Register NamesRegister Names Copyright 2000 Hewlett-Packard Co Register Names B-3 Ski IA-64 Simulator Reference Manual 1.0L Copyright 2000 Hewlett-Packard Co Register Names B-5 Ski IA-64 Simulator Reference Manual 1.0L Register Names Internal Variables Internal Variable NamesCopyright 2000 Hewlett-Packard Co All breakpoints deleted Simulator Status and Error MessagesSimulator Status and Error Messages Expression Help Unknown command %s Missing ELF header Not an IA-64 file Stopping at %s due to unimplemented instruction Usage %s options file args