Return to debug.h CVS log

Up to [MW Coherent from dump] / coherent / f / usr / include / sys

Annotation of coherent/f/usr/include/sys/debug.h, revision 1.1

1.1     ! root        1: #ifndef        __SYS_KDEBUG_H__
        !             2: #define        __SYS_KDEBUG_H__
        !             3: 
        !             4: /*
        !             5:  * This header defines debugging macros suitable for use in an operating
        !             6:  * system kernel. There can be a variety of handling disciplines in place
        !             7:  * for each different class of internal problem, depending on whether or
        !             8:  * not this is a production or debugging system (and on the presence of some
        !             9:  * kind of debugger which we might like to call upon).
        !            10:  *
        !            11:  * One aim is that the code which is being developed should be able to pass
        !            12:  * the strictest of "lint"-style checks. In the past it has often been the
        !            13:  * case that developers have not taken certain classes of diagnostics
        !            14:  * seriously, especially where the return value of a function is not used.
        !            15:  *
        !            16:  * In an operating system kernel, it is *never* safe to assume that any
        !            17:  * function that returns a value can have that value ignored. Even if there
        !            18:  * is no sane corrective action that can take place, developers should be
        !            19:  * able to expect assert ()-style checks will catch such "impossible"
        !            20:  * conditions.
        !            21:  */
        !            22: 
        !            23: /*
        !            24:  *-IMPORTS:
        !            25:  *     <common/ccompat.h>
        !            26:  *             __EXTERN_C_BEGIN__
        !            27:  *             __EXTERN_C_END__
        !            28:  *             __STRING ()
        !            29:  *             __PROTO ()
        !            30:  *     <common/xdebug.h>
        !            31:  *             __FILE_INFO__
        !            32:  */
        !            33: 
        !            34: #include <common/xdebug.h>
        !            35: 
        !            36: 
        !            37: __EXTERN_C_BEGIN__
        !            38: 
        !            39: __NO_RETURN__ void
        !            40:                __assert_fail2  __PROTO ((__CONST__ char * _exp,
        !            41:                                          __CONST__ char * _info,
        !            42:                                          int _lineno));
        !            43: __NO_RETURN__ void
        !            44:                __assert_fail   __PROTO ((__CONST__ char * _exp));
        !            45: 
        !            46: __EXTERN_C_END__
        !            47: 
        !            48: 
        !            49: /*
        !            50:  * The ASSERT () macro evaluates it's argument and checks for a non-zero
        !            51:  * (boolean TRUE, in the C language) result. If any other value is returned,
        !            52:  * an assert ()-style diagnostic is issued to the system console via
        !            53:  * cmn_err () with a severity of CE_WARN.
        !            54:  *
        !            55:  * The name ASSERT () indicates that the value of the test expression is just
        !            56:  * that, a test, and may not be evaluated if the system is compiled with
        !            57:  * debugging facilities suppressed.
        !            58:  */
        !            59: 
        !            60: #ifndef        NDEBUG
        !            61: # if   __NO_FILE_INFO__
        !            62: #  define ASSERT(exp)          ((void) ((exp) ? (void) 0 : \
        !            63:                                 __assert_fail (__STRING (exp), NULL, 0)))
        !            64: # else
        !            65: #  define ASSERT(exp)          ((void) ((exp) ? (void) 0 : \
        !            66:                                 __assert_fail2 (__STRING (exp), __FILE_INFO__)))
        !            67: # endif
        !            68: #else
        !            69: # define ASSERT(exp)           ((void) 0)
        !            70: #endif
        !            71: 
        !            72: 
        !            73: #endif /* ! defined (__SYS_KDEBUG_H__) */

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.