source: svn/branches/kctv/newcon3bcm2_21bu/magnum/basemodules/dbg/bdbg.h

Last change on this file was 2, checked in by phkim, 11 years ago

1.phkim

  1. revision copy newcon3sk r27
  • Property svn:executable set to *
File size: 42.4 KB
Line 
1/***************************************************************************
2 *     Copyright (c) 2003-2012, Broadcom Corporation
3 *     All Rights Reserved
4 *     Confidential Property of Broadcom Corporation
5 *
6 *  THIS SOFTWARE MAY ONLY BE USED SUBJECT TO AN EXECUTED SOFTWARE LICENSE
7 *  AGREEMENT  BETWEEN THE USER AND BROADCOM.  YOU HAVE NO RIGHT TO USE OR
8 *  EXPLOIT THIS MATERIAL EXCEPT SUBJECT TO THE TERMS OF SUCH AN AGREEMENT.
9 *
10 * $brcm_Workfile: bdbg.h $
11 * $brcm_Revision: Hydra_Software_Devel/55 $
12 * $brcm_Date: 2/22/12 1:44p $
13 *
14 * Module Description:
15 *
16 * Revision History:
17 *
18 * $brcm_Log: /magnum/basemodules/dbg/bdbg.h $
19 *
20 * Hydra_Software_Devel/55   2/22/12 1:44p erickson
21 * SW7425-2130: be consistent on #if, not #ifdef
22 *
23 * Hydra_Software_Devel/54   2/22/12 12:16p erickson
24 * SW7425-2130: fix last checkin
25 *
26 * Hydra_Software_Devel/53   2/22/12 12:01p erickson
27 * SW7425-2130: fix B_REFSW_DEBUG=n mode
28 *
29 * Hydra_Software_Devel/52   2/21/12 1:59p erickson
30 * SW7425-2130: add new DBG options for compact debug mode
31 *
32 * Hydra_Software_Devel/51   9/2/11 6:23p vsilyaev
33 * SW7425-1103: Added BDBG_CWARNING
34 *
35 * Hydra_Software_Devel/50   6/21/11 11:23a vsilyaev
36 * SW7420-1640: Fixed defintion of BDBG_P_INSTANCE_PRINTMSG_PRIV
37 *
38 * Hydra_Software_Devel/49   6/17/11 11:06a vsilyaev
39 * SW7420-1640: Added missing BDBG_P_INSTANCE_PRINTMSG_PRIV
40 *
41 * Hydra_Software_Devel/48   6/16/11 1:54p vsilyaev
42 * SW7425-729: Added missing defines for LOG level
43 *
44 * Hydra_Software_Devel/47   6/16/11 1:40p vsilyaev
45 * SW7425-729,SW7400-3012: Added LOG level
46 *
47 * Hydra_Software_Devel/46   6/16/11 11:12a vsilyaev
48 * SW7420-1640: Streamlined Android
49 *
50 * Hydra_Software_Devel/45   6/6/11 3:27p vsilyaev
51 * SW7405-4477: Routed all debug output through buffer and use external
52 * application to extract and print debug output
53 *
54 * Hydra_Software_Devel/44   4/22/11 7:46p vsilyaev
55 * SW7125-918, SW7405-4477: Fixed definitions of the multi module debug
56 * output
57 *
58 * Hydra_Software_Devel/43   4/20/11 10:10a ttrammel
59 * SW7420-1640: Merge Android logging into main branch.
60 *
61 * Hydra_Software_Devel/42   4/13/11 7:00p vsilyaev
62 * SW7405-5221: Route BERR_TRACE through the debug log
63 *
64 * Hydra_Software_Devel/41   1/13/11 3:40p erickson
65 * SWDEPRECATED-2425: consolidate BDBG_OBJECT example code
66 *
67 * Hydra_Software_Devel/40   1/5/11 6:40p vsilyaev
68 * SW7405-4477: Changed names to match ones used in the ticket
69 *
70 * Hydra_Software_Devel/39   1/5/11 6:30p vsilyaev
71 * SW7405-4477: Added BDBG_XXX_EXT to support multiple modules in the same
72 * compilation unit (C file)
73 *
74 * Hydra_Software_Devel/38   12/1/10 12:41p vsilyaev
75 * SWDEPRECATED-1626: Stricter and safer BDBG_CASSERT
76 *
77 * Hydra_Software_Devel/37   8/12/10 6:19p ttrammel
78 * SW7420-943: Fix NFE merge issue.
79 *
80 * Hydra_Software_Devel/36   8/12/10 4:39p ttrammel
81 * SW7420-943: Merge NFE to main branch.
82 *
83 * Hydra_Software_Devel/35   7/7/10 11:48a vsilyaev
84 * SW7420-867: Moved application level API into the bdbg_app.h
85 *
86 * Hydra_Software_Devel/34   6/25/10 6:26p jgarrett
87 * SW7408-88: Removing implicit global from BDBG_OBJECT_DESTROY
88 *
89 * Hydra_Software_Devel/33   10/14/09 6:52p vsilyaev
90 * SW7405-3211: Use constant pointers in  BDBG_Object_Assert
91 *
92 * Hydra_Software_Devel/32   6/24/09 2:25p mphillip
93 * PR54926: Merge DBG extension to /main
94 *
95 * Hydra_Software_Devel/PR54926/1   5/18/09 6:57p vsilyaev
96 * PR 54926: Added interface to capture debug output
97 *
98 * Hydra_Software_Devel/31   4/8/09 4:23p vsilyaev
99 * PR 54015: Don't include bkni_multi.h into the bdbg.h. All thread-aware
100 * modules should include explicitly bkni_multi.h
101 *
102 * Hydra_Software_Devel/30   2/19/09 6:45p vsilyaev
103 * PR 52320: Added BDBG_RELEASE macro to unwind module from BDBG
104 *
105 * Hydra_Software_Devel/29   12/29/08 1:32p erickson
106 * PR50746: make BDBG_OBJECT_ASSERT failures more helpful
107 *
108 * Hydra_Software_Devel/28   7/22/08 12:30p nilesh
109 * PR44846: Added support for setting instance levels on a per module
110 * basis
111 *
112 * Hydra_Software_Devel/27   8/15/07 2:25p vsilyaev
113 * PR 34089: Optimized executuion speed and code size
114 *
115 * Hydra_Software_Devel/26   5/4/07 12:14p vsilyaev
116 * PR 25469: Added function BDBG_EnumerateAll
117 *
118 * Hydra_Software_Devel/25   3/26/07 4:53p vsilyaev
119 * PR 27425: Fixed use of arguments in the BDBG_OBJECT macros
120 *
121 * Hydra_Software_Devel/24   1/30/07 11:03a vsilyaev
122 * PR 27425: Proofread documentation and expaned BDBG_OBJECT portion
123 *
124 * Hydra_Software_Devel/23   9/14/06 11:13a jgarrett
125 * PR 23982: Adding BDBG_NOP to reduce release-mode warnings
126 *
127 * Hydra_Software_Devel/22   7/26/06 4:51p vsilyaev
128 * PR 22695:Fixed issue with previous commit
129 *
130 * Hydra_Software_Devel/21   7/25/06 10:42a vsilyaev
131 * PR 22695: Pulled the debug output routines into the release build
132 *
133 * Hydra_Software_Devel/20   7/21/06 11:28a vsilyaev
134 * PR 22695: Changes in the BDBG module to make it run-time compatible
135 * between debug and release builds
136 *
137 * Hydra_Software_Devel/19   5/1/06 5:16p vsilyaev
138 * PR 21336: PR 21258: Added BDBG_CASSERT, modified BDBG_OBJECT_ID to
139 * include semicolon
140 *
141 * Hydra_Software_Devel/18   4/27/06 10:06a vle
142 * PR 21065: rework BDBG_LOCK and BDBG_UNLOCK to be OS specific
143 * implementation.
144 *
145 * Hydra_Software_Devel/17   2/27/06 5:12p vsilyaev
146 * PR 19917: Added API to check object types at runtime
147 *
148 * Hydra_Software_Devel/16   11/29/05 3:14p vle
149 * PR18319: add timestamp to debug messages
150 *
151 * Hydra_Software_Devel/15   10/5/04 7:49p vsilyaev
152 * PR 12726:  Fixed warnings generated in the Release build.
153 *
154 * Hydra_Software_Devel/14   6/17/04 3:20p erickson
155 * PR11135: fixed type in release build of BDBG_GetModuleLevel
156 *
157 * Hydra_Software_Devel/13   12/29/03 11:24a vsilyaev
158 * PR 9131: Added implementation note for the redirecting debug output
159 * into the file.
160 *
161 * Hydra_Software_Devel/12   11/26/03 3:40p vsilyaev
162 * When code compiled by GNU C, declare bdbg_module as unused variable
163 * (fixed warning issue).
164 *
165 * Hydra_Software_Devel/11   11/13/03 1:53p vsilyaev
166 * Added Trace level to use by BDBG_ENTER and BDBG_LEAVE.
167 *
168 * Hydra_Software_Devel/10   11/13/03 9:33a vsilyaev
169 * Tag malloced and statically allocated memory, so only malloced will be
170 * free'ed at UnInit time.
171 *
172 * Hydra_Software_Devel/9   11/12/03 2:22p vsilyaev
173 * Use statically alllocated data for internal structures, it solves
174 * dilemma of malloc and interrupt.
175 *
176 * Hydra_Software_Devel/8   8/19/03 10:37a vsilyaev
177 * Use verbose initialiization for module to prevent warnings.
178 *
179 * Hydra_Software_Devel/7   4/1/03 9:42a vsilyaev
180 * Fixed release version of the debug interface.
181 *
182 * Hydra_Software_Devel/6   3/20/03 12:43p erickson
183 * removed dulicate BDBG_Instance decl
184 *
185 * Hydra_Software_Devel/5   3/12/03 6:33p vsilyaev
186 * Added description for BDBG_ASSERT macro and module overview.
187 *
188 * Hydra_Software_Devel/4   3/12/03 4:39p vsilyaev
189 * Added comments for the auto documentation tool.
190 *
191 * Hydra_Software_Devel/3   3/10/03 6:36p vsilyaev
192 * Uses extern "C" { } brackets.
193 *
194 * Hydra_Software_Devel/2   3/10/03 10:43a vsilyaev
195 * Integration with berr.h
196 *
197 * Hydra_Software_Devel/1   3/10/03 10:03a vsilyaev
198 * O/S inspecific part of the debug interface.
199 *
200 ***************************************************************************/
201
202#ifndef BDBG_H
203#define BDBG_H
204
205#if defined B_REFSW_ANDROID && !defined __KERNEL__
206#define LOG_TAG "NEXUS"
207#include <cutils/log.h>
208#endif
209
210#include "blst_slist.h"
211
212#ifdef __cplusplus
213extern "C" {
214#endif
215
216
217#define ALCO  1
218//#define AOV_DISABLE_DBG
219
220#if 0
221#define AOV_DBG_PRINT(x) printf("%15s@%5d:%25s ",                               __FILE__,__LINE__,__FUNCTION__);printf x;printf("\n")
222#define AOV_DBG_PRINT1() printf("*** %15s@%5d:%25s ***\n",              __FILE__,__LINE__,__FUNCTION__)
223#define AOV_DBG_PRINT2() printf("\n\n!!! %15s@%5d:%25s !!!\n\n",__FILE__,__LINE__,__FUNCTION__)
224#else
225#define AOV_DBG_PRINT(x) printf("%15s@%5d:%25s ",                               strrchr(__FILE__,'/')? strrchr(__FILE__,'/')+1 : __FILE__,__LINE__,__FUNCTION__);printf x;printf("\n")
226#define AOV_DBG_PRINT1() printf("*** %15s@%5d:%25s ***\n",              strrchr(__FILE__,'/')? strrchr(__FILE__,'/')+1 : __FILE__,__LINE__,__FUNCTION__)
227#define AOV_DBG_PRINT2() printf("\n\n!!! %15s@%5d:%25s !!!\n\n",strrchr(__FILE__,'/')? strrchr(__FILE__,'/')+1 : __FILE__,__LINE__,__FUNCTION__)
228#define AOV_DBG_PRINT3(x) printf("\n\n\n%15s@%5d:%25s",                                 strrchr(__FILE__,'/')? strrchr(__FILE__,'/')+1 : __FILE__,__LINE__,__FUNCTION__);printf x;printf("\n\n\n")
229
230#define aov_dbg_print(x) printf("%15s@%5d:%25s ",                               strrchr(__FILE__,'/')? strrchr(__FILE__,'/')+1 : __FILE__,__LINE__,__FUNCTION__);printf x;printf("\n")
231#define aov_dbg_print1() printf("*** %15s@%5d:%25s ***\n",              strrchr(__FILE__,'/')? strrchr(__FILE__,'/')+1 : __FILE__,__LINE__,__FUNCTION__)
232#define aov_dbg_print2() printf("\n\n!!! %15s@%5d:%25s !!!\n\n",strrchr(__FILE__,'/')? strrchr(__FILE__,'/')+1 : __FILE__,__LINE__,__FUNCTION__)
233#define aov_dbg_print3(x) printf("\n\n\n%15s@%5d:%25s",                                 strrchr(__FILE__,'/')? strrchr(__FILE__,'/')+1 : __FILE__,__LINE__,__FUNCTION__);printf x;printf("\n\n\n")
234
235#endif
236
237/*================== Module Overview =====================================
238This Debug Interface provides console output according to pre-defined levels
239with compile-time and run-time control.
240
241Defined macros:
242 o BDBG_MODULE - register module and allow using the rest of the BDBG_ macros.
243 o BDBG_MSG, BDBG_WRN, BDBG_ERR - message output with 'Message', 'Warning' and 'Error' levels.
244 o BDBG_ASSERT - evaluate expression (condition) and fail if it's false.
245
246To activate debug build BDBG_DEBUG_BUILD macro should be defined to 1,
247i.e. -DBDBG_DEBUG_BUILD=1 .
248
249Implementation note:
250During impementation of this interface for a given plaform, it should be
251noted, that debug messages shall use a different output channel than a normal
252output from the system. For example in Posix like systems it would be
253a good choice to use stderr for the debug messages. In such a case the
254following command could be used to redirect debug messages into a file:
255  application 2>debug_file
256
257A second feature of this debug interface is the BDBG_OBJECT code. These macros provide
258a means to create a unique object type, add that object to a structure, and assert
259when given a pointer to an object that should be of that type but isn't.  This is
260analogous to the old unix "magic" values.  A structure element would be initialized
261to this unique magic value at creation time and be checked each time that structure was
262used to ensure that it is a valid type.  The element would be erased when the structure
263was destroyed to ensure that the element wasn't used after it had been destroyed.
264
265Defined macros:
266 o BDBG_OBJECT_ID, BDBG_OBJECT_ID_DECLARE - register object and allow using the rest of the BDBG_OBJECT_ macros.
267 o BDBG_OBJECT - allocate storage in a structure for the "magic" values.
268 o BDBG_OBJECT_INIT, BDBG_OBJECT_DESTROY, BDBG_OBJECT_SET, BDBG_OBJECT_UNSET - update the object.
269 o BDBG_OBJECT_ASSERT - assert when the object isn't the expected type.
270========================================================================*/
271
272/* Runtime debug level */
273typedef enum {
274  BDBG_P_eUnknown=0, /* special level that is used to indicate that file wasn't registered */
275  BDBG_eTrace,   /* Trace level */
276  BDBG_eMsg,     /* Message level */
277  BDBG_eWrn,     /* Warning level */
278  BDBG_eErr,     /* Error level */
279  BDBG_eLog,     /* Log level */
280  BDBG_P_eLastEntry
281} BDBG_Level;
282
283typedef void *BDBG_Instance;
284
285/***************************************************************************
286Summary:
287        Initialize the debug interface before being used.
288
289Description: StandardProgrammingEnvironment
290        Initializes the debug interface. You must call this before making any
291        other kernel interface call.
292
293Input:
294        <none>
295
296Returns:
297        BERR_SUCCESS - The debug interface successfully initialized.
298****************************************************************************/
299BERR_Code BDBG_Init(void);
300
301/***************************************************************************
302Summary:
303        Releases resources allocated by the debug interface.
304
305Description:
306        Cleans up the debug interface interface. No debug interface calls can be made after this.
307
308Input:
309        <none>
310
311Returns:
312        <none>
313****************************************************************************/
314void BDBG_Uninit(void);
315
316typedef struct BDBG_DebugModuleFile *BDBG_pDebugModuleFile;
317
318#define BDBG_P_FILE_INITIALIZER(module) { BDBG_P_eUnknown, BDBG_P_eUnknown, false, {NULL}, #module, NULL}
319
320typedef enum BDBG_ModulePrintKind  {
321    BDBG_ModulePrintKind_eHeader, /* header only */
322    BDBG_ModulePrintKind_eBody, /* body only */
323    BDBG_ModulePrintKind_eHeaderAndBody, /* entire output - header and body */
324    BDBG_ModulePrintKind_eString /* just a string */
325} BDBG_ModulePrintKind;
326
327typedef struct BDBG_DebugModuleFile BDBG_DebugModuleFile;
328
329typedef void (*BDBG_DebugModule_Print)(
330        BDBG_ModulePrintKind kind, /* type of the output */
331        BDBG_Level level, /* level of the debug output */
332        const BDBG_DebugModuleFile *module, /* pointer to the debug module */
333        const char *fmt,  /* format */
334        va_list ap /* variable list of arguments */
335        );
336
337struct BDBG_DebugModuleFile {
338        int8_t level; /* current level for this module */
339        uint8_t module_level; /* actual level for module */
340        bool module_alloc; /* true if module was instantiated by API call, e.g. BDBG_SetModuleLevel */
341    BLST_S_ENTRY(BDBG_DebugModuleFile) link; /* pointer that links all modules */
342    const char *name; /* name of the module */
343    BDBG_DebugModule_Print module_print;
344};
345
346
347struct bdbg_obj
348{
349        const char *bdbg_obj_id;
350};
351
352
353#if BDBG_DEBUG_BUILD
354
355#if 0
356/***************************************************************************
357Summary:
358    Registers software for the debug interface.
359
360Description:
361    This macro is used to register software module in the system. If module is used in several
362    C files each file should be registered with the same module name. Every modules that uses
363    BDBG_XXX macros should use BDBG_MODULE after '#include' statement.
364
365Example:
366    #include "bstd.h"
367    BDBG_MODULE(some_module)
368
369Input:
370    <none>
371
372Returns:
373    <none>
374****************************************************************************/
375#define BDBG_MODULE(module)
376
377/***************************************************************************
378Summary:
379    Registers software for the debug interface.
380
381Description:
382    This macro is used to register another software module in the same compilation unit. If module is used in several
383    C files each file should be registered with the same module name. Every modules that uses
384    BDBG_MODULE_XXX macros should use BDBG_FILE_MODULE after '#include' statement.
385
386Example:
387    #include "bstd.h"
388    BDBG_FILE_MODULE(another_module)
389
390Input:
391    <none>
392
393Returns:
394    <none>
395****************************************************************************/
396#define BDBG_FILE_MODULE(module)
397
398/***************************************************************************
399Summary:
400    Prints out message.
401
402Description:
403    If either module or system debug level is set to the 'Message' level this macro will print message
404    on the debug output. Message can have a printf style format string but should not include an 'end
405    of line' symbol ("\n") as one will be added.
406
407Note:
408    Text will not be displayed regardless of the error level on Release builds.
409
410See Also:
411    BDBG_SetLevel, BDBG_SetModuleLevel
412
413Example:
414    BDBG_MSG(("Counter value %d", counter));
415
416Input:
417    format - message to print
418
419Returns:
420    <none>
421****************************************************************************/
422#define BDBG_MSG(format)
423
424/***************************************************************************
425Summary:
426    Prints out message.
427
428Description:
429    If either module or system debug level is set to the 'Message' level this macro will print message
430    on the debug output. Message can have a printf style format string but should not include an 'end
431    of line' symbol ("\n") as one will be added.
432
433Note:
434    Text will not be displayed regardless of the error level on Release builds.
435
436See Also:
437    BDBG_SetLevel, BDBG_SetModuleLevel
438
439Example:
440    BDBG_MODULE_MSG(module,("Counter value %d", counter));
441
442Input:
443    format - message to print
444
445Returns:
446    <none>
447****************************************************************************/
448#define BDBG_MODULE_MSG(format)
449
450/***************************************************************************
451Summary:
452    Prints out message.
453
454Description:
455    If either module or system debug level is set to the 'Message' or 'Warning' level this macro will
456    print the message on the debug output. Message can have a printf style format string but should
457    not include an 'end of line' symbol ("\n") as one will be added.
458
459Note:
460    Text will not be displayed regardless of the error level on Release builds.
461
462See Also:
463    BDBG_SetLevel, BDBG_SetModuleLevel
464
465Example:
466    BDBG_WRN(("Counter value %d greater then %d", counter, 10));
467
468Input:
469    format - message to print
470
471Returns:
472    <none>
473****************************************************************************/
474#define BDBG_WRN(format)
475
476/***************************************************************************
477Summary:
478    Prints out message.
479
480Description:
481    If either module or system debug level is set to the 'Message' or 'Warning' level this macro will
482    print the message on the debug output. Message can have a printf style format string but should
483    not include an 'end of line' symbol ("\n") as one will be added.
484
485Note:
486    Text will not be displayed regardless of the error level on Release builds.
487
488See Also:
489    BDBG_SetLevel, BDBG_SetModuleLevel
490
491Example:
492    BDBG_MODULE_WRN(module,("Counter value %d greater then %d", counter, 10));
493
494Input:
495    format - message to print
496
497Returns:
498    <none>
499****************************************************************************/
500#define BDBG_MODULE_WRN(format)
501
502
503
504/***************************************************************************
505Summary:
506    Prints out message.
507
508Description:
509    This macro prints the message on the debug output. Message can have a printf style format string
510    but should not include an 'end of line' symbol ("\n") as one will be added.
511
512Note:
513    Text will not be displayed regardless of the error level on Release builds.
514
515Example:
516    BDBG_ERR(("Counter value %d negative", counter));
517
518Input:
519    format - message to print
520
521Returns:
522    <none>
523****************************************************************************/
524#define BDBG_ERR(format)
525
526/***************************************************************************
527Summary:
528    Prints out message.
529
530Description:
531    This macro prints the message on the debug output. Message can have a printf style format string
532    but should not include an 'end of line' symbol ("\n") as one will be added.
533
534Note:
535    Text will not be displayed regardless of the error level on Release builds.
536
537Example:
538    BDBG_ERR(module,("Counter value %d negative", counter));
539
540Input:
541    format - message to print
542
543Returns:
544    <none>
545****************************************************************************/
546#define BDBG_MODULE_ERR(module,format)
547
548
549/***************************************************************************
550Summary:
551    Test conditions.
552
553Description:
554    Evaluates expression and if result is false, prints out message including
555    textual presentation of the expression, file name and line number where assert
556    occured and then call function BKNI_Fail. The exact behaviour of fail is
557    implementation specific. Usually it traps to the debugger, generate stack trace and/or core dump.
558
559Note:
560    Expression inside BDBG_ASSERT does not evaluated for release builds, therefore expressions
561    in the BDBG_ASSERT macro shall be free of side effects.
562
563See Also:
564    BKNI_Fail, BDBG_CASSERT
565
566Example:
567    BDBG_ASSERT(counter>0);
568
569Input:
570    expr - the expression to evaluate
571
572Returns:
573    <none>
574****************************************************************************/
575#define BDBG_ASSERT(expr)
576
577
578/***************************************************************************
579Summary:
580    Test conditions at compile time.
581
582Description:
583    Evaluates expression at compile time and if result is false, compile process terminates.
584    The exact behaviour of compile error is implementation specific, usually it causes the compiler
585    to generate an error about duplicate case values.
586
587Note:
588    Expression inside BDBG_CASSERT shall be reducable to the boolean constant at compile time
589    in the BDBG_ASSER macro shall be free of side effects.
590
591See Also:
592    BKNI_ASSERT
593    BDBG_CWARNING
594
595Example:
596    BDBG_CASSERT(sizeof(int)==4); // compilation fails if size of the 'int' type if different from 4
597
598Input:
599    expr - the expression to evaluate
600
601Returns:
602    <none>
603****************************************************************************/
604#define BDBG_CASSERT(expr)
605
606/***************************************************************************
607Summary:
608    Test conditions at compile time.
609
610Description:
611    Evaluates expression at compile time and if result is false, compile process generates a warning.
612    The exact behaviour of compile warning is implementation specific, usually it causes the compiler
613    to generate an warning about division to zero.
614
615Note:
616    Expression inside BDBG_CASSERT shall be reducable to the boolean constant at compile time
617    in the BDBG_ASSER macro shall be free of side effects.
618
619See Also:
620    BDBG_CASSERT
621
622Example:
623    BDBG_WARNING(sizeof(int)==4); // compilation fails if size of the 'int' type if different from 4
624
625Input:
626    expr - the expression to evaluate
627
628Returns:
629    <none>
630****************************************************************************/
631#define BDBG_CWARNING(expr)
632
633
634/***************************************************************************
635Summary:
636    Prints out message.
637
638Description:
639    If either instance, module, or system debug level is set to the 'Message' level this macro will print
640    the message on the debug output. The message can have a printf style format string but should not
641    include and 'end of line' character ("\n") as one will be added.
642
643See Also:
644    BDBG_SetLevel, BDBG_SetModuleLevel, BDBG_SetInstanceLevel
645
646Example:
647    BDBG_INSTANCE_MSG(obj, ("Obj's counter value %d", obj->counter));
648
649Input:
650    instance - the module instance
651    format - message to print
652
653Returns:
654    <none>
655****************************************************************************/
656#define BDBG_INSTANCE_MSG(instance, format)
657
658
659/***************************************************************************
660Summary:
661    Prints out message.
662
663Description:
664    If either instance, module, or system debug level is set to the 'Message' or 'Warning' level this macro
665    will print the message on the debug output. The message can have a printf style format string but should
666    not include an 'end of line' character ("\n") as one will be added.
667
668See Also:
669    BDBG_SetLevel, BDBG_SetModuleLevel, BDBG_SetInstanceLevel
670
671Example:
672    BDBG_INSTANCE_WRN(obj, ("Counter value %d greater then %d", obj->counter, 10));
673
674Input:
675    instance - the module instance
676    format - message to print
677
678Returns:
679    <none>
680****************************************************************************/
681#define BDBG_INSTANCE_WRN(instance, format)
682
683
684/***************************************************************************
685Summary:
686    Prints out message.
687
688Description:
689    This macro prints the message on the debug output. Message can have a printf style format string
690    but should not include an 'end of line' character ("\n") as one will be added.
691
692Example:
693    BDBG_INSTANCE_ERR(obj, ("Counter value %d negative", obj->counter));
694
695Input:
696    instance - the module instance
697    format - message to print
698
699Returns:
700    <none>
701****************************************************************************/
702#define BDBG_INSTANCE_ERR(instance, format)
703
704
705/***************************************************************************
706Summary:
707    Prints out message.
708
709Description:
710    If either module or system debug level is set to the 'Trace' level this macro will print the
711    message that function 'function' entered.
712
713See Also:
714    BDBG_SetLevel, BDBG_SetModuleLevel
715
716Example:
717    BDBG_ENTER(BFOO_DoBar);
718
719Input:
720    function - function name
721
722Returns:
723    <none>
724****************************************************************************/
725#define BDBG_ENTER(function)
726
727
728/***************************************************************************
729Summary:
730    Prints out message.
731
732Description:
733    If either module or system debug level is set to the 'Trace' level this macro will print the
734    message that function 'function' exited.
735
736See Also:
737    BDBG_SetLevel, BDBG_SetModuleLevel
738
739Example:
740    BDBG_LEAVE(BFOO_DoBar);
741
742Input:
743    function - function name
744
745Returns:
746    <none>
747****************************************************************************/
748#define BDBG_LEAVE(function)
749
750
751/***************************************************************************
752Summary:
753    Registers instance
754
755Description:
756    This macro registers an intance for the debug interface. An 'Instance' is any pointer like object.
757    Only registered instances should be passed to other debug interface API.
758
759See Also:
760    BDBG_SetInstanceLevel, BDBG_INSTANCE_MSG, BDBG_INSTANCE_WRN, BDBG_INSTANCE_ERR
761
762Example:
763    BDBG_REGISTER_INSTANCE(obj);
764
765Input:
766    instance - the module instance
767
768Returns:
769    BERR_SUCCESS - instance has been registered
770****************************************************************************/
771#define BDBG_REGISTER_INSTANCE(instance)
772
773
774/***************************************************************************
775Summary:
776    Unregisters instance
777
778Description:
779    This macro releases resources allocated for this instance.
780
781See Also:
782    BDBG_REGISTER_INSTANCE
783
784Example:
785    BDBG_UNREGISTER_INSTANCE(obj);
786
787Input:
788    instance - the module instance
789
790Returns:
791    BERR_SUCCESS - instance has been unregistered
792****************************************************************************/
793#define BDBG_UNREGISTER_INSTANCE(instance)
794
795/***************************************************************************
796Summary:
797    Releases resources
798
799Description:
800    This macro releases resources allocated for the file(module) which used this macro.
801
802Example:
803    BDBG_RELEASE();
804
805****************************************************************************/
806#define BDBG_RELEASE()
807
808
809/***************************************************************************
810Summary:
811    Creates object type id
812
813Description:
814    This macro creates the object type id, that to use to check the object type.
815    This macro shall be used in the 'C' file.
816    Only one id with the given object type (name) can exist in the system.
817
818Example:
819    // this shows a non-opaque struct object_type.
820    // if struct object_type is private (e.g. opaque handle), then all this code should be in the implementation file.
821
822    // header file
823    BDBG_OBJECT_ID_DECLARE(object_type);
824    struct object_type {
825        BDBG_OBJECT(object_type)
826        unsigned x;
827    }
828
829    // implementation file
830    BDBG_OBJECT_ID(object_type);
831
832    object_type *open_object() {
833        object_type *obj = malloc(sizeof(*obj));
834        memset(obj, 0, sizeof(*obj));
835        BDBG_OBJECT_SET(obj, object_type);
836        obj->x = 1;
837        return obj;
838    }
839    void use_object(object_type *obj) {
840        BDBG_OBJECT_ASSERT(obj, object_type);
841        obj->x = 2;
842    }
843    void close_object(object_type *obj) {
844        BDBG_OBJECT_ASSERT(obj, object_type);
845        obj->x = 3;
846        BDBG_OBJECT_DESTROY(obj, object_type);
847        free(obj);
848    }
849
850See Also:
851    BDBG_OBJECT_INIT, BDBG_OBJECT_ASSERT
852
853Input:
854    name - object type
855
856Returns:
857    <none>
858****************************************************************************/
859#define BDBG_OBJECT_ID(name)
860
861
862/***************************************************************************
863Summary:
864    Declares object type id
865
866Description:
867    This macro forward declares the object type id.
868    Usually this is used in an H file if its necessary to share the same object ID
869    across multiple C files.
870
871Example:
872    see example for BDBG_OBJECT_ID
873
874See Also:
875    BDBG_OBJECT_ID, BDBG_OBJECT_INIT, BDBG_OBJECT_ASSERT
876
877Input:
878    name - object type
879
880Returns:
881    <none>
882****************************************************************************/
883#define BDBG_OBJECT_ID_DECLARE(name)
884
885
886/***************************************************************************
887Summary:
888    Adds module id to structure
889
890Description:
891    This macro is used to add module id to a structure.
892    This needs to be initialized or set before it can be used in an assert test.
893
894Note:
895    A semi-colon should not be used with this macro as some compilers will generate
896    an error when creating a release build and the macro is removed.
897
898Example:
899    see example for BDBG_OBJECT_ID
900
901See Also:
902    BDBG_OBJECT_ID, BDBG_OBJECT_INIT, BDBG_OBJECT_SET, BDBG_OBJECT_ASSERT
903
904Input:
905    name - object type
906
907Returns:
908    <none>
909****************************************************************************/
910#define BDBG_OBJECT(name)
911
912
913/***************************************************************************
914Summary:
915    Initializes object
916
917Description:
918    This macro is used to initialize pointer and sets the module id.
919    Initialization code fills memory, equal to size of the object, with a random pattern.
920
921Example:
922    see example for BDBG_OBJECT_ID. compare with:
923
924    object_type *open_object() {
925        object_type *obj = malloc(sizeof(*obj));
926        BDBG_OBJECT_INIT(obj, object_type);
927        obj->x = 1;
928        return obj;
929    }
930
931See Also:
932    BDBG_OBJECT_ID, BDBG_OBJECT_DESTROY, BDBG_OBJECT_ASSERT
933
934Input:
935    ptr - pointer to the object
936    name - object type
937
938Returns:
939    <none>
940****************************************************************************/
941#define BDBG_OBJECT_INIT(ptr,name)
942
943
944/***************************************************************************
945Summary:
946    Destroys object
947
948Description:
949    This macro is used to destroy object and remove the type tag. Using this
950    macro fills memory, equal to size of the object, with a random pattern.
951    The assert test will fail if pointer to object is used after its destroyed.
952
953Example:
954    see example for BDBG_OBJECT_ID
955
956See Also:
957    BDBG_OBJECT_ID, BDBG_OBJECT_INIT, BDBG_OBJECT_ASSERT
958
959Input:
960    ptr - pointer to the object
961    name - object type
962
963Returns:
964    <none>
965****************************************************************************/
966#define BDBG_OBJECT_DESTROY(ptr,name)
967
968
969/***************************************************************************
970Summary:
971    Sets the object tag
972
973Description:
974    This macro is used tag pointer with a specific tag.
975
976Example:
977    see example for BDBG_OBJECT_ID
978
979See Also:
980    BDBG_OBJECT_ID, BDBG_OBJECT_UNSET, BDBG_OBJECT_ASSERT
981
982Input:
983    ptr - pointer to the object
984    name - object type
985
986Returns:
987    <none>
988****************************************************************************/
989#define BDBG_OBJECT_SET(ptr,name)
990
991
992/***************************************************************************
993Summary:
994    Removes the object tag
995
996Description:
997    This macro is used remove tag from the pointer.
998
999Example:
1000    see example for BDBG_OBJECT_ID
1001    BDBG_OBJECT_UNSET is an alternative to BDBG_OBJECT_DESTROY.
1002
1003    BDBG_OBJECT_ID(object_type);
1004    struct some *p = malloc(sizeof(struct some));
1005    BDBG_OBJECT_UNSET(p, object_type);
1006
1007See Also:
1008    BDBG_OBJECT_ID, BDBG_OBJECT_INIT, BDBG_OBJECT_SET, BDBG_OBJECT_ASSERT
1009
1010Input:
1011    ptr - pointer to the object
1012    name - object type
1013
1014Returns:
1015    <none>
1016****************************************************************************/
1017#define BDBG_OBJECT_UNSET(ptr,name)
1018
1019
1020/***************************************************************************
1021Summary:
1022    Validates a pointer and type of the pointer
1023
1024Description:
1025    This macro is used validates that pointer is tagged with a specific object type.
1026    The pointer must be valid in order for this macro to succeed. If pointer doesn't
1027    match the expected type, this macro will cause a software assert.
1028
1029Example:
1030    see example for BDBG_OBJECT_ID
1031
1032See Also:
1033    BDBG_OBJECT_ID, BDBG_OBJECT_INIT, BDBG_OBJECT_SET
1034
1035Input:
1036    ptr - pointer to the object
1037    name - object type
1038
1039Returns:
1040    <none>
1041****************************************************************************/
1042#define BDBG_OBJECT_ASSERT(ptr,name)
1043
1044
1045#define BDBG_OBJECT_INIT_INST(ptr,name,inst)
1046#define BDBG_OBJECT_SET_INST(ptr,name,inst)
1047#define BDBG_OBJECT_TEST_INST(ptr,name,inst)
1048
1049#endif /* 0 */
1050
1051
1052#ifdef __GNUC__
1053#define BDBG_MODULE(module) static BDBG_DebugModuleFile __attribute__ ((__unused__)) b_dbg_module = BDBG_P_FILE_INITIALIZER(module)
1054#define BDBG_FILE_MODULE(module) static BDBG_DebugModuleFile __attribute__ ((__unused__)) b_dbg_module_##module = BDBG_P_FILE_INITIALIZER(module)
1055#else
1056#define BDBG_MODULE(module) static BDBG_DebugModuleFile b_dbg_module = BDBG_P_FILE_INITIALIZER(module)
1057#define BDBG_FILE_MODULE(module) static BDBG_DebugModuleFile b_dbg_module_##module = BDBG_P_FILE_INITIALIZER(module)
1058#endif
1059
1060#if defined(__STDC_VERSION__)
1061# if __STDC_VERSION__ == 199901L
1062#  define BDBG_P_UNWRAP(...) __VA_ARGS__
1063# endif
1064#endif
1065#if !defined(BDBG_P_UNWRAP) && defined(__KERNEL__)
1066# define BDBG_P_UNWRAP(args...) args
1067#endif
1068
1069
1070#if defined B_REFSW_ANDROID && !defined __KERNEL__
1071# define BDBG_P_PRINTMSG_PRIV(module, lvl, fmt) do { if(lvl==BDBG_eErr) {LOGE fmt;} else if(lvl==BDBG_eWrn) {LOGW fmt;} else {LOGV fmt;} } while(0)
1072# if defined(BDBG_P_UNWRAP)
1073#  define BDBG_P_INSTANCE_PRINTMSG_PRIV(module, lvl, instance, fmt) (void)BDBG_P_InstTestAndPrint((lvl), &module, (instance), BDBG_P_UNWRAP fmt)
1074# else
1075#  define BDBG_P_INSTANCE_PRINTMSG_PRIV(module, lvl, instance, fmt) ((BDBG_P_InstTestAndPrint((lvl), &module, (instance), NULL))? BDBG_P_PrintWithNewLine fmt:(void)0)
1076# endif
1077#elif defined(BDBG_P_UNWRAP)
1078# define BDBG_P_PRINTMSG_PRIV(module,lvl, fmt) (((lvl) >= module.level)? (void)BDBG_P_TestAndPrint((lvl), &module, BDBG_P_UNWRAP fmt) : (void)0)
1079# define BDBG_P_INSTANCE_PRINTMSG_PRIV(module, lvl, instance, fmt) (void)BDBG_P_InstTestAndPrint((lvl), &module, (instance), BDBG_P_UNWRAP fmt)
1080#else
1081# define BDBG_P_PRINTMSG_PRIV(module, lvl, fmt) ((((lvl) >= module.level) && BDBG_P_TestAndPrint((lvl), &module, NULL)) ? BDBG_P_PrintWithNewLine fmt:(void)0)
1082# define BDBG_P_INSTANCE_PRINTMSG_PRIV(module, lvl, instance, fmt) ((BDBG_P_InstTestAndPrint((lvl), &module, (instance), NULL))? BDBG_P_PrintWithNewLine fmt:(void)0)
1083#endif
1084
1085#define BDBG_P_PRINTMSG(lvl, fmt) BDBG_P_PRINTMSG_PRIV(b_dbg_module, lvl, fmt)
1086#define BDBG_P_MODULE_PRINTMSG(module, lvl, fmt) BDBG_P_PRINTMSG_PRIV(b_dbg_module_##module, lvl, fmt)
1087#define BDBG_P_INSTANCE_PRINTMSG(lvl, instance, fmt) BDBG_P_INSTANCE_PRINTMSG_PRIV(b_dbg_module, lvl, instance, fmt)
1088#define BDBG_P_MODULE_INSTANCE_PRINTMSG(module, lvl, instance, fmt) BDBG_P_INSTANCE_PRINTMSG_PRIV(b_dbg_module_##module, lvl, instance, fmt)
1089
1090#define BDBG_REGISTER_INSTANCE(handle) BDBG_P_RegisterInstance(handle, &b_dbg_module)
1091#define BDBG_UNREGISTER_INSTANCE(handle) BDBG_P_UnRegisterInstance(handle, &b_dbg_module)
1092#define BDBG_RELEASE() BDBG_P_Release(&b_dbg_module)
1093
1094#define BDBG_MODULE_REGISTER_INSTANCE(module, handle) BDBG_P_RegisterInstance(handle, &b_dbg_module_##module)
1095#define BDBG_MODULE_UNREGISTER_INSTANCE(module, handle) BDBG_P_UnRegisterInstance(handle, &b_dbg_module_##module)
1096#define BDBG_MODULE_RELEASE(module) BDBG_P_Release(&b_dbg_module__#module)
1097
1098#if B_REFSW_DEBUG_COMPACT_ASSERT
1099#define BDBG_ASSERT(expr) (expr) ? (void) 0 : BDBG_P_AssertFailed(NULL, __FILE__, __LINE__)
1100#else
1101#define BDBG_ASSERT(expr) (expr) ? (void) 0 : BDBG_P_AssertFailed(#expr, __FILE__, __LINE__)
1102#endif
1103#define BDBG_CASSERT(expr) do switch(0){case 0: case (expr):;} while(0)
1104#define BDBG_CWARNING(expr) do {if(0){int unused = 1/(expr);unused++;}} while(0)
1105
1106
1107#define BDBG_OBJECT_ID(name) const char bdbg_id__##name[]= "#" #name
1108#define BDBG_OBJECT_ID_DECLARE(name) extern const char bdbg_id__##name[]
1109#define BDBG_OBJECT(name) struct bdbg_obj bdbg_object_##name;
1110#define BDBG_OBJECT_INIT(ptr,name) BDBG_Object_Init((ptr),sizeof(*(ptr)),&(ptr)->bdbg_object_##name, bdbg_id__##name)
1111#define BDBG_OBJECT_DESTROY(ptr,name) BDBG_Object_Init((ptr),sizeof(*(ptr)),&(ptr)->bdbg_object_##name, NULL)
1112
1113
1114#define BDBG_OBJECT_SET(ptr,name) (ptr)->bdbg_object_##name.bdbg_obj_id=bdbg_id__##name
1115#define BDBG_OBJECT_UNSET(ptr,name) (ptr)->bdbg_object_##name.bdbg_obj_id=NULL
1116
1117void BDBG_Object_Assert(const void *ptr, size_t size, const struct bdbg_obj *obj, const char *id, const char *file, unsigned line);
1118#define BDBG_OBJECT_ASSERT(ptr,name) (((ptr) && (ptr)->bdbg_object_##name.bdbg_obj_id==bdbg_id__##name)? (void) 0 : BDBG_Object_Assert(ptr, sizeof(*ptr), &(ptr)->bdbg_object_##name, bdbg_id__##name, __FILE__, __LINE__))
1119
1120#define BDBG_OBJECT_INIT_INST(ptr,name,inst) BDBG_Object_Init(ptr,sizeof(*(ptr)),&(ptr)->bdbg_object_##name,bdbg_id__##name+(unsigned)(inst))
1121#define BDBG_OBJECT_SET_INST(ptr,name,inst) (ptr)->bdbg_object_##name.bdbg_obj_id=(bdbg_id__##name + (unsigned)(inst))
1122#define BDBG_OBJECT_ASSERT_INST(ptr,name,inst) BDBG_ASSERT((ptr)->bdbg_object_##name.bdbg_obj_id==&bdbg_id__##name+(unsigned)(inst))
1123
1124void BDBG_Object_Init(void *ptr, size_t size, struct bdbg_obj *obj, const char *id);
1125
1126bool BDBG_P_TestAndPrint(BDBG_Level level, BDBG_pDebugModuleFile dbg_module, const char *fmt, ...);
1127bool BDBG_P_InstTestAndPrint(BDBG_Level level, BDBG_pDebugModuleFile dbg_module, BDBG_Instance handle, const char *fmt, ...);
1128void BDBG_P_RegisterInstance(BDBG_Instance handle, BDBG_pDebugModuleFile dbg_module);
1129void BDBG_P_UnRegisterInstance(BDBG_Instance handle, BDBG_pDebugModuleFile dbg_module);
1130void BDBG_P_PrintWithNewLine(const char *fmt, ...);
1131void BDBG_P_Release(BDBG_pDebugModuleFile dbg_module);
1132
1133void BDBG_EnterFunction(BDBG_pDebugModuleFile dbg_module, const char *function);
1134void BDBG_LeaveFunction(BDBG_pDebugModuleFile dbg_module, const char *function);
1135
1136
1137#else /* BDBG_DEBUG_BUILD */
1138/* stubs */
1139
1140#define BDBG_MODULE(module) extern int bdbg_unused
1141#define BDBG_FILE_MODULE(module) extern int bdbg_unused
1142
1143#define BDBG_RELEASE() BDBG_NOP()
1144#define BDBG_MODULE_RELEASE(module) BDBG_NOP()
1145
1146#define BDBG_REGISTER_INSTANCE(instance)
1147#define BDBG_MODULE_REGISTER_INSTANCE(module,instance)
1148#define BDBG_UNREGISTER_INSTANCE(instance)
1149#define BDBG_MODULE_UNREGISTER_INSTANCE(module,instance)
1150
1151#define BDBG_ASSERT(expr) BDBG_NOP()
1152#define BDBG_CASSERT(expr)
1153#define BDBG_CWARNING(expr)
1154
1155
1156#define BDBG_OBJECT_ID(name) extern const char bdbg_id_unused_##name
1157#define BDBG_OBJECT_ID_DECLARE(name) extern const char bdbg_id_unused_decl_##name
1158#define BDBG_OBJECT(name)
1159#define BDBG_OBJECT_INIT(ptr,name) (void)ptr
1160#define BDBG_OBJECT_DESTROY(ptr,name) (void)ptr
1161#define BDBG_OBJECT_SET(ptr,name) (void)ptr
1162#define BDBG_OBJECT_UNSET(ptr,name) (void)ptr
1163#define BDBG_OBJECT_ASSERT(ptr,name)  (void)ptr
1164#define BDBG_OBJECT_INIT_INST(ptr,name,inst) (void)ptr
1165#define BDBG_OBJECT_SET_INST(ptr,name,inst) (void)ptr
1166#define BDBG_OBJECT_TEST_INST(ptr,name,inst) (void)ptr
1167#define BDBG_OBJECT_ASSERT_INST(ptr,name,inst) (void)ptr
1168
1169/* if not BDBG_DEBUG_BUILD, force these macros to be defined.
1170they can be used to avoid unused code warnings. */
1171#ifndef BDBG_NO_MSG
1172#define BDBG_NO_MSG 1
1173#endif
1174#ifndef BDBG_NO_WRN
1175#define BDBG_NO_WRN 1
1176#endif
1177#ifndef BDBG_NO_LOG
1178#define BDBG_NO_LOG 1
1179#endif
1180#endif /* BDBG_DEBUG_BUILD */
1181
1182#if BDBG_NO_MSG
1183#define BDBG_ENTER(function) BDBG_NOP()
1184#define BDBG_MODULE_ENTER(module,function) BDBG_NOP()
1185#define BDBG_LEAVE(function) BDBG_NOP()
1186#define BDBG_MODULE_LEAVE(module,function) BDBG_NOP()
1187#define BDBG_MSG(format) BDBG_NOP()
1188#define BDBG_MODULE_MSG(module, format) BDBG_NOP()
1189#define BDBG_INSTANCE_MSG(instance, format) BDBG_NOP()
1190#define BDBG_MODULE_INSTANCE_MSG(module, instance, format) BDBG_NOP()
1191#else
1192#define BDBG_ENTER(function) ((BDBG_eTrace >= b_dbg_module.level)? BDBG_EnterFunction(&b_dbg_module, #function)  : (void)0)
1193#define BDBG_MODULE_ENTER(module, function) ((BDBG_eTrace >= b_dbg_module_##module.level)? BDBG_EnterFunction(&b_dbg_module_##module, #function)  : (void)0)
1194#define BDBG_LEAVE(function) ((BDBG_eTrace >= b_dbg_module.level)? BDBG_LeaveFunction(&b_dbg_module, #function)  : (void)0)
1195#define BDBG_MODULE_LEAVE(module, function) ((BDBG_eTrace >= b_dbg_module_##module.level)? BDBG_LeaveFunction(&b_dbg_module_##module, #function)  : (void)0)
1196#define BDBG_MSG(format) BDBG_P_PRINTMSG(BDBG_eMsg, format)
1197#define BDBG_MODULE_MSG(module, format) BDBG_P_MODULE_PRINTMSG(module, BDBG_eMsg, format)
1198#define BDBG_INSTANCE_MSG(instance, format) BDBG_P_INSTANCE_PRINTMSG(BDBG_eMsg, instance, format)
1199#define BDBG_MODULE_INSTANCE_MSG(module, instance, format) BDBG_P_MODULE_INSTANCE_PRINTMSG(module, BDBG_eMsg, instance, format)
1200#endif
1201
1202#if BDBG_NO_WRN
1203#define BDBG_WRN(format) BDBG_NOP()
1204#define BDBG_MODULE_WRN(module,format) BDBG_NOP()
1205#define BDBG_INSTANCE_WRN(instance, format) BDBG_NOP()
1206#define BDBG_MODULE_INSTANCE_WRN(module,instance, format) BDBG_NOP()
1207#else
1208#define BDBG_WRN(format) BDBG_P_PRINTMSG(BDBG_eWrn, format)
1209#define BDBG_MODULE_WRN(module,format) BDBG_P_MODULE_PRINTMSG(module, BDBG_eWrn, format)
1210#define BDBG_INSTANCE_WRN(instance, format) BDBG_P_INSTANCE_PRINTMSG(BDBG_eWrn, instance, format)
1211#define BDBG_MODULE_INSTANCE_WRN(module, instance, format) BDBG_P_MODULE_INSTANCE_PRINTMSG(module, BDBG_eWrn, instance, format)
1212#endif
1213
1214#if BDBG_DEBUG_BUILD
1215#if B_REFSW_DEBUG_COMPACT_ERR
1216#define BDBG_ERR(format)                                   BDBG_P_PrintString("### Error at %s:%d\n", __FILE__, __LINE__)
1217#define BDBG_MODULE_ERR(module,format)                     BDBG_ERR(format)
1218#define BDBG_INSTANCE_ERR(instance, format)                BDBG_ERR(format)
1219#define BDBG_MODULE_INSTANCE_ERR(module, instance, format) BDBG_ERR(format)
1220#else
1221#define BDBG_ERR(format) BDBG_P_PRINTMSG(BDBG_eErr, format)
1222#define BDBG_MODULE_ERR(module,format) BDBG_P_MODULE_PRINTMSG(module,BDBG_eErr, format)
1223#define BDBG_INSTANCE_ERR(instance, format) BDBG_P_INSTANCE_PRINTMSG(BDBG_eErr, instance, format)
1224#define BDBG_MODULE_INSTANCE_ERR(module, instance, format) BDBG_P_MODULE_INSTANCE_PRINTMSG(module,BDBG_eErr, instance, format)
1225#endif
1226#else
1227#define BDBG_ERR(format) BDBG_NOP()
1228#define BDBG_MODULE_ERR(module,format) BDBG_NOP()
1229#define BDBG_INSTANCE_ERR(instance, format) BDBG_NOP()
1230#define BDBG_MODULE_INSTANCE_ERR(module, instance, format) BDBG_NOP()
1231#endif
1232
1233#if BDBG_NO_LOG
1234#define BDBG_LOG(format) BDBG_NOP()
1235#define BDBG_MODULE_LOG(module,format) BDBG_NOP()
1236#define BDBG_INSTANCE_LOG(instance, format) BDBG_NOP()
1237#define BDBG_MODULE_INSTANCE_LOG(module, instance, format) BDBG_NOP()
1238#else
1239#define BDBG_LOG(format) BDBG_P_PRINTMSG(BDBG_eLog, format)
1240#define BDBG_MODULE_LOG(module,format) BDBG_P_MODULE_PRINTMSG(module,BDBG_eLog, format)
1241#define BDBG_INSTANCE_LOG(instance, format) BDBG_P_INSTANCE_PRINTMSG(BDBG_eLog, instance, format)
1242#define BDBG_MODULE_INSTANCE_LOG(module, instance, format) BDBG_P_MODULE_INSTANCE_PRINTMSG(module,BDBG_eLog, instance, format)
1243#endif
1244
1245#ifdef __cplusplus
1246}
1247#endif
1248#include  "bdbg_app.h"
1249#include  "bdbg_priv.h"
1250
1251#endif  /* BDBG_H */
Note: See TracBrowser for help on using the repository browser.