Name
----
phStbDbg


Overview
--------
Kernel module and usermode library implementing debug print macros.


Associated Device(s)
--------------------
/dev/phdbg


Parameters
----------
None

Description
-----------
Implements a facility for C code to print debug messages, and perform
assertion checking.

Depending on the mode of compilation (controlled by the _TMTGTREL environment
variable value) the SDE2 build system will enable/disable various macros:
_TMTGTREL = debug|trace: DBG_PRINT* and DBG_ASSERT* macros active.
_TMTGTREL = assert     : Only DBG_ASSERT* macros active.
_TMTGTREL = retail     : DBG_PRINT* or DBG_ASSERT* macros in-active.

Under Linux the output produced by DBG_PRINT* macros will be passed to syslog(),
which usually ends up in file /var/log/messages.

The tmdbg program can (at least under Linux) be used to control the level/amount
of debug messages. Run the "tmdbg dbg help" command.


IOCTLs
------
Internal use only


Associated files
----------------
comps/phStbDbg/inc/phStbDbg.h
