Logo Search packages:      
Sourcecode: virtualbox-ose version File versions  Download package

Runtime - Logging

VBox uses the IPRT logging system which supports group level flags and multiple destinations. The GC logging is making it even more interesting since GC logging will have to be buffered and written when back in host context.

[more later]

The Destination Specifier.

The {logger-env-base}_DEST environment variable can be used to specify where the log output goes. The following specifiers are recognized:

The Destination Specifier.

The {logger-env-base} environment variable can be used to specify which logger groups to enable and which to disable. By default all groups are disabled. For your convenience this specifier is case in-sensitive (ASCII).

The specifier is evaluated from left to right.

[more later]

The groups settings can be reprogrammed during execution using the RTLogGroupSettings() command and a group specifier.

The Default Logger

The default logger uses VBOX_LOG_DEST as destination specifier. File output is enabled by default and goes to a file "./VBox-\<pid\>.log".

The default logger have all groups turned off by default to force the developer to be careful with what log information to collect - logging everything is generally NOT a good idea.

The log groups of the default logger can be found in the LOGGROUP in enum. The VBOX_LOG environment variable and the .log debugger command can be used to configure the groups.

Each group have flags in addition to the enable/disable flag. These flags can be appended to the group name using dot separators. The flags correspond to RTLOGGRPFLAGS and have a short and a long version:

Todo:
Update this section...
Example:

VBOX_LOG=+all+pgm.e.s.b.z.l-qemu

Space and ';' separators are allowed:

VBOX_LOG=+all +pgm.e.s.b.z.l ; - qemu


Generated by  Doxygen 1.6.0   Back to index