1dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project/* 2dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project * Copyright (C) 2007 The Android Open Source Project 3dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project * 4dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 5dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project * you may not use this file except in compliance with the License. 6dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project * You may obtain a copy of the License at 7dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project * 8dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 9dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project * 10dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 11dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 12dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project * See the License for the specific language governing permissions and 14dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project * limitations under the License. 15dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project */ 16dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project 17dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project#ifndef _LIBS_CUTILS_EVENTTAGMAP_H 18dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project#define _LIBS_CUTILS_EVENTTAGMAP_H 19dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project 20dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project#ifdef __cplusplus 21dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Projectextern "C" { 22dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project#endif 23dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project 242ed51d708eda64516ec79ac6397f690de38f0075Mark Salyzyn#define EVENT_TAG_MAP_FILE "/system/etc/event-log-tags" 25dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project 26dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Projectstruct EventTagMap; 27dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Projecttypedef struct EventTagMap EventTagMap; 28dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project 29dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project/* 30dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project * Open the specified file as an event log tag map. 31dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project * 32dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project * Returns NULL on failure. 33dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project */ 34dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source ProjectEventTagMap* android_openEventTagMap(const char* fileName); 35dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project 36dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project/* 37dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project * Close the map. 38dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project */ 39dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Projectvoid android_closeEventTagMap(EventTagMap* map); 40dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project 41dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project/* 42dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project * Look up a tag by index. Returns the tag string, or NULL if not found. 43dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project */ 44807e40ecc9786755e2f74a7a6a9b20c812588119Mark Salyzynconst char* android_lookupEventTag(const EventTagMap* map, unsigned int tag) 452ed51d708eda64516ec79ac6397f690de38f0075Mark Salyzyn __attribute__(( 462ed51d708eda64516ec79ac6397f690de38f0075Mark Salyzyn deprecated("use android_lookupEventTag_len() instead to minimize " 472ed51d708eda64516ec79ac6397f690de38f0075Mark Salyzyn "MAP_PRIVATE copy-on-write memory impact"))); 48807e40ecc9786755e2f74a7a6a9b20c812588119Mark Salyzyn 49807e40ecc9786755e2f74a7a6a9b20c812588119Mark Salyzyn/* 50807e40ecc9786755e2f74a7a6a9b20c812588119Mark Salyzyn * Look up a tag by index. Returns the tag string & string length, or NULL if 51807e40ecc9786755e2f74a7a6a9b20c812588119Mark Salyzyn * not found. Returned string is not guaranteed to be nul terminated. 52807e40ecc9786755e2f74a7a6a9b20c812588119Mark Salyzyn */ 532ed51d708eda64516ec79ac6397f690de38f0075Mark Salyzynconst char* android_lookupEventTag_len(const EventTagMap* map, size_t* len, 542ed51d708eda64516ec79ac6397f690de38f0075Mark Salyzyn unsigned int tag); 55530711b39e0447b0ce6824de936cedc294634e0eMark Salyzyn 56530711b39e0447b0ce6824de936cedc294634e0eMark Salyzyn/* 57530711b39e0447b0ce6824de936cedc294634e0eMark Salyzyn * Look up a format by index. Returns the format string & string length, 58530711b39e0447b0ce6824de936cedc294634e0eMark Salyzyn * or NULL if not found. Returned string is not guaranteed to be nul terminated. 59530711b39e0447b0ce6824de936cedc294634e0eMark Salyzyn */ 602ed51d708eda64516ec79ac6397f690de38f0075Mark Salyzynconst char* android_lookupEventFormat_len(const EventTagMap* map, size_t* len, 612ed51d708eda64516ec79ac6397f690de38f0075Mark Salyzyn unsigned int tag); 62dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project 63c9e5f3716626fb8fcbde87c2f7324cc9292a0bd5Mark Salyzyn/* 64c9e5f3716626fb8fcbde87c2f7324cc9292a0bd5Mark Salyzyn * Look up tagname, generate one if necessary, and return a tag 65c9e5f3716626fb8fcbde87c2f7324cc9292a0bd5Mark Salyzyn */ 66c9e5f3716626fb8fcbde87c2f7324cc9292a0bd5Mark Salyzynint android_lookupEventTagNum(EventTagMap* map, const char* tagname, 67c9e5f3716626fb8fcbde87c2f7324cc9292a0bd5Mark Salyzyn const char* format, int prio); 68c9e5f3716626fb8fcbde87c2f7324cc9292a0bd5Mark Salyzyn 69dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project#ifdef __cplusplus 70dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project} 71dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project#endif 72dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project 73dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project#endif /*_LIBS_CUTILS_EVENTTAGMAP_H*/ 74