summaryrefslogtreecommitdiff
path: root/libartbase/base/logging.h
diff options
context:
space:
mode:
Diffstat (limited to 'libartbase/base/logging.h')
-rw-r--r--libartbase/base/logging.h113
1 files changed, 113 insertions, 0 deletions
diff --git a/libartbase/base/logging.h b/libartbase/base/logging.h
new file mode 100644
index 0000000000..fd5fc74383
--- /dev/null
+++ b/libartbase/base/logging.h
@@ -0,0 +1,113 @@
+/*
+ * Copyright (C) 2011 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 ART_LIBARTBASE_BASE_LOGGING_H_
+#define ART_LIBARTBASE_BASE_LOGGING_H_
+
+#include <ostream>
+#include <sstream>
+
+#include "android-base/logging.h"
+#include "base/macros.h"
+
+namespace art {
+
+// Make libbase's LogSeverity more easily available.
+using ::android::base::LogSeverity;
+using ::android::base::ScopedLogSeverity;
+
+// Abort function.
+using AbortFunction = void(const char*);
+
+// The members of this struct are the valid arguments to VLOG and VLOG_IS_ON in code,
+// and the "-verbose:" command line argument.
+struct LogVerbosity {
+ bool class_linker; // Enabled with "-verbose:class".
+ bool collector;
+ bool compiler;
+ bool deopt;
+ bool gc;
+ bool heap;
+ bool jdwp;
+ bool jit;
+ bool jni;
+ bool monitor;
+ bool oat;
+ bool profiler;
+ bool signals;
+ bool simulator;
+ bool startup;
+ bool third_party_jni; // Enabled with "-verbose:third-party-jni".
+ bool threads;
+ bool verifier;
+ bool verifier_debug; // Only works in debug builds.
+ bool image;
+ bool systrace_lock_logging; // Enabled with "-verbose:sys-locks".
+ bool agents;
+ bool dex; // Some dex access output etc.
+};
+
+// Global log verbosity setting, initialized by InitLogging.
+extern LogVerbosity gLogVerbosity;
+
+// Configure logging based on ANDROID_LOG_TAGS environment variable.
+// We need to parse a string that looks like
+//
+// *:v jdwp:d dalvikvm:d dalvikvm-gc:i dalvikvmi:i
+//
+// The tag (or '*' for the global level) comes first, followed by a colon
+// and a letter indicating the minimum priority level we're expected to log.
+// This can be used to reveal or conceal logs with specific tags.
+extern void InitLogging(char* argv[], AbortFunction& default_aborter);
+
+// Returns the command line used to invoke the current tool or null if InitLogging hasn't been
+// performed.
+extern const char* GetCmdLine();
+
+// The command used to start the ART runtime, such as "/system/bin/dalvikvm". If InitLogging hasn't
+// been performed then just returns "art"
+extern const char* ProgramInvocationName();
+
+// A short version of the command used to start the ART runtime, such as "dalvikvm". If InitLogging
+// hasn't been performed then just returns "art"
+extern const char* ProgramInvocationShortName();
+
+class LogHelper {
+ public:
+ // A logging helper for logging a single line. Can be used with little stack.
+ static void LogLineLowStack(const char* file,
+ unsigned int line,
+ android::base::LogSeverity severity,
+ const char* msg);
+
+ private:
+ DISALLOW_ALLOCATION();
+ DISALLOW_COPY_AND_ASSIGN(LogHelper);
+};
+
+// Is verbose logging enabled for the given module? Where the module is defined in LogVerbosity.
+#define VLOG_IS_ON(module) UNLIKELY(::art::gLogVerbosity.module)
+
+// Variant of LOG that logs when verbose logging is enabled for a module. For example,
+// VLOG(jni) << "A JNI operation was performed";
+#define VLOG(module) if (VLOG_IS_ON(module)) LOG(INFO)
+
+// Return the stream associated with logging for the given module.
+#define VLOG_STREAM(module) LOG_STREAM(INFO)
+
+} // namespace art
+
+#endif // ART_LIBARTBASE_BASE_LOGGING_H_