list-commands list-debug-contexts
Simics Reference Manual  /  3 Commands  /  3.2 Command List  / 

list-components

Synopsis

list-components [component] ["class"] [-s] [-v] [-t] [-all] [-recursive]

Description

Print or lists components with their names, types, and connectors; and for each connector, the destination component and connector.

With the class argument, you can restrict the listing to components of a particular class.

By default, only the components in the current namespace are listed (see the change-namespace command). If no current namespace has been selected, only top-level components are shown. The component argument can be used to override the current namespace.

With the -all flag, list all components, regardless of where they live. With the -recursive flag, in addition to listing all components that are in the selected namespace, also list all components in the namespaces below it. With -t, list only top-level components. The -s and -v flags select a briefer listing (default), and a more verbose listing, respectively.

Example of default output. Columns are explained by the bottom row.

board            chassis_qsp_x86
ethernet_switch0 ethernet_switch
slot             class name       not instantiated, if applicable

Example of verbose output. Components are printed in bold and columns for the connectors are explained by the bottom row:

board            chassis_qsp_x86

ethernet_switch0 ethernet_switch
device0          ethernet-link    any         board.mb.sb:eth_slot
device1          ethernet-link    any         service_node_cmp0:connector_link0
connector        type             direction   destinations, if any

The list-components command returns a list of components when used in an expression. The get-component-list command just returns such a list.

Provided By

Simics Core
list-commands list-debug-contexts