19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2006 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.util; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19f8880561e67e1da246970b49b14285efd4164ab1Jeff Sharkeyimport android.os.DeadSystemException; 20f8880561e67e1da246970b49b14285efd4164ab1Jeff Sharkey 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport com.android.internal.os.RuntimeInit; 228c84109b9fbbf473b225707a38261ff5f99d95fbDianne Hackbornimport com.android.internal.util.FastPrintWriter; 238413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampeimport com.android.internal.util.LineBreakBufferedWriter; 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.io.PrintWriter; 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.io.StringWriter; 278413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampeimport java.io.Writer; 28dba50c7ed24e05ff349a94b8c4a6d9bb9050973bJoe Onoratoimport java.net.UnknownHostException; 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * API for sending log output. 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Generally, use the Log.v() Log.d() Log.i() Log.w() and Log.e() 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * methods. 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>The order in terms of verbosity, from least to most is 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ERROR, WARN, INFO, DEBUG, VERBOSE. Verbose should never be compiled 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * into an application except during development. Debug logs are compiled 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in but stripped at runtime. Error, warning and info logs are always kept. 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p><b>Tip:</b> A good convention is to declare a <code>TAG</code> constant 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in your class: 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <pre>private static final String TAG = "MyActivity";</pre> 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and use that in subsequent calls to the log methods. 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </p> 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p><b>Tip:</b> Don't forget that when you make a call like 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <pre>Log.v(TAG, "index=" + i);</pre> 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that when you're building the string to pass into Log.d, the compiler uses a 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * StringBuilder and at least three allocations occur: the StringBuilder 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * itself, the buffer, and the String object. Realistically, there is also 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * another buffer allocation and copy, and even more pressure on the gc. 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * That means that if your log message is filtered out, you might be doing 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * significant work and incurring significant overhead. 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic final class Log { 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Priority constant for the println method; use Log.v. 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int VERBOSE = 2; 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Priority constant for the println method; use Log.d. 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int DEBUG = 3; 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Priority constant for the println method; use Log.i. 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int INFO = 4; 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Priority constant for the println method; use Log.w. 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WARN = 5; 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Priority constant for the println method; use Log.e. 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ERROR = 6; 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Priority constant for the println method. 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ASSERT = 7; 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9060d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor /** 91164371fb759bad6854570af0fca60d9a01e17235Dianne Hackborn * Exception class used to capture a stack trace in {@link #wtf}. 9260d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor */ 9360d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor private static class TerribleFailure extends Exception { 9460d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor TerribleFailure(String msg, Throwable cause) { super(msg, cause); } 9560d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor } 9660d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor 9744dc76a8a702d6a919fcea1c2d19ba3792687c85Brad Fitzpatrick /** 98164371fb759bad6854570af0fca60d9a01e17235Dianne Hackborn * Interface to handle terrible failures from {@link #wtf}. 9944dc76a8a702d6a919fcea1c2d19ba3792687c85Brad Fitzpatrick * 10044dc76a8a702d6a919fcea1c2d19ba3792687c85Brad Fitzpatrick * @hide 10144dc76a8a702d6a919fcea1c2d19ba3792687c85Brad Fitzpatrick */ 10244dc76a8a702d6a919fcea1c2d19ba3792687c85Brad Fitzpatrick public interface TerribleFailureHandler { 1035232271a41323594ae406be7476b6ca2f08af3d8Dianne Hackborn void onTerribleFailure(String tag, TerribleFailure what, boolean system); 10444dc76a8a702d6a919fcea1c2d19ba3792687c85Brad Fitzpatrick } 10544dc76a8a702d6a919fcea1c2d19ba3792687c85Brad Fitzpatrick 10644dc76a8a702d6a919fcea1c2d19ba3792687c85Brad Fitzpatrick private static TerribleFailureHandler sWtfHandler = new TerribleFailureHandler() { 1075232271a41323594ae406be7476b6ca2f08af3d8Dianne Hackborn public void onTerribleFailure(String tag, TerribleFailure what, boolean system) { 1085232271a41323594ae406be7476b6ca2f08af3d8Dianne Hackborn RuntimeInit.wtf(tag, what, system); 10944dc76a8a702d6a919fcea1c2d19ba3792687c85Brad Fitzpatrick } 11044dc76a8a702d6a919fcea1c2d19ba3792687c85Brad Fitzpatrick }; 11144dc76a8a702d6a919fcea1c2d19ba3792687c85Brad Fitzpatrick 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private Log() { 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Send a {@link #VERBOSE} log message. 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag Used to identify the source of a log message. It usually identifies 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the class or activity where the log call occurs. 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param msg The message you would like logged. 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int v(String tag, String msg) { 12200bb93823d082c31d757bd7b75a8615afbd2c1a5Joe Onorato return println_native(LOG_ID_MAIN, VERBOSE, tag, msg); 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Send a {@link #VERBOSE} log message and log the exception. 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag Used to identify the source of a log message. It usually identifies 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the class or activity where the log call occurs. 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param msg The message you would like logged. 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tr An exception to log 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int v(String tag, String msg, Throwable tr) { 1338413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe return printlns(LOG_ID_MAIN, VERBOSE, tag, msg, tr); 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Send a {@link #DEBUG} log message. 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag Used to identify the source of a log message. It usually identifies 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the class or activity where the log call occurs. 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param msg The message you would like logged. 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int d(String tag, String msg) { 14300bb93823d082c31d757bd7b75a8615afbd2c1a5Joe Onorato return println_native(LOG_ID_MAIN, DEBUG, tag, msg); 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Send a {@link #DEBUG} log message and log the exception. 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag Used to identify the source of a log message. It usually identifies 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the class or activity where the log call occurs. 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param msg The message you would like logged. 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tr An exception to log 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int d(String tag, String msg, Throwable tr) { 1548413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe return printlns(LOG_ID_MAIN, DEBUG, tag, msg, tr); 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Send an {@link #INFO} log message. 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag Used to identify the source of a log message. It usually identifies 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the class or activity where the log call occurs. 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param msg The message you would like logged. 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int i(String tag, String msg) { 16400bb93823d082c31d757bd7b75a8615afbd2c1a5Joe Onorato return println_native(LOG_ID_MAIN, INFO, tag, msg); 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Send a {@link #INFO} log message and log the exception. 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag Used to identify the source of a log message. It usually identifies 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the class or activity where the log call occurs. 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param msg The message you would like logged. 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tr An exception to log 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int i(String tag, String msg, Throwable tr) { 1758413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe return printlns(LOG_ID_MAIN, INFO, tag, msg, tr); 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Send a {@link #WARN} log message. 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag Used to identify the source of a log message. It usually identifies 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the class or activity where the log call occurs. 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param msg The message you would like logged. 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int w(String tag, String msg) { 18500bb93823d082c31d757bd7b75a8615afbd2c1a5Joe Onorato return println_native(LOG_ID_MAIN, WARN, tag, msg); 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Send a {@link #WARN} log message and log the exception. 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag Used to identify the source of a log message. It usually identifies 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the class or activity where the log call occurs. 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param msg The message you would like logged. 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tr An exception to log 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int w(String tag, String msg, Throwable tr) { 1968413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe return printlns(LOG_ID_MAIN, WARN, tag, msg, tr); 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Checks to see whether or not a log for the specified tag is loggable at the specified level. 20160d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The default level of any tag is set to INFO. This means that any level above and including 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * INFO will be logged. Before you make any calls to a logging method you should check to see 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if your tag should be logged. You can change the default level by setting a system property: 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 'setprop log.tag.<YOUR_LOG_TAG> <LEVEL>' 20660d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * Where level is either VERBOSE, DEBUG, INFO, WARN, ERROR, ASSERT, or SUPPRESS. SUPPRESS will 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * turn off all logging for your tag. You can also create a local.prop file that with the 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * following in it: 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 'log.tag.<YOUR_LOG_TAG>=<LEVEL>' 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and place that in /data/local.prop. 21160d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag The tag to check. 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param level The level to check. 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Whether or not that this is allowed to be logged. 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException is thrown if the tag.length() > 23. 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static native boolean isLoggable(String tag, int level); 21860d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Send a {@link #WARN} log message and log the exception. 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag Used to identify the source of a log message. It usually identifies 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the class or activity where the log call occurs. 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tr An exception to log 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int w(String tag, Throwable tr) { 2268413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe return printlns(LOG_ID_MAIN, WARN, tag, "", tr); 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Send an {@link #ERROR} log message. 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag Used to identify the source of a log message. It usually identifies 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the class or activity where the log call occurs. 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param msg The message you would like logged. 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int e(String tag, String msg) { 23600bb93823d082c31d757bd7b75a8615afbd2c1a5Joe Onorato return println_native(LOG_ID_MAIN, ERROR, tag, msg); 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Send a {@link #ERROR} log message and log the exception. 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag Used to identify the source of a log message. It usually identifies 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the class or activity where the log call occurs. 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param msg The message you would like logged. 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tr An exception to log 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int e(String tag, String msg, Throwable tr) { 2478413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe return printlns(LOG_ID_MAIN, ERROR, tag, msg, tr); 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 25160d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * What a Terrible Failure: Report a condition that should never happen. 25260d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * The error will always be logged at level ASSERT with the call stack. 25360d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * Depending on system configuration, a report may be added to the 25460d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * {@link android.os.DropBoxManager} and/or the process may be terminated 25560d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * immediately with an error dialog. 25660d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * @param tag Used to identify the source of a log message. 25760d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * @param msg The message you would like logged. 25860d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor */ 25960d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor public static int wtf(String tag, String msg) { 2605232271a41323594ae406be7476b6ca2f08af3d8Dianne Hackborn return wtf(LOG_ID_MAIN, tag, msg, null, false, false); 26160d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor } 26260d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor 26360d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor /** 264164371fb759bad6854570af0fca60d9a01e17235Dianne Hackborn * Like {@link #wtf(String, String)}, but also writes to the log the full 265164371fb759bad6854570af0fca60d9a01e17235Dianne Hackborn * call stack. 266164371fb759bad6854570af0fca60d9a01e17235Dianne Hackborn * @hide 267164371fb759bad6854570af0fca60d9a01e17235Dianne Hackborn */ 268164371fb759bad6854570af0fca60d9a01e17235Dianne Hackborn public static int wtfStack(String tag, String msg) { 2695232271a41323594ae406be7476b6ca2f08af3d8Dianne Hackborn return wtf(LOG_ID_MAIN, tag, msg, null, true, false); 270164371fb759bad6854570af0fca60d9a01e17235Dianne Hackborn } 271164371fb759bad6854570af0fca60d9a01e17235Dianne Hackborn 272164371fb759bad6854570af0fca60d9a01e17235Dianne Hackborn /** 27360d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * What a Terrible Failure: Report an exception that should never happen. 27460d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * Similar to {@link #wtf(String, String)}, with an exception to log. 27560d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * @param tag Used to identify the source of a log message. 27660d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * @param tr An exception to log. 27760d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor */ 27860d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor public static int wtf(String tag, Throwable tr) { 2795232271a41323594ae406be7476b6ca2f08af3d8Dianne Hackborn return wtf(LOG_ID_MAIN, tag, tr.getMessage(), tr, false, false); 28060d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor } 28160d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor 28260d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor /** 28360d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * What a Terrible Failure: Report an exception that should never happen. 28460d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * Similar to {@link #wtf(String, Throwable)}, with a message as well. 28560d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * @param tag Used to identify the source of a log message. 28660d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * @param msg The message you would like logged. 28760d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor * @param tr An exception to log. May be null. 28860d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor */ 28960d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor public static int wtf(String tag, String msg, Throwable tr) { 2905232271a41323594ae406be7476b6ca2f08af3d8Dianne Hackborn return wtf(LOG_ID_MAIN, tag, msg, tr, false, false); 291164371fb759bad6854570af0fca60d9a01e17235Dianne Hackborn } 292164371fb759bad6854570af0fca60d9a01e17235Dianne Hackborn 2935232271a41323594ae406be7476b6ca2f08af3d8Dianne Hackborn static int wtf(int logId, String tag, String msg, Throwable tr, boolean localStack, 2945232271a41323594ae406be7476b6ca2f08af3d8Dianne Hackborn boolean system) { 29544dc76a8a702d6a919fcea1c2d19ba3792687c85Brad Fitzpatrick TerribleFailure what = new TerribleFailure(msg, tr); 2962d073ba83c570466a7f77d1cd9193ab4a60eaee4Christopher Ferris // Only mark this as ERROR, do not use ASSERT since that should be 2972d073ba83c570466a7f77d1cd9193ab4a60eaee4Christopher Ferris // reserved for cases where the system is guaranteed to abort. 2982d073ba83c570466a7f77d1cd9193ab4a60eaee4Christopher Ferris // The onTerribleFailure call does not always cause a crash. 2998413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe int bytes = printlns(logId, ERROR, tag, msg, localStack ? what : tr); 3005232271a41323594ae406be7476b6ca2f08af3d8Dianne Hackborn sWtfHandler.onTerribleFailure(tag, what, system); 30160d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor return bytes; 30260d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor } 30360d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor 3041e01d16982e6b22ec4c0e2d6dc1e261eb6f92c8eDianne Hackborn static void wtfQuiet(int logId, String tag, String msg, boolean system) { 3051e01d16982e6b22ec4c0e2d6dc1e261eb6f92c8eDianne Hackborn TerribleFailure what = new TerribleFailure(msg, null); 3061e01d16982e6b22ec4c0e2d6dc1e261eb6f92c8eDianne Hackborn sWtfHandler.onTerribleFailure(tag, what, system); 3071e01d16982e6b22ec4c0e2d6dc1e261eb6f92c8eDianne Hackborn } 3081e01d16982e6b22ec4c0e2d6dc1e261eb6f92c8eDianne Hackborn 30960d8762413e8daba5f73559786312a9ec5e3b827Dan Egnor /** 31044dc76a8a702d6a919fcea1c2d19ba3792687c85Brad Fitzpatrick * Sets the terrible failure handler, for testing. 31144dc76a8a702d6a919fcea1c2d19ba3792687c85Brad Fitzpatrick * 31244dc76a8a702d6a919fcea1c2d19ba3792687c85Brad Fitzpatrick * @return the old handler 31344dc76a8a702d6a919fcea1c2d19ba3792687c85Brad Fitzpatrick * 31444dc76a8a702d6a919fcea1c2d19ba3792687c85Brad Fitzpatrick * @hide 31544dc76a8a702d6a919fcea1c2d19ba3792687c85Brad Fitzpatrick */ 31644dc76a8a702d6a919fcea1c2d19ba3792687c85Brad Fitzpatrick public static TerribleFailureHandler setWtfHandler(TerribleFailureHandler handler) { 31744dc76a8a702d6a919fcea1c2d19ba3792687c85Brad Fitzpatrick if (handler == null) { 31844dc76a8a702d6a919fcea1c2d19ba3792687c85Brad Fitzpatrick throw new NullPointerException("handler == null"); 31944dc76a8a702d6a919fcea1c2d19ba3792687c85Brad Fitzpatrick } 32044dc76a8a702d6a919fcea1c2d19ba3792687c85Brad Fitzpatrick TerribleFailureHandler oldHandler = sWtfHandler; 32144dc76a8a702d6a919fcea1c2d19ba3792687c85Brad Fitzpatrick sWtfHandler = handler; 32244dc76a8a702d6a919fcea1c2d19ba3792687c85Brad Fitzpatrick return oldHandler; 32344dc76a8a702d6a919fcea1c2d19ba3792687c85Brad Fitzpatrick } 32444dc76a8a702d6a919fcea1c2d19ba3792687c85Brad Fitzpatrick 32544dc76a8a702d6a919fcea1c2d19ba3792687c85Brad Fitzpatrick /** 3269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Handy function to get a loggable stack trace from a Throwable 3279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tr An exception to log 3289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static String getStackTraceString(Throwable tr) { 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (tr == null) { 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ""; 3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 333dba50c7ed24e05ff349a94b8c4a6d9bb9050973bJoe Onorato 334dba50c7ed24e05ff349a94b8c4a6d9bb9050973bJoe Onorato // This is to reduce the amount of log spew that apps do in the non-error 335dba50c7ed24e05ff349a94b8c4a6d9bb9050973bJoe Onorato // condition of the network being unavailable. 336dba50c7ed24e05ff349a94b8c4a6d9bb9050973bJoe Onorato Throwable t = tr; 337dba50c7ed24e05ff349a94b8c4a6d9bb9050973bJoe Onorato while (t != null) { 338dba50c7ed24e05ff349a94b8c4a6d9bb9050973bJoe Onorato if (t instanceof UnknownHostException) { 339dba50c7ed24e05ff349a94b8c4a6d9bb9050973bJoe Onorato return ""; 340dba50c7ed24e05ff349a94b8c4a6d9bb9050973bJoe Onorato } 341dba50c7ed24e05ff349a94b8c4a6d9bb9050973bJoe Onorato t = t.getCause(); 342dba50c7ed24e05ff349a94b8c4a6d9bb9050973bJoe Onorato } 343dba50c7ed24e05ff349a94b8c4a6d9bb9050973bJoe Onorato 3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project StringWriter sw = new StringWriter(); 3458c84109b9fbbf473b225707a38261ff5f99d95fbDianne Hackborn PrintWriter pw = new FastPrintWriter(sw, false, 256); 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project tr.printStackTrace(pw); 3478c84109b9fbbf473b225707a38261ff5f99d95fbDianne Hackborn pw.flush(); 3489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return sw.toString(); 3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Low-level logging call. 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param priority The priority/type of this log message 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag Used to identify the source of a log message. It usually identifies 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the class or activity where the log call occurs. 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param msg The message you would like logged. 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The number of bytes written. 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 35900bb93823d082c31d757bd7b75a8615afbd2c1a5Joe Onorato public static int println(int priority, String tag, String msg) { 36000bb93823d082c31d757bd7b75a8615afbd2c1a5Joe Onorato return println_native(LOG_ID_MAIN, priority, tag, msg); 36100bb93823d082c31d757bd7b75a8615afbd2c1a5Joe Onorato } 36200bb93823d082c31d757bd7b75a8615afbd2c1a5Joe Onorato 3638a9b22056b13477f59df934928c00c58b5871c95Joe Onorato /** @hide */ public static final int LOG_ID_MAIN = 0; 3648a9b22056b13477f59df934928c00c58b5871c95Joe Onorato /** @hide */ public static final int LOG_ID_RADIO = 1; 3658a9b22056b13477f59df934928c00c58b5871c95Joe Onorato /** @hide */ public static final int LOG_ID_EVENTS = 2; 3668a9b22056b13477f59df934928c00c58b5871c95Joe Onorato /** @hide */ public static final int LOG_ID_SYSTEM = 3; 36769eb6f57e34fb78050adcedcda8479cf2ad0c418Mark Salyzyn /** @hide */ public static final int LOG_ID_CRASH = 4; 36800bb93823d082c31d757bd7b75a8615afbd2c1a5Joe Onorato 3698a9b22056b13477f59df934928c00c58b5871c95Joe Onorato /** @hide */ public static native int println_native(int bufID, 3708a9b22056b13477f59df934928c00c58b5871c95Joe Onorato int priority, String tag, String msg); 3718413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe 3728413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe /** 3738413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe * Return the maximum payload the log daemon accepts without truncation. 3748413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe * @return LOGGER_ENTRY_MAX_PAYLOAD. 3758413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe */ 3768413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe private static native int logger_entry_max_payload_native(); 3778413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe 3788413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe /** 3798413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe * Helper function for long messages. Uses the LineBreakBufferedWriter to break 3808413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe * up long messages and stacktraces along newlines, but tries to write in large 3818413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe * chunks. This is to avoid truncation. 382d888beb9bfca2da6bba303cd7db809ccefa7b996Andreas Gampe * @hide 3838413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe */ 384d888beb9bfca2da6bba303cd7db809ccefa7b996Andreas Gampe public static int printlns(int bufID, int priority, String tag, String msg, 3858413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe Throwable tr) { 3868413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe ImmediateLogWriter logWriter = new ImmediateLogWriter(bufID, priority, tag); 3878413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe // Acceptable buffer size. Get the native buffer size, subtract two zero terminators, 3888413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe // and the length of the tag. 3898413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe // Note: we implicitly accept possible truncation for Modified-UTF8 differences. It 3908413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe // is too expensive to compute that ahead of time. 3918413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe int bufferSize = NoPreloadHolder.LOGGER_ENTRY_MAX_PAYLOAD // Base. 3928413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe - 2 // Two terminators. 3938413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe - (tag != null ? tag.length() : 0) // Tag length. 3948413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe - 32; // Some slack. 3958413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe // At least assume you can print *some* characters (tag is not too large). 3968413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe bufferSize = Math.max(bufferSize, 100); 3978413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe 3988413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe LineBreakBufferedWriter lbbw = new LineBreakBufferedWriter(logWriter, bufferSize); 3998413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe 4008413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe lbbw.println(msg); 4018413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe 4028413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe if (tr != null) { 4038413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe // This is to reduce the amount of log spew that apps do in the non-error 4048413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe // condition of the network being unavailable. 4058413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe Throwable t = tr; 4068413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe while (t != null) { 4078413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe if (t instanceof UnknownHostException) { 4088413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe break; 4098413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe } 410f8880561e67e1da246970b49b14285efd4164ab1Jeff Sharkey if (t instanceof DeadSystemException) { 411f8880561e67e1da246970b49b14285efd4164ab1Jeff Sharkey lbbw.println("DeadSystemException: The system died; " 412f8880561e67e1da246970b49b14285efd4164ab1Jeff Sharkey + "earlier logs will point to the root cause"); 413f8880561e67e1da246970b49b14285efd4164ab1Jeff Sharkey break; 414f8880561e67e1da246970b49b14285efd4164ab1Jeff Sharkey } 4158413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe t = t.getCause(); 4168413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe } 4178413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe if (t == null) { 4188413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe tr.printStackTrace(lbbw); 4198413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe } 4208413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe } 4218413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe 4228413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe lbbw.flush(); 4238413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe 4248413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe return logWriter.getWritten(); 4258413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe } 4268413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe 4278413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe /** 4288413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe * NoPreloadHelper class. Caches the LOGGER_ENTRY_MAX_PAYLOAD value to avoid 4298413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe * a JNI call during logging. 4308413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe */ 4318413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe static class NoPreloadHolder { 4328413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe public final static int LOGGER_ENTRY_MAX_PAYLOAD = 4338413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe logger_entry_max_payload_native(); 4348413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe } 4358413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe 4368413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe /** 4378413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe * Helper class to write to the logcat. Different from LogWriter, this writes 4388413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe * the whole given buffer and does not break along newlines. 4398413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe */ 4408413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe private static class ImmediateLogWriter extends Writer { 4418413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe 4428413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe private int bufID; 4438413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe private int priority; 4448413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe private String tag; 4458413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe 4468413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe private int written = 0; 4478413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe 4488413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe /** 4498413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe * Create a writer that immediately writes to the log, using the given 4508413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe * parameters. 4518413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe */ 4528413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe public ImmediateLogWriter(int bufID, int priority, String tag) { 4538413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe this.bufID = bufID; 4548413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe this.priority = priority; 4558413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe this.tag = tag; 4568413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe } 4578413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe 4588413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe public int getWritten() { 4598413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe return written; 4608413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe } 4618413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe 4628413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe @Override 4638413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe public void write(char[] cbuf, int off, int len) { 4648413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe // Note: using String here has a bit of overhead as a Java object is created, 4658413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe // but using the char[] directly is not easier, as it needs to be translated 4668413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe // to a C char[] for logging. 4678413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe written += println_native(bufID, priority, tag, new String(cbuf, off, len)); 4688413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe } 4698413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe 4708413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe @Override 4718413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe public void flush() { 4728413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe // Ignored. 4738413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe } 4748413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe 4758413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe @Override 4768413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe public void close() { 4778413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe // Ignored. 4788413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe } 4798413db8c36f4ba5979cdc2b1c3e1429e6ba34d6aAndreas Gampe } 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 481