Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance. Project price only 1 $
You can buy this project and download/modify it how often you want.
/**
* Oshi (https://github.com/oshi/oshi)
*
* Copyright (c) 2010 - 2018 The Oshi Project Team
*
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
* http://www.eclipse.org/legal/epl-v10.html
*
* Maintainers:
* dblock[at]dblock[dot]org
* widdis[at]gmail[dot]com
* enrico.bianchi[at]gmail[dot]com
*
* Contributors:
* https://github.com/oshi/oshi/graphs/contributors
*/
package oshi.hardware;
import java.io.Serializable;
/**
* The Central Processing Unit (CPU) or the processor is the portion of a
* computer system that carries out the instructions of a computer program, and
* is the primary element carrying out the computer's functions.
*
* @author dblock[at]dblock[dot]org
*/
public interface CentralProcessor extends Serializable {
/**
* Index of CPU tick counters in the {@link #getSystemCpuLoadTicks()} and
* {@link #getProcessorCpuLoadTicks()} arrays.
*/
enum TickType {
/**
* CPU utilization that occurred while executing at the user level
* (application).
*/
USER(0),
/**
* CPU utilization that occurred while executing at the user level with
* nice priority.
*/
NICE(1),
/**
* CPU utilization that occurred while executing at the system level
* (kernel). Also includes CPU time which the hypervisor dedicated for
* other guests in the system (steal).
*/
SYSTEM(2),
/**
* Time that the CPU or CPUs were idle and the system did not have an
* outstanding disk I/O request.
*/
IDLE(3),
/**
* Time that the CPU or CPUs were idle during which the system had an
* outstanding disk I/O request.
*/
IOWAIT(4),
/**
* Time that the CPU used to service hardware IRQs
*/
IRQ(5),
/**
* Time that the CPU used to service soft IRQs
*/
SOFTIRQ(6),
/**
* Time which the hypervisor dedicated for other guests in the system.
* Only supported on Linux.
*/
STEAL(7);
private int index;
TickType(int value) {
this.index = value;
}
/**
* @return The integer index of this ENUM in the processor tick arrays,
* which matches the output of Linux /proc/cpuinfo
*/
public int getIndex() {
return index;
}
}
/**
* Processor vendor.
*
* @return vendor string.
*/
String getVendor();
/**
* Set processor vendor.
*
* @param vendor
* Vendor.
*/
void setVendor(String vendor);
/**
* Name, eg. Intel(R) Core(TM)2 Duo CPU T7300 @ 2.00GHz
*
* @return Processor name.
*/
String getName();
/**
* Set processor name.
*
* @param name
* Name.
*/
void setName(String name);
/**
* Vendor frequency (in Hz), eg. for processor named Intel(R) Core(TM)2 Duo
* CPU T7300 @ 2.00GHz the vendor frequency is 2000000000.
*
* @return Processor frequency or -1 if unknown.
*/
long getVendorFreq();
/**
* Set processor vendor frequency (in Hz).
*
* @param freq
* Frequency.
*/
void setVendorFreq(long freq);
/**
* Gets the Processor ID. This is a hexidecimal string representing an
* 8-byte value, normally obtained using the CPUID opcode with the EAX
* register set to 1. The first four bytes are the resulting contents of the
* EAX register, which is the Processor signature, represented in
* human-readable form by {@link #getIdentifier()} . The remaining four
* bytes are the contents of the EDX register, containing feature flags.
*
* NOTE: The order of returned bytes is platform and software dependent.
* Values may be in either Big Endian or Little Endian order.
*
* @return A string representing the Processor ID
*/
String getProcessorID();
/**
* Set processor ID
*
* @param processorID
* The processor ID
*/
void setProcessorID(String processorID);
/**
* Identifier, eg. x86 Family 6 Model 15 Stepping 10.
*
* @return Processor identifier.
*/
String getIdentifier();
/**
* Set processor identifier.
*
* @param identifier
* Identifier.
*/
void setIdentifier(String identifier);
/**
* Is CPU 64bit?
*
* @return True if cpu is 64bit.
*/
boolean isCpu64bit();
/**
* Set flag is cpu is 64bit.
*
* @param cpu64
* True if cpu is 64.
*/
void setCpu64(boolean cpu64);
/**
* @return the stepping
*/
String getStepping();
/**
* @param stepping
* the stepping to set
*/
void setStepping(String stepping);
/**
* @return the model
*/
String getModel();
/**
* @param model
* the model to set
*/
void setModel(String model);
/**
* @return the family
*/
String getFamily();
/**
* @param family
* the family to set
*/
void setFamily(String family);
/**
* Returns the "recent cpu usage" for the whole system by counting ticks
* from {@link #getSystemCpuLoadTicks()} between successive calls of this
* method, with a minimum interval slightly less than 1 second. If less than
* one second has elapsed since the last call of this method, it will return
* a calculation based on the tick counts and times of the previous two
* calls. If at least a second has elapsed, it will return the average CPU
* load for the interval and update the "last called" times. This method is
* intended to be used for periodic polling at intervals of 1 second or
* longer.
*
* @return CPU load between 0 and 1 (100%)
*/
double getSystemCpuLoadBetweenTicks();
/**
* Get System-wide CPU Load tick counters. Returns an array with seven
* elements representing either clock ticks or milliseconds (platform
* dependent) spent in User (0), Nice (1), System (2), Idle (3), IOwait (4),
* Hardware interrupts (IRQ) (5), Software interrupts/DPC (SoftIRQ) (6), or
* Steal (7) states. Use {@link TickType#getIndex()} to retrieve the
* appropriate index. By measuring the difference between ticks across a
* time interval, CPU load over that interval may be calculated.
*
* Nice and IOWait information is not available on Windows, and IOwait and
* IRQ information is not available on macOS, so these ticks will always be
* zero.
*
* To calculate overall Idle time using this method, include both Idle and
* IOWait ticks. Similarly, IRQ, SoftIRQ, and Steal ticks should be added to
* the System value to get the total. System ticks also include time
* executing other virtual hosts (steal).
*
* @return An array of 7 long values representing time spent in User, Nice,
* System, Idle, IOwait, IRQ, SoftIRQ, and Steal states.
*/
long[] getSystemCpuLoadTicks();
/**
* Returns the "recent cpu usage" for the whole system from
* {@link com.sun.management.OperatingSystemMXBean#getSystemCpuLoad()} if a
* user is running the Oracle JVM. This value is a double in the [0.0,1.0]
* interval. A value of 0.0 means that all CPUs were idle during the recent
* period of time observed, while a value of 1.0 means that all CPUs were
* actively running 100% of the time during the recent period being
* observed. All values between 0.0 and 1.0 are possible depending of the
* activities going on in the system. If the system recent cpu usage is not
* available, the method returns a negative value. Calling this method
* immediately upon instantiating the {@link CentralProcessor} may give
* unreliable results. If a user is not running the Oracle JVM, this method
* will default to the behavior and return value of
* {@link #getSystemCpuLoadBetweenTicks()}.
*
* @return the "recent cpu usage" for the whole system; a negative value if
* not available.
*/
@SuppressWarnings("restriction")
double getSystemCpuLoad();
/**
* Returns the system load average for the last minute. This is equivalent
* to calling {@link CentralProcessor#getSystemLoadAverage(int)} with an
* argument of 1 and returning the first value, and is retained for
* compatibility.
*
* @return the system load average; or a negative value if not available.
*/
double getSystemLoadAverage();
/**
* Returns the system load average for the number of elements specified, up
* to 3, representing 1, 5, and 15 minutes. The system load average is the
* sum of the number of runnable entities queued to the available processors
* and the number of runnable entities running on the available processors
* averaged over a period of time. The way in which the load average is
* calculated is operating system specific but is typically a damped
* time-dependent average. If the load average is not available, a negative
* value is returned. This method is designed to provide a hint about the
* system load and may be queried frequently. The load average may be
* unavailable on some platforms (e.g., Windows) where it is expensive to
* implement this method.
*
* @param nelem
* Number of elements to return.
* @return an array of the system load averages for 1, 5, and 15 minutes
* with the size of the array specified by nelem; or negative values
* if not available.
*/
double[] getSystemLoadAverage(int nelem);
/**
* Returns the "recent cpu usage" for all logical processors by counting
* ticks for the processors from {@link #getProcessorCpuLoadTicks()} between
* successive calls of this method, with a minimum interval slightly less
* than 1 second. If less than one second has elapsed since the last call of
* this method, it will return a calculation based on the tick counts and
* times of the previous two calls. If at least a second has elapsed, it
* will return the average CPU load for the interval and update the "last
* called" times. This method is intended to be used for periodic polling
* (iterating over all processors) at intervals of 1 second or longer.
*
* @return array of CPU load between 0 and 1 (100%) for each logical
* processor
*/
double[] getProcessorCpuLoadBetweenTicks();
/**
* Get Processor CPU Load tick counters. Returns a two dimensional array,
* with {@link #getLogicalProcessorCount()} arrays, each containing seven
* elements representing either clock ticks or milliseconds (platform
* dependent) spent in User (0), Nice (1), System (2), Idle (3), IOwait (4),
* Hardware interrupts (IRQ) (5), Software interrupts/DPC (SoftIRQ) (6), or
* Steal (7) states. Use {@link TickType#getIndex()} to retrieve the
* appropriate index. By measuring the difference between ticks across a
* time interval, CPU load over that interval may be calculated.
*
* Nice and IOwait per processor information is not available on Windows,
* and IOwait and IRQ information is not available on macOS, so these ticks
* will always be zero.
*
* To calculate overall Idle time using this method, include both Idle and
* IOWait ticks. Similarly, IRQ, SoftIRQ and Steal ticks should be added to
* the System value to get the total. System ticks also include time
* executing other virtual hosts (steal).
*
* @return A 2D array of logicalProcessorCount x 7 long values representing
* time spent in User, Nice, System, Idle, IOwait, IRQ, SoftIRQ, and
* Steal states.
*/
long[][] getProcessorCpuLoadTicks();
/**
* Get the System uptime (time since boot).
*
* @return Number of seconds since boot.
*/
long getSystemUptime();
/**
* Get the System/CPU Serial Number, if available.
*
* On Linux and FreeBSD, this requires either root permissions, installation
* of the (deprecated) HAL library (lshal command). Linux also attempts to
* read the dmi/id serial number files in sysfs, which are read-only root by
* default but may have permissions altered by the user.
*
* @return the System/CPU Serial Number, if available, otherwise returns
* "unknown"
*
* @deprecated use {@link ComputerSystem#getSerialNumber()} instead.
*/
@Deprecated
String getSystemSerialNumber();
/**
* Get the number of logical CPUs available for processing. This value may
* be higher than physical CPUs if hyperthreading is enabled.
*
* @return The number of logical CPUs available.
*/
int getLogicalProcessorCount();
/**
* Get the number of physical CPUs/cores available for processing.
*
* @return The number of physical CPUs available.
*/
int getPhysicalProcessorCount();
/**
* Get the number of packages/sockets in the system. A single package may
* contain multiple cores.
*
* @return The number of physical packages available.
*/
int getPhysicalPackageCount();
/**
* Get the number of context switches which have occurred
*
* @return The number of context switches
*/
long getContextSwitches();
/**
* Get the number of interrupts which have occurred
*
* @return The number of interrupts
*/
long getInterrupts();
}
