1879N/A * Copyright (c) 2008, Oracle and/or its affiliates. All rights reserved. 1756N/A * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 1756N/A * This code is free software; you can redistribute it and/or modify it 1756N/A * under the terms of the GNU General Public License version 2 only, as 1756N/A * published by the Free Software Foundation. Oracle designates this 1756N/A * particular file as subject to the "Classpath" exception as provided 1756N/A * by Oracle in the LICENSE file that accompanied this code. 1756N/A * This code is distributed in the hope that it will be useful, but WITHOUT 1756N/A * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 1756N/A * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 1756N/A * version 2 for more details (a copy is included in the LICENSE file that 1756N/A * You should have received a copy of the GNU General Public License version 1756N/A * 2 along with this work; if not, write to the Free Software Foundation, 1879N/A * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 1879N/A * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 1756N/A * or visit www.oracle.com if you need additional information or have any 1879N/A * This package contains internal common code for implementing tracing 1879N/A * frameworks, and defined a number of existing frameworks. 3863N/A * There are four tracing frameworks currently defined. The "Null" and 1756N/A * "Multiplex" frameworks are used internally as part of the implementation. 1756N/A * The "DTrace" framework is the prime consumer framework at the moment, 1756N/A * while the "PrintStream" framework is a functional, but hidden, framework 1756N/A * which can be used to track probe firings. All but the "DTrace" framework 1756N/A * are defined in this package. The "DTrace" framework is implemented in the 1756N/A * {@code sun.tracing.dtrace} package. 1756N/A * This package also contains the {@code ProviderSkeleton} class, which 3863N/A * holds most of the common code needed for implementing frameworks. 1756N/A * The "Null" framework is used when there are no other active frameworks. 1756N/A * It accomplishes absolutely nothing and is merely a placeholder so that 1756N/A * the application can call the tracing routines without error. 1756N/A * The "Multiplex" framework is used when there are multiple active frameworks. 1756N/A * It is initialized with the framework factories and create providers and 1756N/A * probes that dispatch to each active framework in turn. 1756N/A * The "PrintStream" framework is currently a debugging framework which 3863N/A * dispatches trace calls to a user-defined PrintStream class, defined by 3863N/A * a property. It may some day be opened up to general use. 1756N/A * See the {@code sun.tracing.dtrace} and {@code com.sun.tracing.dtrace} 1756N/A * packages for information on the "DTrace" framework.