VIRTUTECH CONFIDENTIAL    Previous - Up - Next

context

Provided by
Simics Core
Class Hierarchy
conf-objectcontext
Interfaces Implemented
breakpoint
Description
This is an abstraction of a virtual address space. It handles virtual-address breakpoints and may have symbol tables attached to it. Note that there is no automatic correspondence to any hardware or operating-system context, although such a mapping may be set up by the user.

Attributes

Attributes inherited from class conf-object
attributes, classname, component, iface, name, object_id, queue
Attribute List
active
Session attribute; read/write access; type: Integer.

Context currently active.

breakpoints
Session attribute; read/write access; type: [[i+]*]; integer indexed; indexed type: [i*].

((id, start, stop)*) Tells which breakpoints (identified by their id) are set for the space object. start and stop specifies the interval for the breakpoint.

gdb_remote_variant
Session attribute; read/write access; type: s|n.

Preferred gdb-remote variant.

symtable
Session attribute; read/write access; type: Object or Nil.

Symbol table for the context.

Command List

Commands defined by interface breakpoint
break, tbreak
Commands
finish-functionfinish the current function
infoprint information about the device
next-instructionrun to the next instruction, skipping subroutine calls
next-linerun to the next source line, skipping subroutine calls
offswitch off context object
onswitch on context object
reverse-next-instructionback to the previous instruction, skipping subroutine calls
reverse-next-lineback to the previous source line, skipping subroutine calls
reverse-step-instructionback to the previous instruction
reverse-step-lineback to the previous source line
reverse-until-activereverse until context becomes active
run-until-activerun until context becomes active
statusprint status of the device
step-instructionrun to the next instruction
step-linerun to the next source line
symtableset the symbol table of a context
uncall-functiongo back to when the current function was called

Command Descriptions

<context>.finish-function
Alias
<context>.finish, <context>.fin
Synopsis
<context>.finish-function
Description
step-line causes the simulation to run until it reaches another source line. reverse-step-line does the same thing, except for running backwards.

next-line causes the simulation to run until it reaches another source line, but will not stop in subroutine calls. reverse-next-line is the same as next-line, except for running backwards. next-instruction and reverse-next-instruction are like next-line and reverse-next-line, respectively, except for stepping just one instruction instead of an entire source line.

finish-function causes the simulation to run until the current function has returned. uncall-function causes the simulation to run backwards until just before the current function was called.

These commands can either be called as context namespace commands, e.g., context.step-line, in which case the command will apply to that context; or not, e.g., step-line, in which case the command will operate on the current context of the current processor.

See Also
<context>.step-line, <context>.step-instruction, <context>.reverse-step-line, <context>.reverse-step-instruction, <context>.next-line, <context>.next-instruction, <context>.reverse-next-line, <context>.reverse-next-instruction, <context>.uncall-function
<context>.info
Synopsis
<context>.info
Description
Print detailed information about the configuration of the device.
<context>.next-instruction
Alias
<context>.nexti, <context>.ni
Synopsis
<context>.next-instruction
Description
step-line causes the simulation to run until it reaches another source line. reverse-step-line does the same thing, except for running backwards.

next-line causes the simulation to run until it reaches another source line, but will not stop in subroutine calls. reverse-next-line is the same as next-line, except for running backwards. next-instruction and reverse-next-instruction are like next-line and reverse-next-line, respectively, except for stepping just one instruction instead of an entire source line.

finish-function causes the simulation to run until the current function has returned. uncall-function causes the simulation to run backwards until just before the current function was called.

These commands can either be called as context namespace commands, e.g., context.step-line, in which case the command will apply to that context; or not, e.g., step-line, in which case the command will operate on the current context of the current processor.

See Also
<context>.step-line, <context>.step-instruction, <context>.reverse-step-line, <context>.reverse-step-instruction, <context>.next-line, <context>.reverse-next-line, <context>.reverse-next-instruction, <context>.finish-function, <context>.uncall-function
<context>.next-line
Alias
<context>.next, <context>.n
Synopsis
<context>.next-line
Description
step-line causes the simulation to run until it reaches another source line. reverse-step-line does the same thing, except for running backwards.

next-line causes the simulation to run until it reaches another source line, but will not stop in subroutine calls. reverse-next-line is the same as next-line, except for running backwards. next-instruction and reverse-next-instruction are like next-line and reverse-next-line, respectively, except for stepping just one instruction instead of an entire source line.

