src/share/vm/utilities/events.hpp

Thu, 20 Nov 2008 16:56:09 -0800

author
ysr
date
Thu, 20 Nov 2008 16:56:09 -0800
changeset 888
c96030fff130
parent 435
a61af66fc99e
child 1907
c18cbe5936b8
permissions
-rw-r--r--

6684579: SoftReference processing can be made more efficient
Summary: For current soft-ref clearing policies, we can decide at marking time if a soft-reference will definitely not be cleared, postponing the decision of whether it will definitely be cleared to the final reference processing phase. This can be especially beneficial in the case of concurrent collectors where the marking is usually concurrent but reference processing is usually not.
Reviewed-by: jmasa

duke@435 1 /*
duke@435 2 * Copyright 1997-2003 Sun Microsystems, Inc. All Rights Reserved.
duke@435 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
duke@435 4 *
duke@435 5 * This code is free software; you can redistribute it and/or modify it
duke@435 6 * under the terms of the GNU General Public License version 2 only, as
duke@435 7 * published by the Free Software Foundation.
duke@435 8 *
duke@435 9 * This code is distributed in the hope that it will be useful, but WITHOUT
duke@435 10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
duke@435 11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
duke@435 12 * version 2 for more details (a copy is included in the LICENSE file that
duke@435 13 * accompanied this code).
duke@435 14 *
duke@435 15 * You should have received a copy of the GNU General Public License version
duke@435 16 * 2 along with this work; if not, write to the Free Software Foundation,
duke@435 17 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
duke@435 18 *
duke@435 19 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
duke@435 20 * CA 95054 USA or visit www.sun.com if you need additional information or
duke@435 21 * have any questions.
duke@435 22 *
duke@435 23 */
duke@435 24
duke@435 25 // Events and EventMark provide interfaces to log events taking place in the vm.
duke@435 26 // This facility is extremly useful for post-mortem debugging. The eventlog
duke@435 27 // often provides crucial information about events leading up to the crash.
duke@435 28 //
duke@435 29 // All arguments past the format string must be passed as an intptr_t.
duke@435 30 //
duke@435 31 // To log a single event use:
duke@435 32 // Events::log("New nmethod has been created " INTPTR_FORMAT, nm);
duke@435 33 //
duke@435 34 // To log a block of events use:
duke@435 35 // EventMark m("GarbageCollecting %d", (intptr_t)gc_number);
duke@435 36 //
duke@435 37 // The constructor to eventlog indents the eventlog until the
duke@435 38 // destructor has been executed.
duke@435 39 //
duke@435 40 // IMPLEMENTATION RESTRICTION:
duke@435 41 // Max 3 arguments are saved for each logged event.
duke@435 42 //
duke@435 43
duke@435 44 class Events : AllStatic {
duke@435 45 public:
duke@435 46 // Logs an event, format as printf
duke@435 47 static void log(const char* format, ...) PRODUCT_RETURN;
duke@435 48
duke@435 49 // Prints all events in the buffer
duke@435 50 static void print_all(outputStream* st) PRODUCT_RETURN;
duke@435 51
duke@435 52 // Prints last number events from the event buffer
duke@435 53 static void print_last(outputStream *st, int number) PRODUCT_RETURN;
duke@435 54 };
duke@435 55
duke@435 56 class EventMark : public StackObj {
duke@435 57 public:
duke@435 58 // log a begin event, format as printf
duke@435 59 EventMark(const char* format, ...) PRODUCT_RETURN;
duke@435 60 // log an end event
duke@435 61 ~EventMark() PRODUCT_RETURN;
duke@435 62 };
duke@435 63
duke@435 64 int print_all_events(outputStream *st);

mercurial