Class MacOperatingSystem

  • All Implemented Interfaces:
    OperatingSystem

    @ThreadSafe
    public class MacOperatingSystem
    extends AbstractOperatingSystem
    macOS, previously Mac OS X and later OS X) is a series of proprietary graphical operating systems developed and marketed by Apple Inc. since 2001. It is the primary operating system for Apple's Mac computers.
    • Field Detail

      • LOG

        private static final org.slf4j.Logger LOG
      • MACOS_VERSIONS_PROPERTIES

        public static final java.lang.String MACOS_VERSIONS_PROPERTIES
        See Also:
        Constant Field Values
      • SYSTEM_LIBRARY_LAUNCH_AGENTS

        private static final java.lang.String SYSTEM_LIBRARY_LAUNCH_AGENTS
        See Also:
        Constant Field Values
      • SYSTEM_LIBRARY_LAUNCH_DAEMONS

        private static final java.lang.String SYSTEM_LIBRARY_LAUNCH_DAEMONS
        See Also:
        Constant Field Values
      • maxProc

        private int maxProc
      • osXVersion

        private final java.lang.String osXVersion
      • major

        private final int major
      • minor

        private final int minor
      • BOOTTIME

        private static final long BOOTTIME
    • Constructor Detail

      • MacOperatingSystem

        public MacOperatingSystem()
    • Method Detail

      • parseCodeName

        private java.lang.String parseCodeName()
      • 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
      • 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
      • 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
      • 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.
      • 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
      • 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.