Changes between Version 3 and Version 4 of VBoxLogging

Timestamp:

Aug 22, 2011 11:57:54 AM (13 years ago)

Author:

Michael Thayer

Comment:

More corrections, mainly links

VBoxLogging

@@ -3 +3 @@
 The generic description of the IPRT logging facility is found [http://www.virtualbox.org/browser/trunk/src/VBox/Runtime/VBox/log-vbox.cpp#L27 here].
 
-IPRT log group names are found in source:trunk/include/iprt/log.h [[BR]]
-!VirtualBox log group names are found in source:trunk/include/VBox/log.h
+IPRT log group names are found in [http://www.virtualbox.org/browser/trunk/include/iprt/log.h source]:trunk/include/iprt/log.h [[BR]]
+!VirtualBox log group names are found in [http://www.virtualbox.org/browser/trunk/include/VBox/log.h source]:trunk/include/VBox/log.h
 
 !VirtualBox uses the env.vars `VBOX_LOG`, `VBOX_LOG_DEST` and `VBOX_LOG_FLAGS` to
@@ -34 +34 @@
 environment variable "VBOX_LOG_DEST" for debug logging and "VBOX_RELEASE_LOG_DEST" for
 release logging, add the prefix "file=" (if logging to a file) or "dir=" (directory) plus
-the file name / directory. See "Runtime\common\log\log.cpp" around line 300.
+the file name / directory. See "Runtime/common/log/log.cpp" around [http://www.virtualbox.org/browser/trunk/src/Runtime/common/log/log.cpp#L300 line 300].  Example:
+
+{{{
+export VBOX_LOG_DEST="dir=/tmp"
+}}}
 
 By default, all level 1 release log statements ("!LogRel()") cause logging to the release log.
@@ -46 +50 @@
 sparingly in performance-critical code.
 
-To enable ring-0 logging add VBOX_WITH_R0_LOGGING=1 to !LocalConfig.kmk or pass it to kmk in the command line (this part is not necessary for guest ring-0 logging) and set up loggging preferences in the source file src/VBox/Runtime/VBox/log-vbox.cpp.
+To enable ring-0 logging add VBOX_WITH_R0_LOGGING=1 to !LocalConfig.kmk or pass it to kmk in the command line (this part is not necessary for guest ring-0 logging) and set up logging preferences in the [http://www.virtualbox.org/browser/trunk/src/Runtime/VBox/log-vbox.cpp source file] src/VBox/Runtime/VBox/log-vbox.cpp.
 
 Some notes about group suffixes:[[BR]]
@@ -58 +62 @@
 Sometimes core developers use private logging statements which look like Log<Nick>(...), where <Nick> is the developer's nickname.  To enable those logging statements you must set the log flag for that developer.  For example, for the developer with the nick "!NoName" (!LogNoName(...) statements in the code) use the suffix[[BR]]
 .n = .noname;[[BR]]
-
-To control where logging output/files go(es), use the VBOX_LOG_DEST variable, e.g.:
-
-{{{
-export VBOX_LOG_DEST="dir=c:\temp"
-}}}
-
 
 To disable logging entirely, use one of: