1 /*

     2  * Copyright 2007 Sun Microsystems, Inc. All rights reserved.

     3  * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.

     4  */

     5 

     6 /**

     7  * This package contains internal common code for implementing tracing

     8  * frameworks, and defined a number of existing frameworks.

     9  * <p>

    10  * There are four tracing frameworks currently defined.  The "Null" and

    11  * "Multiplex" frameworks are used internally as part of the implementation.

    12  * The "DTrace" framework is the prime consumer framework at the moment,

    13  * while the "PrintStream" framework is a functional, but hidden, framework

    14  * which can be used to track probe firings.  All but the "DTrace" framework

    15  * are defined in this package.  The "DTrace" framework is implemented in the

    16  * {@code sun.tracing.dtrace} package.

    17  * <p>

    18  * This package also contains the {@code ProviderSkeleton} class, which

    19  * holds most of the common code needed for implementing frameworks.

    20  * <p>

    21  * The "Null" framework is used when there are no other active frameworks.

    22  * It accomplishes absolutely nothing and is merely a placeholder so that

    23  * the application can call the tracing routines without error.

    24  * <p>

    25  * The "Multiplex" framework is used when there are multiple active frameworks.

    26  * It is initialized with the framework factories and create providers and

    27  * probes that dispatch to each active framework in turn.

    28  * <p>

    29  * The "PrintStream" framework is currently a debugging framework which

    30  * dispatches trace calls to a user-defined PrintStream class, defined by

    31  * a property.  It may some day be opened up to general use.

    32  * <p>

    33  * See the {@code sun.tracing.dtrace} and {@code com.sun.tracing.dtrace}

    34  * packages for information on the "DTrace" framework.

    35  */

    36 

    37 package sun.tracing;