Package oshi.software.os.linux

Class LinuxOperatingSystem

java.lang.Object

oshi.software.common.AbstractOperatingSystem

oshi.software.os.linux.LinuxOperatingSystem

All Implemented Interfaces:

OperatingSystem

@ThreadSafe
public class LinuxOperatingSystem
extends AbstractOperatingSystem

Linux is a family of open source Unix-like operating systems based on the Linux kernel, an operating system kernel first released on September 17, 1991, by Linus Torvalds. Linux is typically packaged in a Linux distribution.

Nested Class Summary

Nested classes/interfaces inherited from interface oshi.software.os.OperatingSystem

OperatingSystem.OSVersionInfo, OperatingSystem.ProcessFiltering, OperatingSystem.ProcessSorting

Field Summary

Fields

Modifier and Type	Field	Description
static final boolean	HAS_GETTID	This static field identifies if the gettid function is in the c library.
static final boolean	HAS_SYSCALL_GETTID	This static field identifies if the syscall for gettid returns sane results.
static final boolean	HAS_UDEV	This static field identifies if the udev library can be loaded.

Fields inherited from class oshi.software.common.AbstractOperatingSystem

USE_WHO_COMMAND

Constructor Summary

Constructors

Constructor	Description
LinuxOperatingSystem()	Constructor for LinuxOperatingSystem.

Method Summary

Modifier and Type	Method	Description
OSThread	getCurrentThread()	Makes a best effort to get the current thread.
FileSystem	getFileSystem()	Instantiates a FileSystem object.
static long	getHz()	Gets Jiffies per second, useful for converting ticks to milliseconds and vice versa.
InternetProtocolStats	getInternetProtocolStats()	Instantiates a InternetProtocolStats object.
NetworkParams	getNetworkParams()	Instantiates a NetworkParams object.
static long	getPageSize()	Gets Page Size, for converting memory stats from pages to bytes
OSProcess	getProcess(int pid)	Gets information on a currently running process
int	getProcessCount()	Get the number of processes currently running
int	getProcessId()	Gets the current process ID (PID).
protected static String	getReleaseFilename()	Looks for a collection of possible distrib-release filenames
List<OSService>	getServices()	Gets the all services on the system.
List<OSSession>	getSessions()	Gets currently logged in users.
long	getSystemBootTime()	Get Unix time of boot.
long	getSystemUptime()	Get the System up time (time since boot).
int	getThreadCount()	Get the number of threads currently running
int	getThreadId()	Makes a best effort to get the current thread ID (TID).
List<OSProcess>	queryAllProcesses()
protected int	queryBitness(int jvmBitness)	Backup OS-specific query to determine bitness if previous checks fail
List<OSProcess>	queryChildProcesses(int parentPid)
List<OSProcess>	queryDescendantProcesses(int parentPid)
Pair<String,OperatingSystem.OSVersionInfo>	queryFamilyVersionInfo()
String	queryManufacturer()

Methods inherited from class oshi.software.common.AbstractOperatingSystem

getBitness, getChildProcesses, getChildrenOrDescendants, getChildrenOrDescendants, getDescendantProcesses, getFamily, getManufacturer, getProcesses, getVersionInfo, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface oshi.software.os.OperatingSystem

getCurrentProcess, getDesktopWindows, getProcesses, getProcesses, isElevated

Field Details

HAS_UDEV

public static final boolean HAS_UDEV

This static field identifies if the udev library can be loaded.

HAS_GETTID

public static final boolean HAS_GETTID

This static field identifies if the gettid function is in the c library.

HAS_SYSCALL_GETTID

public static final boolean HAS_SYSCALL_GETTID

This static field identifies if the syscall for gettid returns sane results.

Constructor Details

LinuxOperatingSystem

public LinuxOperatingSystem()

Constructor for LinuxOperatingSystem.

Method Details

queryManufacturer

public String queryManufacturer()

Specified by:

queryManufacturer in class AbstractOperatingSystem

queryFamilyVersionInfo

public Pair<String,OperatingSystem.OSVersionInfo> queryFamilyVersionInfo()

Specified by:

queryFamilyVersionInfo in class AbstractOperatingSystem

queryBitness

protected int queryBitness(int jvmBitness)

