Home | History | Annotate | Download | only in utils
      1 /* Copyright (C) 2007-2008 The Android Open Source Project
      2 **
      3 ** This software is licensed under the terms of the GNU General Public
      4 ** License version 2, as published by the Free Software Foundation, and
      5 ** may be copied, distributed, and modified under those terms.
      6 **
      7 ** This program is distributed in the hope that it will be useful,
      8 ** but WITHOUT ANY WARRANTY; without even the implied warranty of
      9 ** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     10 ** GNU General Public License for more details.
     11 */
     12 #ifndef _ANDROID_UTILS_DEBUG_H
     13 #define _ANDROID_UTILS_DEBUG_H
     14 
     15 #include <stdarg.h>
     16 
     17 #define  VERBOSE_TAG_LIST    \
     18     _VERBOSE_TAG(init,         "emulator initialization")  \
     19     _VERBOSE_TAG(console,      "control console")  \
     20     _VERBOSE_TAG(modem,        "emulated GSM modem")  \
     21     _VERBOSE_TAG(radio,        "emulated GSM AT Command channel") \
     22     _VERBOSE_TAG(keys,         "key bindings & presses") \
     23     _VERBOSE_TAG(slirp,        "internal router/firewall") \
     24     _VERBOSE_TAG(timezone,     "host timezone detection" ) \
     25     _VERBOSE_TAG(socket,       "network sockets") \
     26     _VERBOSE_TAG(proxy,        "network proxy support") \
     27     _VERBOSE_TAG(audio,        "audio sub-system") \
     28     _VERBOSE_TAG(audioin,      "audio input backend") \
     29     _VERBOSE_TAG(audioout,     "audio output backend") \
     30     _VERBOSE_TAG(surface,      "video surface support") \
     31     _VERBOSE_TAG(qemud,        "qemud multiplexer daemon") \
     32     _VERBOSE_TAG(gps,          "emulated GPS") \
     33     _VERBOSE_TAG(nand_limits,  "nand/flash read/write thresholding") \
     34     _VERBOSE_TAG(hw_control,   "emulated power/flashlight/led/vibrator") \
     35     _VERBOSE_TAG(avd_config,   "android virtual device configuration") \
     36     _VERBOSE_TAG(sensors,      "emulated sensors") \
     37     _VERBOSE_TAG(memcheck,     "memory checker") \
     38 
     39 #define  _VERBOSE_TAG(x,y)  VERBOSE_##x,
     40 typedef enum {
     41     VERBOSE_TAG_LIST
     42     VERBOSE_MAX  /* do not remove */
     43 } VerboseTag;
     44 #undef  _VERBOSE_TAG
     45 
     46 /* defined in android_main.c */
     47 extern unsigned long  android_verbose;
     48 
     49 #define  VERBOSE_ENABLE(tag)    \
     50     android_verbose |= (1 << VERBOSE_##tag)
     51 
     52 #define  VERBOSE_DISABLE(tag)   \
     53     android_verbose &= (1 << VERBOSE_##tag)
     54 
     55 #define  VERBOSE_CHECK(tag)    \
     56     ((android_verbose & (1 << VERBOSE_##tag)) != 0)
     57 
     58 #define  VERBOSE_CHECK_ANY()    \
     59     (android_verbose != 0)
     60 
     61 #define  VERBOSE_PRINT(tag,...)  \
     62     do { if (VERBOSE_CHECK(tag)) dprint(__VA_ARGS__); } while (0)
     63 
     64 /** DEBUG TRACE SUPPORT
     65  **
     66  ** debug messages can be sent by calling these function
     67  **
     68  ** 'dprint' prints the message, then appends a '\n\
     69  ** 'dprintn' simply prints the message as is
     70  ** 'dprintnv' allows you to use a va_list argument
     71  ** 'dwarning' prints a warning message, then appends a '\n'
     72  ** 'derror' prints a severe error message, then appends a '\n'
     73  */
     74 
     75 extern void   dprint( const char*  format, ... );
     76 extern void   dprintn( const char*  format, ... );
     77 extern void   dprintnv( const char*  format, va_list  args );
     78 extern void   dwarning( const char*  format, ... );
     79 extern void   derror( const char*  format, ... );
     80 
     81 /** STDOUT/STDERR REDIRECTION
     82  **
     83  ** allows you to shut temporarily shutdown stdout/stderr
     84  ** this is useful to get rid of debug messages from ALSA and esd
     85  ** on Linux.
     86  **/
     87 
     88 extern void  stdio_disable( void );
     89 extern void  stdio_enable( void );
     90 
     91 /* */
     92 
     93 #endif /* _ANDROID_UTILS_DEBUG_H */
     94