<os_awareness>.enable-tracker <os_awareness>.info
Simics Reference Manual  /  3 Commands  /  3.2 Command List  / 

<os_awareness>.find

Synopsis

<os_awareness>.find node [-unique] [-raise] [-id] [root-id]

Description

Search for a node in the node tree. The find command takes a node specification as input and from that finds all nodes matching the expression. By default the matching nodes are represented with their node path specification. If this command is run from the CLI the matching nodes will be printed on the console. If this command is run from a script it will return a list with the result.

The node contains the node specification to use when searching for matching nodes. This is backward compatible with the old system. If the node argument is an integer only, it will be treated as a node id. For more information about node specifications please see the Analyzer User's Guide.

The -id parameter can be specified in order to identify the matched nodes with their node id instead of with a node path.

The -unique parameter can be specified to only allow one matching node to be found. If multiple matches are found, no matches at all will be listed.

The -raise can be used to specify that the command should raise a CliError if no nodes are found. It can also be used in combination with the -unique parameter to force an exception if multiple nodes matches the node specification.

The root-id argument specifies if only nodes belonging to that specific node tree should be searched for. Leaving this out will search all node trees.

Provided By

os-awareness

See Also

<os_awareness>.active-node, <os_awareness>.list, <os_awareness>.node-info, <os_awareness>.node-tree
<os_awareness>.enable-tracker <os_awareness>.info