Sync usage with man page.
[netbsd-mini2440.git] / share / doc / iso / ucb / intro.nr
blob2e380e69edf4a50f387b3fdc4b275a385236da2b
1 .\"     $NetBSD$
2 .\"
3 .NC "Introduction"
4 .sh 1 "Introduction"
5 .pp
6 This document describes the usage of the ISO
7 transport and network layers written for the ACIS Operating System,
8 the IBM ACIS port of Berkeley 4.3 Unix\**
9 .(f
10 \** Unix is a registered trademark of AT&T.
11 .)f
12 for the IBM RT PC,
13 hereafter called AOS, as modified by UC Berkeley.
14 This document describes work in progress and is an extremely
15 hasty job of editing an earlier document written by colleagues
16 at the university of Wisconsin.
17 It is to be regarded as an emergency manual prepared for testers
18 at NIST and should not be redistributed further.
19 As such, there are philosophical
20 statements that Berkeley fundamentally disagrees with, which
21 we do not presently have the time to rip out.
22 Collectively, this work is called the Wisconsin ARGO kernel. 
23 The ARGO kernel supports the 
24 the connection-oriented ISO transport service (COTS), the
25 ISO connectionless network service (CLNS)
26 and a
27 connection-oriented network service (CONS).
28 The COTS is provided by the ISO transport protocol TP,
29 ISO 8073 Revised.
30 The CLNS is provided by the connectionless network protocol,
31 ISO 8473.
32 The CONS is provided by the X.25 protocols.
33 The ARGO implementation of the CONS is not a complete
34 ISO CONS, but contains enough of the CONS to support
35 the COTS and the CLNS (in the latter case, the CONS can be
36 viewed as a subnetwork service).
37 .pp
38 The purposes of this document are
39 .ip "1) "
40 to describe the transport service and the software interface
41 between the user and provider of this service,
42 .ip "2) "
43 to describe the network service and the software interface it
44 provides.
45 .pp
46 It is assumed that the reader is familiar with the \fBC\fR
47 programming language,
48 with Unix conventions, and with the ISO specifications listed in Appendix A.
49 .sh 1 "Organization"
50 .pp
51 This document is composed of several chapters.
52 Chapter One contains this introduction. Chapter Two presents a
53 definition of terms and phrases used throughout the document.
54 Chapter Three describes the transport service interface, which is
55 the interface between the transport protocol implementation software and the transport user software.
56 Chapter Four describes the network service interface, and the interface
57 above and below the network layer.
58 Chapter Five explains the format of an OSI address.
59 Chapter Six describes the
60 the architecture of the interprocess communication support in the 
61 kernel, which to a large degree mandates
62 the design of a protocol implementation for a 4.3 Unix kernel.
63 .\" Appendix A is a list of the applicable ISO standards.
64 .\" The manual pages relevant to the transport and network layers
65 .\" are included as Appendix B.
66 .pp
67 Several conventions are followed in this document.
68 All procedure names and system call names are followed
69 by a pair of parentheses, for example,
70 .i read ().
71 References to manual pages consist of the name of the
72 manual page, followed by the section in which
73 the man page is found:
74 .i read (2).