OSINFO_$INTRO Domain/OS OSINFO_$INTRO
NAME
intro - Domain/OS information
SYNOPSIS (C)
#include <apollo/base.h>
#include <apollo/osinfo.h>
SYNOPSIS (Pascal)
%include '/sys/ins/base.ins.pas';
%include '/sys/ins/osinfo.ins.pas';
DESCRIPTION
The osinfo_$ calls allow programs to get information about the node type,
memory size, and operating system revision running on a node.
The following routines make up the osinfo_$ library.
osinfo_$get_rev get Domain/OS revision information
osinfo_$mem_size get memory size of specified node
osinfo_$node_type get model number of specified node
Constants
os_rev_$version
The current revision.
os_rev_$n_patches
The maximum number of recorded patches to an operating system revi-
sion level.
os_rev_$strlen
The number of bytes in a Domain/OS revision string.
Data Types
os_rev_str_$t
An array of os_rev_$strlen bytes for holding operating system revi-
sion strings.
os_rev_patch_$t
An array of os_rev_$n_patches for recording operating system
patches.
os_rev_$t
A record supplied by osinfo_$get_rev for conveying information about
a Domain/OS revision. The following diagram illustrates the format:
15 0
______________________________________________________________
| version |
|_____________________________________________________________|
| version |
|_____________________________________________________________|
| major (mmajor) |
|_____________________________________________________________|
| minor (mminor) |
|_____________________________________________________________|
| subminor |
|_____________________________________________________________|
| code |
|_____________________________________________________________|
| build_time |
|_____________________________________________________________|
| build_time |
|_____________________________________________________________|
| patch |
|_____________________________________________________________|
| patch |
|_____________________________________________________________|
| ... |
|_____________________________________________________________|
| ... |
|_____________________________________________________________|
| os_len |
|_____________________________________________________________|
| os_len |
|_____________________________________________________________|
| pvt_len |
|_____________________________________________________________|
| pvt_len |
|_____________________________________________________________|
| date_len |
|_____________________________________________________________|
| date_len |
|_____________________________________________________________|
| os_str | ... |
|______________________________|______________________________|
| pvt_str | ... |
|______________________________|______________________________|
| date_str | ... |
______________________________________________________________
15 8 7 0
version
The current version number.
major (mmajor)
The major revision number. Pascal programs should refer to
this field as major; C programs should refer to it as mmajor.
The altered name in C is necessary to prevent conflicts with
the file /usr/include/sys/types.h .
minor (mminor)
The minor revision number. Pascal programs should refer to
this field as minor; C programs should refer to it as mminor.
The altered name in C is necessary to prevent conflicts with
the file /usr/include/sys/types.h .
subminor
The subminor revision number.
code Reserved for future use.
build_time
A time_$clockh_t value representing the most-significant 32
bits of the clock value when the system was built.
patch
An array of numbers for patches applied to the system.
os_len
The number of significant bytes in os_str.
pvt_len
The number of significant bytes in pvt_str.
date_len
The number of significant bytes in date_str.
os_str
The name of the operating system.
pvt_str
An extention to the name of the operating system.
date_str
The build date of the operating system.
Errors
osinfo_$array_toosmall
The requested information is too large to fit in the space allotted.
osinfo_$wrong_version
An incorrect version number was passed to osinfo_$get_rev. Use
os_rev_$version for the version argument.