By default, only the objects in the current namespace are listed (see the change-namespace
command). The namespace argument can be used to override the current namespace. (The component argument is a deprecated alias of namespace.)
When the namespace argument is used, objects in standard sub-namespaces are always included, e.g. list-objects namespace=DEV will always include objects hierarchies rooted at DEV.bank, DEV.port and DEV.impl.
Objects of class index-map are only listed if specifically asked for, using the class argument.
If the optional substr argument is specified, only objects with a name matching this sub-string will be printed. The current namespace part of the object name will not be included in the name matched against.
The default is to list objects in the current namespace as well as namespaces below, i.e. list the whole tree rooted at the given namespace. Use the -local flag to only list the current namespace.
The -show-port-objects flag will include port objects in the result; this includes "port", "bank", and "impl" objects.
With the -all flag, all objects are listed, regardless of namespace. This implies the -show-port-objects flag.