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
There is currently only one osinfo_$ call, osinfo_$get_rev, which returns
information about the current Domain/OS revision running on a 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 |
|_____________________________________________________________|
| minor |
|_____________________________________________________________|
| 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
The major revision number.
minor
The minor revision number.
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.