log log-group
Simics Reference Manual  /  3 Commands  /  3.2 Command List  / 

log-filter

Synopsis

log-filter [object] ["substr"] ["substring"] [-temporary] [-clear]

Description

Adds a filter that selectively suppresses log messages from an object.

While it is possible to disable logging for a particular object by setting its log level to 0, doing so may also hide important information. As an alternative, this command can suppress select log messages from a particular object. This is useful when lots of messages are printed by a misbehaving model. Using log-filter should be a temporary solution until the model is fixed by moving offending log messages to one or more log groups or to a higher log level.

When used without any arguments, or with just the object argument, the command will print all current log suppression entries, or those for the specified object.

To add a filter, both the object and substr arguments are mandatory. A message will be suppressed when it is logged by the specified object and it matches the substr. Messages of "critical" type are never suppressed. If the -temporary flag is specified, the filter will be removed if a message not suppressed by any filter is encountered.

The -clear flag is used to disable log suppression. When the flag is used and no other arguments, all suppression entries will be cleared. Otherwise, the object and substr arguments are required to disable suppression for the specified object and substring.

Provided By

Simics Core
log log-group