1edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project/* 2edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * Copyright (C) 2005 The Android Open Source Project 3edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * 4edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 5edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * you may not use this file except in compliance with the License. 6edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * You may obtain a copy of the License at 7edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * 8edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 9edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * 10edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 11edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 12edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * See the License for the specific language governing permissions and 14edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * limitations under the License. 15edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project */ 16edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 17edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// 18edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// C/C++ logging functions. See the logging documentation for API details. 19edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// 20edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// We'd like these to be available from C code (in case we import some from 21edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// somewhere), so this has a C interface. 22edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// 23edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// The output will be correct when the log file is shared between multiple 24edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// threads and/or multiple processes so long as the operating system 25edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// supports O_APPEND. These calls have mutex-protected data structures 26edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// and so are NOT reentrant. Do not use LOG in a signal handler. 27edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// 28edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#ifndef _LIBS_UTILS_LOG_H 29edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#define _LIBS_UTILS_LOG_H 30edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 31edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#include <cutils/log.h> 326f12d573251528086636707dde2fb01a8b7199b8Jeff Brown#include <sys/types.h> 336f12d573251528086636707dde2fb01a8b7199b8Jeff Brown 346f12d573251528086636707dde2fb01a8b7199b8Jeff Brown#ifdef __cplusplus 356f12d573251528086636707dde2fb01a8b7199b8Jeff Brown 366f12d573251528086636707dde2fb01a8b7199b8Jeff Brownnamespace android { 376f12d573251528086636707dde2fb01a8b7199b8Jeff Brown 386f12d573251528086636707dde2fb01a8b7199b8Jeff Brown/* 396f12d573251528086636707dde2fb01a8b7199b8Jeff Brown * A very simple utility that yells in the log when an operation takes too long. 406f12d573251528086636707dde2fb01a8b7199b8Jeff Brown */ 416f12d573251528086636707dde2fb01a8b7199b8Jeff Brownclass LogIfSlow { 426f12d573251528086636707dde2fb01a8b7199b8Jeff Brownpublic: 436f12d573251528086636707dde2fb01a8b7199b8Jeff Brown LogIfSlow(const char* tag, android_LogPriority priority, 446f12d573251528086636707dde2fb01a8b7199b8Jeff Brown int timeoutMillis, const char* message); 456f12d573251528086636707dde2fb01a8b7199b8Jeff Brown ~LogIfSlow(); 466f12d573251528086636707dde2fb01a8b7199b8Jeff Brown 476f12d573251528086636707dde2fb01a8b7199b8Jeff Brownprivate: 486f12d573251528086636707dde2fb01a8b7199b8Jeff Brown const char* const mTag; 496f12d573251528086636707dde2fb01a8b7199b8Jeff Brown const android_LogPriority mPriority; 506f12d573251528086636707dde2fb01a8b7199b8Jeff Brown const int mTimeoutMillis; 516f12d573251528086636707dde2fb01a8b7199b8Jeff Brown const char* const mMessage; 526f12d573251528086636707dde2fb01a8b7199b8Jeff Brown const int64_t mStart; 536f12d573251528086636707dde2fb01a8b7199b8Jeff Brown}; 546f12d573251528086636707dde2fb01a8b7199b8Jeff Brown 556f12d573251528086636707dde2fb01a8b7199b8Jeff Brown/* 566f12d573251528086636707dde2fb01a8b7199b8Jeff Brown * Writes the specified debug log message if this block takes longer than the 576f12d573251528086636707dde2fb01a8b7199b8Jeff Brown * specified number of milliseconds to run. Includes the time actually taken. 586f12d573251528086636707dde2fb01a8b7199b8Jeff Brown * 596f12d573251528086636707dde2fb01a8b7199b8Jeff Brown * { 606f12d573251528086636707dde2fb01a8b7199b8Jeff Brown * ALOGD_IF_SLOW(50, "Excessive delay doing something."); 616f12d573251528086636707dde2fb01a8b7199b8Jeff Brown * doSomething(); 626f12d573251528086636707dde2fb01a8b7199b8Jeff Brown * } 636f12d573251528086636707dde2fb01a8b7199b8Jeff Brown */ 646f12d573251528086636707dde2fb01a8b7199b8Jeff Brown#define ALOGD_IF_SLOW(timeoutMillis, message) \ 656f12d573251528086636707dde2fb01a8b7199b8Jeff Brown LogIfSlow _logIfSlow(LOG_TAG, ANDROID_LOG_DEBUG, timeoutMillis, message); 666f12d573251528086636707dde2fb01a8b7199b8Jeff Brown 676f12d573251528086636707dde2fb01a8b7199b8Jeff Brown} // namespace android 686f12d573251528086636707dde2fb01a8b7199b8Jeff Brown 696f12d573251528086636707dde2fb01a8b7199b8Jeff Brown#endif // __cplusplus 70edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 71edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#endif // _LIBS_UTILS_LOG_H 72