Merge from vendor branch CVS:
[dragonfly.git] / share / examples / atm / README
1
2                 ===================================
3                 HARP  |  Host ATM Research Platform
4                 ===================================
5
6                               HARP 3
7
8
9 What is this stuff?
10 -------------------
11 The Advanced Networking Group (ANG) at the Minnesota Supercomputer Center,
12 Inc. (MSCI), as part of its work on the MAGIC Gigabit Testbed, developed
13 the Host ATM Research Platform (HARP) software, which allows IP hosts to
14 communicate over ATM networks using standard protocols.  It is intended to
15 be a high-quality platform for IP/ATM research.
16
17 HARP provides a way for IP hosts to connect to ATM networks.  It supports 
18 standard methods of communication using IP over ATM.  A host's standard IP 
19 software sends and receives datagrams via a HARP ATM interface.  HARP provides 
20 functionality similar to (and typically replaces) vendor-provided ATM device 
21 driver software.
22
23 HARP includes full source code, making it possible for researchers to
24 experiment with different approaches to running IP over ATM.  HARP is 
25 self-contained; it requires no other licenses or commercial software packages.
26
27 HARP implements support for the IETF Classical IP model for using IP over ATM 
28 networks, including:
29
30    o IETF ATMARP address resolution client
31    o IETF ATMARP address resolution server
32    o IETF SCSP/ATMARP server
33    o UNI 3.1 and 3.0 signalling protocols
34    o Fore Systems's SPANS signalling protocol
35
36
37
38 What's supported
39 ----------------
40 The following are supported by HARP 3:
41
42    o ATM Host Interfaces
43         - FORE Systems, Inc. SBA-200 and SBA-200E ATM SBus Adapters
44         - FORE Systems, Inc. PCA-200E ATM PCI Adapters
45         - Efficient Networks, Inc. ENI-155p ATM PCI Adapters
46
47    o ATM Signalling Protocols
48         - The ATM Forum UNI 3.1 signalling protocol
49         - The ATM Forum UNI 3.0 signalling protocol
50         - The ATM Forum ILMI address registration
51         - FORE Systems's proprietary SPANS signalling protocol
52         - Permanent Virtual Channels (PVCs)
53
54    o IETF "Classical IP and ARP over ATM" model
55         - RFC 1483, "Multiprotocol Encapsulation over ATM Adaptation Layer 5"
56         - RFC 1577, "Classical IP and ARP over ATM"
57         - RFC 1626, "Default IP MTU for use over ATM AAL5"
58         - RFC 1755, "ATM Signaling Support for IP over ATM"
59         - RFC 2225, "Classical IP and ARP over ATM"
60         - RFC 2334, "Server Cache Synchronization Protocol (SCSP)"
61         - Internet Draft draft-ietf-ion-scsp-atmarp-00.txt,
62                 "A Distributed ATMARP Service Using SCSP"
63
64    o ATM Sockets interface
65         - The file atm-sockets.txt contains further information
66
67
68 What's not supported
69 --------------------
70 The following major features of the above list are not currently supported:
71
72         o UNI point-to-multipoint support
73         o Driver support for Traffic Control/Quality of Service
74         o SPANS multicast and MPP support
75         o SPANS signalling using Efficient adapters
76
77
78 For further information
79 -----------------------
80 For additional information about HARP, please see:
81
82         http://www.msci.magic.net
83
84
85 Suggestions and Problem Reports
86 -------------------------------
87 While HARP is made available "as is" and is not supported, ANG is continuing
88 development of HARP.  We welcome suggestions for new or enhanced features, 
89 summaries of your experience with HARP, as well as reports of problems which
90 you may experience.  Feel free to contact us at harp-bugs@magic.net.
91
92 ANG is maintaining a mail list of those who wish to share their experiences
93 with HARP, learn of others' experiences, or receive information about future 
94 releases of HARP.  The HARP mailing list is at harp@magic.net.  To be added
95 to the list, send email to harp-request@magic.net.
96
97
98 Acknowledgments
99 ---------------
100 This software was developed under the sponsorship of the Defense Advanced 
101 Research Projects Agency (DARPA).
102
103
104 Citing HARP
105 -----------
106 When citing HARP in published works, please use the following citation:
107
108 Host ATM Research Platform (HARP), Network Computing Services, Inc.
109 This software was developed with the support of the Defense Advanced
110 Research Projects Agency (DARPA).
111
112
113 Copyright and Permitted Use
114 ---------------------------
115 The Host ATM Research Platform ("HARP") software (the "Software") is
116 made available by Network Computing Services, Inc. ("NetworkCS")
117 "AS IS".  NetworkCS does not provide maintenance, improvements or
118 support of any kind.
119
120 NETWORKCS MAKES NO WARRANTIES OR REPRESENTATIONS, EXPRESS OR IMPLIED,
121 INCLUDING, BUT NOT LIMITED TO, IMPLIED WARRANTIES OF MERCHANTABILITY
122 AND FITNESS FOR A PARTICULAR PURPOSE, AS TO ANY ELEMENT OF THE
123 SOFTWARE OR ANY SUPPORT PROVIDED IN CONNECTION WITH THIS SOFTWARE.
124 In no event shall NetworkCS be responsible for any damages, including
125 but not limited to consequential damages, arising from or relating to
126 any use of the Software or related support.
127
128 Copyright 1994-1998 Network Computing Services, Inc.
129
130 Copies of this Software may be made, however, the above copyright
131 notice must be reproduced on all copies.
132
133 Portions of this Software include materials copyrighted by the Regents of
134 the University of California and by Sun Microsystems, Inc.  The applicable
135 copyright notices are reproduced in the files where the material appears.
136
137 --------------------------------------------------------------------------------
138
139         @(#) $FreeBSD: src/share/examples/atm/README,v 1.2 1999/08/28 00:19:06 peter Exp $
140         @(#) $DragonFly: src/share/examples/atm/README,v 1.2 2003/06/17 04:36:57 dillon Exp $
141