log-filter log-level
Simics Reference Manual  /  3 Commands  /  3.2 Command List  / 

log-group

Synopsis

log-group [object] [-enable|-disable|-add|-sub] ["log-group"] [-r]
<conf_object>.log-group [-enable|-disable|-add|-sub] ["log-group"] [-r]

Description

Enable (-enable) or disable (-disable) a log-group, or show whether it is enabled. If no object is specified, do so on all objects in the configuration that define the log group. When object is specified the command will also recursively update log groups for all descendants of object whose name matches object.bank[.*], object.port[.*] or object.impl[.*] pattern. The flag -r can be used to operate on all the descendants of the object object.

To enable or disable all log groups, specify all as log-group.

(The flags -add/-sub are deprecated aliases of -enable/-disable.)

An object in Simics can specify a number of groups, and each log message is associated with one or more groups. Groups are typically used to separate log messages belonging to different aspects of an object such as a device. Log messages not associated with any model-specific group will all be collected in the Default_Log_Group.

For example, a network device can have one group each for the receive and transmit engines, one group for the host protocol and another for PCI accesses.

Having multiple groups simplifies debugging when only messages of the selected groups are logged and displayed. By default, all groups are enabled.

Provided By

Simics Core

See Also

log, log-level, log-size, log-type
log-filter log-level