media/omx-plugin/include/froyo/cutils/log.h@b8a032363ba2
media/omx-plugin/include/froyo/cutils/log.h
Thu, 22 Jan 2015 13:21:57 +0100
- author
- Michael Schloh von Bennewitz <michael@schloh.com>
- date
- Thu, 22 Jan 2015 13:21:57 +0100
- branch
- TOR_BUG_9701
- changeset 15
- b8a032363ba2
- permissions
- -rw-r--r--
Incorporate requested changes from Mozilla in review:
https://bugzilla.mozilla.org/show_bug.cgi?id=1123480#c6
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 */
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
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>
40 #include <cutils/uio.h>
41 #include <cutils/logd.h>
43 #ifdef __cplusplus
44 extern "C" {
45 #endif
47 // ---------------------------------------------------------------------
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
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
71 // ---------------------------------------------------------------------
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
84 #define CONDITION(cond) (__builtin_expect((cond)!=0, 0))
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
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
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
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
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
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
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
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
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
153 // ---------------------------------------------------------------------
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
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
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
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
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
200 // ---------------------------------------------------------------------
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
213 #define CONDITION(cond) (__builtin_expect((cond)!=0, 0))
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
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
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
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
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
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
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
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
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
284 // ---------------------------------------------------------------------
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 )
297 #define LOG_ALWAYS_FATAL(...) \
298 ( ((void)android_printAssert(NULL, LOG_TAG, __VA_ARGS__)) )
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
306 #define LOG_FATAL_IF(cond, ...) ((void)0)
307 #define LOG_FATAL(...) ((void)0)
309 #else
311 #define LOG_FATAL_IF(cond, ...) LOG_ALWAYS_FATAL_IF(cond, __VA_ARGS__)
312 #define LOG_FATAL(...) LOG_ALWAYS_FATAL(__VA_ARGS__)
314 #endif
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)
323 // ---------------------------------------------------------------------
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
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
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
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
362 // ---------------------------------------------------------------------
364 /*
365 * Event logging.
366 */
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;
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 */
394 /*
395 * ===========================================================================
396 *
397 * The stuff in the rest of this file should not be used directly.
398 */
400 #define android_printLog(prio, tag, fmt...) \
401 __android_log_print(prio, tag, fmt)
403 #define android_vprintLog(prio, cond, tag, fmt...) \
404 __android_log_vprint(prio, tag, fmt)
406 #define android_printAssert(cond, tag, fmt...) \
407 __android_log_assert(cond, tag, fmt)
409 #define android_writeLog(prio, tag, text) \
410 __android_log_write(prio, tag, text)
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)
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)
426 typedef enum {
427 LOG_ID_MAIN = 0,
428 LOG_ID_RADIO = 1,
429 LOG_ID_EVENTS = 2,
430 LOG_ID_SYSTEM = 3,
432 LOG_ID_MAX
433 } log_id_t;
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, ...);
442 #ifdef __cplusplus
443 }
444 #endif
446 #endif // _LIBS_CUTILS_LOG_H
