events.hpp revision 3863
1472N/A * Copyright (c) 1997, 2012, Oracle and/or its affiliates. All rights reserved. 0N/A * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 0N/A * This code is free software; you can redistribute it and/or modify it 0N/A * under the terms of the GNU General Public License version 2 only, as 0N/A * published by the Free Software Foundation. 0N/A * This code is distributed in the hope that it will be useful, but WITHOUT 0N/A * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 0N/A * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 0N/A * version 2 for more details (a copy is included in the LICENSE file that 0N/A * accompanied this code). 0N/A * You should have received a copy of the GNU General Public License version 0N/A * 2 along with this work; if not, write to the Free Software Foundation, 0N/A * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 1472N/A * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 1879N/A// Events and EventMark provide interfaces to log events taking place in the vm. 0N/A// This facility is extremly useful for post-mortem debugging. The eventlog 0N/A// often provides crucial information about events leading up to the crash. 0N/A// Abstractly the logs can record whatever they way but normally they 0N/A// would record at least a timestamp and the current Thread, along 0N/A// with whatever data they need in a ring buffer. Commonly fixed 0N/A// length text messages are recorded for simplicity but other 0N/A// strategies could be used. Several logs are provided by default but 0N/A// new instances can be created as needed. 0N/A// The base event log dumping class that is registered for dumping at 0N/A// crash time. This is a very generic interface that is mainly here 0N/A// for completeness. Normally the templated EventLogBase would be 0N/A// subclassed to provide different log types. 0N/A // Automatically registers the log so that it will be printed during 1166N/A// A templated subclass of EventLog that provides basic ring buffer 1166N/A// functionality. Most event loggers should subclass this, possibly 0N/A// providing a more featureful log function if the existing copy 0N/A// semantics aren't appropriate. The name is used as the label of the 0N/A// log when it is dumped during a crash. 0N/A // move the ring buffer to next open slot and return the index of 0N/A // the slot to use for the current message. Should only be called 0N/A // while mutex is held. 0N/A // Don't bother adding new entries when we're crashing. This also 0N/A // avoids mutating the ring buffer when printing the log. 0N/A // Print the contents of the log 0N/A // Print a single element. A templated implementation might need to 0N/A // be declared by subclasses. 0N/A// A simple wrapper class for fixed size text messages. 0N/A // Wrap this buffer in a stringStream. 481N/A// A simple ring buffer of fixed size text messages. 0N/A // A log for generic messages that aren't well categorized. 0N/A // A log for internal exception related messages, like internal 0N/A // throws and implicit exceptions. 0N/A // Deoptization related messages 0N/A // Dump all events to the tty 0N/A // Logs a generic message with timestamp and format as printf. 0N/A // Log exception related message 0N/A // Register default loggers 0N/A // Not a regular Java thread so don't bother locking 0N/A// Dump the ring buffer entries that current have entries. 2474N/A// Implement a printing routine for the StringLogMessage 941N/A// Place markers for the beginning and end up of a set of events. 941N/A// These end up in the default log. 0N/A // log a begin event, format as printf 0N/A#
endif // SHARE_VM_UTILITIES_EVENTS_HPP