Class LinuxOSThread

java.lang.Object

oshi.software.common.AbstractOSThread

oshi.software.common.os.linux.LinuxOSThread

All Implemented Interfaces:

OSThread

@ThreadSafe
public class LinuxOSThread
extends AbstractOSThread

OSThread implementation

Nested Class Summary

Nested classes/interfaces inherited from interface OSThread

OSThread.ThreadFiltering

Modifier and Type	Interface	Description
static final class	OSThread.ThreadFiltering	Constants which may be used to filter Thread lists

Constructor Summary

Constructors

Constructor	Description
LinuxOSThread(int processId, int tid, LinuxOperatingSystem os)	Creates a LinuxOSThread.

Method Summary

Modifier and Type	Method	Description
long	getContextSwitches()	A snapshot of the context switches the thread has done.
long	getKernelTime()	Kernel (privileged) time used by the thread.
long	getMajorFaults()	The number of major (hard) faults the thread has made which have required loading a memory page from disk.
long	getMinorFaults()	The number of minor (soft) faults the thread has made which have not required loading a memory page from disk.
String	getName()	The name of the thread.
int	getPriority()	Priority of the thread, the meaning of which is dependent on the OS.
long	getStartMemoryAddress()	The memory address above which this thread can run.
long	getStartTime()	The start time of the thread.
OSProcess.State	getState()	Gets the execution state of the task/thread.
int	getThreadId()	The thread id.
long	getUpTime()	Elapsed/up-time of the thread.
long	getUserTime()	User time used by the thread.
boolean	updateAttributes()	Attempts to updates process attributes.

Methods inherited from class AbstractOSThread

getOwningProcessId, getThreadCpuLoadBetweenTicks, getThreadCpuLoadCumulative, toString

Modifier and Type	Method	Description
int	getOwningProcessId()	The owning process of this thread.
double	getThreadCpuLoadBetweenTicks(OSThread priorSnapshot)	Gets CPU usage of this thread since a previous snapshot of the same thread, provided as a parameter.
double	getThreadCpuLoadCumulative()	Gets cumulative CPU usage of this thread.
String	toString()

Methods inherited from class Object

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

Constructor Details

LinuxOSThread

public LinuxOSThread(int processId,
 int tid,
 LinuxOperatingSystem os)

Creates a LinuxOSThread.

Parameters:

processId - the owning process ID

tid - the thread ID

os - the operating system

Method Details

getThreadId

public int getThreadId()

Description copied from interface: OSThread

The thread id. The meaning of this value is OS-dependent.

Returns:

Returns the id of the thread.

getName

public String getName()

Description copied from interface: OSThread

The name of the thread. Presence of a name is operating-system dependent and may include information (such as an index of running threads) that changes during execution.

Returns:

Returns the name of the task/thread.

getState

public OSProcess.State getState()

Description copied from interface: OSThread

Gets the execution state of the task/thread.

Returns:

Returns the execution state of the task/thread.

getStartTime

public long getStartTime()

Description copied from interface: OSThread

The start time of the thread.

Returns:

Returns the start time of the task/thread in number of milliseconds since January 1, 1970.

getStartMemoryAddress

public long getStartMemoryAddress()

Description copied from interface: OSThread

The memory address above which this thread can run.

Returns:

The start address.

getContextSwitches

public long getContextSwitches()

Description copied from interface: OSThread

A snapshot of the context switches the thread has done. Since the context switches could be voluntary and non-voluntary, this gives the sum of both.

Not available on AIX.

Returns:

sum of both voluntary and involuntary context switches.

getMinorFaults

public long getMinorFaults()

Description copied from interface: OSThread

The number of minor (soft) faults the thread has made which have not required loading a memory page from disk. Sometimes called reclaims. Linux only.

Returns:

minor faults.

getMajorFaults

public long getMajorFaults()

Description copied from interface: OSThread

The number of major (hard) faults the thread has made which have required loading a memory page from disk. Linux only.

Returns:

major faults.

getKernelTime

public long getKernelTime()

Description copied from interface: OSThread

Kernel (privileged) time used by the thread.

Returns:

Returns the number of milliseconds the task/thread has executed in kernel/system mode.

getUserTime

public long getUserTime()

Description copied from interface: OSThread

User time used by the thread.

Returns:

Returns the number of milliseconds the task/thread has executed in user mode.

getUpTime

public long getUpTime()

Description copied from interface: OSThread

Elapsed/up-time of the thread.

Returns:

Returns the number of milliseconds since the task/thread started.

getPriority

public int getPriority()

Description copied from interface: OSThread

Priority of the thread, the meaning of which is dependent on the OS.

Returns:

priority.

updateAttributes

public boolean updateAttributes()

Description copied from interface: OSThread

Attempts to updates process attributes. Returns false if the update fails, which will occur if the process no longer exists. Not implemented for macOS, as thread ID is simply an index and not unique.

Returns:

true if the update was successful, false if the update failed. In addition, on a failed update the thread state will be changed to OSProcess.State.INVALID.