Guts

This document serves as a comprehensive user and system reference manual for GUTS (Groningen University Terminal System), a single-user, multi-tasking operating system adapted from DEIMOS for the PDP11.

The user manual section details how to log in, interact with the system via the command language interpreter (CLI), and use standard programs (e.g., rd, st, dump, delete, rename, logout). It explains file naming conventions, stream definitions for I/O, and lists available system routines for IMP programs. It also covers using the Edinburgh Compatible Context Editor, running the IMP compiler (a three-pass process followed by linking and object file generation), and manipulating libraries with programs like newlib, crlibs, insert, and index.

The system reference manual section describes supervisor calls, categorized by user or supervisor access. It outlines the parameters for these calls and their corresponding replies, covering a wide range of services including file management (connect, create, delete, rename, permission setting, etc.), console (user terminal) I/O, recovery services, clock services (get/set time), disk operations (read/write blocks), core memory management, and login procedures. It also details the format of messages sent to the scheduler by various supervisor processes.

Finally, the document provides instructions for system generation and maintenance, including how to load and start GUTS on an RT11 compatible disk, introduce new users, and generate a new system. Generating a new system involves modifying and assembling source files (kernel, heap, and IMP programs like clock handler, disk driver, file system, scheduler) and linking them using RT11 tools. Appendices offer crucial reference information, such as RADIX 50 conversion tables, example macro files for system components, lists of system source files with stack details, and octal process/service numbers.