IAS:
User Commands

Type usage at the command line for online help.

General Notes

• IAS reads the commands in the file .iasrc in the current directory at startup.
• With Tcl, you can abbreviate commands to their unique prefixes (Tcl feature). IAS also supports other Tcl features, such as defining Tcl variables, command history, and so on.
• You can input numerical values either as decimals (default) or as hex numbers if they are prefixed by 0x, or as octal numbers if they are prefixed with 0.
• To stop a long-running simulation, press Control-C and return IAS to the prompt. To terminate IAS, press Control-C again.

Commands

bmemfile filename
Loads a binary memory file into the simulator in .binit file format. For details on the .binit file format, see the chapter, "Test Environment and Reset Code," in picoJava^TM-II Verification Guide.

configure
Configures the core for the I-Cache and D-Cache size and the FPU present or absent option. For example:

configure icache [0|1|2|4|8|16]
configure dcache [0|1|2|4|8|16]
configure fpu [present|absent]

cont
Continues execution of a program from the current PC.

dis
Disassemble instructions, starting from the current PC.

dsTrap trapName len
Disassembles a trap handler up to len bytes.

disAsmAddr address(%h)
Disassembles at address.

disAsm className methodName
Looks into picoJava^TM memory and looks for className and methodName; if disAsm finds them, it disassembles them. IAS is aware of some rules for the format of the class data structure, such as where it is stored in memory.

ds addr len
Disassembles instructions from addr to addr + len.

dumpClass [className]
Dumps the contents of className, including the constant pool, methods, attributes, and so on.

With no arguments, dumpClass dumps all the classes that have been loaded.

dumpDcache [line [count]]
dumpIcache [line [count]]
Performs a raw dump of the contents of the specified cache lines. With no arguments, successive dumpDcache or dumpIcache commands print the contents of successive lines.

dumpMethod className methodName
Dumps methodName in className.

dumpReg [regName]
Prints the contents of regName. With no arguments, dumpReg prints the contents of all the registers. (For the official names of the registers, refer to their dumps.)

dumpStack [depth]
Dumps the stack contents for depth words from the top of the stack. The default depth is 8.

dumpStats [filename]
Shows the statistics about the program IAS is running, which it maintains.

itrace [on|off|level]
Sets the tracing level (0 - 9); on = 3.

loadClass class1 class2 ...
Loads class files into memory. The loadClass command also loads class_name.init and class_name.binit files into memory if they are present.

loadCache path
Loads the contents of D$ and I$ RAMs from the files in the specified path.

loadRT
Loads a standard subset of runtime classes.

loadElf objFile1 objFile2 ...
Loads ELF files.

memfile filename
Loads a memory file in .init file format. See picoJava-II^TM Verification Guide for details.

memPeek address
Looks through the caches and displays the contents of a word at address.

memPeekDirect address
Ignores the caches and displays the contents of a word in main memory at address.

memPoke address data
Same as memPokeDirect.

memPokeDirect address data
Writes data into memory at address, bypassing caches.

memOR address data
OR's the data value with the data value at the memory location and writes it back.

readMemory address length
Looks up the caches and displays the program memory.

readMemoryDirect address length
Ignores the caches and displays main memory contents.

reset
Resets the processor.

restart filename
Restores the state of the simulator from a checkpoint file that was saved previously.

run [numOfSteps]
Starts running the program from PC 0 for numOfSteps of instructions. By default, runs till the program halts simulation by writing to END_ADDRESS.

run2 target_pc
Steps the simulator till it hits target_pc. If run2 does not hit PC, it may keep running even when program execution is complete. Also, run2 is much slower than setting a breakpoint at the address you want to run to because it steps the back-end one instruction at a time whereas the breakpoint functionality is part of the back-end.

s
Single-steps.

scache [on|off]
Signals to the IAS that the stack cache is present or absent. If the stack cache is absent, IAS operates directly on memory for its instructions. In the picoJava-II hardware, however, you cannot switch off the stack cache.

set dumpFile filename
Redirects output for dump* commands. With no arguments, set dumpFile dumps to stdout.

steps [numOfSteps]
Steps for numOfSteps of instructions. With no arguments, steps for one instruction only.

usage
Outputs online help.

where
Outputs the current register values and disassembles the next instruction.

writeMemory address
Writes a value (number of bytes) into address.

brk list|exec|read|write|enable|disable|ignore ...
Executes breakpoint commands.

intr \[repeat|disable\] \[count\] \[irl\]
Schedules or disables an interrupt.

checkpoint filename
Stores the state of the simulator to filename.

profile create id
Creates a profile.

profile enable|disable id
Enables or disables a profile.

profile freeze|unfreeze id
Freezes or unfreezes a profile.

profile switch id
Switches to a profile.

profile close id
Closes a profile.

profile print id
Prints a profile.

profile markenter
Marks an entry into a new block in the current profile.

profile markexit
Marks the exit from the topmost block in the current profile.

profile list
Lists the status of all available profiles.