scope

Sets and gets internal scope properties

Format: 

TV::scope action [ object-id ] [ other-args ]

Arguments: 

action

The action to perform, as follows:

cast

Attempts to find or create the type named by the other-args argument in the given scope.

code_unit_by_soid

Look up loader symbols by using a regular expression to match the base name. For example:

TV::scope lookup $scope_id \

loader_sym_by_regexp \

"regular expression"

commands

Displays the subcommands that you can use. The CLI responds by displaying the subcommands shown here. Do not use additional arguments with this subcommand.

create

Allows you to create blocks, enum_type, named_constant, typedef, upc_shared_type, and variable symbols. The type of symbol determines the properties you meed to specify. In all cases, you must specify the kind property. If you are creating a located symbol such as a block, you need to provide a location. If you are creating a upc_shared_type, you need a target_type index.

dump

Dump all properties of all symbols in the scope and in the enclosed scope.

get

Returns properties of the symbols whose soids are specified. Specify the kinds of properties using the other-args argument.

If you use the -all option instead of object-id, the CLI returns a list containing one (sublist) element for each object.

lookup

Look up a symbol by name. Specify the kind of lookup using the other-args argument. The values you can enter are:

by_language_rules: Use the language rules of the language of the scope to find a single name.

by_path: Look up a symbol using a pathname.

by_properties [proptery_regexp_pair]: TotalView recurses down the scope tree after it visits a symbol. This means TotalView will search for matching symbols in the specified scope and any nested scope. The walk property shows an example.

by_type_index: Look up a symbol using a type index.

in_scope: Look up a name in the given scope and in all enclosing scopes, and in the global scope.

lookup_keys

Displays the kinds of lookup operations that you can perform.

properties

Displays the properties that the CLI can access. Do not use additional arguments with this option. The arguments displayed are those that are displayed for the scope of all types. Additional properties also exist but are not shown.(Only the ones used by all are visible.) For more information, see TV::symbol.

walk

Walk the scope, calling Tcl commands at particular points in the walk. The commands are named using the following options:

by_properties [proptery_regexp_pair]: TotalView recurses down the scope tree after it visits a symbol. This means TotalView will search for matching symbols in the specified scope and any nested scope. For example:

TV::scope walk $scope_id by_properties \

kind typedef base_name "^__BMN_.*$"

-pre_scope tcl_cmd: Names the commands called before walking a scope.

-pre_sym tcl_cmd: Names the commands called before walking a symbol.

-post_scope tcl_cmd: Names the commands called after walking a scope.

-post_symbol tcl_cmd: Names the commands called after walking a symbol.

tcl_cmd: Names the commands called for each symbol.

object-id

The ID of a scope.

other-args

Arguments required by the get subcommand.

Description: 

The TV::scope command lets you examine and set a scope’s properties and states.

Examples: 

TV::scope create $scope kind [kind] \

[required_property_regexp_pair]...

[non-required_property_regexp_pair]...

This is the general specification for creating a symbol

TV::scope create 1|31 kind block location {ldam 0x12}

Create a block. A block should have a length. However, you can set the length later using the set property.