HP Ski Simulator, IA-64 manual Quit returnvalueforshell, Rest filename

Page 92

Ski IA-64 Simulator Reference Manual 1.0L

isyms [filename ]

Write internal symbols to the screen or to the file given by filename . See “Symbol Table Commands” on page 8-8.

load filename [args]+

Prepare for IA-64 application-mode simulation: Load the IA-64 ELF executable program file given by filename and prepare to pass the program args using the C language argc/argv parameter mechanism. See “How to Load a Pro- gram” on page 6-3.

pj [address]

Jump the Program Window display to the specified address. If no address is given, the window display changes to the previous location, providing a handy way to swap the display between two different parts of the program. See “Summary of Program Window Commands” on page 5-2.

pa

Display the program in assembly language format only. (IA-64 only) See “Summary of Program Window Com- mands” on page 5-2.

pb [count]

Move the Program Window backward count IA-64 bundles or IA-32 instructions, or one windowful less one bundle or instruction if no count is given. See “Summary of Program Window Commands” on page 5-2.

pd starting_address ending_address [filename ]

Dump memory to the screen or to the file given by filename . The range dumped is between starting_address and ending_address inclusive. The dump is formatted as disassembled instructions, without source code. See “Summary of Program Window Commands” on page 5-2.

pf [count]

Move the Program Window forward count IA-64 bundles or IA-32 instructions, or one windowful less one bundle or instruction if no count is given. See “Summary of Program Window Commands” on page 5-2.

pm

Display an IA-64 program in both source and assembly form. The source code file must be available to the simulator in the location recorded in the executable file when this command is issued. The source code is displayed for conve- nience; it cannot be modified or interacted with. Mixed display may not be useful if a high degree of optimization was applied during compilation. (IA-64 only) See “Summary of Program Window Commands” on page 5-2.

quit [return_value_for_shell]

Quit the simulator. If no return_value_for_shell is given, a zero value is returned to the shell. Return values are use- ful in shell script programming. See “Quitting Ski” on page 2-6.

run

Simulate the program. Using the C language argc/argv mechanism, Ski will pass the program a copy of the com- mand line parameters Ski received on its command line, or, if specified, the command line parameters provided with the load and iaload commands. See “Program Execution” on page 6-5.

rest filename

Restore the state of a simulated processor from the specified file and prepare to resume a suspended simulation. Only the registers and memory of the simulated processor are restored; state information private to the simulator such as cycle counts is not restored. See “Saving and Restoring the Simulator State” on page 8-8.

rf [count]

Moves the Register Window “forward” (scroll down) through the currently-displayed register set. The Register Win- dow is scrolled count lines. If count is omitted, the Register Window scrolls down one windowful less one line, i.e.

A-4 Command Reference

Copyright © 2000 Hewlett-Packard Co.

