java.lang.management

Interface OperatingSystemMXBean

Known Implementing Classes:
OperatingSystemMXBeanImpl

public interface OperatingSystemMXBean

Provides access to information about the underlying operating system. An instance of this bean is obtained by calling ManagementFactory.getOperatingSystemMXBean().
Since:
1.5

Method Summary

String
getArch()
Returns the name of the underlying system architecture.
int
getAvailableProcessors()
Returns the number of processors currently available to the virtual machine.
String
getName()
Returns the name of the underlying operating system.
double
getSystemLoadAverage()
Returns the system load average for the last minute, or -1 if this is unavailable.
String
getVersion()
Returns the version of the underlying operating system.

Method Details

getArch

public String getArch()
Returns the name of the underlying system architecture. This is equivalent to obtaining the os.arch property via System.getProperty(String).
Returns:
the name of the underlying system architecture on which the VM is running.
Throws:
SecurityException - if a security manager exists which prevents access to the name property.

getAvailableProcessors

public int getAvailableProcessors()
Returns the number of processors currently available to the virtual machine. This number is subject to change during execution of the virtual machine, and will always be >= 1. The call is equivalent to Runtime.availableProcessors().
Returns:
the number of processors available to the VM.

getName

public String getName()
Returns the name of the underlying operating system. This is equivalent to obtaining the os.name property via System.getProperty(String).
Returns:
the name of the operating system on which the VM is running.
Throws:
SecurityException - if a security manager exists which prevents access to the name property.

getSystemLoadAverage

public double getSystemLoadAverage()
Returns the system load average for the last minute, or -1 if this is unavailable. The availability and calculation of the load average is system-dependent, but is usually a damped time-dependent average obtained by monitoring the number of queued and running processes. It is expected that this method will be called frequently to monitor the average over time, so it may not be implemented on systems where such a call is expensive.
Returns:
the system load average for the last minute, or -1 if this is unavailable.
Since:
1.6

getVersion

public String getVersion()
Returns the version of the underlying operating system. This is equivalent to obtaining the os.version property via System.getProperty(String).
Returns:
the version of the operating system on which the VM is running.
Throws:
SecurityException - if a security manager exists which prevents access to the name property.

OperatingSystemMXBean.java - Interface for an operating system bean Copyright (C) 2006 Free Software Foundation This file is part of GNU Classpath. GNU Classpath is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. GNU Classpath is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with GNU Classpath; see the file COPYING. If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. Linking this library statically or dynamically with other modules is making a combined work based on this library. Thus, the terms and conditions of the GNU General Public License cover the whole combination. As a special exception, the copyright holders of this library give you permission to link this library with independent modules to produce an executable, regardless of the license terms of these independent modules, and to copy and distribute the resulting executable under terms of your choice, provided that you also meet, for each linked independent module, the terms and conditions of the license of that module. An independent module is a module which is not derived from or based on this library. If you modify this library, you may extend this exception to your version of the library, but you are not obligated to do so. If you do not wish to do so, delete this exception statement from your version.