BSD 4_4 release

[unix-history] / usr / src / share / doc / psd / 05.sysman / 0.t

diff --git a/usr/src/share/doc/psd/05.sysman/0.t b/usr/src/share/doc/psd/05.sysman/0.t
index d018b49..865e8ff 100644 (file)
--- a/usr/src/share/doc/psd/05.sysman/0.t
+++ b/usr/src/share/doc/psd/05.sysman/0.t
@@ -1,33 +1,61 @@
-.\" Copyright (c) 1983 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1983, 1993
+.\"    The Regents of the University of California.  All rights reserved.

 .\"
 .\"

-.\"    @(#)0.t 5.1 (Berkeley) %G%
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"    This product includes software developed by the University of
+.\"    California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\"    @(#)0.t 8.1 (Berkeley) 6/8/93

 .\"
 .\"

-.\" 0.t 5.1 86/05/08

 .if n .ND
 .TL
 .if n .ND
 .TL

-4.2BSD System Manual
-.sp
-Revised July, 1983
-.AU
-William Joy, Eric Cooper, Robert Fabry,
+Berkeley Software Architecture Manual

 .br
 .br

-Samuel Leffler, Kirk McKusick and David Mosher
+4.4BSD Edition
+.AU
+William Joy, Robert Fabry,
+.AU
+Samuel Leffler, M. Kirk McKusick,
+.AU
+Michael Karels

 .AI
 Computer Systems Research Group
 Computer Science Division
 Department of Electrical Engineering and Computer Science
 University of California, Berkeley
 Berkeley, CA  94720
 .AI
 Computer Systems Research Group
 Computer Science Division
 Department of Electrical Engineering and Computer Science
 University of California, Berkeley
 Berkeley, CA  94720

-
-(415) 642-7780
+.EH 'PSD:5-%''4.4BSD Architecture Manual'
+.OH '4.4BSD Architecture Manual''PSD:5-%'

 .AB
 .FS
 * UNIX is a trademark of Bell Laboratories.
 .FE
 This document summarizes the facilities
 .AB
 .FS
 * UNIX is a trademark of Bell Laboratories.
 .FE
 This document summarizes the facilities

-provided by the 4.2BSD version of the UNIX operating system.
+provided by the 4.4BSD version of the UNIX\|* operating system.

 It does not attempt to act as a tutorial for use of the system
 nor does it attempt to explain or justify the design of the
 system facilities.
 It does not attempt to act as a tutorial for use of the system
 nor does it attempt to explain or justify the design of the
 system facilities.


@@ -53,20 +81,7 @@ These facilities are implemented by the operating system or by
 network server processes.
 .AE
 .LP
 network server processes.
 .AE
 .LP

