Changes between Version 16 and Version 17 of VBoxLogging

Timestamp:

Jan 16, 2015 9:25:49 AM (9 years ago)

Author:

Michael Thayer

Comment:

--

VBoxLogging

@@ -3 +3 @@
 The generic description of the IPRT logging facility is found in [/browser/trunk/src/VBox/Runtime/VBox/log-vbox.cpp#L27 Runtime/VBox/log-vbox.cpp].
 
-IPRT log group names are found in [/browser/trunk/include/iprt/log.h include/iprt/log.h] [[BR]]
-!VirtualBox log group names are found in [/browser/trunk/include/VBox/log.h include/VBox/log.h]
+IPRT log group names and logging flags are found in [/browser/trunk/include/iprt/log.h include/iprt/log.h] [[BR]]
+!VirtualBox log group names and flags are found in [/browser/trunk/include/VBox/log.h include/VBox/log.h]
 
 !VirtualBox uses the env.vars `VBOX_LOG`, `VBOX_LOG_DEST` and `VBOX_LOG_FLAGS` to
@@ -18 +18 @@
 
 {{{
-set VBOX_LOG=em=~0 rem* -rem_mmio
-set VBOX_LOG_FLAGS=buffered thread tsc
+set VBOX_LOG=em=~0 rem* -rem_mmio       # Enable all EM group logging and all level 1 REM*
+                                        # groups logging except REM_MMIO.
+set VBOX_LOG_FLAGS=buffered thread tsc  # Buffer log output, print thread IDs in the log
+                                        # statements, print TSC values
 }}}
 
@@ -25 +27 @@
 export VBOX_RELEASE_LOG="rem*.e.l.f main gui"
 export VBOX_RELEASE_LOG_FLAGS="buffered thread msprog"
+# Disable the limit of log entries from each group
+export VBOX_RELEASE_LOG_FLAGS=-restrict_groups
 }}}
 
@@ -108 +112 @@
 '''NOTE:''' If you have release build of GAs installed into your Windows guest, please also consider to set HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\VBoxGuest\LoggingEnabled registry key to value 0xFF (DWORD 32bit) in order to enable R3 logging into VMM backdoor. 
 
+== Changing settings using VBoxManage ==
+
+The VBoxManage command line tool can be used to change the log settings of a running virtual machine.  Examples:
+
+{{{
+$ VBoxManage debugvm <name> log --release +dev_vga.e.l.f
+$ VBoxManage debugvm <name> logdest --debug stdout
+$ VBoxManage debugvm <name> logflags --release -restrict_groups
+$ VBoxManage debugvm <name> show logdbg-settings
+}}}
+
 == Changing settings inside a debugger ==
 
-Logging settings can be changed at runtime using a debugger.  Here are two examples with gdb:
+Logging settings can be changed at runtime using a debugger.  This is mainly useful for VBoxSVC.  Here are two examples with gdb:
 
 {{{