.\" .\" P_R_P_Q_# (C) COPYRIGHT IBM CORPORATION 1986, 1987 .\" LICENSED MATERIALS - PROPERTY OF IBM .\" REFER TO COPYRIGHT INSTRUCTIONS FORM NUMBER G120-2083 .\" .\"$Header: about,v 10.8 87/08/05 11:29:55 sullivan Exp $ .\"$Source: /ibm/acis/usr/doc/ibmdoc/frontmatter/04.about/RCS/about,v $ .\"This file uses tbl and -me macros. .nr si 3n .he '4.3 for the IBM RT PC''About This Manual' .fo ''%'July 1987' .bp .(l C .sz 14 ABOUT THIS MANUAL .sz .)l .(x ABOUT THIS MANUAL .)x .sp .sh 1 "PURPOSE AND AUDIENCE" .lp This multi-volume manual is for programmers, system managers, and users experienced with the 4.3 Berkeley Software Distribution\** .(f \**Hereinafter referred to as ``4.3BSD''. .)f version of UNIX operating systems. The manual describes Academic Information Systems 4.3,\** which is a port of the 4.3BSD operating system .(f \**Hereinafter referred to as ``4.3/RT'' or ``4.3 on the IBM RT PC''. .)f and runs on the IBM RT PC. The manual also describes differences between 4.3/RT and 4.3BSD for the VAX, and provides information to help the system manager configure and operate 4.3/RT. .sh 1 "SOFTWARE DESCRIPTION" .lp 4.3 for the IBM RT PC is a multi-user, multi-tasking operating system. Features include a comprehensive command language, device-independent input/output, extensive communications facilities, a hierarchical file system, and program development tools. It supports a wide range of environments and application areas, including timesharing, batch processing, program development, and document preparation. Two C language compilers, a FORTRAN 77 language compiler, an assembler, and system source code are shipped with the system. The C compilers allow for migration to the IBM RT PC of applications developed for other UNIX operating systems. .lp 4.3/RT includes hardware support for the desk-top IBM 6151 Models 10, 15, and 115 and the floor-standing IBM 6150 Models 20, 25, and 125 processors. For a complete list of all other hardware supported, such as displays, printers, and adapters, see the \*(lqInstalling and Operating Academic Information Systems 4.3\*(rq article in Volume II. .lp Major subsystems include: .ba +5 .ip \(bu 4.3BSD hierarchical file system .ip \(bu Extensive communications support, including: .ba +5 .ip \- an IBM Ethernet network .ip \- a Token-ring network .ip \- asynchronous communications .ip \- .i uucp .r (which copies files between systems running UNIX operating systems) .ip \- TCP/IP .ba -5 .ip \(bu Programming tools .ip \(bu Document preparation tools .ip \(bu Electronic mail .ip \(bu System resource accounting .ba -5 .lp Software support includes: .ba +5 .ip \(bu Shared read-only code .ip \(bu Demand-paged virtual memory .ip \(bu C shell and Bourne shell command languages .ip \(bu Modular utilities .ip \(bu Background and foreground processing .ip \(bu Use of the machine as a gateway .ip \(bu \fIpcc\fP, the Portable C compiler .ip \(bu \fIhc\fP, the MetaWare High C compiler .ip \(bu Source files for 4.3BSD tools and utilities .ip \(bu Binary files for supported 4.3BSD tools and utilities .ip \(bu IEEE 754 floating point arithmetic and math library .ip \(bu \fIf77\fP, a FORTRAN 77 compiler .ip \(bu .i dbx , a source level debugger .ba -5 .lp Optional features include: .ba +5 .ip \(bu \fIpp\fP, the MetaWare Professional Pascal compiler .ip \(bu Ditroff (device-independent troff) support for the IBM 3812 Pageprinter .ba -5 .sh 1 "CONTENTS OF THIS MANUAL" .lp This multi-volume manual contains: .ba +5 .lp .b Volume I. Manual Pages .r is for all readers. It contains revised manual pages for the .i "UNIX User's Reference Manual (URM)" , the .i "UNIX Programmer's Reference Manual (PRM)" , and the .i "UNIX System Manager's Manual (SMM)" as well as new pages for new commands, devices, and subroutines. .r .ba +5 .ip \(bu .b Section 1. Commands and Application Programs .r describes publicly-accessible, general-use commands. These are additions to and changes of material found in the 4.3BSD URM. .r .ip \(bu .b Section 2. System Calls .r describes system calls. These are additions to and changes of material found in the 4.3BSD PRM. .r .ip \(bu .b Section 3. Subroutines .r describes functions in various libraries. These are additions to and changes of material found in the 4.3BSD PRM. .r .ip \(bu .b Section 4. Special Files .r describes special files, related driver functions, and networking support. These are additions to and changes of material found in the 4.3BSD PRM. .r .ip \(bu .b Section 5. File Formats and Conventions .r describes file formats and conventions. These are additions to and changes of material found in the 4.3BSD PRM. .r .ip \(bu .b Section 8. Maintenance Commands and Procedures .r contains commands for system operation and maintenance. These are additions to and changes of material found in the 4.3BSD SMM. .ba -5 .lp .b .ne 2 Volume II. Supplementary Documents .r contains information about configuring and operating 4.3/RT, as well as information for the programmer. It contains new and revised material for the 4.3BSD \fIUNIX System Manager's Manual (SMM)\fP and the \fIUNIX Programmer's Supplementary Documents (PS1)\fP. The organization of source for the 4.3/RT manual is discussed in the README file in /usr/doc/ibmdoc. .ba +5 .ip \(bu .b Installing and Operating Academic Information Systems 4.3 .r describes how to install and operate the operating system. .ip \(bu .b Building 4.3/RT Systems with Config .r describes .i config , a tool used in building 4.3/RT system images, and provides information for using .i config on the IBM RT PC. .ip \(bu .b IBM RT PC New Model Series Upgrade Instructions .r describes how to install the upgrade kit used to convert an IBM RT PC Model 15 or 25 to a Model 115 or 125. .ip \(bu .b The IBM 3812 Pageprinter .r provides information for installing the IBM 3812 Pageprinter, and installing and converting fonts. .ip \(bu .b 4.3/RT Console Emulators .r explains the need for, and design of, emulators for 4.3/RT. .ip \(bu .b The Remote Virtual Disk System .r describes a network service that provides a client computer with the appearance of removable-media disk drives and an unlimited number of disk packs. .ip \(bu .b The DMA Reference Manual .r describes the utilities provided with the operating system for using the Direct Memory Access (DMA) channels. .ip \(bu .b Assembler Reference Manual for 4.3/RT .r describes the usage and input syntax of .i as , the 4.3/RT assembler for the IBM RT PC. This article replaces the \fIAssembler Reference Manual\fP found in the 4.3BSD PS1. .ip \(bu .b Floating Point Arithmetic .r summarizes floating point arithmetic in 4.3/RT. .ip \(bu .b The C Subroutine Interface for the IBM Academic Information .b Systems Experimental Display .r describes an interface with graphics routines for the IBM Academic Information Systems experimental display.\** .(f \**Hereinafter referred to as ``the experimental display.'' .)f .ip \(bu .b Programmer's Notes .r is a brief compendium of insights, suggestions, and notes gathered from the programmers who ported applications to 4.3/RT. .ip \(bu .b 4.3/RT Linkage Convention .r describes the calling sequence used in 4.3 on the IBM RT PC. .ip \(bu .b Recompiling with High C .r provides guidance to C programmers who recompile existing programs with High C. .ip \(bu .b Professional Pascal Differences .r points out the major differences between Berkeley Pascal and Professional Pascal as an aid to programmers who recompile existing programs with Professional Pascal. .ip \(bu .b Appendix A. Software Description .r contains a list of 4.3BSD and 4.3/RT functions supported in this distribution, as well as a list of unsupported functions. .ip \(bu .b Appendix B. Graphics Manual Pages .r contains manual pages for the graphics routines provided with the C Subroutine Interface for the experimental display. .ip \(bu .b Appendix C. High C Programmer's Guide .r contains a guide to programming with High C on the IBM RT PC. .ba .bp .sh 1 "HOW TO USE THIS MANUAL" .lp Use the following table to locate information appropriate to your use of 4.3 on the IBM RT PC. .sp 2 .TS center, tab (+), box; c|c|c l|c|l. User Type+Volume+Section or Article = System Manager+I+Sections 1 and 8 \^+_+_ \^+II+Installing and Operating Academic Information Systems 4.3 \^+\^+Building 4.3/RT Systems with Config \^+\^+IBM RT PC New Model Series Upgrade Instructions \^+\^+The IBM 3812 Pageprinter \^+\^+4.3/RT Console Emulators \^+\^+The Remote Virtual Disk System \^+\^+The DMA Reference Manual \^+\^+Programmer's Notes \^+\^+Appendix A: Software Description _ Programmer+I+All sections \^+_+_ \^+II+Assembler Reference Manual for 4.3/RT \^+\^+Floating Point Arithmetic \^+\^+The C Subroutine Interface for the IBM Academic \^+\^+ Information Systems Experimental Display \^+\^+Programmer's Notes \^+\^+4.3/RT Linkage Convention \^+\^+Recompiling with High C \^+\^+Professional Pascal Differences \^+\^+The Remote Virtual Disk System \^+\^+The DMA Reference Manual \^+\^+Appendix B: Graphics Manual Pages \^+\^+Appendix C: High C Programmer's Guide _ User+I+Section 1 .TE .sh 1 "RELATED PUBLICATIONS" .lp To use 4.3 on the IBM RT PC, you should have access to the following publications: .ba +5 .ip \(bu The 4.3BSD library: .ba +5 .ip \- .i UNIX User's Reference Manual (URM) .ip \- .i UNIX Programmer's Reference Manual (PRM) .ip \- .i UNIX User's Supplementary Documents (USD) .ip \- .i UNIX Programmer's Supplementary Documents, Volume 1 (PS1) .ip \- .i UNIX Programmer's Supplementary Documents, Volume 2 (PS2) .ip \- .i UNIX System Manager's Manual (SMM) .ip \- .i User Contributed Software (UCS) .r .ba -5 .ip \(bu \fIIBM RT PC Site Preparation Guide\fP, GA23-1058 .ip \(bu \fIIBM RT PC User Setup Guide\fP, SV21-8020 .ip \(bu \fIIBM RT PC Guide to Operations\fP, SV21-8021 .ip \(bu \fIIBM RT PC Problem Determination Guide\fP, SV21-8022 .ip \(bu \fIIBM RT PC Hardware Technical Reference\fP, SV21-8024 .ip \(bu \fIIBM RT PC 6150 System Unit Hardware Maintenance and Service\fP, SV21-8025 .ip \(bu \fIIBM RT PC 6151 System Unit Hardware Maintenance and Service\fP, SV21-8026 .ip \(bu \fIHigh C Language Reference Manual\fP, from MetaWare Incorporated, Santa Cruz, CA, 1986 .ip \(bu \fIHigh C Language Extensions Manual with Rationale & Tutorials\fP, \fIibid\fR, 1986 .ip \(bu \fIProfessional Pascal Documentation Set\fP, \fIibid\fR, 1986 .ba .if t .if o \{\ .bp .rs .sp 25 .ce This page intentionally left blank. .\}