Page 91 Page 93
Image 92
Page 91 Page 93
Contents Ski IA-64 Simulator Reference Manual Copyright 2000 Hewlett-Packard CoPrinting History TrademarksHow to Use This Manual PrefaceFont Conventions Syntax 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 How to Run an IA-64 Application Program Getting Started a Ski TutorialSki Simulator Starting xskiStarting xski From the Command Line Exiting Ski Loading Your ProgramLoading the hello Program Inspecting Data Xski Data WindowChanging the Data Window Display Data Window Showing argv and envp Strings in Hexadecimal Viewing Data in Ascii Looking at CodeViewing Source Code Mixed In with Assembly Code 12. Jumping the Program Window to the Beginning of mainControlling Breakpoints 14. The Program Window Showing a Breakpoint at mainRunning a Program 15. The Breakpoint List WindowSingle-stepping a Program 16. The Terminal Window After the hello Program is RunChanging Registers and Memory 18. The Main Window After Reaching the Breakpoint at main+10Ski 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 Getting Help Next StepsCopyright 2000 Hewlett-Packard Co Overview IntroductionWhat You Need to Know to Use This Manual Defects and Defect ReportingUsing bski for Batch Simulations Ski VariationsX Window System, Motif-based xski Interface Command Line Flags Starting SkiXSki File 1.1 Summary of FlagsQuit expression Summary of the Quit CommandQuitting Ski Register Window Screen PresentationSki’s Use of Windows User Registers Pane Register Window in xskiGeneral Registers Pane Floating Point Registers PaneSystem Registers Pane IA-32 Registers PaneResizing Register Window Panes with xski Register Window and skiProgram Window 1 IA-64 Instruction DisplaySki IA-64 Simulator Reference Manual 1.0L 2 IA-32 Instruction Display Changing the Range of Locations Shown in the Program Window Invalid Code and the Program WindowData Window 12. xski’s Program Window Showing Illegal InstructionsChanging the Range of Locations Shown in the Data Window Xski Main Window Command/Main WindowInvalid Code and the Data Window Ski Command Window 16. xski’s Main Command Window17. ski’s Command Window at Bottom Other Windows18. xski’s Symbol List Window Copyright 2000 Hewlett-Packard Co Command Language Command EntryCommand Arguments Command Sequences, Repetition, and AbbreviationArgument Specification Numeric ArgumentsNumbers and Counts ExpressionsSki Simulator Arithmetic and Logic Operators Xski Evaluating ExpressionsAddresses Symbolic ArgumentsProgram-Defined Symbols Resolving Ambiguous Symbols and Numbers Internal VariablesLabels FilenamesSki IA-64 Simulator Reference Manual 1.0L Screen Manipulation Commands Register Window CommandsSummary of Register Window Commands Xski Register Window CommandsProgram Window Commands Summary of Program Window CommandsXski’s Program Window Showing IA-64 Assembly Language Code Xski’s Assembly Language Dump Window Pd startingaddress endingaddress filenameData Window Commands Summary of Data Window CommandsDj address Df countXski Showing Data in Raw Hexadecimal and Ascii Dd startingaddress endingaddress filenameProgram Simulation Application-Mode and System-Mode SimulationSki Support for Application-Mode Programs Ski Support for System-Mode ProgramsSummary of TLB Display Commands System-Mode IA-64 ProgramsSystem-Mode IA-32 Programs System-Mode TLB SimulationProgram Loading Misaligned Data Access TrapHow to Load a Program Summary of Program Loading Commands Load filename args+Adding Information after Loading Creating the argc, argv, and envp ParametersSummary of Program Execution Commands Program ExecutionSki IA-64 Simulator Reference Manual 1.0L Program Simulation Linux Application Environment Linux and MS-DOS ABI EmulationInterruptions Linux System Calls Supported by Ski Linux System Calls Accepted but Ignored by SkiMS-DOS System Calls in Hexadecimal Supported by Ski MS-DOS Application EnvironmentProgram I/O Copyright 2000 Hewlett-Packard Co Changing Registers and Memory with Assignment Commands Summary of Assignment CommandsExamples of Assignment Commands DebuggingOriginal Program Loaded in ski Bit-encoded Registers AllocationSummary of The eval Command Setting Program BreakpointsEvaluating Formulas and Formatting Data Program BreakpointsDeleting Program Breakpoints Listing Program BreakpointsBs address Summary of Program Breakpoint CommandsUnexpected Breakpoints Setting Data Breakpoints Summary of Data Breakpoint CommandsData Breakpoints Deleting Data BreakpointsSymbol Table Commands Summary of Save and Restore CommandsSummary of Symbol Commands Dumping Registers and Memory to a FileSymlist Output from xski Isyms filenameSki IA-64 Simulator Reference Manual 1.0L Debugging Command Files Labels and Control Flow in Command FilesGoto Command and Labels Initialization FileIf Command Comments in Command FilesAn Example Command File Summary of Command File Commands filename# comment LabelSki IA-64 Simulator Reference Manual 1.0L Command Files Command Reference =s address stringwithoutspacesDbs address length rwrw Dbd breakpointnumberHelp commandname Eval expressionwithoutspaces+Quit returnvalueforshell Rest filenameStep until expressionwithoutspaces Ski IA-64 Simulator Reference Manual 1.0L Register Names IA-64 RegistersRegister 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 Variable Names Internal VariablesCopyright 2000 Hewlett-Packard Co Simulator Status and Error Messages All breakpoints deletedSimulator 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
Top Page Image Contents