finish-function causes the simulation to run until the current function has returned. uncall-function causes the simulation to run backwards until just before the current function was called.

These commands can either be called as context namespace commands, e.g., context.step-line, in which case the command will apply to that context; or not, e.g., step-line, in which case the command will operate on the current context of the current processor.

See Also
<context>.step-line, <context>.step-instruction, <context>.reverse-step-line, <context>.reverse-step-instruction, <context>.next-instruction, <context>.reverse-next-line, <context>.reverse-next-instruction, <context>.finish-function, <context>.uncall-function
<context>.off
Synopsis
<context>.off
<context>.on
Description
<context>.on activates the effects of a context object, i.e., breakpoints on virtual addresses. <context>.off deactivates a context object.
<context>.on
Synopsis
<context>.on
<context>.off
Description
<context>.on activates the effects of a context object, i.e., breakpoints on virtual addresses. <context>.off deactivates a context object.
<context>.reverse-next-instruction
Alias
<context>.rnexti, <context>.rni
Synopsis
<context>.reverse-next-instruction
Description
step-line causes the simulation to run until it reaches another source line. reverse-step-line does the same thing, except for running backwards.

next-line causes the simulation to run until it reaches another source line, but will not stop in subroutine calls. reverse-next-line is the same as next-line, except for running backwards. next-instruction and reverse-next-instruction are like next-line and reverse-next-line, respectively, except for stepping just one instruction instead of an entire source line.

finish-function causes the simulation to run until the current function has returned. uncall-function causes the simulation to run backwards until just before the current function was called.

These commands can either be called as context namespace commands, e.g., context.step-line, in which case the command will apply to that context; or not, e.g., step-line, in which case the command will operate on the current context of the current processor.

See Also
<context>.step-line, <context>.step-instruction, <context>.reverse-step-line, <context>.reverse-step-instruction, <context>.next-line, <context>.next-instruction, <context>.reverse-next-line, <context>.finish-function, <context>.uncall-function
<context>.reverse-next-line
Alias
<context>.rnext, <context>.rn
Synopsis
<context>.reverse-next-line
Description
step-line causes the simulation to run until it reaches another source line. reverse-step-line does the same thing, except for running backwards.

next-line causes the simulation to run until it reaches another source line, but will not stop in subroutine calls. reverse-next-line is the same as next-line, except for running backwards. next-instruction and reverse-next-instruction are like next-line and reverse-next-line, respectively, except for stepping just one instruction instead of an entire source line.

finish-function causes the simulation to run until the current function has returned. uncall-function causes the simulation to run backwards until just before the current function was called.

These commands can either be called as context namespace commands, e.g., context.step-line, in which case the command will apply to that context; or not, e.g., step-line, in which case the command will operate on the current context of the current processor.

See Also
<context>.step-line, <context>.step-instruction, <context>.reverse-step-line, <context>.reverse-step-instruction, <context>.next-line, <context>.next-instruction, <context>.reverse-next-instruction, <context>.finish-function, <context>.uncall-function
<context>.reverse-step-instruction
Alias
<context>.rstepi, <context>.rsi, <context>.unstep-instruction, <context>.ui
Synopsis
<context>.reverse-step-instruction
Description
step-line causes the simulation to run until it reaches another source line. reverse-step-line does the same thing, except for running backwards.

next-line causes the simulation to run until it reaches another source line, but will not stop in subroutine calls. reverse-next-line is the same as next-line, except for running backwards. next-instruction and reverse-next-instruction are like next-line and reverse-next-line, respectively, except for stepping just one instruction instead of an entire source line.

finish-function causes the simulation to run until the current function has returned. uncall-function causes the simulation to run backwards until just before the current function was called.

These commands can either be called as context namespace commands, e.g., context.step-line, in which case the command will apply to that context; or not, e.g., step-line, in which case the command will operate on the current context of the current processor.

See Also
<context>.step-line, <context>.step-instruction, <context>.reverse-step-line, <context>.next-line, <context>.next-instruction, <context>.reverse-next-line, <context>.reverse-next-instruction, <context>.finish-function, <context>.uncall-function
<context>.reverse-step-line
Alias
<context>.rstep, <context>.rs
Synopsis
<context>.reverse-step-line
Description
step-line causes the simulation to run until it reaches another source line. reverse-step-line does the same thing, except for running backwards.

