GEOS SDK TechDocs
|
| 
4.2 Using Timers
| 
4.4 Shutting the System Down
SysStatistics(), SysGetInfo(), SysGetConfig(), SysGetPenMode(), SysGetDosEnvironment()
Occasionally, a geode will need to query the kernel about the state or configuration of the system. GEOS offers five routines for this:
SysStatistics()
returns a structure of type
SysStats
. This structure contains information about how busy the CPU is, how much swap activity is going on, how many context switches occurred in the last second, how many interrupts occurred in the last second, and how many runnable threads exist. You can not set or otherwise alter this structure.
SysGetInfo()
returns a particular statistic about the current system status. It can return a number of different statistics including the CPU speed, the total number of handles in the handle table, the total heap size, the total number of geodes running, and the size of the largest free block on the heap. Most of the information your application can request with this routine can be garnered from the Perf performance meter; it is easiest to use Perf when debugging, though a few geodes will need to know this information.
SysGetConfig()
returns information about the current system's configuration including the processor type and machine type. It also returns flags about the particular session of GEOS including whether this session was started with Swat, whether a coprocessor exists, and other information.
SysGetPenMode()
returns TRUE if GEOS is currently running on a pen-based machine.
SysGetDosEnvironment()
returns the value of a DOS environment variable. It is passed a string representing the variable name and returns a string representing the value.
GEOS SDK TechDocs
|
| 4.2 Using Timers
| 4.4 Shutting the System Down