OS-9 Operating System User's Guide
Total Page:16
File Type:pdf, Size:1020Kb
OS-9 Operating System User's Guide For Use with OS-9 Level One and OS-9 Level Two OS-9 Operating System User's Guide: For Use with OS-9 Level One and OS-9 Level Two Copyright © 1980, 1983 Microware Systems Corporation All Rights Reserved. Introduction .................................................................................................................. v 1. Getting Started... ....................................................................................................... 1 1.1. What You Need to Run OS-9 ........................................................................... 1 1.1.1. Starting the System ............................................................................... 1 1.1.2. In Case You Have Problems Starting OS-9 ............................................... 1 1.1.3. A Quick Introduction to the Use of the Keyboard and Disks ......................... 2 1.1.4. Initial Explorations ............................................................................... 2 1.2. Making a Backup of the System Disk ................................................................. 3 1.2.1. Formatting Blank Disks ......................................................................... 3 1.2.2. Running the Backup Program ................................................................. 4 2. Basic Interactive Functions .......................................................................................... 5 2.1. Running Commands and Basic Shell Operation .................................................... 5 2.1.1. Sending Output to the Printer ................................................................. 5 2.2. Shell Command Line Parameters ....................................................................... 6 2.3. Some Common Command Formats .................................................................... 7 2.4. Using the Keyboard and Video Display .............................................................. 7 2.4.1. Video Display Functions ........................................................................ 8 2.4.2. Keyboard Shift and Control Functions ...................................................... 8 2.4.3. Control Key Functions ........................................................................... 8 3. The OS-9 File System .............................................................................................. 11 3.1. Introduction to the Unified Input/Output System ................................................. 11 3.2. Pathlists: How Paths Are Named ...................................................................... 11 3.3. I/O Device Names ......................................................................................... 12 3.4. Multifile Devices And Directory Files ............................................................... 12 3.5. Creating and Using Directories ........................................................................ 13 3.6. Deleting Directory Files ................................................................................. 15 3.7. Additional Information About Directories .......................................................... 15 3.8. Using and Changing Working Directories .......................................................... 16 3.8.1. Automatic Selection of Working Directories ............................................ 16 3.8.2. Changing Current Working Directories ................................................... 17 3.8.3. Anonymous Directory Names ................................................................ 17 3.9. The File Security System ................................................................................ 18 3.9.1. Examining and Changing File Attributes ................................................. 18 3.10. Reading and Writing From Files ..................................................................... 19 3.10.1. File Usage in OS-9 ............................................................................ 19 3.10.2. Text Files ........................................................................................ 20 3.10.3. Random Access Data Files .................................................................. 20 3.10.4. Executable Program Module Files ........................................................ 20 3.10.5. Directory Files .................................................................................. 21 3.10.6. Miscellaneous File Usage ................................................................... 21 3.10.7. Record Lockout (Level Two Only) ....................................................... 21 3.11. Physical File Organization ............................................................................. 21 3.12. Physical Sector I/O ...................................................................................... 22 4. Advanced Features of the Shell .................................................................................. 25 4.1. A More Detailed Description Command Line Processing ...................................... 25 4.2. Execution Modifiers ....................................................................................... 26 4.2.1. Alternate Memory Size Modifier ........................................................... 26 4.2.2. I/O Redirection Modifiers ..................................................................... 26 4.3. Command Separators ..................................................................................... 27 4.3.1. Sequential Execution ........................................................................... 27 4.3.2. Concurrent Execution .......................................................................... 27 4.3.3. Pipes and Filters ................................................................................. 28 4.4. Command Grouping ....................................................................................... 28 4.5. Built-in Shell Commands and Options ............................................................... 29 4.6. Shell Procedure Files ..................................................................................... 30 4.7. Error Reporting ............................................................................................. 30 4.8. Running Compiled Intermediate Code Programs ................................................. 31 4.9. Setting Up Timesharing System Procedure Files ................................................. 31 iii OS-9 Operating System User's Guide 5. Multiprogramming and Memory Management ............................................................... 33 5.1. Processor Time Allocation and Timeslicing ........................................................ 33 5.2. Process States ............................................................................................... 34 5.3. Creation of New Processes .............................................................................. 34 5.4. Basic Memory Management Functions .............................................................. 35 5.4.1. Loading Program Modules Into Memory ................................................. 35 5.4.2. Loading Multiple Programs .................................................................. 37 5.4.3. Memory Fragmentation ........................................................................ 37 6. Use of the System Disk ............................................................................................ 39 6.1. The OS9Boot File ......................................................................................... 39 6.2. The SYS Directory ........................................................................................ 40 6.3. The Startup File ............................................................................................ 40 6.4. The CMDS Directory ..................................................................................... 40 6.5. The DEFS Directory ...................................................................................... 40 6.6. Changing System Disks .................................................................................. 40 6.7. Making New System Disks ............................................................................. 41 7. System Command Descriptions .................................................................................. 43 7.1. Formal Syntax Notation .................................................................................. 43 7.2. Commands ................................................................................................... 43 A. OS-9 Error Codes ................................................................................................... 89 A.1. Device Driver Errors ..................................................................................... 90 B. VDG Display System Functions ................................................................................. 91 B.1. The Video Display Generator .......................................................................... 91 B.2. Alpha Mode Display ..................................................................................... 91 B.3. Graphics Mode Display ................................................................................. 92 B.4. Get Status Commands ................................................................................... 94 C. Key Definitions With Hexadecimal Values .................................................................