home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / hamradio / nosvw304.zip / NOSGAS.ZIP / !!README.2ND < prev    next >
Text File  |  1993-01-25  |  12KB  |  341 lines
  1. ============                                        NOSview [304]
  2. !!README.2ND
  3. ============
  4.  
  5. Before doing anything further, please read the file
  6. "!!README.1ST" and follow the NOSView installation instructions.
  7.  
  8.  
  9. ================================
  10. WELCOME TO NOSVIEW RELEASE [304]
  11. ================================
  12. by Ian Wade
  13. G3NRW
  14.  
  15. NOSview, first introduced in September 1991, is an on-line
  16. documentation and runtime package for the KA9Q Network Operating
  17. System (NOS).  It contains:
  18.  
  19. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  20.  
  21. ***  probably the only complete reference work anywhere that
  22.      describes all of the commands to be found in the major NOS
  23.      releases.
  24.  
  25. ***  a TSR file viewer that lets you read the NOSview
  26.      documentation on-line, without breaking out of NOS.
  27.  
  28. ***  NOSgas: the "NOS Get-Away Special"  --  a complete set of
  29.      working NOS runtime software.
  30.  
  31. ***  a complete set of templates for the NOS control files.
  32.  
  33. ***  full details on how to get the book "NOSintro", which
  34.      describes in detail how TCP/IP works and how to use KA9Q
  35.      NOS.  Ideal for beginners to TCP/IP (and more advanced users
  36.      will find many gems of helpful information there as well).
  37.  
  38. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  39.  
  40.  
  41. NOSview [304] contains many new documentation files, and the
  42. template NOS control files match the listings in "NOSintro".  The
  43. PA0GRI version 2.0m of NOS is also included.
  44.  
  45. Extras include ....
  46.  
  47.     UUENCODE/UUDECODE file conversion utilities
  48.     AX.25 Baycom Packet Driver
  49.     KISS protocol documentation
  50.     HOSTS <> DOMAIN conversion programs
  51.     PCElm and ELM Mailers
  52.     The Clockwork VIEW TSR file viewer
  53.  
  54. -----------------------------------------------------------------
  55.  
  56. Over the years, many documents have appeared on the networks
  57. describing various features of NOS, but much of that material was
  58. incomplete.  Some of it was inaccurate, and, because it was
  59. written and edited by many hands, sometimes very misleading and
  60. inconsistent.
  61.  
  62. My small contribution to the genre is NOSview.  In NOSview I have
  63. attempted to pull together all the available documentation and
  64. massage it into a consistent whole.  The release is almost 300
  65. pages long, around 20 percent being new material.
  66.  
  67. All of the NOS commands are described in detail, with actual
  68. examples showing the exact way that you enter them into the
  69. system.  There are also many examples of display outputs showing
  70. the results of executing the commands.
  71.  
  72. But this is only half the story.  The real power of NOSview comes
  73. into its own when used with a file-viewing TSR program such as
  74. VIEW from Clockwork Software.  With VIEW (which is public domain
  75. and supplied with NOSview), you can hot-key to a menu to list the
  76. files in a particular directory, pick the file of interest and
  77. presto! the file is displayed on the screen.  You can then scroll
  78. up and down the file to read it at leisure.
  79.  
  80. To take full advantage of VIEW, NOSview is provided not as one
  81. huge monolithic document, but consists of over 100 separate
  82. description files, one for each NOS command.  Thus when you are
  83. using NOS and want to find out about a particular command, all
  84. you do is hot-key to VIEW and read the command description file,
  85. without breaking out of NOS.
  86.  
  87. It is this on-line feature of NOSview which makes it an
  88. exceptionally useful tool, and because NOSview consists of many
  89. small files it is much easier to maintain and much less
  90. wasteful of trees.  What's more, you can use VIEW to examine any
  91. file in the system (ASCII or binary); indeed, it makes the NOS
  92. 'more' and 'tail' commands redundant.
  93.  
  94. Yet another feature of NOSview is that it contains a complete set
  95. of NOS runtime files and a set of template files (such as
  96. autoexec.nos, ftpusers and so forth) which you can use on your
  97. system.  The files are accompanied by full descriptions of their
  98. formats, together with warnings about "gotchas" which can cause a
  99. lot of frustration if you are unaware of them.
  100.  
  101. The template files are located in the correct directories for NOS
  102. operation.  All you have to do is edit them to match your system
  103. (in most cases by just modifying callsigns and directory paths),
  104. and you have a ready-made environment to try out NOS.  In
  105. addition, read-only master copies are kept in directory
  106. /public/masters, so you have a copy to fall back on if you make
  107. any mistakes.
  108.  
  109. ----------------
  110. Acknowledgements
  111. ----------------
  112. NOSview is based on the work of many, many people, and in the
  113. list below I hope I have included all of those who have written
  114. NOS software and documentation in the past.
  115.  
  116. However, if you recognise some of your work but have not been
  117. acknowledged here, please don't be offended.  It's simply that I
  118. did not know you had written it, and if you care to drop me a
  119. line I'll be glad to add your name to the credits in the next
  120. release.
  121.  
  122. In strict surname order, the work of the following people is
  123. acknowledged:
  124.  
  125. Phil Karn, KA9Q   |  Who said the alphabet doesn't begin with K ?
  126.                   |  Oh, well.  If you insist ...
  127.                   |  .... here are the rest .....
  128.  
  129. John Ackermann, AG9V
  130. Hayden Bate, G8AMD
  131. Dave Brooke, G6GZH
  132. Mike Chace, G6DHU
  133. Tom Clark, W3IWI
  134. Mike Dent, G6PHF
  135. D R Evans, G4AMJ/NQ0I
  136. Gary Ford, N6GF
  137. Dan Frank, W9NK
  138. Bdale Garbee, N3EUA
  139. Fred Goldstein, K1IO
  140. Gerard van der Grinten, PA0GRI
  141. Allen Gwinn, NK5CKP
  142. Charles Hedricks
  143. Kelvin Hill, G1EMM
  144. Gareth Howell, G6KVK
  145. Pavel Jalocha, SP9VRC
  146. Brian Kantor, WB6CYT
  147. Anders Klemets, SM0RGV
  148. Wally Linstruth, WA6JPR
  149. Peter Meiring, G0BSX
  150. Russell Nelson
  151. Johan Reinalda, WG7J/PA3DIS
  152. Bill Simpson
  153. Mike Stockett, WA7DYX
  154. Paul Taylor, G1PLT
  155. Dave Trulli, NN2Z
  156. Stanley Wilson, AK0B
  157.  
  158.  
  159. -----------
  160. Conventions
  161. -----------
  162. To obtain overall consistency throughout NOSview, a number of
  163. conventions have been adopted.
  164.  
  165.  
  166. Callsigns
  167. ---------
  168. All radio callsigns in the examples are (intended to be)
  169. fictitious.
  170.  
  171. Calls in the NS9xxx series are for NOS stations, and in the
  172. AX9xxx series for vanilla AX.25 stations.
  173.  
  174. NET/ROM aliases start with a # (e.g. "#BOB"), and real NET/ROM
  175. stations (as distinct from NOS stations running NET/ROM) have
  176. NR9xxx callsigns.
  177.  
  178. Also, to distinguish between IP hostnames and AX.25 callsigns,
  179. the hostnames are shown in lower case (e.g. "ns9abc"), whereas
  180. AX.25 callsigns are in upper case (e.g. "NS9ABC-5").  Hopefully
  181. this will remove much of the confusion which exists in other
  182. documentation.
  183.  
  184. (And should you actually hold a callsign mentioned in NOSview,
  185. feel proud that your call will now be known around the world!).
  186.  
  187.  
  188. Parameter Names
  189. ---------------
  190. Because the NOS packages contain software modules originating
  191. from several different sources, the documentation which describes
  192. them inevitably contains a number of inconsistencies.  For
  193. example, the words "label" and "interface" apparently describe
  194. different objects, whereas in actuality they are the same thing.
  195. On the other hand, the word "address" can have different
  196. meanings, depending on the command.
  197.  
  198. In NOSview, the names of these parameters have been rationalised
  199. to produce a consistent command set.  The parameters which often
  200. cause confusion are to do with names, addresses and interfaces.
  201. These are now defined as follows:
  202.  
  203.   <callsign>      an AX.25 MYCALL callsign     (e.g.  "NS9AAA-5")
  204.  
  205.   <hostname>      a host name in DOMAIN.TXT
  206.                          (e.g.  "ns9aaa"  or  "ns9aaa.ampr.org.")
  207.  
  208.   <ipaddress>     an Internet address         (e.g. "44.128.5.2")
  209.  
  210.   <host>          <hostname>  or  <ipaddress>
  211.  
  212.   <username>      a user at a computer               (e.g. "ian")
  213.  
  214.   <interface>     a device interface name           (e.g. "tnc0")
  215.  
  216.   <ioaddress>     a device I/O base address       (e.g.  "0x3f8")
  217.  
  218.   <vector>        an IRQ level                         (e.g. "4")
  219.  
  220. The word "hostid" is not used at all, to avoid confusion with the
  221. Unix command of the same name.
  222.  
  223.  
  224. Interface Names
  225. ---------------
  226. You can choose any name for a device interface.  In NOSview, the
  227. following names are used:
  228.  
  229.   "tnc0"    for a TNC KISS interface.
  230.               (this replaces the names "ax0" and "pk0" found in
  231.                other documents).
  232.  
  233.   "sl0"     for a SLIP (Serial Line Internet Protocol) interface.
  234.  
  235.   "en0"     for an Ethernet interface.
  236.  
  237.   "pp0"     for a PPP (Point-to-Point Protocol) interface.
  238.  
  239.  
  240.  
  241. Directory Paths
  242. ---------------
  243. You can install NOS in any directory on any disk drive.  NOSview
  244. suggests the use of the DOS 'SUBST' command to define the root of
  245. the NOS system, and all NOS directory and file path names are
  246. then shown relative to that root.
  247.  
  248. NOSview documentation suggests drive N: as the NOS root, and thus
  249. refers to NOS directories and files in the following manner:
  250.  
  251.      n:/spool/mail
  252.      n:/ftpusers
  253.  
  254. and so forth.
  255.  
  256. Note that NOS commands use the FORWARD slash (/) to separate
  257. directory levels.  Only those commands which are directly
  258. interpreted by DOS use the backslash (\).
  259.  
  260.  
  261. ------------------
  262. Technical vs Legal
  263. ------------------
  264. NOSview describes what is technically possible within NOS.  Some
  265. of its features, however, may not be covered by the terms of your
  266. licence (for example, third-party message handling).  It is
  267. clearly your responsibility to operate within the law of your
  268. country.
  269.  
  270.  
  271. -------------------
  272. Release Information
  273. -------------------
  274. Full details of the current release of NOSview are included in
  275. the file "!RELEASE.304.
  276.  
  277.  
  278.  
  279. ------------------
  280. How to get NOSview
  281. ------------------
  282. By now, NOSview should be available on the major bulletin boards
  283. throughout the world, and also via Internet on "ucsd.edu" in
  284. directory "hamradio/packet/tcpip/docs".
  285.  
  286. Look for two files:
  287.  
  288.   NOSVIEW.ZIP  (which contains a very brief intro to NOSview)
  289.   NOSVW304.ZIP (which contains the complete NOSview package)
  290.  
  291. NOSVW304.ZIP is quite large (around 700 KB), so you may prefer
  292. instead to get your copy by mailing a DOS-formatted diskette (any
  293. size EXCEPT 360 KB) and return mailer to:
  294.  
  295.      Ian Wade, G3NRW
  296.      7 Daubeney Close
  297.      Harlington
  298.      DUNSTABLE
  299.      Bedfordshire
  300.      LU5 6NF
  301.      United Kingdom
  302.  
  303. Please enclose return postage as follows:
  304.  
  305.      United Kingdom:               UK postage stamps
  306.      Rest of Europe:               3 IRCs
  307.      The Americas, Africa:         7 IRCs
  308.      Rest of the World:            9 IRCs
  309.  
  310. (Any unused IRCs will of course be returned).
  311.  
  312. There is no charge for NOSview, so please do NOT enclose any form
  313. of payment.
  314.  
  315. NOSview is provided on an "as is" basis, and is believed to
  316. contain working, virus-free software.  However, no responsibility
  317. can be taken for any erroneous operation or malfunction that may
  318. occur as a result of using it.
  319.  
  320.  
  321. ----------------------
  322. "NOSintro" -- the book
  323. ----------------------
  324.  
  325. As a final comment, NOSview is an advanced reference document
  326. intended primarily for people who have already got NOS up and
  327. running.  Beginners will probably find it heavy going, but may be
  328. interested to know that my new book on NOS for beginners
  329. ("NOSintro") is now available.  Full information on "NOSintro" is
  330. included in file !INTRO.
  331.  
  332. 73 and good luck with TCP/IP and NOS.
  333.  
  334. Ian Wade
  335.  
  336. AMPRnet    g3nrw.ampr.org [44.131.5.2]
  337. AX.25      G3NRW @ GB7BIL
  338. Internet   g3nrw @ dircon.co.uk
  339.  
  340. January 1993
  341.