home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / internet / bootnet / ReadMe-ANT < prev    next >
Text File  |  1995-08-08  |  37KB  |  1,256 lines
  1.  
  2. Introduction
  3.  
  4. What's New?
  5.     *configure etherX multiple
  6.     *eXtest commands
  7.     *showstat command
  8.  
  9. Downloading new drivers from the Internet
  10.     Downloading via WWW
  11.     Downloading via anonymous FTP
  12.  
  13. Configuration Commands
  14.     Default
  15.     Terse
  16.     Verbose
  17.     Single
  18.     Multiple
  19.     LiveWireTest
  20.     NoLiveWireTest
  21.     Strict
  22.     Ignore
  23.     Enable
  24.     Disable
  25.  
  26. Selftests and the *eXtest commands
  27.  
  28. A couple of obscure points
  29.  
  30. Statistics and trouble shooting
  31.  
  32. The *showstat command
  33.  
  34. Summary of *commands described
  35.  
  36. Obtaining further assistance
  37.  
  38. -----------------------------------------------------------------------------
  39.  
  40. Introduction
  41.  
  42. This release of ANT's network device drivers for its ethernet cards conform
  43. to the new DCI4 interface specification.  Additional support for PC cards has
  44. been added to the drivers, along with a separate program to collect statistic
  45. information and present it tidily.
  46.  
  47. -----------------------------------------------------------------------------
  48.  
  49. What's New?
  50.  
  51. The major enhancement of interest to PC card users is the ability to
  52. configure for multiple operation.  This is a software trick that makes one
  53. ethernet card appear to be two cards, permitting RISC OS and the PC card to
  54. connect to differently named interfaces.  Together with a network client such
  55. as OmniClient, this makes it possible to view the same network file server in
  56. both RISC OS and PC windows at the same time.  This feature is available in
  57. both the Ether3 and EtherB drivers.  See the section on configuration
  58. commands for usage details.
  59.  
  60. For easier network administration, a *command has been added that runs the
  61. selftests.  This can be used at any stage (selftests are normally only run
  62. when a network protocol first connects to an ethernet interface).  See the
  63. section on selftests for
  64.  
  65. The *showstat program collects statistics from any module that understands
  66. that ANT Statistics Protocol and presents them tidily.  Currently, all our
  67. DCI4 network drivers and the Mbuf Manager are capable of supplying statistics
  68. suitably.  We intend to increase the range of programs supporting this
  69. protocol.
  70.  
  71. -----------------------------------------------------------------------------
  72.  
  73. Downloading new drivers from the Internet
  74.  
  75. You can download the latest network device drivers from our WWW and anonymous
  76. FTP sites on the Internet.
  77.  
  78. -----------------------------------------------------------------------------
  79.  
  80. Downloading via WWW
  81.  
  82. For general information on our DCI4 drivers, you should access the URL
  83.  
  84.     http://www.ant.co.uk/dci4/
  85.  
  86. For specific downloading options, access the URL
  87.  
  88.     http://www.ant.co.uk/dci4/download.html
  89.  
  90. -----------------------------------------------------------------------------
  91.  
  92. Downloading via FTP
  93.  
  94. Important:  if your FTP client permits you to vary the transfer mode, ensure
  95. that you have selected image (binary) transfer mode before downloading new
  96. device drivers or programs.
  97.  
  98. For a traditional FTP client, the following information is relevant:
  99.  
  100.     host:       ftp.ant.co.uk
  101.     userid:     anonymous
  102.     password:   <your email address>
  103.     directory:  /pub/dci4/
  104.  
  105. When using an FTP client built into a web browser (such as ANT's Fresco), the
  106. following URL should be used:
  107.  
  108.     ftp://ftp.ant.co.uk/pub/dci4/
  109.  
  110. -----------------------------------------------------------------------------
  111.  
  112. Configuration Commands
  113.  
  114. In general, the configuration options available are the same across Ether3,
  115. EtherB and EtherP modules with the same version number.  The EtherP module
  116. does not use CMOS RAM to store its configuration options, as there is none
  117. allocated (to the parallel port) that it may safely use.  Instead, EtherP
  118. takes an argument string when being loaded that contains the necessary
  119. configuration options.  Most of the configuration options are paired
  120. together.  For example, the verbose option is paired with the terse option.
  121. The general form for configuration is:
  122.  
  123.     *Configure <driver-name> <option> [slot]
  124.  
  125. Where:
  126.  
  127. <driver-name>
  128.     is Ether3, EtherB or EtherP
  129.  
  130. <option>
  131.     is one of the options listed below
  132.  
  133. [slot]
  134.     specifies a specific expansion card slot to apply the configuration
  135.     option to.  This paramater is optional.  It is used when an Ether3 module
  136.     is controlling more than one expansion card and it is desired to update
  137.     the configuration options associated with only one of them.
  138.  
  139. By way of example, the following illustrates how to configure "verbose"
  140. operation:
  141.  
  142.  
  143. For Ether3 modules:
  144.  
  145.     *configure Ether3 verbose
  146.  
  147.  
  148. For EtherB modules:
  149.  
  150.     *configure EtherB verbose
  151.  
  152.  
  153. For EtherP modules only:
  154.  
  155. The RMload command in the startup file in the files subdirectory of the
  156. !Internet directory that loads the Ethernet module requires the options
  157. appending.  A standard startup file contains a section similar to this:
  158.  
  159. | Load driver and initialise Ethernet interface, if required
  160.  
  161. IF "<Inet$EtherIPAddr>" <> "" AND "<Inet$EtherDevice>" <> "" THEN rmload inet:drivers.<Inet$EtherDevice>
  162.  
  163. This should be changed to something similar to
  164.  
  165. | Load driver and initialise Ethernet interface, if required,
  166. | including configuration options
  167.  
  168. IF "<Inet$EtherIPAddr>" <> "" AND "<Inet$EtherDevice>" <> "" THEN rmload inet:drivers.<Inet$EtherDevice> verbose
  169.  
  170. -----------------------------------------------------------------------------
  171.  
  172. Configuration option: default
  173. Applicability       : ether3, etherb
  174.  
  175. Description:
  176. ============
  177.  
  178. Selecting this configuration option restores all configuration options to
  179. their default values.
  180.  
  181. Example:
  182. ========
  183.  
  184.     *configure ether3 default
  185.  
  186. This restores the configuration of an Ether3 card to the default values.
  187. These are equivalent to:
  188.  
  189.     *configure ether3 Enable
  190.     *configure ether3 Strict
  191.     *configure ether3 NoLiveWireTest
  192.     *configure ether3 Terse
  193.     *configure ether3 Single
  194.  
  195. Notes:
  196. ======
  197.  
  198. This restoration happens automatically if the values recorded in CMOS RAM are
  199. detected as being incorrect (say because a different type of card was
  200. previously installed in the same expansion card slot the last time the
  201. machine was used).
  202.  
  203. With EtherP, simply supply no command line arguments when the module is
  204. loaded.
  205.  
  206. -----------------------------------------------------------------------------
  207.  
  208. Configuration option: terse
  209. Paired with         : verbose
  210. Applicability       : ether3, etherb
  211.  
  212. Description:
  213. ============
  214.  
  215. 1) When performing selftests, terse operation causes printing to only
  216. occur if an error is encountered.
  217.  
  218. 2) Terse selftests perform a quicker memory test than verbose
  219. selftests.
  220.  
  221. 3) Terse operation generally omits printing a count for a statistic if
  222. the value is zero.
  223.  
  224. Example:
  225. ========
  226.  
  227.     *configure ether3 terse
  228.  
  229. This configures an Ether3 card to operate in terse mode.
  230.  
  231. Notes:
  232. ======
  233.  
  234. Terse operation is often the most convenient in normal use.
  235.  
  236. -----------------------------------------------------------------------------
  237.  
  238. Configuration option: verbose
  239. Paired with         : terse
  240. Applicability       : ether3, etherb
  241.  
  242. Description:
  243. ============
  244.  
  245. 1) When performing selftests, verbose operation always prints the test
  246. being conducted and the test result.
  247.  
  248. 2) Verbose selftests perform a more extensive memory test than terse
  249. selftests.  This adds notably to the time it takes to perform
  250. selftests, but can be a useful diagnostic aid.
  251.  
  252. 3) A verbose configuration lists all available statistics, including
  253. those that are zero.
  254.  
  255. Example:
  256. ========
  257.  
  258.     *configure ether3 verbose
  259.  
  260. This configures an Ether3 card to operate in verbose mode.
  261.  
  262. Notes:
  263. ======
  264.  
  265. See also the *showstat command.
  266.  
  267. -----------------------------------------------------------------------------
  268.  
  269. Configuration option: single
  270. Paired with         : multiple
  271. Applicability       : ether3, etherb
  272.  
  273. Description:
  274. ============
  275.  
  276. When configured for single operation, each ethernet card presents one
  277. software interface to network protocols. This is the more traditional
  278. mode of operation, as contrasted with multiple operation.
  279.  
  280. Example:
  281. ========
  282.  
  283.     *configure ether3 single
  284.  
  285. This configures an Ether3 card to operate in single mode. This causes
  286. an interface named "ea0" to be presented in software to the rest of
  287. the system.
  288.  
  289. Notes:
  290. ======
  291.  
  292. -------------------------------------------------------