1 /* 2 * Copyright (C) 2014 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 #ifndef __ADB_TRACE_H 18 #define __ADB_TRACE_H 19 20 #if !ADB_HOST 21 #include <android/log.h> 22 #endif 23 24 /* define ADB_TRACE to 1 to enable tracing support, or 0 to disable it */ 25 #define ADB_TRACE 1 26 27 /* IMPORTANT: if you change the following list, don't 28 * forget to update the corresponding 'tags' table in 29 * the adb_trace_init() function implemented in adb.c 30 */ 31 typedef enum { 32 TRACE_ADB = 0, /* 0x001 */ 33 TRACE_SOCKETS, 34 TRACE_PACKETS, 35 TRACE_TRANSPORT, 36 TRACE_RWX, /* 0x010 */ 37 TRACE_USB, 38 TRACE_SYNC, 39 TRACE_SYSDEPS, 40 TRACE_JDWP, /* 0x100 */ 41 TRACE_SERVICES, 42 TRACE_AUTH, 43 TRACE_FDEVENT, 44 } AdbTrace; 45 46 #if ADB_TRACE 47 48 #if !ADB_HOST 49 /* 50 * When running inside the emulator, guest's adbd can connect to 'adb-debug' 51 * qemud service that can display adb trace messages (on condition that emulator 52 * has been started with '-debug adb' option). 53 */ 54 55 /* Delivers a trace message to the emulator via QEMU pipe. */ 56 void adb_qemu_trace(const char* fmt, ...); 57 /* Macro to use to send ADB trace messages to the emulator. */ 58 #define DQ(...) adb_qemu_trace(__VA_ARGS__) 59 #else 60 #define DQ(...) ((void)0) 61 #endif /* !ADB_HOST */ 62 63 extern int adb_trace_mask; 64 extern unsigned char adb_trace_output_count; 65 void adb_trace_init(void); 66 67 # define ADB_TRACING ((adb_trace_mask & (1 << TRACE_TAG)) != 0) 68 69 /* you must define TRACE_TAG before using this macro */ 70 #if ADB_HOST 71 # define D(...) \ 72 do { \ 73 if (ADB_TRACING) { \ 74 int save_errno = errno; \ 75 adb_mutex_lock(&D_lock); \ 76 fprintf(stderr, "%s::%s():", \ 77 __FILE__, __FUNCTION__); \ 78 errno = save_errno; \ 79 fprintf(stderr, __VA_ARGS__ ); \ 80 fflush(stderr); \ 81 adb_mutex_unlock(&D_lock); \ 82 errno = save_errno; \ 83 } \ 84 } while (0) 85 # define DR(...) \ 86 do { \ 87 if (ADB_TRACING) { \ 88 int save_errno = errno; \ 89 adb_mutex_lock(&D_lock); \ 90 errno = save_errno; \ 91 fprintf(stderr, __VA_ARGS__ ); \ 92 fflush(stderr); \ 93 adb_mutex_unlock(&D_lock); \ 94 errno = save_errno; \ 95 } \ 96 } while (0) 97 # define DD(...) \ 98 do { \ 99 int save_errno = errno; \ 100 adb_mutex_lock(&D_lock); \ 101 fprintf(stderr, "%s::%s():", \ 102 __FILE__, __FUNCTION__); \ 103 errno = save_errno; \ 104 fprintf(stderr, __VA_ARGS__ ); \ 105 fflush(stderr); \ 106 adb_mutex_unlock(&D_lock); \ 107 errno = save_errno; \ 108 } while (0) 109 #else 110 # define D(...) \ 111 do { \ 112 if (ADB_TRACING) { \ 113 __android_log_print( \ 114 ANDROID_LOG_INFO, \ 115 __FUNCTION__, \ 116 __VA_ARGS__ ); \ 117 } \ 118 } while (0) 119 # define DR(...) \ 120 do { \ 121 if (ADB_TRACING) { \ 122 __android_log_print( \ 123 ANDROID_LOG_INFO, \ 124 __FUNCTION__, \ 125 __VA_ARGS__ ); \ 126 } \ 127 } while (0) 128 # define DD(...) \ 129 do { \ 130 __android_log_print( \ 131 ANDROID_LOG_INFO, \ 132 __FUNCTION__, \ 133 __VA_ARGS__ ); \ 134 } while (0) 135 #endif /* ADB_HOST */ 136 #else 137 # define D(...) ((void)0) 138 # define DR(...) ((void)0) 139 # define DD(...) ((void)0) 140 # define ADB_TRACING 0 141 #endif /* ADB_TRACE */ 142 143 #endif /* __ADB_TRACE_H */ 144