3 * Copyright (c) 2005-2008, The Android Open Source Project
4 * Copyright (c) 2012-2013 Samsung Electronics Co., Ltd.
6 * Licensed under the Apache License, Version 2.0 (the License);
7 * you may not use this file except in compliance with the License.
8 * You may obtain a copy of the License at
10 * http://www.apache.org/licenses/LICENSE-2.0
12 * Unless required by applicable law or agreed to in writing, software
13 * distributed under the License is distributed on an "AS IS" BASIS,
14 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 * See the License for the specific language governing permissions and
16 * limitations under the License.
44 typedef struct log_format_t log_format;
46 typedef struct log_entry_t {
49 log_priority priority;
57 log_format *log_format_new();
59 void log_format_free(log_format *p_format);
61 void log_set_print_format(log_format *p_format,
62 log_print_format format);
65 * Returns FORMAT_OFF on invalid string
67 log_print_format log_format_from_string(const char *s);
70 * filterExpression: a single filter expression
73 * returns 0 on success and -1 on invalid expression
75 * Assumes single threaded execution
79 int log_add_filter_rule(log_format *p_format,
80 const char *filterExpression);
84 * filterString: a whitespace-separated set of filter expressions
87 * returns 0 on success and -1 on invalid expression
89 * Assumes single threaded execution
93 int log_add_filter_string(log_format *p_format,
94 const char *filterString);
98 * returns 1 if this log line should be printed based on its priority
99 * and tag, and 0 if it should not
101 int log_should_print_line (
102 log_format *p_format, const char *tag, log_priority pri);
106 * Splits a wire-format buffer into an log_entry
107 * entry allocated by caller. Pointers will point directly into buf
109 * Returns 0 on success and -1 on invalid wire format (entry will be
110 * in unspecified state)
112 int log_process_log_buffer(struct logger_entry *buf,
116 * Formats a log message into a buffer
118 * Uses defaultBuffer if it can, otherwise malloc()'s a new buffer
119 * If return value != defaultBuffer, caller must call free()
120 * Returns NULL on malloc error
123 char *log_format_log_line (
124 log_format *p_format,
126 size_t defaultBufferSize,
127 const log_entry *p_line,
128 size_t *p_outLength);
132 * Either print or do not print log line, based on filter
134 * Assumes single threaded execution
137 int log_print_log_line(
138 log_format *p_format,
140 const log_entry *entry);
143 * logprint test furction
146 void logprint_run_tests(void);
152 #endif /*_LOGPRINT_H*/