next-line causes the simulation to run until it reaches another source line, but will not stop in subroutine calls. reverse-next-line is the same as next-line, except for running backwards. next-instruction and reverse-next-instruction are like next-line and reverse-next-line, respectively, except for stepping just one instruction instead of an entire source line.

finish-function causes the simulation to run until the current function has returned. uncall-function causes the simulation to run backwards until just before the current function was called.

These commands can either be called as context namespace commands, e.g., context.step-line, in which case the command will apply to that context; or not, e.g., step-line, in which case the command will operate on the current context of the current processor.

See Also
<context>.step-line, <context>.step-instruction, <context>.reverse-step-instruction, <context>.next-line, <context>.next-instruction, <context>.reverse-next-line, <context>.reverse-next-instruction, <context>.finish-function, <context>.uncall-function
<context>.reverse-until-active
Synopsis
<context>.reverse-until-active
Description
Reverse until context become active.
<context>.run-until-active
Synopsis
<context>.run-until-active
Description
Run until context become active.
<context>.status
Synopsis
<context>.status
Description
Print detailed information about the current status of the device.
<context>.step-instruction
Alias
<context>.stepi, <context>.si
Synopsis
<context>.step-instruction
Description
step-line causes the simulation to run until it reaches another source line. reverse-step-line does the same thing, except for running backwards.

next-line causes the simulation to run until it reaches another source line, but will not stop in subroutine calls. reverse-next-line is the same as next-line, except for running backwards. next-instruction and reverse-next-instruction are like next-line and reverse-next-line, respectively, except for stepping just one instruction instead of an entire source line.

finish-function causes the simulation to run until the current function has returned. uncall-function causes the simulation to run backwards until just before the current function was called.

These commands can either be called as context namespace commands, e.g., context.step-line, in which case the command will apply to that context; or not, e.g., step-line, in which case the command will operate on the current context of the current processor.

See Also
<context>.step-line, <context>.reverse-step-line, <context>.reverse-step-instruction, <context>.next-line, <context>.next-instruction, <context>.reverse-next-line, <context>.reverse-next-instruction, <context>.finish-function, <context>.uncall-function
<context>.step-line
Alias
<context>.step, <context>.s
Synopsis
<context>.step-line
Description
step-line causes the simulation to run until it reaches another source line. reverse-step-line does the same thing, except for running backwards.

next-line causes the simulation to run until it reaches another source line, but will not stop in subroutine calls. reverse-next-line is the same as next-line, except for running backwards. next-instruction and reverse-next-instruction are like next-line and reverse-next-line, respectively, except for stepping just one instruction instead of an entire source line.

finish-function causes the simulation to run until the current function has returned. uncall-function causes the simulation to run backwards until just before the current function was called.

These commands can either be called as context namespace commands, e.g., context.step-line, in which case the command will apply to that context; or not, e.g., step-line, in which case the command will operate on the current context of the current processor.

See Also
<context>.step-instruction, <context>.reverse-step-line, <context>.reverse-step-instruction, <context>.next-line, <context>.next-instruction, <context>.reverse-next-line, <context>.reverse-next-instruction, <context>.finish-function, <context>.uncall-function
<context>.symtable
Synopsis
<context>.symtable ["symtable"]
Description
Sets the symbol table of the context to symtable, or displays the name of the symtable currently bound to the context. The symbol table is created if it does not already exist.
See Also
set-context, new-symtable
<context>.uncall-function
Alias
<context>.uncall
Synopsis
<context>.uncall-function
Description
step-line causes the simulation to run until it reaches another source line. reverse-step-line does the same thing, except for running backwards.

next-line causes the simulation to run until it reaches another source line, but will not stop in subroutine calls. reverse-next-line is the same as next-line, except for running backwards. next-instruction and reverse-next-instruction are like next-line and reverse-next-line, respectively, except for stepping just one instruction instead of an entire source line.

finish-function causes the simulation to run until the current function has returned. uncall-function causes the simulation to run backwards until just before the current function was called.

These commands can either be called as context namespace commands, e.g., context.step-line, in which case the command will apply to that context; or not, e.g., step-line, in which case the command will operate on the current context of the current processor.

See Also
<context>.step-line, <context>.step-instruction, <context>.reverse-step-line, <context>.reverse-step-instruction, <context>.next-line, <context>.next-instruction, <context>.reverse-next-line, <context>.reverse-next-instruction, <context>.finish-function

VIRTUTECH CONFIDENTIAL    Previous - Up - Next