Class WindowsOperatingSystem

  • All Implemented Interfaces:
    OperatingSystem

    @ThreadSafe
    public class WindowsOperatingSystem
    extends AbstractOperatingSystem
    Microsoft Windows, commonly referred to as Windows, is a group of several proprietary graphical operating system families, all of which are developed and marketed by Microsoft.
    • Field Detail

      • LOG

        private static final org.slf4j.Logger LOG
      • USE_PROCSTATE_SUSPENDED

        private static final boolean USE_PROCSTATE_SUSPENDED
      • IS_VISTA_OR_GREATER

        private static final boolean IS_VISTA_OR_GREATER
      • systemLog

        private static java.util.function.Supplier<java.lang.String> systemLog
      • BOOTTIME

        private static final long BOOTTIME
      • X86

        private static final boolean X86
      • WOW

        private static final boolean WOW
    • Constructor Detail

      • WindowsOperatingSystem

        public WindowsOperatingSystem()
    • Method Detail

      • parseCodeName

        private static java.lang.String parseCodeName​(int suiteMask)
        Gets suites available on the system and return as a codename
        Parameters:
        suiteMask - The suite mask bitmask
        Returns:
        Suites
      • 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
      • isElevated

        public boolean isElevated()
        Description copied from interface: OperatingSystem
        Determine whether the current process has elevated permissions such as sudo / Administrator
        Returns:
        True if this process has elevated permissions
      • getSessions

        public java.util.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
      • getProcesses

        public java.util.List<OSProcess> getProcesses​(java.util.Collection<java.lang.Integer> pids)
        Description copied from interface: OperatingSystem
        Gets information on a Collection of currently running processes. This has potentially improved performance vs. iterating individual processes.
        Parameters:
        pids - A collection of process IDs
        Returns:
        A list of OSProcess objects for the specified process ids if it is running
      • getParentPidsFromSnapshot

        private static java.util.Map<java.lang.Integer,​java.lang.Integer> getParentPidsFromSnapshot()
      • 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
      • processMapToList

        private java.util.List<OSProcess> processMapToList​(java.util.Collection<java.lang.Integer> pids)
      • 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.
      • querySystemUptime

        private static long querySystemUptime()
      • 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.
      • querySystemBootTime

        private static long querySystemBootTime()
      • enableDebugPrivilege

        private static boolean enableDebugPrivilege()
        Attempts to enable debug privileges for this process, required for OpenProcess() to get processes other than the current user. Requires elevated permissions.
        Returns:
        true if debug privileges were successfully enabled.
      • getServices

        public java.util.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
      • querySystemLog

        private static java.lang.String querySystemLog()
      • getDesktopWindows

        public java.util.List<OSDesktopWindow> getDesktopWindows​(boolean visibleOnly)
        Description copied from interface: OperatingSystem
        Gets windows on the operating system's GUI desktop.

        On Unix-like systems, reports X11 windows only, which may be limited to the current display and will not report windows used by other window managers.

        While not a guarantee, a best effort is made to return windows in foreground-to-background order. This ordering may be used along with OSDesktopWindow.getOrder() to (probably) determine the frontmost window.

        Parameters:
        visibleOnly - Whether to restrict the list to only windows visible to the user.

        This is a best effort attempt at a reasonable definition of visibility. Visible windows may be completely transparent.

        Returns:
        A list of OSDesktopWindow objects representing the desktop windows.
      • isX86

        static boolean isX86()
        Is the processor architecture x86?
        Returns:
        true if the processor architecture is Intel x86
      • isCurrentX86

        private static boolean isCurrentX86()
      • isWow

        static boolean isWow()
        Is the current operating process x86 or x86-compatibility mode?
        Returns:
        true if the current process is 32-bit
      • isWow

        static boolean isWow​(com.sun.jna.platform.win32.WinNT.HANDLE h)
        Is the specified process x86 or x86-compatibility mode?
        Parameters:
        h - The handle to the processs to check
        Returns:
        true if the process is 32-bit
      • isCurrentWow

        private static boolean isCurrentWow()