-.de PT
-.lt \\n(LLu
-.pc %
-.nr PN \\n%
-.tl '\\*(LH'\\*(CH'\\*(RH'
-.lt \\n(.lu
-..
-.af PN i
-.ds LH 4.2BSD System Manual
-.ds RH Contents
-.bp 1
-.if t .ds CF -- September 1, 1982 --
-.if t .ds LF CSRG TR/5
-.if t .ds RF "Joy, et. al.
+.bp

 .ft B
 .br
 .sv 2
 .ft B
 .br
 .sv 2


@@ -90,56 +105,57 @@ TABLE OF CONTENTS
 .nf
 .nf
 \fB1.1.  Processes and protection\fP
 .nf
 .nf
 \fB1.1.  Processes and protection\fP

-\0\0\0.1.  Host and process identifiers
-\0\0\0.2.  Process creation and termination
-\0\0\0.3.  User and group ids
-\0\0\0.4.  Process groups
+1.1.1.  Host and process identifiers
+1.1.2.  Process creation and termination
+1.1.3.  User and group ids
+1.1.4.  Process groups

 .LP
 .nf
 \fB1.2.  Memory management\fP
 .LP
 .nf
 \fB1.2.  Memory management\fP

-\0\0\0.1.  Text, data and stack
-\0\0\0.2.  Mapping pages
-\0\0\0.3.  Page protection control
-\0\0\0.4.  Giving and getting advice
+1.2.1.  Text, data and stack
+1.2.2.  Mapping pages
+1.2.3.  Page protection control
+1.2.4.  Giving and getting advice
+1.2.5.  Protection primitives

 .LP
 .if t .sp .5v
 .nf
 \fB1.3.  Signals\fP
 .LP
 .if t .sp .5v
 .nf
 \fB1.3.  Signals\fP

-\0\0\0.1.  Overview
-\0\0\0.2.  Signal types
-\0\0\0.3.  Signal handlers
-\0\0\0.4.  Sending signals
-\0\0\0.5.  Protecting critical sections
-\0\0\0.6.  Signal stacks
+1.3.1.  Overview
+1.3.2.  Signal types
+1.3.3.  Signal handlers
+1.3.4.  Sending signals
+1.3.5.  Protecting critical sections
+1.3.6.  Signal stacks

 .LP
 .if t .sp .5v
 .nf
 \fB1.4.  Timing and statistics\fP
 .LP
 .if t .sp .5v
 .nf
 \fB1.4.  Timing and statistics\fP

-\0\0\0.1.  Real time
-\0\0\0.2.  Interval time
+1.4.1.  Real time
+1.4.2.  Interval time

 .LP
 .if t .sp .5v
 .nf
 \fB1.5.  Descriptors\fP
 .LP
 .if t .sp .5v
 .nf
 \fB1.5.  Descriptors\fP

-\0\0\0.1.  The reference table
-\0\0\0.2.  Descriptor properties
-\0\0\0.3.  Managing descriptor references
-\0\0\0.4.  Multiplexing requests
-\0\0\0.5.  Descriptor wrapping
+1.5.1.  The reference table
+1.5.2.  Descriptor properties
+1.5.3.  Managing descriptor references
+1.5.4.  Multiplexing requests
+1.5.5.  Descriptor wrapping

 .LP
 .if t .sp .5v
 .nf
 \fB1.6.  Resource controls\fP
 .LP
 .if t .sp .5v
 .nf
 \fB1.6.  Resource controls\fP

-\0\0\0.1.  Process priorities
-\0\0\0.2.  Resource utilization
-\0\0\0.3.  Resource limits
+1.6.1.  Process priorities
+1.6.2.  Resource utilization
+1.6.3.  Resource limits

 .LP
 .if t .sp .5v
 .nf
 \fB1.7.  System operation support\fP
 .LP
 .if t .sp .5v
 .nf
 \fB1.7.  System operation support\fP

-\0\0\0.1.   Bootstrap operations
-\0\0\0.2.   Shutdown operations
-\0\0\0.3.   Accounting
+1.7.1.   Bootstrap operations
+1.7.2.   Shutdown operations
+1.7.3.   Accounting

 .bp
 .LP
 .if t .sp .5v
 .bp
 .LP
 .if t .sp .5v


@@ -150,65 +166,65 @@ TABLE OF CONTENTS
 .if t .sp .5v
 .nf
 \fB2.1.   Generic operations\fP
 .if t .sp .5v
 .nf
 \fB2.1.   Generic operations\fP

-\0\0\0.1.   Read and write
-\0\0\0.2.   Input/output control
-\0\0\0.3.   Non-blocking and asynchronous operations
+2.1.1.   Read and write
+2.1.2.   Input/output control
+2.1.3.   Non-blocking and asynchronous operations

 .LP
 .if t .sp .5v
 .nf
 \fB2.2.  File system\fP
 .LP
 .if t .sp .5v
 .nf
 \fB2.2.  File system\fP

-\0\0\0.1   Overview
-\0\0\0.2.  Naming
-\0\0\0.3.  Creation and removal
-\0\0\0.3.1.  Directory creation and removal
-\0\0\0.3.2.  File creation
-\0\0\0.3.3.  Creating references to devices
-\0\0\0.3.4.  Portal creation
-\0\0\0.3.6.  File, device, and portal removal
-\0\0\0.4.  Reading and modifying file attributes
-\0\0\0.5.  Links and renaming
-\0\0\0.6.  Extension and truncation
-\0\0\0.7.  Checking accessibility
-\0\0\0.8.  Locking
-\0\0\0.9.  Disc quotas
+2.2.1   Overview
+2.2.2.  Naming
+2.2.3.  Creation and removal
+2.2.3.1.  Directory creation and removal
+2.2.3.2.  File creation
+2.2.3.3.  Creating references to devices
+2.2.3.4.  Portal creation
+2.2.3.6.  File, device, and portal removal
+2.2.4.  Reading and modifying file attributes
+2.2.5.  Links and renaming
+2.2.6.  Extension and truncation
+2.2.7.  Checking accessibility
+2.2.8.  Locking
+2.2.9.  Disc quotas

 .LP
 .if t .sp .5v
 .nf
 .LP
 .if t .sp .5v
 .nf

-\fB2.3.  Inteprocess communication\fP
-\0\0\0.1.   Interprocess communication primitives
-\0\0\0.1.1.\0   Communication domains
-\0\0\0.1.2.\0   Socket types and protocols
-\0\0\0.1.3.\0   Socket creation, naming and service establishment
-\0\0\0.1.4.\0   Accepting connections
-\0\0\0.1.5.\0   Making connections
-\0\0\0.1.6.\0   Sending and receiving data
-\0\0\0.1.7.\0   Scatter/gather and exchanging access rights
-\0\0\0.1.8.\0   Using read and write with sockets
-\0\0\0.1.9.\0   Shutting down halves of full-duplex connections
-\0\0\0.1.10.\0  Socket and protocol options
-\0\0\0.2.   UNIX domain
-\0\0\0.2.1.    Types of sockets
-\0\0\0.2.2.    Naming
-\0\0\0.2.3.    Access rights transmission
-\0\0\0.3.   INTERNET domain
-\0\0\0.3.1.    Socket types and protocols
-\0\0\0.3.2.    Socket naming
-\0\0\0.3.3.    Access rights transmission
-\0\0\0.3.4.    Raw access
+\fB2.3.  Interprocess communication\fP
+2.3.1.   Interprocess communication primitives
+2.3.1.1.\0   Communication domains
+2.3.1.2.\0   Socket types and protocols
+2.3.1.3.\0   Socket creation, naming and service establishment
+2.3.1.4.\0   Accepting connections
+2.3.1.5.\0   Making connections
+2.3.1.6.\0   Sending and receiving data
+2.3.1.7.\0   Scatter/gather and exchanging access rights
+2.3.1.8.\0   Using read and write with sockets
+2.3.1.9.\0   Shutting down halves of full-duplex connections
+2.3.1.10.\0  Socket and protocol options
+2.3.2.   UNIX domain
+2.3.2.1.    Types of sockets
+2.3.2.2.    Naming
+2.3.2.3.    Access rights transmission
+2.3.3.   INTERNET domain
+2.3.3.1.    Socket types and protocols
+2.3.3.2.    Socket naming
+2.3.3.3.    Access rights transmission
+2.3.3.4.    Raw access

 .LP
 .if t .sp .5v
 .nf
 \fB2.4.  Terminals and devices\fP
 .LP
 .if t .sp .5v
 .nf
 \fB2.4.  Terminals and devices\fP

-\0\0\0.1.   Terminals
-\0\0\0.1.1.    Terminal input
-\0\0\0.1.1.1     Input modes
-\0\0\0.1.1.2     Interrupt characters
-\0\0\0.1.1.3     Line editing
-\0\0\0.1.2.    Terminal output
-\0\0\0.1.3.    Terminal control operations
-\0\0\0.1.4.    Terminal hardware support
-\0\0\0.2.   Structured devices
-\0\0\0.3.   Unstructured devices
+2.4.1.   Terminals
+2.4.1.1.    Terminal input
+2.4.1.1.1     Input modes
+2.4.1.1.2     Interrupt characters
+2.4.1.1.3     Line editing
+2.4.1.2.    Terminal output
+2.4.1.3.    Terminal control operations
+2.4.1.4.    Terminal hardware support
+2.4.2.   Structured devices
+2.4.3.   Unstructured devices

 .LP
 .if t .sp .5v
 .nf
 .LP
 .if t .sp .5v
 .nf


@@ -218,7 +234,6 @@ TABLE OF CONTENTS
 .nf
 \fBI.  Summary of facilities\fP
 .LP
 .nf
 \fBI.  Summary of facilities\fP
 .LP

-.af PN 1

 .de sh
 .ds RH \\$1
 .bp
 .de sh
 .ds RH \\$1
 .bp


@@ -227,8 +242,8 @@ TABLE OF CONTENTS
 .PP
 .PP
 ..
 .PP
 .PP
 ..

-.bp 1
-.nr ss 1
+.bp
+.ds ss 1

 .de _d
 .if t .ta .6i 2.1i 2.6i
 .\" 2.94 went to 2.6, 3.64 to 3.30
 .de _d
 .if t .ta .6i 2.1i 2.6i
 .\" 2.94 went to 2.6, 3.64 to 3.30


@@ -266,7 +281,8 @@ when an error occurs, returning the error code in the global variable
 \fIerrno\fP.
 Other languages may present errors in different ways.
 .PP
 \fIerrno\fP.
 Other languages may present errors in different ways.
 .PP

-A number of system standard types are defined in the include file <sys/types.h>
+A number of system standard types are defined in the include file
+.I <sys/types.h>

 and used in the specifications here and in many C programs.
 These include \fBcaddr_t\fP giving a memory address (typically as
 a character pointer), 
 and used in the specifications here and in many C programs.
 These include \fBcaddr_t\fP giving a memory address (typically as
 a character pointer),