https://www.haiku-os.org/legacy-docs/bebook/TheKernelKit_SystemInfo.html#is_computer_on

Prev Up Next
haiku-os.org
Home
I
en
The Be Book - Classes And Methods - The Kernel Kit
Prev: Time Information  Up: The Kernel Kit  Next: Miscellaneous
Functions And Constants
---------------------------------------------------------------------

System Information

Declared in: kernel/OS.h
Library:     libroot.so

The following functions, types, and structures are used to convey
basic information about the system, such as the number of CPUs, when
the kernel was built, what time it is now and whether your computer
is on fire.

---------------------------------------------------------------------

System Info Functions and Structures

get_system_info(), system_info, cpu_info, cpu_type, platform_type

status_t get_system_info(system_info* info);

struct {} system_info

struct {} cpu_info

enum cpu_type

enum platform_type

The get_system_info() function tells you more than you want to know
about the physical capacities and other statistics of your operating
system. The function takes a pointer to an allocated system_info
structure and fills it in.

typedef struct {
   machine_id  id;
   bigtime_t  boot_time;
   int32  cpu_count;
   cpu_type  cpu_type;
   int32  cpu_revision;
   cpu_info  cpu_infos[B_MAX_CPU_NUM];
   int64  cpu_clock_speed;
   int64  bus_clock_speed;
   platform_type  platform_type;
   int32  max_pages;
   int32  used_pages;
   int32  page_faults;
   int32  max_sems;
   int32  used_sems;
   int32  max_ports;
   int32  used_ports;
   int32  max_threads;
   int32  used_threads;
   int32  max_teams;
   int32  used_teams;
   char   kernel_name[B_FILE_NAME_LENGTH];
   char   kernel_build_date[B_OS_NAME_LENGTH];
   char   kernel_build_time[B_OS_NAME_LENGTH];
   int64  kernel_version;
} system_info

The system_info structure holds information about the machine and the
state of the kernel. The structure's fields are:

      Field                           Description
id.                The 64-bit number (encoded as two int32s) that
                   uniquely identifies this machine.

boot_time.         The time at which the computer was last booted,
                   measured in microseconds since January 1st, 1970.

cpu_count.         The number of CPUs.

cpu_type and       The type constant and revision number of the CPUs.
cpu_revision.

cpu_infos.         An array of cpu_info structures, one for each CPU.

cpu_clock_speed.   The speed (in Hz) at which the CPUs operate.

bus_clock_speed.   The speed (in Hz) at which the bus operates.

platform_type.     One of the platform type constants.

                   The five pairs of max/used fields give the total
max_resources and  number of RAM pages, semaphores, and so on, that
used_resources.    the system can create, and the number that are
                   currently in use.

page_faults.       The number of times the system a read a page of
                   memory into RAM due to a page fault.

kernel_name.       The (leaf) name of the kernel.

kernel_build_date  Human-readable strings that tell you when the
and                kernel was built.
kernel_build_time.

kernel_version.    A number that identifies the kernel version.

The cpu_info structure is:

typedef struct {
      bigtime_t active_time;
} cpu_info;

   Field                           Description
active_time Is the number of microseconds spent doing useful work
            since the machine was booted.

Relatedly, B_MAX_CPU_COUNT is currently 8.

The machine_id type is:

typedef int32 machine_id[2];

The cpu_type constants are:

typedef enum {
    B_CPU_PPC_601 = 1,
    B_CPU_PPC_603 = 2,
    B_CPU_PPC_603e = 3,
    B_CPU_PPC_604 = 4,
    B_CPU_PPC_604e = 5,
    B_CPU_PPC_686 = 13,
    B_CPU_AMD_29K,
    B_CPU_X86,
    B_CPU_MC6502,
    B_CPU_Z80,
    B_CPU_ALPHA,
    B_CPU_MIPS,
    B_CPU_HPPA,
    B_CPU_M68K,
    B_CPU_ARM,
    B_CPU_SH,
    B_CPU_SPARC
} cpu_type;

The platform_type constants are:

typedef enum {
    B_BEBOX_PLATFORM = 0,
    B_MAC_PLATFORM,
    B_AT_CLONE_PLATFORM,
    B_ENIAC_PLATFORM,
    B_APPLE_II_PLATFORM,
    B_CRAY_PLATFORM,
    B_LISA_PLATFORM,
    B_TI_994A_PLATFORM,
    B_TIMEX_SINCLAIR_PLATFORM,
    B_ORAC_1_PLATFORM,
    B_HAL_PLATFORM
} platform_type;

I haven't tried it, but I really don't think the BeOS would work at
all well on a Timex Sinclair (see is_computer_on_fire()).

get_system_info() always returns B_OK.

is_computer_on()

int32 is_computer_on();

Returns 1 if the computer is on. If the computer isn't on, the value
returned by this function is undefined.

is_computer_on_fire()

double is_computer_on_fire();

Returns the temperature of the motherboard if the computer is
currently on fire. Smoldering doesn't count. If the computer isn't on
fire, the function returns some other value.

---------------------------------------------------------------------
Prev: Time Information  Up: The Kernel Kit  Next: Miscellaneous
Functions And Constants 
Prev Up Next
haiku-os.org
Home
Access Company
Creative Commons License
Legal Notice
This work is licensed under a Creative Commons Attribution-Non
commercial-No Derivative Works 3.0 License.