diff options
author | Chris Craik <ccraik@google.com> | 2015-06-10 23:48:13 +0000 |
---|---|---|
committer | Android (Google) Code Review <android-gerrit@google.com> | 2015-06-10 23:48:14 +0000 |
commit | 8a4222a647bd17c991959eca17a50ba911c3ab6b (patch) | |
tree | aa33f1f19b4990a53109d8b07c14b3be687104a7 /include | |
parent | 52720f45098e9aed57c906e64a13e4a4a2173ce8 (diff) | |
parent | 6a40d678eadceb67b119a056726c5fcb3dce6b21 (diff) | |
download | frameworks_native-8a4222a647bd17c991959eca17a50ba911c3ab6b.zip frameworks_native-8a4222a647bd17c991959eca17a50ba911c3ab6b.tar.gz frameworks_native-8a4222a647bd17c991959eca17a50ba911c3ab6b.tar.bz2 |
Merge "Add tracing header" into mnc-dev
Diffstat (limited to 'include')
-rw-r--r-- | include/android/trace.h | 55 |
1 files changed, 55 insertions, 0 deletions
diff --git a/include/android/trace.h b/include/android/trace.h new file mode 100644 index 0000000..e42e334 --- /dev/null +++ b/include/android/trace.h @@ -0,0 +1,55 @@ +/* + * Copyright (C) 2015 The Android Open Source Project + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + + +#ifndef ANDROID_NATIVE_TRACE_H +#define ANDROID_NATIVE_TRACE_H + +#include <stdbool.h> + +#ifdef __cplusplus +extern "C" { +#endif + +/** + * Returns true if tracing is enabled. Use this signal to avoid expensive computation only necessary + * when tracing is enabled. + */ +bool ATrace_isEnabled(); + +/** + * Writes a tracing message to indicate that the given section of code has begun. This call must be + * followed by a corresponding call to endSection() on the same thread. + * + * Note: At this time the vertical bar character '|' and newline character '\n' are used internally + * by the tracing mechanism. If sectionName contains these characters they will be replaced with a + * space character in the trace. + */ +void ATrace_beginSection(const char* sectionName); + +/** + * Writes a tracing message to indicate that a given section of code has ended. This call must be + * preceeded by a corresponding call to beginSection(char*) on the same thread. Calling this method + * will mark the end of the most recently begun section of code, so care must be taken to ensure + * that beginSection / endSection pairs are properly nested and called from the same thread. + */ +void ATrace_endSection(); + +#ifdef __cplusplus +}; +#endif + +#endif // ANDROID_NATIVE_TRACE_H |