Module com.github.oshi
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.

  • 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