Index

ACIAPAK 8-136
active process 2-12 - 2-13
queue 2-14, 8-98
state 2-13 - 2-14
address
find 64K block 8-85
lines 2-7
polling 2-17
space, add module 8-104
age, process 2-14
alarm, set 8-66
allocate
high RAM 8-69
image 8-70
memory 8-76

memory blocks
8-68

process descriptor 8-71
process task number
8-73
RAM 8-72
allocation
bit map 8-7
map sector 5-1

of memory 2-5 - 2-7 button

polling 2-17
allocation map
clear 8-13
disk 5-3
alpha screen
cursor 8-118
memory 8-117
ASM assembler 8-2
assembler, RMA 8-2
attach a device 8-44 - 8-45
attribute
byte 5-5,
file 5-12
background color, get 8-130
bell, set alarm 8-66
bit map 2-5
allocation 8-7

8-67 -

block

byte

bit map (cont'd.)

search memory

allocation 8-33

allocate system
memory 8-105
deallocate system
memory 8-106
map into process
space 8-96
number 2-7
scroll 8-139
block map, system 8-18
boot
file, load 5-26
module, link 8-75
booting OS-9 1-3
bootstrap
memory request 8-76
system 8-75
border color, get 8-130
buffer
map (Get/Put) 8-122
reserve graphics 8-137

state, mouse 8-125 -
8-126, 8-127
timeout, mouse 8-140

attribute 5-5
deallocate 64-byte
block 8-101
get from memory
block 8-94
get two bytes 8-95
read from path 8-59 -
8-60
store in task 8-109

calling process

insert in I/O queue 8-91

terminate 8-14

turnoff 8-35, 8-43

CC3DISK 1-2

OS-9 Technical Reference

CC 3 GO module 2-19
CC310 1-2, 6-1
chain 8-8 - 8-9
change
device operating
parameters 5-23
directory 8-46
character
read SCF input 6-13
write, SCF 6-14
ChgDir 4-4
child process 2-13
create 8-15 - 8-17
clear specified block 8-77
click 8-127
CLOCK 1-2
clock
module 1-2, 2-19
real-time 2-12, 2-17

close

codes

file 4-7
path 8-47, 8-136

signal 2-15
system error C-1
command interpreter 1-4
communication,
interprocess 2-15
compact module directory
8-88
compare strings 8-10
compatibility with Level
One 2-1
concurrent execution 7-1 - 7-3
copy external memory 8-11
count, link 2-5
counter start, mouse 8-125
CPU 2-7
time 4-11
CRC
calculate 8-12

validate module
value 3-1 - 3-3
create

directory 8-55 - 8-56


create (cont'd.)


file 8-48 - 8-49


current


data directory $-51


execution directory 8-51


cursor positioning 4-5


cyclic redundancy check 3-1 -


3-3


DAT

data

hardware 8-99
registers 8-103
to logical address 8-7$

available, SCF test
8-113
directory 8-51
stream 4-3
transfer, pipes 7-1 - 7-3
move in memory 8-97
DAT image 8-70
conversion 8-78
copy into process
descriptor 8-102
deallocate block 8-77
high block 8-86
low block 8-87
pointer 8-95
DAT task number
release 8-99
reserve 8-100

date

get system 8-40
set 8-38
deadlock 5-13
deadly embrace 5-13
deallocate
image RAM blocks 8-79
map bits 8-13
process descriptor 8-80
RAM blocks 8-81
task number 8-82
default palette registers
8-130, 8-149
delete file 8-50 - 8-51
Index


descriptions, system call 8-2 device driver modules,


descriptor RBF 5-13 - 5-17


get process 8-20 device interrupt 5-25


path 4-18 SCF 6-17


pointer 8-82 directory


process 2-13 attribute byte 5-5


detach device 8-52 change 8-46


device disk 5-5


add or remove from entry, module 8-83


polling table 8-92 get module 8-19


attach 8-44 - 8-45 make 8-55 - 8-56


attachment, verify 8-44 module 2-12, 8-88


- 8-45 disk


controller 5-15 directories 5-5


control registers, sector read 5-19, 5-21

initialize 6-12 disk allocation map 5-3
control registers, SCF sector 5-1
6-12 diskette format B-1
descriptor 1-4, 4-2, 4-17, display
A-2 screen 8-143
detach 8-52 status, get 8-115
''~ modules 5-15 drag 8-127

modules, RBF 5-8 - 5-10 drive head, restore 8-132


modules, SCF 6-6 - 6-8 duplicate path 8-53


name, get 8-115


open path to 8-57 - 8-58 editing, line 6-1, 8-61


operating parameters, end-of-file, test for 8-114


RBF 5-23 equate file 2-4


operating parameters, equivalent logical address


SCF 6-15 8-78


status 2-17 - 2-18, 8-63 error


status, get 8-54 codes, system C-1 - C-6


table 4-2, 8-52 message, write 8-30


terminate, RBF 5-24 print 8-30


terminate, SCF 6-16 exclamation point, pipes 7-1 -


write to 8-64 - 8-65 7-3


device driver 1-3, 4-11 execute


close path 8-136 mode 5-11


modules 4-8 system calls 8-1 - 8-2


name 5-15 execution


SCF 6-9 - 6-17 directory 8-51


SCF subroutines 6-10 - offset, module 3-7


6-17 exit calling process 8-14


subroutines, RBF 5-16 - external memory, read 8-11


5-27

OS-9 Technical Reference

fatal signal 2-13
file
attribute byte 5-12
closing 4-7
create 4-4, 5-12, 8-48 -
8-49
deadlock 5-13
delete 4-5, 8-50 - 8-51
descriptor 5-3 - 5-4
execute mode 5-11
get pointer position
8-114
line reading/writing 4-6
load module 8-29
locking 5-12
non-shareable 5-12
opening 4-4
open path 8-57 - 8-58
permission bits 5-4
pipe 7-1 - 7-3
pointer 4-5, 8-62
position, RBF 8-114
read 5-1, 4-5
sharing 5-12
size, get 8-114
status, get 8-54, 8-114
update mode 5-11
write line to 8-64 - 8-65
writing 4-6
file manager 1-3
modules 4-3
name 5-15

find

64-byte block 8-85
module directory
entry 8-84
fire button 8-124 - 8-128
FIRQ 4-12
interrupt 2-17
flag, RAM In Use 8-81
flip byte 2-17
floppy diskette format B-1
foreground color, get 8-130
FORK 2-8
fork, child process 8-15 - 8-17

FORMAT 5-2
format
device descriptor 4-17,
A-2
INIT module A-3
memory module 3-6 -
3-7, A-1
of device driver
modules 4-10
track 8-133
function
calls 2-4 - 2-5, 8-1
key sense 8-134


get


a byte 8-94
free high block 8-86
free low block 8-87
ID 8-22
process pointer 8-89
status 8-54
Status system calls
8-112 - 8-131
system time 8-40
Get/Put buffer, map 8-122
GETSTA 8-112
SCF 6-15
GetStat 4-6
Getstats 5-23
graphics buffer
reserve 8-137
select 8-138
graphics interface 1-2
GRFINT 1-2

handler routine, virtual
interrupt 8-110
hard disk shutdown 8-134
hardware
controller, SCF 6-9
DAT registers 8-103
vector 2-16
header
module 3-1 - 3-2
parity 8-111

Index


header (cont'd.)


pattern, floppy


diskette B-1


high block, memory search


8-86


high-level


menu handler 8 -12 3


menu manager 8-148


window handler 8-139


high-resolution


mouse adapter 8-127


screen, allocate 8-142


hold, button 8-127


I/O


calls 2-4 - 2-5, 8-1


device accessing 2-11


module, delete 8-90


path, close 8-47


queue, insert calling


process 8-91


I/O system 1-3 - 1-4


calls 2-1, 8-2


system modules
1-4, 4-1
transfers 4-8
ID
return caller's
process 8-22
set user 8-39

identification sector 5-1
image, allocate 8-70
INIT 1-2, 5-18
INIT module 2-17
format A-3
link 8-75
Init, SFC 6-12
initialization table, SCF
device 6-6 - 6-8
initialize device memory 5-18
input buffer, read SCF
character 6-13
insert process 8-74
install virtual interrupt
8-110
intercept, set signal 8-21


interface


graphics 1-2


VDG 4-2


Windint 4-2


interprocess


communication 2-15


interrupt


device 5-25


enable, SCF 6-12


FIRQ 2-17


processing 2-1


IOMAN 1-2


IRQ 4-12


add/remove device from


polling table 8-92


interrupt 2-17


polling 2-17


polling table 2-18


service routine 5-25


IRQSERUC routine 4-13


IRQSV 4-11


joystick value, get 8-116

kernel 1-2
key
repeat parameters,
set 8-147
sense function 8-134
status, get 8-120
keyboard scan 2-17

language byte 3-4
line
editing 6-1, 8-61
reads 4-6, 8-61
writes 4-6, 8-65

to memory module 8-23
- 8-24, 8-28
using module directory
entry 8-83
link count 2-5
decrease 8-42

link
OS-9 Technical Reference

load

boot file 5-26
byte from memory
block 8-94
from task offset 8-93
module 8-25 - 8-26, 8-29
two bytes 8-95
lock, end-of-lock 5-12
locking
files 5-12
record 5-10 - 5-11
logical
address space 2-6, 2-8
sector number 5-1
LSN 5-2, 5-5

macro 2-4
MAKDIR 4-4
make directory 8-55 - 8-56
manager
file 1-3
random block 1-3
sequential file 1-3
map
block 8-96
search allocation 8-33
mask byte 2-18
memory
allocate 8-76
allocate blocks 8-67 -
8-68
allocate high RAM 8-69
change process data
size 8-27
deallocate 2-5
find low block 8-87
free screen 8-144
map 2-6
module format 3-6 - 3-7,
A-1
module, link 8-23 - 8-24
move data 8-97
page 2-5
pool 8-80
request, bootstrap 8-76


memory (cont'd.)


segment 2-8


memory allocation 2-5 - 2-7


memory block 2-7


find 64K 8-85


get byte 8-94


get high 8-86


map 8-81


map, search 8-72


memory management 2-1, 2-5


- 2-12


unit 2-7 - 2-8


menu


manager, update


request 8-148


selection 8-123


message, write error 8-30


MMU registers 2-8


mnemonic name, LSN 5-2


MODPAK 8-136


module


add into address


space 8-104


body 3-1 - 3-2


clock 2-19


CRC calculate 8-12


decrease link count 8-42


delete I/O module 8-90


device descriptor 5-15


device driver 4-8


file manager 4-3


finding 2-12


format 3-1 - 3-3


link 8-28


link count, decrease


8-42


linking 1-2 _


load 8-25 - 8-26, 8-29


load and execute


primary 8-8 - 8-9


name 3-3


RBF-type device


drivers 5-13 - 5-17


SCF device descriptor


6-6 - 6-8


6
Index


module (cont'd.)


types 3-1, 3-5


unlink 8-41


validate 8-111


module directory 2-5, 2-12


compact 8-88


entry, link using 8-83


find 8-84


get 8-19


pointer 8-84


module header 3-1 - 3-3, 5-15


SCF device driver 6-9


monitor, set type 8-146


mouse


button state 8-126


button timeout 8-140


click 8-123


coordinates 8-128


countdown 8-126


countup 8-126


parameters, set 8-147


port 8-126


resolution 8-127


screen position 8-127


send signal to process 8


141


status, get 8-124


timeout 8-125


window working area


8-128


move data 8-97


multiplexer 2-8


multiprogramming 2-12 -


2-16


management 2-1


multitasking 1-2


name parse 8-31 - 8-32
names, compare 8-10
next process 8-98
NMI interrupt 2-17
non-shareable file 5-12
number, path 8-53


open


file 8-48 - 8-49
path 8-57 - 8-58
operation of memory
management 2-8 - 2-12
OS-9
Level One
compatibility 2-1
modules 1-2
scheduler 2-14 - 2-15
OS9P3 2-1
module 2-2

packet size 8-125
palette, get information 8-128
palette register 8-130
set default 8-149
settings 8-130
parameters, mouse and key
repeat 8-147
parent
directory 5-3
process 2-13
parity 8-136
parse name 8-31 - 8-32
path
close 8-47, 8-136
duplicate 8-53
open 8-57 - 8-58
read bytes 8-59 - 8-60
table 4-2
path descriptor 4-18, 5-5 -
5-8
read option section
8-112
SCF 6-2 - 6-6
write option section
8-131
permanent storage size,
module 3-7
physical address space 2-7
pipe file manager 4-3
PIPEMAN 1-2 - 1-3, 4-3
OS-9 Technical Reference

pipes 4-3, 7-1 - 7-3
process descriptor 2-13 -
2-14, 8-102
deallocate 8-80
descriptor, allocate 8-71
get 8-20
pointer 8-82

real-time clock 2-12, 2-17
record locking 5-10
reference


System Mode calls


8-6

User Mode system
calls 8-3 - 8-4
registers

processes

active 2-12 DAT 8-103
data size, change 8-27 MMU 2-8

process ID 2-13
return caller's 8-22
pseudo vector 2-16
PutStat 4-6

RAM 2-5 - 2-7
allocate 8-69, 8-72
allocate blocks 8-70
allocation 2-13
blocks, deallocate 8-81
blocks, deallocate
image 8-79
interrupt vector 2-18
random

RBF

access 5-1
block file manager
4-3

1-3,

change file size 8-132
format track 8-133
get file size 8-114
manager 4-3
tables 5-14 - 5-17
RBFMAN 1-2
read
bytes 8-59 - 8-60
device operating
parameters 5-23
disk sector 5-19
external memory 8-11
input character, SCF
6-13
line 6-2, 8-61
mode 5-11
system call 6-1

8-5 -

release a task 8-99
request system memory
8-105
reserved memory 2-5 - 2-7
reserve task number 8-100
return
64 bytes 8-101
system memory 8-106
RMA assembler 8-2

ROOT directory
RTS instruction

SCF

5-3, 5-5
2-18

configure serial port
8-135 - 8-136
data available test
8-113
device control
registers 6-12
Getsta 6-15
manager 4-3
path descriptor 6-2 - 6-6
terminate device 6-16
SCFMAN 1-2, 6-1
scheduler, OS-9 2-14 - 2-15
screen
allocate high
resolution 8-142
convert type 8-145
display 8-143
free memory 8-144
mouse position 8-127
palette 8-128
size, get 8-119
type 8-129, 8-142, 8-145
scroll block, install 8-139

Index

set

search bits 8-33
sector 5-3
pattern, floppy
diskette B-1
seek, file pointer 8-62
segment, memory 2-8
select graphics buffer 8-138
send signal 8-34
sequential character
file manager 1-3, 4-3
I/O 6-1
serial port configuration
8-121
service
request processing 2-1
routine, IRQ 5-25

alarm 8-66
date 8-38
IRQ 8-92
priority 8-36
process DAT image
8-102
process task DAT
registers 8-103
status 8-63
SVC 8-107 - 8-108
SWI 8-37
time 8-38
user ID 8-39
Setstats 5-23
Set Status system calls
- 8-150
shareable bit 3-5
sharing, file 5-12
shell 1-4

shutdown hard disk 8-134
signal 2-15 - 2-16
codes 2-15
fatal 2-13
from mouse to
process 8-141
intercept trap 2-15 -
2-16
intercept, set 8-21
send to process 8-34

8-131

single-user

size

attribute 5-12
bit, files 5-12

of screen 8-119
of window 8-119
sleep
calling process 8-35
sleeping process 2-14, 2-16
slices, time 2-12
sound, create 8-150
speaker, create sound 8-150
state
active 2-13
of button 8-127
sleeping 2-14
suspend 4-13
waiting 2-13
static storage address 2-18
status
display 8-115
get, SCF 6-15
get mouse 8-124 - 8-128
of key 8-120
register 2-17
set, SCF 6-15
status, get 8-54
status, set 8-63
store byte in a task 8-109
string, scan input 8-31 - 8-32
strings, compare 8-10
subroutines
RBF device driver 5-16 -
5-27
SCF device drivers 6-10
- 6-17
suspend
bit 4-13 - 4-14
state 4-13
SWI, set 8-37
SW12 instruction 2-4
symbolic names 2-4
sync byte 3-3
synonymous path number,
return 8-53

9
OS-9 Technical Reference


system


block map, get 8-18


boot 1-3


bootstrap 8-75


date, get 8-40


device, attach 8-44


error codes C-1 - C-6


initialization 2-1


link 8-104


mode call reference 8-5 -


8-6


time, get 8-40


system call


add 8-107 - 8-108


descriptions 8-2, 2-4


execution 8-1 - 8-2


get status 8-112 - 8-131


mnemonics names 8-1


User Mode reference 8-3


- 8-4


system memory


allocate high RAM 8-69


block map 8-81


deallocate 8-106


module directory, get


8-19


request 8-105


system modules 1-1 - 1-4


table

task

device 8-52
IRQ polling 2-18
RBF 5-14 - 5-17
SCF device descriptor
6-6 - 6-8
VIRQ 2-20

map 2-12
offset, load from 8-93
register 2-8
release 8-99
store byte 8-109
task number 8-73
DAT 8-100
deallocate 8-82

terminal, create sound 8-150

terminate

a device 5-24
calling process 8-14
SCF device 6-16
ticks 4-11
time
CPU 4-11
get system 8-40
set 8-38
sharing 2-11
slice 2-16, 2-12
timeout, mouse 8-125
track
format 8-133
restore drive head 8-132
trailer pattern, floppy
diskette B-1
trap, signal intercept 2-15 -
2-16
type
convert screen 8-145
of screen 8-129
set monitor 8-146
window screen 8-142

unlink module 8-41 - 8-42
update mode 5-11
user calls 2-5
user ID 2-13
set 8-39
User Mode system calls
reference 8-3 - 8-4

validate module 8-111
VDG 1-2
alpha screen cursor
8-118
alpha screen memory
8-117
interface 4-2
vector
pseudo 2-16
set SWI 8-37
vectoring 2-16

10

Index



verify device attachment working directory, change


8-44 - 8-45 8-46

- -, video display generator 1-2 write
VIRQ 2-19 - 2-20 character to SCF
polling table _ 2 -19 - 2-20 output 6-14
virtual interrupt, install disk sector 5-21
8-110 path descriptor 8-131 -
8-132
wait to file or device 8-64

calling process 8-43 write line 8-65


state 2-13 - 2-14 line system call 6-2


waiting process 2-13


wildcard 4-6


WINDINT 1-2


Windint interface 4-2


window


descriptors 1-2


high-level handler 8-139


pointer location 8-125


screen, type 8-142


size, get 8-119


type 8-145

~~ working area, mouse

8-128


11