|
1 /* |
|
2 * Copyright (C) 2005 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 // |
|
18 // C/C++ logging functions. See the logging documentation for API details. |
|
19 // |
|
20 // We'd like these to be available from C code (in case we import some from |
|
21 // somewhere), so this has a C interface. |
|
22 // |
|
23 // The output will be correct when the log file is shared between multiple |
|
24 // threads and/or multiple processes so long as the operating system |
|
25 // supports O_APPEND. These calls have mutex-protected data structures |
|
26 // and so are NOT reentrant. Do not use LOG in a signal handler. |
|
27 // |
|
28 #ifndef _LIBS_CUTILS_LOG_H |
|
29 #define _LIBS_CUTILS_LOG_H |
|
30 |
|
31 #include <stdio.h> |
|
32 #include <time.h> |
|
33 #include <sys/types.h> |
|
34 #include <unistd.h> |
|
35 #ifdef HAVE_PTHREADS |
|
36 #include <pthread.h> |
|
37 #endif |
|
38 #include <stdarg.h> |
|
39 |
|
40 #include <cutils/uio.h> |
|
41 #include <cutils/logd.h> |
|
42 |
|
43 #ifdef __cplusplus |
|
44 extern "C" { |
|
45 #endif |
|
46 |
|
47 // --------------------------------------------------------------------- |
|
48 |
|
49 /* |
|
50 * Normally we strip LOGV (VERBOSE messages) from release builds. |
|
51 * You can modify this (for example with "#define LOG_NDEBUG 0" |
|
52 * at the top of your source file) to change that behavior. |
|
53 */ |
|
54 #ifndef LOG_NDEBUG |
|
55 #ifdef NDEBUG |
|
56 #define LOG_NDEBUG 1 |
|
57 #else |
|
58 #define LOG_NDEBUG 0 |
|
59 #endif |
|
60 #endif |
|
61 |
|
62 /* |
|
63 * This is the local tag used for the following simplified |
|
64 * logging macros. You can change this preprocessor definition |
|
65 * before using the other macros to change the tag. |
|
66 */ |
|
67 #ifndef LOG_TAG |
|
68 #define LOG_TAG NULL |
|
69 #endif |
|
70 |
|
71 // --------------------------------------------------------------------- |
|
72 |
|
73 /* |
|
74 * Simplified macro to send a verbose log message using the current LOG_TAG. |
|
75 */ |
|
76 #ifndef LOGV |
|
77 #if LOG_NDEBUG |
|
78 #define LOGV(...) ((void)0) |
|
79 #else |
|
80 #define LOGV(...) ((void)LOG(LOG_VERBOSE, LOG_TAG, __VA_ARGS__)) |
|
81 #endif |
|
82 #endif |
|
83 |
|
84 #define CONDITION(cond) (__builtin_expect((cond)!=0, 0)) |
|
85 |
|
86 #ifndef LOGV_IF |
|
87 #if LOG_NDEBUG |
|
88 #define LOGV_IF(cond, ...) ((void)0) |
|
89 #else |
|
90 #define LOGV_IF(cond, ...) \ |
|
91 ( (CONDITION(cond)) \ |
|
92 ? ((void)LOG(LOG_VERBOSE, LOG_TAG, __VA_ARGS__)) \ |
|
93 : (void)0 ) |
|
94 #endif |
|
95 #endif |
|
96 |
|
97 /* |
|
98 * Simplified macro to send a debug log message using the current LOG_TAG. |
|
99 */ |
|
100 #ifndef LOGD |
|
101 #define LOGD(...) ((void)LOG(LOG_DEBUG, LOG_TAG, __VA_ARGS__)) |
|
102 #endif |
|
103 |
|
104 #ifndef LOGD_IF |
|
105 #define LOGD_IF(cond, ...) \ |
|
106 ( (CONDITION(cond)) \ |
|
107 ? ((void)LOG(LOG_DEBUG, LOG_TAG, __VA_ARGS__)) \ |
|
108 : (void)0 ) |
|
109 #endif |
|
110 |
|
111 /* |
|
112 * Simplified macro to send an info log message using the current LOG_TAG. |
|
113 */ |
|
114 #ifndef LOGI |
|
115 #define LOGI(...) ((void)LOG(LOG_INFO, LOG_TAG, __VA_ARGS__)) |
|
116 #endif |
|
117 |
|
118 #ifndef LOGI_IF |
|
119 #define LOGI_IF(cond, ...) \ |
|
120 ( (CONDITION(cond)) \ |
|
121 ? ((void)LOG(LOG_INFO, LOG_TAG, __VA_ARGS__)) \ |
|
122 : (void)0 ) |
|
123 #endif |
|
124 |
|
125 /* |
|
126 * Simplified macro to send a warning log message using the current LOG_TAG. |
|
127 */ |
|
128 #ifndef LOGW |
|
129 #define LOGW(...) ((void)LOG(LOG_WARN, LOG_TAG, __VA_ARGS__)) |
|
130 #endif |
|
131 |
|
132 #ifndef LOGW_IF |
|
133 #define LOGW_IF(cond, ...) \ |
|
134 ( (CONDITION(cond)) \ |
|
135 ? ((void)LOG(LOG_WARN, LOG_TAG, __VA_ARGS__)) \ |
|
136 : (void)0 ) |
|
137 #endif |
|
138 |
|
139 /* |
|
140 * Simplified macro to send an error log message using the current LOG_TAG. |
|
141 */ |
|
142 #ifndef LOGE |
|
143 #define LOGE(...) ((void)LOG(LOG_ERROR, LOG_TAG, __VA_ARGS__)) |
|
144 #endif |
|
145 |
|
146 #ifndef LOGE_IF |
|
147 #define LOGE_IF(cond, ...) \ |
|
148 ( (CONDITION(cond)) \ |
|
149 ? ((void)LOG(LOG_ERROR, LOG_TAG, __VA_ARGS__)) \ |
|
150 : (void)0 ) |
|
151 #endif |
|
152 |
|
153 // --------------------------------------------------------------------- |
|
154 |
|
155 /* |
|
156 * Conditional based on whether the current LOG_TAG is enabled at |
|
157 * verbose priority. |
|
158 */ |
|
159 #ifndef IF_LOGV |
|
160 #if LOG_NDEBUG |
|
161 #define IF_LOGV() if (false) |
|
162 #else |
|
163 #define IF_LOGV() IF_LOG(LOG_VERBOSE, LOG_TAG) |
|
164 #endif |
|
165 #endif |
|
166 |
|
167 /* |
|
168 * Conditional based on whether the current LOG_TAG is enabled at |
|
169 * debug priority. |
|
170 */ |
|
171 #ifndef IF_LOGD |
|
172 #define IF_LOGD() IF_LOG(LOG_DEBUG, LOG_TAG) |
|
173 #endif |
|
174 |
|
175 /* |
|
176 * Conditional based on whether the current LOG_TAG is enabled at |
|
177 * info priority. |
|
178 */ |
|
179 #ifndef IF_LOGI |
|
180 #define IF_LOGI() IF_LOG(LOG_INFO, LOG_TAG) |
|
181 #endif |
|
182 |
|
183 /* |
|
184 * Conditional based on whether the current LOG_TAG is enabled at |
|
185 * warn priority. |
|
186 */ |
|
187 #ifndef IF_LOGW |
|
188 #define IF_LOGW() IF_LOG(LOG_WARN, LOG_TAG) |
|
189 #endif |
|
190 |
|
191 /* |
|
192 * Conditional based on whether the current LOG_TAG is enabled at |
|
193 * error priority. |
|
194 */ |
|
195 #ifndef IF_LOGE |
|
196 #define IF_LOGE() IF_LOG(LOG_ERROR, LOG_TAG) |
|
197 #endif |
|
198 |
|
199 |
|
200 // --------------------------------------------------------------------- |
|
201 |
|
202 /* |
|
203 * Simplified macro to send a verbose system log message using the current LOG_TAG. |
|
204 */ |
|
205 #ifndef SLOGV |
|
206 #if LOG_NDEBUG |
|
207 #define SLOGV(...) ((void)0) |
|
208 #else |
|
209 #define SLOGV(...) ((void)__android_log_buf_print(LOG_ID_SYSTEM, ANDROID_LOG_VERBOSE, LOG_TAG, __VA_ARGS__)) |
|
210 #endif |
|
211 #endif |
|
212 |
|
213 #define CONDITION(cond) (__builtin_expect((cond)!=0, 0)) |
|
214 |
|
215 #ifndef SLOGV_IF |
|
216 #if LOG_NDEBUG |
|
217 #define SLOGV_IF(cond, ...) ((void)0) |
|
218 #else |
|
219 #define SLOGV_IF(cond, ...) \ |
|
220 ( (CONDITION(cond)) \ |
|
221 ? ((void)__android_log_buf_print(LOG_ID_SYSTEM, ANDROID_LOG_VERBOSE, LOG_TAG, __VA_ARGS__)) \ |
|
222 : (void)0 ) |
|
223 #endif |
|
224 #endif |
|
225 |
|
226 /* |
|
227 * Simplified macro to send a debug system log message using the current LOG_TAG. |
|
228 */ |
|
229 #ifndef SLOGD |
|
230 #define SLOGD(...) ((void)__android_log_buf_print(LOG_ID_SYSTEM, ANDROID_LOG_DEBUG, LOG_TAG, __VA_ARGS__)) |
|
231 #endif |
|
232 |
|
233 #ifndef SLOGD_IF |
|
234 #define SLOGD_IF(cond, ...) \ |
|
235 ( (CONDITION(cond)) \ |
|
236 ? ((void)__android_log_buf_print(LOG_ID_SYSTEM, ANDROID_LOG_DEBUG, LOG_TAG, __VA_ARGS__)) \ |
|
237 : (void)0 ) |
|
238 #endif |
|
239 |
|
240 /* |
|
241 * Simplified macro to send an info system log message using the current LOG_TAG. |
|
242 */ |
|
243 #ifndef SLOGI |
|
244 #define SLOGI(...) ((void)__android_log_buf_print(LOG_ID_SYSTEM, ANDROID_LOG_INFO, LOG_TAG, __VA_ARGS__)) |
|
245 #endif |
|
246 |
|
247 #ifndef SLOGI_IF |
|
248 #define SLOGI_IF(cond, ...) \ |
|
249 ( (CONDITION(cond)) \ |
|
250 ? ((void)__android_log_buf_print(LOG_ID_SYSTEM, ANDROID_LOG_INFO, LOG_TAG, __VA_ARGS__)) \ |
|
251 : (void)0 ) |
|
252 #endif |
|
253 |
|
254 /* |
|
255 * Simplified macro to send a warning system log message using the current LOG_TAG. |
|
256 */ |
|
257 #ifndef SLOGW |
|
258 #define SLOGW(...) ((void)__android_log_buf_print(LOG_ID_SYSTEM, ANDROID_LOG_WARN, LOG_TAG, __VA_ARGS__)) |
|
259 #endif |
|
260 |
|
261 #ifndef SLOGW_IF |
|
262 #define SLOGW_IF(cond, ...) \ |
|
263 ( (CONDITION(cond)) \ |
|
264 ? ((void)__android_log_buf_print(LOG_ID_SYSTEM, ANDROID_LOG_WARN, LOG_TAG, __VA_ARGS__)) \ |
|
265 : (void)0 ) |
|
266 #endif |
|
267 |
|
268 /* |
|
269 * Simplified macro to send an error system log message using the current LOG_TAG. |
|
270 */ |
|
271 #ifndef SLOGE |
|
272 #define SLOGE(...) ((void)__android_log_buf_print(LOG_ID_SYSTEM, ANDROID_LOG_ERROR, LOG_TAG, __VA_ARGS__)) |
|
273 #endif |
|
274 |
|
275 #ifndef SLOGE_IF |
|
276 #define SLOGE_IF(cond, ...) \ |
|
277 ( (CONDITION(cond)) \ |
|
278 ? ((void)__android_log_buf_print(LOG_ID_SYSTEM, ANDROID_LOG_ERROR, LOG_TAG, __VA_ARGS__)) \ |
|
279 : (void)0 ) |
|
280 #endif |
|
281 |
|
282 |
|
283 |
|
284 // --------------------------------------------------------------------- |
|
285 |
|
286 /* |
|
287 * Log a fatal error. If the given condition fails, this stops program |
|
288 * execution like a normal assertion, but also generating the given message. |
|
289 * It is NOT stripped from release builds. Note that the condition test |
|
290 * is -inverted- from the normal assert() semantics. |
|
291 */ |
|
292 #define LOG_ALWAYS_FATAL_IF(cond, ...) \ |
|
293 ( (CONDITION(cond)) \ |
|
294 ? ((void)android_printAssert(#cond, LOG_TAG, __VA_ARGS__)) \ |
|
295 : (void)0 ) |
|
296 |
|
297 #define LOG_ALWAYS_FATAL(...) \ |
|
298 ( ((void)android_printAssert(NULL, LOG_TAG, __VA_ARGS__)) ) |
|
299 |
|
300 /* |
|
301 * Versions of LOG_ALWAYS_FATAL_IF and LOG_ALWAYS_FATAL that |
|
302 * are stripped out of release builds. |
|
303 */ |
|
304 #if LOG_NDEBUG |
|
305 |
|
306 #define LOG_FATAL_IF(cond, ...) ((void)0) |
|
307 #define LOG_FATAL(...) ((void)0) |
|
308 |
|
309 #else |
|
310 |
|
311 #define LOG_FATAL_IF(cond, ...) LOG_ALWAYS_FATAL_IF(cond, __VA_ARGS__) |
|
312 #define LOG_FATAL(...) LOG_ALWAYS_FATAL(__VA_ARGS__) |
|
313 |
|
314 #endif |
|
315 |
|
316 /* |
|
317 * Assertion that generates a log message when the assertion fails. |
|
318 * Stripped out of release builds. Uses the current LOG_TAG. |
|
319 */ |
|
320 #define LOG_ASSERT(cond, ...) LOG_FATAL_IF(!(cond), __VA_ARGS__) |
|
321 //#define LOG_ASSERT(cond) LOG_FATAL_IF(!(cond), "Assertion failed: " #cond) |
|
322 |
|
323 // --------------------------------------------------------------------- |
|
324 |
|
325 /* |
|
326 * Basic log message macro. |
|
327 * |
|
328 * Example: |
|
329 * LOG(LOG_WARN, NULL, "Failed with error %d", errno); |
|
330 * |
|
331 * The second argument may be NULL or "" to indicate the "global" tag. |
|
332 */ |
|
333 #ifndef LOG |
|
334 #define LOG(priority, tag, ...) \ |
|
335 LOG_PRI(ANDROID_##priority, tag, __VA_ARGS__) |
|
336 #endif |
|
337 |
|
338 /* |
|
339 * Log macro that allows you to specify a number for the priority. |
|
340 */ |
|
341 #ifndef LOG_PRI |
|
342 #define LOG_PRI(priority, tag, ...) \ |
|
343 android_printLog(priority, tag, __VA_ARGS__) |
|
344 #endif |
|
345 |
|
346 /* |
|
347 * Log macro that allows you to pass in a varargs ("args" is a va_list). |
|
348 */ |
|
349 #ifndef LOG_PRI_VA |
|
350 #define LOG_PRI_VA(priority, tag, fmt, args) \ |
|
351 android_vprintLog(priority, NULL, tag, fmt, args) |
|
352 #endif |
|
353 |
|
354 /* |
|
355 * Conditional given a desired logging priority and tag. |
|
356 */ |
|
357 #ifndef IF_LOG |
|
358 #define IF_LOG(priority, tag) \ |
|
359 if (android_testLog(ANDROID_##priority, tag)) |
|
360 #endif |
|
361 |
|
362 // --------------------------------------------------------------------- |
|
363 |
|
364 /* |
|
365 * Event logging. |
|
366 */ |
|
367 |
|
368 /* |
|
369 * Event log entry types. These must match up with the declarations in |
|
370 * java/android/android/util/EventLog.java. |
|
371 */ |
|
372 typedef enum { |
|
373 EVENT_TYPE_INT = 0, |
|
374 EVENT_TYPE_LONG = 1, |
|
375 EVENT_TYPE_STRING = 2, |
|
376 EVENT_TYPE_LIST = 3, |
|
377 } AndroidEventLogType; |
|
378 |
|
379 |
|
380 #define LOG_EVENT_INT(_tag, _value) { \ |
|
381 int intBuf = _value; \ |
|
382 (void) android_btWriteLog(_tag, EVENT_TYPE_INT, &intBuf, \ |
|
383 sizeof(intBuf)); \ |
|
384 } |
|
385 #define LOG_EVENT_LONG(_tag, _value) { \ |
|
386 long long longBuf = _value; \ |
|
387 (void) android_btWriteLog(_tag, EVENT_TYPE_LONG, &longBuf, \ |
|
388 sizeof(longBuf)); \ |
|
389 } |
|
390 #define LOG_EVENT_STRING(_tag, _value) \ |
|
391 ((void) 0) /* not implemented -- must combine len with string */ |
|
392 /* TODO: something for LIST */ |
|
393 |
|
394 /* |
|
395 * =========================================================================== |
|
396 * |
|
397 * The stuff in the rest of this file should not be used directly. |
|
398 */ |
|
399 |
|
400 #define android_printLog(prio, tag, fmt...) \ |
|
401 __android_log_print(prio, tag, fmt) |
|
402 |
|
403 #define android_vprintLog(prio, cond, tag, fmt...) \ |
|
404 __android_log_vprint(prio, tag, fmt) |
|
405 |
|
406 #define android_printAssert(cond, tag, fmt...) \ |
|
407 __android_log_assert(cond, tag, fmt) |
|
408 |
|
409 #define android_writeLog(prio, tag, text) \ |
|
410 __android_log_write(prio, tag, text) |
|
411 |
|
412 #define android_bWriteLog(tag, payload, len) \ |
|
413 __android_log_bwrite(tag, payload, len) |
|
414 #define android_btWriteLog(tag, type, payload, len) \ |
|
415 __android_log_btwrite(tag, type, payload, len) |
|
416 |
|
417 // TODO: remove these prototypes and their users |
|
418 #define android_testLog(prio, tag) (1) |
|
419 #define android_writevLog(vec,num) do{}while(0) |
|
420 #define android_write1Log(str,len) do{}while (0) |
|
421 #define android_setMinPriority(tag, prio) do{}while(0) |
|
422 //#define android_logToCallback(func) do{}while(0) |
|
423 #define android_logToFile(tag, file) (0) |
|
424 #define android_logToFd(tag, fd) (0) |
|
425 |
|
426 typedef enum { |
|
427 LOG_ID_MAIN = 0, |
|
428 LOG_ID_RADIO = 1, |
|
429 LOG_ID_EVENTS = 2, |
|
430 LOG_ID_SYSTEM = 3, |
|
431 |
|
432 LOG_ID_MAX |
|
433 } log_id_t; |
|
434 |
|
435 /* |
|
436 * Send a simple string to the log. |
|
437 */ |
|
438 int __android_log_buf_write(int bufID, int prio, const char *tag, const char *text); |
|
439 int __android_log_buf_print(int bufID, int prio, const char *tag, const char *fmt, ...); |
|
440 |
|
441 |
|
442 #ifdef __cplusplus |
|
443 } |
|
444 #endif |
|
445 |
|
446 #endif // _LIBS_CUTILS_LOG_H |