Return to debug.h CVS log

Up to [local] / prex-old / sys / include

Annotation of prex-old/sys/include/debug.h, Revision 1.1.1.1

1.1       nbrk        1: /*-
                      2:  * Copyright (c) 2005-2006, Kohsuke Ohtani
                      3:  * All rights reserved.
                      4:  *
                      5:  * Redistribution and use in source and binary forms, with or without
                      6:  * modification, are permitted provided that the following conditions
                      7:  * are met:
                      8:  * 1. Redistributions of source code must retain the above copyright
                      9:  *    notice, this list of conditions and the following disclaimer.
                     10:  * 2. Redistributions in binary form must reproduce the above copyright
                     11:  *    notice, this list of conditions and the following disclaimer in the
                     12:  *    documentation and/or other materials provided with the distribution.
                     13:  * 3. Neither the name of the author nor the names of any co-contributors
                     14:  *    may be used to endorse or promote products derived from this software
                     15:  *    without specific prior written permission.
                     16:  *
                     17:  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
                     18:  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
                     19:  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
                     20:  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
                     21:  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
                     22:  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
                     23:  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
                     24:  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
                     25:  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
                     26:  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
                     27:  * SUCH DAMAGE.
                     28:  */
                     29:
                     30: #ifndef _DEBUG_H
                     31: #define _DEBUG_H
                     32:
                     33: #define MSGBUFSZ       128     /* Size of one kernel message */
                     34:
                     35: /*
                     36:  * BREAKPOINT()
                     37:  *
                     38:  * Break into debugger.
                     39:  * This works only with a debug version, and only when debugger
                     40:  * is attached.
                     41:  */
                     42: #ifdef DEBUG
                     43: #define BREAKPOINT()   breakpoint()
                     44: #else
                     45: #define BREAKPOINT()   do {} while (0)
                     46: #endif
                     47:
                     48: /*
                     49:  * printk()
                     50:  *
                     51:  * Print out kernel message to the debug port.
                     52:  * The message is enabled only when DEBUG build.
                     53:  */
                     54: #ifdef DEBUG
                     55: extern void printk(const char *fmt, ...);
                     56: #else
                     57: #define printk(fmt...) do {} while (0)
                     58: #endif
                     59:
                     60: /*
                     61:  * panic()
                     62:  *
                     63:  * Reset CPU for fatal error.
                     64:  * If debugger is attached, break into it.
                     65:  */
                     66: #ifdef DEBUG
                     67: extern void panic(const char *fmt, ...);
                     68: #else
                     69: extern void machine_reset(void);
                     70: #define panic(fmt...)  machine_reset()
                     71: #endif
                     72:
                     73: /*
                     74:  * ASSERT(exp)
                     75:  *
                     76:  * If exp is false(zero), stop with source info.
                     77:  * This is enabled only when DEBUG build. An asserion check
                     78:  * should be used only for invalid kernel condition.
                     79:  * It can not be used to check the input argument from user
                     80:  * mode because kernel must not do panic for it. The kernel
                     81:  * should return an appropriate error code in such case.
                     82:  */
                     83: #ifdef DEBUG
                     84: extern void assert(const char *file, int line, const char *exp);
                     85: #define ASSERT(exp)    do { if (!(exp)) \
                     86:     assert(__FILE__, __LINE__, #exp); } while (0)
                     87: #else
                     88: #define ASSERT(exp)    do {} while (0)
                     89: #endif
                     90:
                     91: /*
                     92:  * Command for sys_debug()
                     93:  */
                     94: #define DCMD_DUMP      0
                     95: #define DCMD_LOGSIZE   1
                     96: #define DCMD_GETLOG    2
                     97:
                     98: /*
                     99:  * Items for debug_dump()
                    100:  */
                    101: #define DUMP_THREAD    1
                    102: #define DUMP_TASK      2
                    103: #define DUMP_OBJECT    3
                    104: #define DUMP_TIMER     4
                    105: #define DUMP_IRQ       5
                    106: #define DUMP_DEVICE    6
                    107: #define DUMP_VM                7
                    108: #define DUMP_MSGLOG    8
                    109: #define DUMP_TRACE     9
                    110:
                    111: #ifdef DEBUG
                    112: extern void     boot_dump(void);
                    113: extern int      log_get(char **, size_t *);
                    114: #endif
                    115: extern int      debug_dump(int);
                    116: extern void     debug_attach(void (*)(char *));
                    117:
                    118: #endif /* !_DEBUG_H */