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_UTILS_LOG_H 29 #define _LIBS_UTILS_LOG_H 30 31 #include <sys/types.h> 32 33 #include <log/log.h> 34 35 #ifdef __cplusplus 36 37 namespace android { 38 39 /* 40 * A very simple utility that yells in the log when an operation takes too long. 41 */ 42 class LogIfSlow { 43 public: 44 LogIfSlow(const char* tag, android_LogPriority priority, 45 int timeoutMillis, const char* message); 46 ~LogIfSlow(); 47 48 private: 49 const char* const mTag; 50 const android_LogPriority mPriority; 51 const int mTimeoutMillis; 52 const char* const mMessage; 53 const int64_t mStart; 54 }; 55 56 /* 57 * Writes the specified debug log message if this block takes longer than the 58 * specified number of milliseconds to run. Includes the time actually taken. 59 * 60 * { 61 * ALOGD_IF_SLOW(50, "Excessive delay doing something."); 62 * doSomething(); 63 * } 64 */ 65 #define ALOGD_IF_SLOW(timeoutMillis, message) \ 66 android::LogIfSlow _logIfSlow(LOG_TAG, ANDROID_LOG_DEBUG, timeoutMillis, message); 67 68 } // namespace android 69 70 #endif // __cplusplus 71 72 #endif // _LIBS_UTILS_LOG_H 73