event_tag_map.h revision c9e5f3716626fb8fcbde87c2f7324cc9292a0bd5
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 24dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project#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) 45807e40ecc9786755e2f74a7a6a9b20c812588119Mark Salyzyn __attribute__((deprecated("use android_lookupEventTag_len() instead to minimize MAP_PRIVATE copy-on-write memory impact"))); 46807e40ecc9786755e2f74a7a6a9b20c812588119Mark Salyzyn 47807e40ecc9786755e2f74a7a6a9b20c812588119Mark Salyzyn/* 48807e40ecc9786755e2f74a7a6a9b20c812588119Mark Salyzyn * Look up a tag by index. Returns the tag string & string length, or NULL if 49807e40ecc9786755e2f74a7a6a9b20c812588119Mark Salyzyn * not found. Returned string is not guaranteed to be nul terminated. 50807e40ecc9786755e2f74a7a6a9b20c812588119Mark Salyzyn */ 51530711b39e0447b0ce6824de936cedc294634e0eMark Salyzynconst char* android_lookupEventTag_len(const EventTagMap* map, 52530711b39e0447b0ce6824de936cedc294634e0eMark Salyzyn size_t* len, unsigned int tag); 53530711b39e0447b0ce6824de936cedc294634e0eMark Salyzyn 54530711b39e0447b0ce6824de936cedc294634e0eMark Salyzyn/* 55530711b39e0447b0ce6824de936cedc294634e0eMark Salyzyn * Look up a format by index. Returns the format string & string length, 56530711b39e0447b0ce6824de936cedc294634e0eMark Salyzyn * or NULL if not found. Returned string is not guaranteed to be nul terminated. 57530711b39e0447b0ce6824de936cedc294634e0eMark Salyzyn */ 58530711b39e0447b0ce6824de936cedc294634e0eMark Salyzynconst char* android_lookupEventFormat_len(const EventTagMap* map, 59530711b39e0447b0ce6824de936cedc294634e0eMark Salyzyn size_t* len, unsigned int tag); 60dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project 61c9e5f3716626fb8fcbde87c2f7324cc9292a0bd5Mark Salyzyn/* 62c9e5f3716626fb8fcbde87c2f7324cc9292a0bd5Mark Salyzyn * Look up tagname, generate one if necessary, and return a tag 63c9e5f3716626fb8fcbde87c2f7324cc9292a0bd5Mark Salyzyn */ 64c9e5f3716626fb8fcbde87c2f7324cc9292a0bd5Mark Salyzynint android_lookupEventTagNum(EventTagMap* map, const char* tagname, 65c9e5f3716626fb8fcbde87c2f7324cc9292a0bd5Mark Salyzyn const char* format, int prio); 66c9e5f3716626fb8fcbde87c2f7324cc9292a0bd5Mark Salyzyn 67dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project#ifdef __cplusplus 68dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project} 69dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project#endif 70dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project 71dd7bc3319deb2b77c5d07a51b7d6cd7e11b5beb0The Android Open Source Project#endif /*_LIBS_CUTILS_EVENTTAGMAP_H*/ 72