fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee/*
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee * CDDL HEADER START
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee *
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee * The contents of this file are subject to the terms of the
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee * Common Development and Distribution License (the "License").
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee * You may not use this file except in compliance with the License.
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee *
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee * or http://www.opensolaris.org/os/licensing.
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee * See the License for the specific language governing permissions
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee * and limitations under the License.
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee *
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee * When distributing Covered Code, include this CDDL HEADER in each
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee * If applicable, add the following below this CDDL HEADER, with the
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee * fields enclosed by brackets "[]" replaced with your own identifying
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee * information: Portions Copyright [yyyy] [name of copyright owner]
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee *
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee * CDDL HEADER END
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee */
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee/*
e77b06d21580f630e0a7c437495ab283d3672828tomee * Copyright 2008 Sun Microsystems, Inc. All rights reserved.
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee * Use is subject to license terms.
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee */
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomeepackage org.opensolaris.os.dtrace;
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomeeimport java.util.*;
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee/**
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee * Implementation detail used by {@link Consumer#getAggregate()}.
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee * Package level access.
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee */
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomeeclass AggregateSpec {
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee private Set <String> includedAggregationNames;
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee private Set <String> clearedAggregationNames;
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee AggregateSpec()
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee {
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee includedAggregationNames = new HashSet <String> ();
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee clearedAggregationNames = new HashSet <String> ();
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee }
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee public boolean
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee isIncludeByDefault()
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee {
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee return (includedAggregationNames == null);
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee }
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee public boolean
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee isClearByDefault()
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee {
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee return (clearedAggregationNames == null);
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee }
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee public void
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee setIncludeByDefault(boolean include)
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee {
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee if (include) {
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee includedAggregationNames = null;
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee } else if (includedAggregationNames == null) {
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee includedAggregationNames = new HashSet <String> ();
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee }
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee }
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee public void
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee setClearByDefault(boolean clear)
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee {
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee if (clear) {
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee clearedAggregationNames = null;
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee } else if (clearedAggregationNames == null) {
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee clearedAggregationNames = new HashSet <String> ();
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee }
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee }
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee /**
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee * Specifies which aggregations to include in an aggregate snapshot.
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee * If none are specified, all aggregations are included. A snapshot
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee * is read-consistent across all included aggregations.
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee *
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee * @see Consumer#getAggregate(AggregateSpec spec)
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee */
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee public void
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee addIncludedAggregationName(String name)
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee {
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee if (includedAggregationNames == null) {
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee includedAggregationNames = new HashSet <String> ();
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee }
3e359d9c8f6757343a2958bb1e6e1cbbe9a657b8Tom Erickson includedAggregationNames.add(
3e359d9c8f6757343a2958bb1e6e1cbbe9a657b8Tom Erickson Aggregate.filterUnnamedAggregationName(name));
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee }
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee /**
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee * Specifies which aggregations to clear after snapping the
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee * aggregate. If none are specified, no aggregations are cleared.
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee * <p>
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee * Aggregations are cleared immediately after they are snapped
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee * before any more data can be accumulated in order to prevent loss
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee * of data between snapshots.
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee *
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee * @see Consumer#getAggregate(AggregateSpec spec)
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee */
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee public void
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee addClearedAggregationName(String name)
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee {
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee if (clearedAggregationNames == null) {
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee clearedAggregationNames = new HashSet <String> ();
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee }
3e359d9c8f6757343a2958bb1e6e1cbbe9a657b8Tom Erickson clearedAggregationNames.add(
3e359d9c8f6757343a2958bb1e6e1cbbe9a657b8Tom Erickson Aggregate.filterUnnamedAggregationName(name));
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee }
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee public Set <String>
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee getIncludedAggregationNames()
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee {
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee if (includedAggregationNames == null) {
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee return Collections. <String> emptySet();
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee }
e77b06d21580f630e0a7c437495ab283d3672828tomee return Collections. <String> unmodifiableSet(includedAggregationNames);
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee }
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee public Set <String>
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee getClearedAggregationNames()
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee {
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee if (clearedAggregationNames == null) {
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee return Collections. <String> emptySet();
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee }
e77b06d21580f630e0a7c437495ab283d3672828tomee return Collections. <String> unmodifiableSet(clearedAggregationNames);
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee }
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee
3e359d9c8f6757343a2958bb1e6e1cbbe9a657b8Tom Erickson // Called by native code
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee public boolean
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee isIncluded(String aggregationName)
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee {
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee return ((includedAggregationNames == null) ||
3e359d9c8f6757343a2958bb1e6e1cbbe9a657b8Tom Erickson includedAggregationNames.contains(
3e359d9c8f6757343a2958bb1e6e1cbbe9a657b8Tom Erickson Aggregate.filterUnnamedAggregationName(aggregationName)));
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee }
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee
3e359d9c8f6757343a2958bb1e6e1cbbe9a657b8Tom Erickson // Called by native code
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee public boolean
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee isCleared(String aggregationName)
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee {
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee return ((clearedAggregationNames == null) ||
3e359d9c8f6757343a2958bb1e6e1cbbe9a657b8Tom Erickson clearedAggregationNames.contains(
3e359d9c8f6757343a2958bb1e6e1cbbe9a657b8Tom Erickson Aggregate.filterUnnamedAggregationName(aggregationName)));
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee }
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee public String
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee toString()
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee {
4ae67516a1d5dc4a5dbc761762bad5b596647388tomee StringBuilder buf = new StringBuilder();
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee buf.append(AggregateSpec.class.getName());
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee buf.append("[includedAggregationNames = ");
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee buf.append(Arrays.toString(getIncludedAggregationNames().toArray()));
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee buf.append(", clearedAggregationNames = ");
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee buf.append(Arrays.toString(getClearedAggregationNames().toArray()));
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee buf.append(", includeByDefault = ");
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee buf.append(isIncludeByDefault());
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee buf.append(", clearByDefault = ");
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee buf.append(isClearByDefault());
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee buf.append(']');
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee return buf.toString();
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee }
fb3fb4f3d76d55b64440afd0af72775dfad3bd1dtomee}