Description copied from class: AbstractOperatingSystem

Backup OS-specific query to determine bitness if previous checks fail

Specified by:

queryBitness in class AbstractOperatingSystem

Parameters:

jvmBitness - The bitness of the JVM

Returns:

The operating system bitness

getFileSystem

public FileSystem getFileSystem()

Description copied from interface: OperatingSystem

Instantiates a FileSystem object.

Returns:

A FileSystem object.

getInternetProtocolStats

public InternetProtocolStats getInternetProtocolStats()

Description copied from interface: OperatingSystem

Instantiates a InternetProtocolStats object.

Returns:

a InternetProtocolStats object.

getSessions

public List<OSSession> getSessions()

Description copied from interface: OperatingSystem

Gets currently logged in users.

On macOS, Linux, and Unix systems, the default implementation uses native code (see man getutxent) that is not thread safe. OSHI's use of this code is synchronized and may be used in a multi-threaded environment without introducing any additional conflicts. Users should note, however, that other operating system code may access the same native code.

The Who.queryWho() method produces similar output parsing the output of the Posix-standard who command, and may internally employ reentrant code on some platforms. Users may opt to use this command-line variant by default using the oshi.os.unix.whoCommand configuration property.

Returns:

A list of OSSession objects representing logged-in users

getProcess

public OSProcess getProcess(int pid)

Description copied from interface: OperatingSystem

Gets information on a currently running process

Parameters:

pid - A process ID

Returns:

An OSProcess object for the specified process id if it is running; null otherwise

queryAllProcesses

public List<OSProcess> queryAllProcesses()

Specified by:

queryAllProcesses in class AbstractOperatingSystem

queryChildProcesses

public List<OSProcess> queryChildProcesses(int parentPid)

Specified by:

queryChildProcesses in class AbstractOperatingSystem

queryDescendantProcesses

public List<OSProcess> queryDescendantProcesses(int parentPid)

Specified by:

queryDescendantProcesses in class AbstractOperatingSystem

getProcessId

public int getProcessId()

Description copied from interface: OperatingSystem

Gets the current process ID (PID).

Returns:

the Process ID of the current process

getProcessCount

public int getProcessCount()

Description copied from interface: OperatingSystem

Get the number of processes currently running

Returns:

The number of processes running

getThreadId

public int getThreadId()

Description copied from interface: OperatingSystem

Makes a best effort to get the current thread ID (TID). May not be useful in a multithreaded environment. The thread ID returned may have been short lived and no longer exist.

Thread IDs on macOS are not correlated with any other Operating System output.

Returns:

the Thread ID of the current thread if known, 0 otherwise.

getCurrentThread

public OSThread getCurrentThread()

Description copied from interface: OperatingSystem

Makes a best effort to get the current thread. May not be useful in a multithreaded environment. The thread returned may have been short lived and no longer exist.

On macOS, returns the oldest thread in the calling process.

Returns:

the current thread if known; an invalid thread otherwise.

getThreadCount

public int getThreadCount()

Description copied from interface: OperatingSystem

Get the number of threads currently running

Returns:

The number of threads running

getSystemUptime

public long getSystemUptime()

Description copied from interface: OperatingSystem

Get the System up time (time since boot).

Returns:

Number of seconds since boot.

getSystemBootTime

public long getSystemBootTime()

Description copied from interface: OperatingSystem

Get Unix time of boot.

Returns:

The approximate time at which the system booted, in seconds since the Unix epoch.

getNetworkParams

public NetworkParams getNetworkParams()

Description copied from interface: OperatingSystem

Instantiates a NetworkParams object.

Returns:

A NetworkParams object.

getReleaseFilename

protected static String getReleaseFilename()

Looks for a collection of possible distrib-release filenames

Returns:

The first valid matching filename

getServices

public List<OSService> getServices()

Description copied from interface: OperatingSystem

Gets the all services on the system. The definition of what is a service is platform-dependent.

Returns:

An array of OSService objects

getHz

public static long getHz()

Gets Jiffies per second, useful for converting ticks to milliseconds and vice versa.

Returns:

Jiffies per second.

getPageSize

public static long getPageSize()

Gets Page Size, for converting memory stats from pages to bytes

Returns:

Page Size