HP IA-64, Ski Simulator manual XSki File, Summary of Flags

Page 35

Ski IA-64 Simulator Reference Manual 1.0L

standard Linux fashion. The Ski command line syntax is shown below. The -i, -rest, -icnt, and -statsflags can appear in any order.

ski [-help][-ifilename ] [-restfilename ] [program_filename [args]+]

xski [-help][-noconsole][-i

filename ] [-restfilename ] [program_filename [args]+]

bski [-help][-noconsole][-i

filename ] [-restfilename ] [-icntfilename ] [-stats] [program_filename

[args]+]

 

 

2.5.1.1

Summary of Flags

 

-help

 

 

A list of flags accepted by this variety of Ski ( ski, xski, or bski) is printed out. No other processing is done and Ski terminates.

-ifilename

The specified file is run as a command file before the first prompt to the user. If an program_filename is provided on the same command line, the program_filename is loaded before the command file is run. This provides a convenient way to load a program, initialize other machine state, and then turn control over to the user.

-icntfilename

For bski only: This flag specifies instruction counts should be saved in the specified file. For each kind of instruction executed during the simulation, the instruction count file shows five fields of information:

The instruction mnemonic

The total number of times the instruction was executed

The number of executions that were predicated on

The number of executions that were predicated off

The number of executions that were predicated on predicate register 0, which is “hardwired” on The value in the second field equals the sum of the values in the last three fields.

-noconsole

For xski and bski only: This flag tells Ski not to create a separate console window for the simulated program’s standard I/O. Instead, Ski will use the existing console window’s for standard I/O purposes in the simulated program.

-restfilename

Restore the simulator run saved in filename . See Section 8.6, “Saving and Restoring the Simulator State”. This flag cannot be combined with an program_filename . If combined with a -iflag, the -iflag is accepted and the -restflag is silently ignored.

-stats

For bski only: specifies execution run-time and instruction rate information should be send to standard out (stdout) at the end of the run. This information is normally displayed in the Main/Command Window of xski and ski. The -statsflag allows users of bski to get the same information.

2.5.2The XSki File

xski’s screen presentation is substantially controlled by the contents of the XSki file, which uses the X Window System’s resource mechanism to provide information to xski. You can edit this file to change xski’s use of graphic buttons, described in Section 3.7.1, “The xski Main Window”. The XSki file is part of the standard Ski distribution and you should put this file in your X Window System’s app-defaultsdirectory or in your home directory. If there is no valid XSki file, the simulator will not be usable. You can find more information on installing xski in the release notes that come with each Ski distribution.

Copyright © 2000 Hewlett-Packard Co.

Overview

2-5

Image 35
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 FileQuit expression Summary of the Quit CommandQuitting Ski Register Window Screen PresentationSki’s Use of Windows 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 Xski Main Window Command/Main WindowInvalid Code and the Data 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 OperatorsAddresses Symbolic ArgumentsProgram-Defined Symbols 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 ProgramsProgram Loading Misaligned Data Access TrapHow to Load a Program 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 Linux Application Environment Linux and MS-DOS ABI EmulationInterruptions Linux System Calls Accepted but Ignored by Ski Linux System Calls Supported by SkiMS-DOS System Calls in Hexadecimal Supported by Ski MS-DOS Application EnvironmentProgram I/O 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 BreakpointsBs address Summary of Program Breakpoint CommandsUnexpected Breakpoints 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 LabelsIf Command Comments in Command FilesAn Example Command File Label Summary of Command File Commandsfilename # commentSki 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