list-length list-namespaces – deprecated
Simics Reference Manual  /  3 Commands  /  3.2 Command List  / 

list-modules

Synopsis

list-modules ["substr"] [package-number] [-l] [-v] [thread-safe]

Description

Lists all modules that can be loaded into Simics. If the substr argument is specified, only modules with a matching name will be listed. If a package-number is specified, only modules from that package will be listed.

Use -l to only list loaded modules and -v to enable verbose output, which includes the module file system path, package name if the module comes from a package, and if the module shadows another module (which will be listed by list-failed-modules).

"Build ID" is the module-specific build ID, defaulting to the build-ID of the Simics package that the module was compiled with. The full build-ID reads for example "namespace:1234", except for Simics modules which displays just the integer part.

The "ABI" column is the build-ID of the Simics package that the module was compiled with.

The "Compat" column is the oldest Simics ABI version the module is binary compatible with. Note that a module with a low "compat" value may still require a later version of Simics for API functions that were introduced later on.

The "API" column is the API version that was set in the modules' makefile.

The "Thread-safe" column shows whether the module has been tagged as thread safe, "Yes" or "No". Use the thread-safe argument to filter on this column.

The "User Version" column shows the user defined version string (if any) which was provided in the MODULE_USER_VERSION variable in the module's Makefile.

When used in an expression, a list of module names is returned, or a list of [<module name>, <loaded status>, <build ID>, <ABI>, <compat>, <API>, <thread-safe>, <user version>, <path>, <package>, <shadowing>] entries if -v is specified.

Provided By

Simics Core

See Also

list-failed-modules, module-list-refresh, load-module, add-module-directory
list-length list-namespaces – deprecated