Attempts to find or create the type named by the other-args argument in the given scope.
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 theother-argsargument.
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.
loader_sym_by_regexp: Look up loader symbols using a regular expression to match the base name. For example:
finds all of the loader symbols ending in "print" contained in the given 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_scopetcl_cmd: Names the commands called before walking a scope.
-pre_symtcl_cmd: Names the commands called before walking a symbol.
-post_scopetcl_cmd: Names the commands called after walking a scope.
-post_symboltcl_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