Sync usage with man page.
[netbsd-mini2440.git] / share / doc / iso / wisc / intro.nr
blob7102d13e2f227b8ebcf1f26ef1a54da4d8b7724d
1 .\"     $NetBSD$
2 .\"
3 .NC "Introduction"
4 .sh 1 "Introduction"
5 .pp
6 This document describes the design and implementation 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.
14 Collectively, this work is called the Wisconsin ARGO kernel. 
15 The ARGO kernel supports the 
16 the connection-oriented ISO transport service (COTS), the
17 ISO connectionless network service (CLNS)
18 and a
19 connection-oriented network service (CONS).
20 The COTS is provided by the ISO transport protocol TP,
21 ISO 8073 Revised.
22 The CLNS is provided by the connectionless network protocol,
23 ISO 8473.
24 The CONS is provided by the X.25 protocols.
25 The ARGO implementation of the CONS is not a complete
26 ISO CONS, but contains enough of the CONS to support
27 the COTS and the CLNS (in the latter case, the CONS can be
28 viewed as a subnetwork service).
29 .pp
30 The purposes of this document are
31 .ip "1) "
32 to describe the transport service and the software interface
33 between the user and provider of this service,
34 .ip "2) "
35 to describe the network service and the software interface it
36 provides,
37 .ip "3) "
38 to describe the design of the software which provides
39 these services, and
40 .ip "4) "
41 to provide a guide for readers who are perusing or maintaining
42 the ARGO kernel source code.
43 .pp
44 It is assumed that the reader is familiar with the \fBC\fR
45 programming language,
46 with Unix conventions, and with the ISO specifications listed in Appendix A.
47 .sh 1 "Organization"
48 .pp
49 This document is composed of several chapters.
50 Chapter One contains this introduction. Chapter Two presents a
51 definition of terms and phrases used throughout the document.
52 Chapter Three describes the transport service interface, which is
53 the interface between the transport protocol implementation software and the transport user software.
54 Chapter Four describes the network service interface, and the interface
55 above and below the network layer.
56 Chapter Five explains the format of an OSI address.
57 Chapter Six describes the
58 the architecture of the interprocess communication support in the 
59 kernel, which to a large degree mandates
60 the design of a protocol implementation for a 4.3 Unix kernel.
61 Chapter Seven describes the design of this transport
62 protocol implementation,
63 including descriptions of implementation options.
64 Chapter Eight describes the design of the network layer implementation.
65 Chapter Nine describes the way errors are handled in the system.
66 Chapter Ten summarizes the methods used for
67 testing and debugging the ARGO kernel.
68 Appendix A is a list of the applicable ISO standards.
69 .\" The manual pages relevant to the transport and network layers
70 .\" are included as Appendix B.
71 .pp
72 Several conventions are followed in this document.
73 All procedure names and system call names are followed
74 by a pair of parentheses, for example,
75 \fIread()\fR.
76 References to manual pages consist of the name of the
77 manual page, followed by the section in which
78 the man page is found: \fIread(2)\fR.