1*7c478bd9Sstevel@tonic-gate /* 2*7c478bd9Sstevel@tonic-gate * CDDL HEADER START 3*7c478bd9Sstevel@tonic-gate * 4*7c478bd9Sstevel@tonic-gate * The contents of this file are subject to the terms of the 5*7c478bd9Sstevel@tonic-gate * Common Development and Distribution License, Version 1.0 only 6*7c478bd9Sstevel@tonic-gate * (the "License"). You may not use this file except in compliance 7*7c478bd9Sstevel@tonic-gate * with the License. 8*7c478bd9Sstevel@tonic-gate * 9*7c478bd9Sstevel@tonic-gate * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 10*7c478bd9Sstevel@tonic-gate * or http://www.opensolaris.org/os/licensing. 11*7c478bd9Sstevel@tonic-gate * See the License for the specific language governing permissions 12*7c478bd9Sstevel@tonic-gate * and limitations under the License. 13*7c478bd9Sstevel@tonic-gate * 14*7c478bd9Sstevel@tonic-gate * When distributing Covered Code, include this CDDL HEADER in each 15*7c478bd9Sstevel@tonic-gate * file and include the License file at usr/src/OPENSOLARIS.LICENSE. 16*7c478bd9Sstevel@tonic-gate * If applicable, add the following below this CDDL HEADER, with the 17*7c478bd9Sstevel@tonic-gate * fields enclosed by brackets "[]" replaced with your own identifying 18*7c478bd9Sstevel@tonic-gate * information: Portions Copyright [yyyy] [name of copyright owner] 19*7c478bd9Sstevel@tonic-gate * 20*7c478bd9Sstevel@tonic-gate * CDDL HEADER END 21*7c478bd9Sstevel@tonic-gate */ 22*7c478bd9Sstevel@tonic-gate /* 23*7c478bd9Sstevel@tonic-gate * Copyright 2003 Sun Microsystems, Inc. All rights reserved. 24*7c478bd9Sstevel@tonic-gate * Use is subject to license terms. 25*7c478bd9Sstevel@tonic-gate * 26*7c478bd9Sstevel@tonic-gate * ident "%Z%%M% %I% %E% SMI" 27*7c478bd9Sstevel@tonic-gate */ 28*7c478bd9Sstevel@tonic-gate 29*7c478bd9Sstevel@tonic-gate package com.sun.solaris.service.kstat; 30*7c478bd9Sstevel@tonic-gate 31*7c478bd9Sstevel@tonic-gate /** 32*7c478bd9Sstevel@tonic-gate * <code>kstat</code> controlling object. Allows kstats to be looked up 33*7c478bd9Sstevel@tonic-gate * so they can later be sampled. 34*7c478bd9Sstevel@tonic-gate */ 35*7c478bd9Sstevel@tonic-gate public final class KstatCtl 36*7c478bd9Sstevel@tonic-gate { 37*7c478bd9Sstevel@tonic-gate static { 38*7c478bd9Sstevel@tonic-gate System.loadLibrary("jkstat"); KstatCtl.init()39*7c478bd9Sstevel@tonic-gate KstatCtl.init(); 40*7c478bd9Sstevel@tonic-gate } 41*7c478bd9Sstevel@tonic-gate 42*7c478bd9Sstevel@tonic-gate /** 43*7c478bd9Sstevel@tonic-gate * Pointer to a <code>kstat_ctl_t</code>. 44*7c478bd9Sstevel@tonic-gate */ 45*7c478bd9Sstevel@tonic-gate private long kctl; 46*7c478bd9Sstevel@tonic-gate 47*7c478bd9Sstevel@tonic-gate /** 48*7c478bd9Sstevel@tonic-gate * Invokes <code>kstat_open(3KSTAT)</code>. The returned object 49*7c478bd9Sstevel@tonic-gate * should be explicitly finalized when it's no longer needed. 50*7c478bd9Sstevel@tonic-gate */ KstatCtl()51*7c478bd9Sstevel@tonic-gate public KstatCtl() 52*7c478bd9Sstevel@tonic-gate { 53*7c478bd9Sstevel@tonic-gate kctl = open(); 54*7c478bd9Sstevel@tonic-gate assert(kctl != 0); 55*7c478bd9Sstevel@tonic-gate } 56*7c478bd9Sstevel@tonic-gate 57*7c478bd9Sstevel@tonic-gate /** 58*7c478bd9Sstevel@tonic-gate * Calls <code>kstat_close(3KSTAT)</code>. 59*7c478bd9Sstevel@tonic-gate */ finalize()60*7c478bd9Sstevel@tonic-gate public void finalize() 61*7c478bd9Sstevel@tonic-gate { 62*7c478bd9Sstevel@tonic-gate close(kctl); 63*7c478bd9Sstevel@tonic-gate kctl = 0; 64*7c478bd9Sstevel@tonic-gate } 65*7c478bd9Sstevel@tonic-gate 66*7c478bd9Sstevel@tonic-gate /** 67*7c478bd9Sstevel@tonic-gate * Invokes <code>kstat_open(3KSTAT)</code>. 68*7c478bd9Sstevel@tonic-gate */ open()69*7c478bd9Sstevel@tonic-gate private native long open(); 70*7c478bd9Sstevel@tonic-gate 71*7c478bd9Sstevel@tonic-gate /** 72*7c478bd9Sstevel@tonic-gate * Invokes <code>kstat_close(3KSTAT)</code>. 73*7c478bd9Sstevel@tonic-gate */ close(long kctl)74*7c478bd9Sstevel@tonic-gate private native int close(long kctl); 75*7c478bd9Sstevel@tonic-gate 76*7c478bd9Sstevel@tonic-gate /** 77*7c478bd9Sstevel@tonic-gate * Invokes <code>kstat_lookup(3KSTAT)</code> and returns a Kstat 78*7c478bd9Sstevel@tonic-gate * for any result, or null if none is found. 79*7c478bd9Sstevel@tonic-gate */ lookup(String module, int instance, String name)80*7c478bd9Sstevel@tonic-gate public native Kstat lookup(String module, int instance, String name); 81*7c478bd9Sstevel@tonic-gate 82*7c478bd9Sstevel@tonic-gate /** 83*7c478bd9Sstevel@tonic-gate * Invokes <code>kstat_chain_update(3KSTAT)</code>. 84*7c478bd9Sstevel@tonic-gate * 85*7c478bd9Sstevel@tonic-gate * @throws KstatChainUpdateException if the native function 86*7c478bd9Sstevel@tonic-gate * returns -1. 87*7c478bd9Sstevel@tonic-gate */ chainUpdate()88*7c478bd9Sstevel@tonic-gate public native void chainUpdate() throws KstatChainUpdateException; 89*7c478bd9Sstevel@tonic-gate 90*7c478bd9Sstevel@tonic-gate /** 91*7c478bd9Sstevel@tonic-gate * Initialize cached class, method, and field IDs. 92*7c478bd9Sstevel@tonic-gate */ init()93*7c478bd9Sstevel@tonic-gate private static native void init(); 94*7c478bd9Sstevel@tonic-gate } 95