![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to preface.tex CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDReno / contrib / isode-beta / doc / manual|
Return to preface.tex CVS log | Up to [CSRG BSD Unix] / 43BSDReno / contrib / isode-beta / doc / manual |
1.1 root 1: % run this through LaTeX with the appropriate wrapper
2:
3: \preface
4: The software described herein has been developed as a research tool and
5: represents an effort to promote the use of the International Organization
6: for Standardization (ISO) interpretation of Open Systems Interconnection (OSI),
7: particularly in the Internet and RARE research communities.
8:
9: \newpage\section* {Notice, Disclaimer, and Conditions of Use}\label{license}
10: The ISODE is openly available but is {\bf NOT\/} in the public domain.
11: You are allowed and encouraged to take this software and build commercial
12: products.
13: However, as a condition of use, you are required to ``hold harmless'' all
14: contributors.
15:
16: \noindent
17: Permission to use, copy, modify, and distribute this software and its
18: documentation for any purpose and without fee is hereby granted, provided
19: that this notice and the reference to this notice
20: appearing in each software module be retained unaltered,
21: and that the name of any contributors shall not be used in advertising
22: or publicity pertaining to distribution of the software without specific
23: written prior permission.
24: No contributor makes any
25: representations about the suitability of this software for any purpose.
26: It is provided ``as is'' without express or implied warranty.
27:
28: \vskip 0.15in
29: \noindent
30: \begin{small}
31: ALL CONTRIBUTORS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
32: INCLUDING ALL IMPLIED WARRANTIES OF MER\-CHAN\-TI\-BIL\-ITY AND FITNESS.
33: IN NO EVENT SHALL ANY CONTRIBUTOR BE LIABLE FOR ANY SPECIAL,
34: INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOSEVER RESULTING FROM
35: LOSS OF USE,
36: DATA OR PROFITS,
37: WHETHER IN ACTION OF CONTRACT,
38: NEG\-LI\-GENCE OR OTHER TORTIOUS ACTION,
39: ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
40: \end{small}
41:
42: \vskip 0.15in
43: \noindent
44: As used above,
45: ``contributor'' includes, but is not limited to:
46: \begin{quote}
47: \begin{tabular}{l}
48: The MITRE Corporation\\
49: The Northrop Corporation\\
50: NYSERNet, Inc.\\
51: Performance Systems International, Inc.\\
52: University College London\\
53: The University of Nottingham\\
54: The Wollongong Group, Inc.\\
55: Marshall T. Rose
56: \end{tabular}
57: \end{quote}
58: In particular,
59: the Northrop Corporation provided the initial sponsorship for the ISODE
60: and the Wollongong Group, Inc., also supported this effort.
61: The ISODE receives partial support from the U.S.~Defense Advanced Research
62: Projects Agency and the Rome Air Development Center of the U.S.~Air Force
63: Systems Command under contract number F30602--88--C--0016 to NYSERNet Inc.
64:
65: \newpage\section* {Revision Information}
66: This document (version \versiontag/) and its companion volumes are believed
67: to accurately reflect release v~\isodevrsn/ of \today{}.
68: This release contains the following com\-po\-nent/re\-vis\-ion relationships:
69: \vspace{0.1in}
70: \[\begin{tabular}{|l|l|}
71: \hline
72: \multicolumn{1}{|c|}{\bf Component}&
73: \multicolumn{1}{c|}{\bf Revision}\\
74: \hline
75: Compatibility Services& \tt compat~\compatvrsn/\\
76: Transport Services& \tt tsap~\tsapvrsn/\\
77: Session Services& \tt ssap~\ssapvrsn/\\
78: Presentation Services& \tt psap2~\psapXvrsn/\\
79: Encoding of Data-Structures& \tt psap~\psapvrsn/\\
80: ASN.1 compiler& \tt pepy~\pepyvrsn/\\
81: Association Control Services& \tt acsap~\acsapvrsn/\\
82: Reliable Transfer Services& \tt rtsap~\rtsapvrsn/\\
83: Remote Operation Services& \tt rosap~\rosapvrsn/\\
84: Remote Operations Stub-generator&
85: \tt rosy~\rosyvrsn/\\
86: \ \ and Run-Time Environment& \\
87: Structure-generator& \tt posy~\posyvrsn/\\
88: \hline
89: \end{tabular}\]
90:
91: \newpage\section* {Comments}\label{comments}
92: Comments concerning this release should be addressed to:
93: \[\begin{tabular}{ll}
94: Postal address:& PSI, Inc.\\
95: & PSI California Office\\
96: & Attn: Marshall T. Rose\\
97: & POB 391776\\
98: & Mountain View, CA 94039\\
99: & US\\[0.1in]
100: Telephone:& +1 415--961--3380\\[0.1in]
101: Internet Mailbox:& \tt [email protected]
102: \end{tabular}\]
103:
104: If you'd like a copy of the release described in this document,
105: there are several avenues available:
106: \begin{itemize}
107: \item NORTH AMERICA\\
108: For mailings in NORTH AMERICA,
109: send a check for 375 US Dollars to:
110: \[\begin{tabular}{ll}
111: Postal address:&University of Pennsylvania\\
112: & \small Department of Computer and Information Science\\
113: & Moore School\\
114: & Attn: David J. Farber (ISODE Distribution)\\
115: & 200 South 33rd Street\\
116: & Philadelphia, PA 19104-6314\\
117: & US\\[0.1in]
118: Telephone:& +1 215--898--8560
119: \end{tabular}\]
120: Specify one of:
121: \begin{enumerate}
122: \item 1600bpi 1/2--inch tape, or
123:
124: \item Sun 1/4--inch cartridge tape.
125: \end{enumerate}
126: The tape will be written in \pgm{tar} format and returned with
127: a documentation set.
128: Do not send tapes or envelopes.
129: Documentation only is the same price.
130:
131: \item EUROPE\\
132: For mailings in EUROPE, send a cheque or bankers draft and a purchase order
133: for 200 Pounds Sterling to:
134: \[\begin{tabular}{ll}
135: Postal address:& Department of Computer Science\\
136: & Attn: Natalie May/Dawn Bailey\\
137: & University College London\\
138: & Gower Street\\
139: & London, WC1E 6BT\\
140: & UK
141: \end{tabular}\]
142: For information only:
143: \[\begin{tabular}{ll}
144: \ Telephone:& +44 1--380--7214\\
145: \ Fax:& +44 1--387--1397\\
146: \ Telex:& 28722\\
147: \ Internet:& \verb"[email protected]"\\
148: & \verb"[email protected]"
149: \end{tabular}\]
150: Specify one of:
151: \begin{enumerate}
152: \item 1600bpi 1/2--inch tape, or
153:
154: \item Sun 1/4--inch cartridge tape.
155: \end{enumerate}
156: The tape will be written in \pgm{tar} format and returned with
157: a documentation set.
158: Do not send tapes or envelopes.
159: Documentation only is the same price.
160:
161: \item EUROPE (tape only)\\
162: Tapes without hardcopy documentation can be obtained via the European \unix/
163: User Group (EUUG).
164: The ISODE~\isodevrsn/ distribution is called EUUGD14.
165: \[\begin{tabular}{ll}
166: Postal address:& EUUG Distributions\\
167: & c/o Frank Kuiper\\
168: & Centrum voor Wiskunde en Informatica\\
169: & Kruislann 413\\
170: & 1098 SJ Amsterdam\\
171: & The Netherlands\\[0.1in]
172: For information only:&\\
173: \ Telephone:& +31 20--5924056\\
174: & (or +31 20--5929333)\\
175: \ Telex:& 12571 mactr nl\\
176: \ Telefax:& +31--20--5924199\\
177: \ Internet:& \verb"[email protected]"
178: \end{tabular}\]
179: Specify one of:
180: \begin{enumerate}
181: \item 1600bpi 1/2--inch tape: 130 Dutch Guilders
182:
183: \item 800bpi 1/2--inch tape: 130 Dutch Guilders
184:
185: \item Sun 1/4--inch cartridge tape (QIC-24 format): 190 Dutch Guilders
186:
187: \item 1600 1/2--inch tape (QIC-11 format): 190 Dutch Guilders
188: \end{enumerate}
189: If you require DHL this is possible and will be billed through.
190: Note that if you are not a member of EUUG,
191: then there is an additional handling fee of 300 Dutch Guilders
192: (please encloses a copy of your membership or contribution payment form when
193: ordering).
194: Do not send money, cheques, tapes or envelopes,
195: you will be invoiced.
196:
197: \item AUSTRALIA and NEW ZEALAND\\
198: For mailings in AUSTRALIA and NEW ZEALAND,
199: send a cheque for 250 dollars Australian to:
200: \[\begin{tabular}{ll}
201: Postal address:& CSIRO DIT\\
202: & Attn: Andrew Waugh (ISODE Distribution)\\
203: & 55 Barry Street\\
204: & Carlton, 3053\\
205: & Australia
206: \end{tabular}\]
207: For information only:
208: \[\begin{tabular}{ll}
209: \ Telephone:& +61 3--347--8644\\
210: \ Fax:& +61 3--347--8987\\
211: \ Internet:& \verb"[email protected]"
212: \end{tabular}\]
213: Specify one of:
214: \begin{enumerate}
215: \item 1600/3200/6250bpi 1/2--inch tape, or
216:
217: \item Sun 1/4---inch cartridge tape in either QIC-11 or QIC-24 format.
218: \end{enumerate}
219: The tape will be written in tar format and returned with a documentation set.
220: Do not send tapes or envelopes.
221: Documentation only is the same price.
222:
223: \item Internet\\
224: If you can FTP to the Internet,
225: you can use anonymous FTP to the host \verb"uu.psi.com"
226: \verb"[136.161.128.3]"
227: to retrieve \compressfile/ in BINARY mode from the \tarplace/
228: directory.
229: This file is the \pgm{tar} image after being run through the compress program
230: and is approximately \compressize/ in size.
231:
232: \item NIFTP\\
233: If you run NIFTP over the public X.25 or over JANET, and are
234: registered in the NRS at Salford, you can use NIFTP with username
235: ``guest'' and your own name as password, to access \verb"UK.AC.UCL.CS" to
236: retrieve the file \uktarfile/.
237: This is a \tarsize/ \pgm{tar} image.
238: The file \ukcompressfile/ is the \pgm{tar} image after being
239: run through the compress program (\compressize/).
240:
241: \item FTAM on the JANET or PSS\\
242: The source code is available by FTAM at the University College London over X.25
243: using JANET (DTE \verb"00000511160013") or PSS (DTE \verb"23421920030013") with
244: TSEL~\verb"259" (ASCII encoding).
245: Use the ``anon'' user-identity and retrieve the file \uktarfile/.
246: This is a \tarsize/ \pgm{tar} image.
247: The file \ukcompressfile/ is the \pgm{tar} image after being
248: run through the compress program (\compressize/).
249:
250: \item FTAM on the Internet\\
251: The source code is available by FTAM over the
252: Internet at host \verb"osi.nyser.net" \verb"[192.33.4.10]"
253: (TCP port~102 selects the OSI transport service)
254: with TSEL~\verb"259" (numeric encoding).
255: Use the ``anon'' user-identity, supply any password,
256: and retrieve \compressfile/ from the \tarplace/ directory.
257: This file is the \pgm{tar} image after being run through the compress program
258: and is approximately \compressize/ in size.
259: \end{itemize}
260: For distributions via FTAM,
261: the file service is provided by the FTAM implementation in ISODE~5.0 or later
262: (IS FTAM).
263:
264: For distributions via either FTAM or FTP, there is an additional file
265: available for retrieval, called \PSfile/ which is a compressed tar
266: image (\PSsize/) containing the entire documentation set in PostScript format.
267:
268: \newpage\section* {Discussion Groups}
269: The Internet discussion group {\tt [email protected]\/} is
270: used as a forum to discuss ISODE.
271: Contact the Internet mailbox {\tt [email protected]\/}
272: to be asked to be added to this list.
273:
274: \newpage\section* {Acknowledgements}
275: Many people have made comments about and contributions to the ISODE which have
276: been most helpful.
277: The following list is by no means complete:
278:
279: The first three releases of the ISODE were developed at the Northrop
280: Research and Technology Center,
281: and the first version of this manual is referenced as NRTC Technical
282: Paper \#702.
283: The initial work was supported in part by Northrop's Independent
284: Research and Development program.
285:
286: The Wollongong Group supported ISODE for its 4.0 and 5.0 release.
287: they deserve much credit for that.
288: Further,
289: they contributed an implementation of RFC1085,
290: a lightweight presentation protocol for TCP/IP-based internets.
291:
292: The ISODE is currently supported by Performance Systems International,
293: Inc.~and NYSERNet, Inc.
294: It should be noted that PSI/NYSERNet support for the ISODE represents a
295: substantial increase in commitment.
296: That is,
297: the ISODE is now a funded project,
298: whereas before ISODE was always an after-hours activity.
299: The NYSERNet effort is partially support by the U.S.~Defense Advanced Research
300: Projects Agency and the Rome Air Development Center of the U.S.~Air Force
301: Systems Command under contract number F30602--88--C--0016 to NYSERNet Inc.
302:
303: Christopher W.~Moore\index{Moore, Christopher W.}
304: of the Wollongong Group has provided much help with ISODE both in terms of
305: policy and implementational matters.
306: He also performed Directory interoperability testing against a different
307: implementation of the OSI Directory.
308:
309: Dwight E.~Cass\index{Cass, Dwight E.}
310: of the Northrop Research and Technology Center was one of the original
311: architects of {\em The ISO Development Environment}.
312: His work was critical for the original proof of concept and should not be
313: forgotten.
314: John L.~Romine\index{Romine, John L.}
315: also of the Northrop Research and Technology Center provided many
316: fine comments concerning the presentation of the material herein.
317: This resulted in a much more readable manuscript.
318: Stephen H.~Willson\index{Willson, Stephen H.},
319: also of the Northrop Research and Technology Center,
320: provided some help in verifying the operation of the
321: software on a system running the AT\&T variant of \unix/.
322:
323: The \man librosap(3n) library was heavily influenced by an earlier native-TCP
324: version written by George Michaelson\index{Michaelson, George}
325: of University College London, in
326: the United Kingdom.
327: Stephen E.~Kille\index{Kille, Stephen E.},
328: also of University College London,
329: provided valuable feedback on the \man pepy(1) utility.
330: In addition,
331: both Steve and George provided us with some good comments concerning the
332: \man libpsap(3) library.
333: Steve is also the conceptual architect for the addressing scheme used in
334: the software,
335: and he modified the \man librosap(3n) library to support half-duplex mode when
336: providing ECMA ROS service.
337: George contributed the CAMTEC X.25 interface.
338: Simon Walton\index{Walton, Simon},
339: also of University College London,
340: has been very helpful in providing constant feedback on the ISODE during
341: beta-testing.
342:
343: The INCA project donated the QUIPU Directory implementation to the ISODE.
344: Stephen E.~Kille\index{Kille, Stephen E.},
345: Colin J.~Robbins\index{Robbins, Colin J.},
346: and Alan Turland\index{Turland, Alan},
347: all of University College London,
348: are the three principals who developed the directory software
349: and also wrote \volfive/ describing the QUIPU directory.
350: In addition,
351: Steve Titcombe\index{Titcombe, Steve},
352: also of UCL
353: spent considerable time on the DIrectory SHell (DISH).
354:
355: The UCL work has been partially supported by the commission of the
356: EEC\index{EEC} under its ESPRIT\index{ESPRIT} program,
357: as a stage in the promotion of OSI standards.
358: Their support has been vital to the UCL activity.
359: In addition,
360: QUIPU is also funded by the UK Joint Network Team (JNT).
361:
362: Julian P.~Onions\index{Onions, Julian},
363: at the Department of Computer Science at Nottingham University,
364: is the current \man pepy(1) guru,
365: having brainstormed and implemented the encoding functionality along with
366: Stephen E.~Easterbrook\index{Easterbrook, Stephen}
367: of University College London.
368: Julian also contributed the UBC X.25 interface
369: along with the TCP/X.25 TP0 bridge,
370: and has also contributed greatly to \man posy(1).
371: Julian's latest contribution has been a {\em transport service bridge}.
372: This is used to masterfully solve interworking problems between different OSI
373: stacks (TP0/X.25, TP4/CLNP, RFC1006/TCP, and so on).
374:
375: John Pavel\index{Pavel, John}
376: and Godfrey Cowin\index{Cowin, Godfrey}
377: of the Department of Trade and Industry/National Physical Laboratory in the
378: United Kingdom
379: both contributed significant comments during beta-testing.
380: In particular, John gave us a lot of feedback on \man pepy(1)
381: and on the early FTAM DIS implementation.
382: John also contributed the SunLink X.25 interface.
383:
384: Keith Ruttle\index{Ruttle, Keith} of CAMTEC Electronics Limited in the United
385: Kingdom contributed the both the driver for the new CAMTEC X.25 interface and
386: the CAMTEC CONS interface (X.25 over 802 networks).
387: This latter driver was later removed from the distribution for lack of use.
388:
389: In addition,
390: Andrew Worsley\index{Worsley, Andrew}
391: of the Department of Computer Science at the University of Melbourne in
392: Australia
393: pointed out several problems with the FTAM DIS implementation.
394: He also developed a replacement for \pgm{pepy} and \pgm{posy} called
395: \pgm{pepsy}.
396: After moving to University College London,
397: he improved this system and integrated into the ISODE.
398:
399: Mark R.~Horton\index{Horton, Mark R.}
400: of AT\&T Bell Laboratories
401: also provided some help in verifying the operation of the
402: software on a 3B2~system running \unix/ System~V release~2.
403: In addition,
404: Greg Lavender\index{Lavender, Greg} of NetWorks One
405: under contract to the U.S.~Navy Regional Data Automation Center (NARDAC),
406: provided modifications to allow the software to run on a generic port of
407: \unix/ System~V release~3.
408:
409: Jem Taylor\index{Taylor, Jem}
410: of the Computer Science Department at the University of Glasgow
411: provided some comments on the documentation.
412:
413: Hans-Werner Braun\index{Braun, Hans-Werner}
414: of the University of Michigan provided the inspiration for the initial part of
415: Section~\ref{name}.
416:
417: A previous release of the software contained an ISO TP4/CLNP package
418: derived from a public-domain implementation developed by the National
419: Bureau of Standards\index{NBS}.
420: The purpose of including the NBS package (and associated support)
421: was to give an example of how one would interface the code to a ``generic'' TP4
422: implementation.
423: As the software has now been interfaced to various native TP4 implementations,
424: the NBS package is no longer present in the distribution.
425:
426: John A.~Scott\index{Scott, John A.}
427: of the MITRE Corporation contributed the SunLink OSI interface for TP4.
428: He also wrote the FTAM/FTP gateway which the MITRE Corporation has generously
429: donated to this package.
430:
431: Philip B.~Jelfs\index{Jelfs, Philip B.}
432: of the Wollongong Group upgraded the FTAM/FTP gateway to the
433: ``IS-level'' (International Standard) FTAM.
434:
435: Rick Wilder\index{Wilder, Rick}
436: and
437: Don Chirieleison\index{Chirieleison, Don}
438: of the MITRE Corporation contributed the VT implementation which the MITRE
439: Corporation has generously donated to this package.
440:
441: Jacob Rekhter\index{Rekhter, Jacob}
442: of the T.~J.~Watson Research Center, IBM Corporation
443: provided some suggestions as to how the system should be ported
444: to the IBM RT/PC running either AIX or 4.3\bsd/.
445: He also fixed the incompatibilities of the FTAM/FTP gateway when running on
446: 4.3\bsd/ systems.
447:
448: Ashar Aziz\index{Aziz, Ashar}
449: and
450: Peter Vanderbilt\index{Vanderbilt, Peter},
451: both of of Sun Microsystems Inc.,
452: provided some very useful information on modifying the SunLink OSI interface
453: for TP4.
454:
455: John Brezak\index{Brezak, John}
456: of Apollo Computer, Incorporated
457: ported the ISODE to the Apollo workstation.
458: Don Preuss\index{Preuss, Don},
459: also of Apollo,
460: contributed several enhancements and minor fixes.
461:
462: Ole-Jorgen Jacobsen\index{Jacobsen, Ole-Jorgen} of Advanced Computing
463: Environments provided some suggestions on the presentation of the material
464: herein.
465:
466: Nandor Horvath\index{Horvath, Nandor}
467: of the Computer and Automation Institute of the Hungarian Academy of Sciences
468: while a guest-researcher at the DFN/GMD in Darmstadt, FRG,
469: provided several fixes to the FTAM implementation and documentation.
470:
471: George Pavlou\index{Pavlou, George}
472: and Graham Knight\index{Knight, Graham}
473: of University College London contributed some management instrumentation to
474: the \man libtsap(3n) library.
475:
476: Juha Hein\"{a}nen\index{Hein\"{a}nen, Juha}
477: of Tampere University of Technology
478: provided many valuable comments and fixes on the ISODE.
479:
480: Paul Keogh\index {Keogh, Paul}
481: of the Nixdorf Research and Development Center, in Dublin, Ireland,
482: provided some fixes to the FTAM implementation.
483:
484: Finally,
485: James Gosling,\index{Gosling, James}
486: author of the superb Emacs screen-editor for \unix/,
487: and
488: Leslie Lamport,\index{Lamport, Leslie}
489: author of the excellent \LaTeX{} document preparation system
490: both deserve much praise for such winning software.
491: Of course,
492: the whole crew at U.C.~Berkeley\index{U.C.~Berkeley}
493: also deserves tremendous praise for their wonderful work on their variant of
494: \unix/.
495:
496: \vspace{0.25in}
497: {\raggedleft /mtr\par}
498: {\raggedright Palo Alto, California\\
499: \ifcase\month
500: \number\month\or
501: January\or February\or March\or April\or May\or June\or
502: July\or August\or September\or October\or November\or December\else
503: \number\month\fi,
504: {\oldstyle\number\year}\par}
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.